AgileApps Support Wiki Pre Release

Difference between revisions of "Prefill Form Fields"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 1: Line 1:
By creating the appropriate URL, you can take a registered platform user to a [[Form]] that has select fields pre-filled with default data. For example, you could put a link to that URL on a JSP page, and even JavaScript to acquire the data from other sources.
By creating the appropriate URL, you can take a registered platform user to a [[Form]] that has select fields pre-filled with default data. For example, you could put a link to that URL on a JSP page, and even JavaScript to acquire the data from other sources.
;Example:
:This HTML code displays a "Click here" link in a JSP page. When clicked, the user is directed to a form that has two fields pre-filled.
::{|
<tt><b><a href="https://</b>claims.mycompany.com<b>/networking/servicedesk<br> &nbsp; &nbsp;  &nbsp; /index.jsp?applicationId=</b>123456789<b>#_</b>Claims<br> &nbsp; &nbsp;  &nbsp; <b>/new/_form_title=</b>Agent+Form<b>/</b>fieldName1<b>=</b>value1<b>/</b>fieldName2<b>=</b>value1<b>"><br>
&nbsp; Click here<br>
</a></b></tt>
|}
:In this example:
::* ''domain'' = <tt>claims.mycompany.com</tt>
::* ''appID'' = <tt>123456789</tt>
::* ''objectName'' = <tt>Claims</tt>
::* ''formTitle'' = <tt>Agent+Form</tt> ("+" replaces the space in the form name)
::* ''field #1'' = <tt>xx</tt>, ''prefill value'' = <tt>xx</tt>
::* ''field #2'' = <tt>xx</tt>, ''prefill value'' = <tt>xx</tt>


;Syntax:
;Syntax:
:{|
:{|
<tt>
<tt>
https://<i>domain</i>/networking/servicedesk/index.jsp?applicationId=<i>appID</i>#_<i>objectName</i><br> &nbsp; &nbsp;  &nbsp; /new/_form_title=<i>formTitle</i>/<i>fieldName</i>=<i>value</i>/...</tt>
https://<i>domain</i>/networking/servicedesk/index.jsp?applicationId=<i>appID</i>#_<i>objectName</i><br> &nbsp; &nbsp;  &nbsp; /new/_form_title=<i>formName</i>/<i>fieldName</i>=<i>value</i>/...</tt>
|}
|}
: (''Line breaks have been added for readability.'' The URL must be a single contiguous string.)
: (''Line breaks have been added for readability.'' The URL must be a single contiguous string.)
Line 13: Line 28:
:* ''<tt>appID</tt>'' - The application ID, taken from the [[Application Properties]].
:* ''<tt>appID</tt>'' - The application ID, taken from the [[Application Properties]].
:* ''<tt>objectName</tt>'' - The name of the Object, taken from the [[Object Properties#Object Information|Object Information]] section of the Object Properties.
:* ''<tt>objectName</tt>'' - The name of the Object, taken from the [[Object Properties#Object Information|Object Information]] section of the Object Properties.
:* ''<tt>formTitle</tt>'' - The name of the form, taken from the [[Form#Form Properties|Form Properties]].
:* ''<tt>formName</tt>'' - The name of the form, taken from the [[Form#Form Properties|Form Properties]].
:* ''<tt>fieldName</tt>'' - The name of a [[Field]] that is displayed in the form.
:* ''<tt>fieldName</tt>'' - The name of a [[Field]] that is displayed in the form.
:* ''<tt>value</tt>'' - The value to pre-fill.
:* ''<tt>value</tt>'' - The value to pre-fill.
;Example:
:This HTML code displays a "Click here" link in a JSP page. When clicked, the user is directed to a form that has two fields pre-filled.
::{|
<tt><b><a href="https://</b>mycompany.com<b>/networking/servicedesk<br> &nbsp; &nbsp;  &nbsp; /index.jsp?applicationId=</b>123456789<b>#_</b>objectName<br> &nbsp; &nbsp;  &nbsp; <b>/new/_form_title=</b>formTitle<b>/</b>fieldName1<b>=</b>value1<b>/</b>fieldName2<b>=</b>value1<b>"><br>
&nbsp; Click here<br>
</a></b></tt>
|}
:In this example:
::* ''domain'' = <tt>mycompany.com</tt>
::* ''appID'' = <tt>123456789</tt>
::* ''objectName'' = <tt>xx</tt>
::* ''formTitle'' = <tt>xx</tt>
::* ''field #1'' = <tt>xx</tt>, ''prefill value'' = <tt>xx</tt>
::* ''field #2'' = <tt>xx</tt>, ''prefill value'' = <tt>xx</tt>


;Considerations:
;Considerations:
:* Only fields included in the form can be pre-filled. (Note that you can include ''hidden'' fields in a form, in order to include data that isn't immediately visible to the user.)
:* Only fields included in the form can be pre-filled. (Note that you can include ''hidden'' fields in a form, in order to include data that isn't immediately visible to the user.)
:* When examining a Form, you see field labels. But the internal field ''name'' must be specified in the URL.
:* For all parameter values, use "+" in place of a space.<br>Example: <tt>217 Jason Street</tt> becomes: <tt>217+Jason+Street</tt>
:* For all parameter values, use "+" in place of a space.<br>Example: <tt>217 Jason Street</tt> becomes: <tt>217+Jason+Street</tt>
:* Parameters must be specified in the order shown, separated by a slash ("/")
:* Parameters must be specified in the order shown, separated by a slash ("/")

Revision as of 22:49, 30 July 2013

By creating the appropriate URL, you can take a registered platform user to a Form that has select fields pre-filled with default data. For example, you could put a link to that URL on a JSP page, and even JavaScript to acquire the data from other sources.

Example
This HTML code displays a "Click here" link in a JSP page. When clicked, the user is directed to a form that has two fields pre-filled.
<a href="https://claims.mycompany.com/networking/servicedesk
      /index.jsp?applicationId=123456789#_Claims
      /new/_form_title=Agent+Form/fieldName1=value1/fieldName2=value1">
  Click here
</a>
In this example:
  • domain = claims.mycompany.com
  • appID = 123456789
  • objectName = Claims
  • formTitle = Agent+Form ("+" replaces the space in the form name)
  • field #1 = xx, prefill value = xx
  • field #2 = xx, prefill value = xx
Syntax
https://domain/networking/servicedesk/index.jsp?applicationId=appID#_objectName
      /new/_form_title=formName/fieldName=value/...
(Line breaks have been added for readability. The URL must be a single contiguous string.)

where:

  • The underscore ("_") before the object name is required, as are the underscores in the keyword, _form_title
  • domain - The domain used to access the platform.
  • appID - The application ID, taken from the Application Properties.
  • objectName - The name of the Object, taken from the Object Information section of the Object Properties.
  • formName - The name of the form, taken from the Form Properties.
  • fieldName - The name of a Field that is displayed in the form.
  • value - The value to pre-fill.
Considerations
  • Only fields included in the form can be pre-filled. (Note that you can include hidden fields in a form, in order to include data that isn't immediately visible to the user.)
  • When examining a Form, you see field labels. But the internal field name must be specified in the URL.
  • For all parameter values, use "+" in place of a space.
    Example: 217 Jason Street becomes: 217+Jason+Street
  • Parameters must be specified in the order shown, separated by a slash ("/")
  • If a data value includes a "/", encode it using %2F.
    Example: either/or becomes: either%2For
Supported Fields
  • BOOLEAN (value should be either 1 or 0 )
  • CURRENCY
  • DOUBLE
  • GLOBAL_PICK_LIST
  • NUMBER
  • PERCENT
  • PHONE
  • PICK_LIST
  • RADIO_BUTTON
  • TEXT_FIELD
  • TEXT_AREA
  • TIME
Retrieved from "https://agileappscloud.info/aadev-src/index.php?title=Prefill_Form_Fields&oldid=21490"