Misc

<input type="text" cp-sig-id="sig1" cp-sig-type="click" cp-sig-role="role1"/>

To reference a specific target in the HTML document other than the default cp-root:

<div id="cp-root">
 <p>Text here not referenced by the signature</p>
 <div id="otherArea">
 <input type="text" cp-sig-id="sig1" cp-sig-type="click" cp-sig-role="role1" cp-sig-target="otherArea"/>
 </div>
</div>

<input type="text" cp-sig-id="sig1" cp-sig-type="image" cp-sig-role="role1"/>

<input type="text" cp-sig-id="sig1" cp-sig-type="audio" cp-sig-role="role1" cp-sig-audiomax="1"/>

<input type="text" cp-sig-id="sig1" cp-sig-type="click-initial" cp-sig-role="role1"/>

<input type="text" cp-sig-id="sig1" cp-sig-role="roleName" cp-sig-type="click"/>
<input type="text" cp-sig-id="sig1-initial" cp-sig-role="roleName" cp-sig-type="initial" cp-required="true" cp-sig-ref="sig1"/>

<input type="text" cp-sig-id="sig1" cp-sig-role="roleName" cp-sig-type="click"/>
<input type="text" cp-sig-id="sig1-initial1" cp-sig-role="roleName" cp-sig-type="initial-ex" cp-sig-group="group1" cp-required="true" cp-sig-ref="sig1"/>
<input type="text" cp-sig-id="sig1-initial2" cp-sig-role="roleName" cp-sig-type="initial-ex" cp-sig-group="group1" cp-required="true" cp-sig-ref="sig1"/>

Optional attributes

• firstDialog: otherwise use the first one listed
• styleSheet: a css file to link to the wizard
• id: the id for the element
• validationTarget: the validationTarget for the wizard

Child Tags

• dialog: Required

Sample:

	
<dialogs>
 <dialog name="one">
        <!-- dialog one's content-->
    </dialog>
 <dialog name="two">
        <!-- dialog two's content-->
    </dialog>
 <dialog name="three">
        <!-- dialog three's content-->
    </dialog>
</dialogs>
	
	

Optional attributes

• progress: a number 1-100 indicating progress through the wizard
• goto: the name of the next dialog to goto if if or compound if fail. endWizard is a special case that will drop to workflow.
• action: if goto="endWizard", this action will be passed back to the workflow
• id: the id for the element
• validationTarget: the validationTarget for the dialog

Child Tags

• if: Optional
• if_compound: Optional
• content: Required

Sample

	
<dialog name="one" progress="20">
 <if></if> <!-- if attributes -->
    <content>
        <!-- dialog content -->
    </content>
</dialog>
<dialog name="info" goto="endWizard" action="wizardFinished">
 <content>
        <!-- dialog content -->
    </content>
</dialog>
	
	

Attributes

• field: the field used for the test
• condition: the jexl condition. (eq, neq, lt, gt, etc.)
• value: the value
• type: the type of the field(string, date, number)
• target: the dialog to go to if the test evaluates to true (or 'endWizard' to return to workflow)
• action (Optional): if target="endWizard" this action will be returned to workflow

Sample

	
<if field="country" condition="eq" value="US" type="string" target="US"></if>
<if field="birth" condition="lt" value="01/01/2000" type="date" target="younger"></if>
<if field="GPA" condition="gt" value="3" type="number" target="endWizard" action="passes"></if>
	
	

Attributes

• target: the dialog to go to if the test evaluates to true (or 'endWizard' to return to workflow)
• action (Optional): if target="endWizard" this action will be returned to workflow

Child Tags, Use one or the other

• and
• or

Sample

	
<if_compound target="last">
 <and>
 <test field="firstName" condition="neq" value="" type="string"></test>
 <test field="age" condition="gt" value="19" type="number"></test>
 </and>
</if_compound>
<if_compound target="endWizard" action="wizard_done">
 <or>
 <test field="State" condition="eq" value="CA" type="string"></test>
 <test field="State" condition="eq" value="OR" type="string"></test>
 <test field="State" condition="eq" value="WA" type="string"></test>
 <test field="State" condition="eq" value="AZ" type="string"></test>
 </or>
</if_compound>
	
	

Child Tags

• test

Sample

Child Tags

• test

Sample

Attributes

• field: the field used for the test
• condition: the JEXL condition. (eq, neq, lt, gt, etc.)
• value: the value
• type: the type of the field(string, date, number)

Sample

Sample

	
<content>
 <div>
        all the content here
    </div>
</content>
<content>
 <p>
        all the content here
    </p>
</content>
	
	

Attributes

• name: (Required) the wizard data will use this name as the key
• value: (Optional) a default value for the wizard
• cp-use: (Optional) is an answer required. (R: required, roles: check the roles attribute, test: evaluate the test attribute
• cp-pattern: (Optional) answer must match the pattern
• cp-custompattern: (Optional) when pattern="custom" this attribute has a regular expression to use
• cp-sample: (Optional) displays a sample next to the field if pattern fails
• cp-roles: (Optional) when use="roles" this attribute will have a list of comma separated roles that the field is required for
• cp-test: (Optional) when use="test" this attribute will have a JEXL statement to evaluate.
• cp-validationTarget: (Optional) the validationTarget for the wizard field.
• cp-requiredMessage: (Optional) message displayed in validationTarget if wizard field fails the use test
• cp-validationMessage: (Optional) message displayed in validationTarget if wizard field fails the pattern test
• cp-message: (Optional) message displayed in validationTarget if wizard field fails a test and no specific message is available

Sample

	
<input type="checkbox" name="yes" cp-use="R" cp-validationTarget="errorTarget" cp-requiredMessage="yes must be checked"/>
<!-- This textarea (reason) and text field (phone) assumes the dialog or
     wizard contains the validationTarget to display the message-->
<textarea name="reason" cp-use="test" cp-test="${medicalIssue eq 'true'}" cp-message="must have a reason stated"></textarea>
<input type="text" name="phone" cp-pattern="phone" cp-validationMessage="must be a phone number"/>
	
	

// in workflow
var dateString = c.getWizard("wizard").getData().getValue("birthDate");
c.getPage("index").setValue("birthDate",dateString);

// in the page
${formatter.formatDateString(birthDate,'MMM dd, yyyy')}

// in workflow, assumes wizard has a field named 'fee'
c.getPage("index").getData().addData(c.getWizard("wizard").getData());

// in the page
${formatter.formatCurrency(fee)}

// in workflow
var userAgent = c.getBrowser().getUserAgent();

// in the page
<p>You are using this browser: ${browser.userAgent}</p>

<style>
    body.ie     {color:red}
    body.win    {font-family:Tahoma}
    body.ff     {color:blue}
    body.sf     {color:green}
    body.mac    {font-family:Helvetica}
    body.linux  {font-family:Courier}
</style>
<body class="${browser.browser} ${browser.operatingSystem}">
 <p>Here is some text that will look different depending on browser and operating system</p>
</body>

var page = c.getPage("index");
page.addJavascript("runMyClientSideScript()");

var frm = ClientPal.getPageForm();
frm.elements["name"].value="My name";

// for libraries that needs the form by name:
var frmName = ClientPal.getPageFormName();

// since eval is restricted, any eval we need to do goes through ClientPal.
// see the AJAX sample below for a better use case.
var x = 3;
ClientPal.runJavascript("a=x*9");

<input type="button" value="Send" onclick="sendAjax()"/>

// client-side javascript
function sendAjax()
{
    ClientPal.sendAjaxRequest("saveThis","resultHandler",ClientPal.getPageForm());
}

function resultHandler(html,js)
{
    if (html!=null)
    {
        document.getElementById("result").innerHTML=html;
    }
    if (js!=null)
    {
        ClientPal.runJavascript(js);
    }
}

// server-side workflow
if (c.isAction("saveThis"))
{
    var frag = c.createFragment("frag","<p>OK</p>",false);
    var response = c.createAjaxResponse(frag,false);
    response.addJavascript("alert('we saved your info')");
    return response;
}

// client-side javascript
function openThisWindow()
{
    var url = "http://www.someothersite.com";
    var name="myWIndow";
    var params="toolbar=yes,width=300,height=300,resizable=yes,scrollbars=yes,location=yes,status=yes,directories=yes,menubar=yes,copyhistory=no";
    var win = ClientPal.openWindow(url,name,params);
}

// client-side javascript
function reloadDoc()
{
    ClientPal.reloadDocument();
}

 
// in workflow
var filter = ds.createFilter();
filter.setPageSize(10);
filter.filterByPage(pageNumber);
var records = ds.getRecords(filter);
records.setName("records");
page.addDataList(records);
return page;

// in the page
${records.hasPreviousPage()}
${records.hasNextPage()}
${records.getFirstPage()}
${records.getPreviousPage()}
${records.getNextPage()}
${records.getLastPage()}
${records.getCurrentPage()}
${records.getPageCount()}