Difference between revisions of "Prefill Form Fields"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 15: Line 15:
;Example:
;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.  
: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>
https://<b>mycompany.com</b>/networking/servicedesk/index.jsp?applicationId=<b>123456789</b>#_<b>objectName</b>/new<br> &nbsp; &nbsp;  &nbsp; /_form_title=<b>formTitle</b>/<b>fieldName1</b>=<b>value1</b>/<b>fieldName2</b>=<b>value1</b></tt>


In this example:
:In this example:
:* ''domain'' = <tt>mycompany.com</tt>
::* ''domain'' = <tt>mycompany.com</tt>
:* ''appID'' = <tt>123456789</tt>  
::* ''appID'' = <tt>123456789</tt>  
:* ''objectName'' = <tt>xx</tt>
::* ''objectName'' = <tt>xx</tt>
:* ''formTitle'' = <tt>xx</tt>
::* ''formTitle'' = <tt>xx</tt>
:* ''field #1'' = <tt>xx</tt>, ''prefill value'' = <tt>xx</tt>
::* ''field #1'' = <tt>xx</tt>, ''prefill value'' = <tt>xx</tt>
:* ''field #2'' = <tt>xx</tt>, ''prefill value'' = <tt>xx</tt>
::* ''field #2'' = <tt>xx</tt>, ''prefill value'' = <tt>xx</tt>


;Considerations:
;Considerations:

Revision as of 22:25, 30 July 2013

You can add a record to a take a registered platform user to a Form that has select fields pre-filled with default data.

Syntax

https://domain/networking/servicedesk/index.jsp?applicationId=appID#_objectName/new
      /_form_title=formTitle/fieldName=value/...

where:

  • 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.
  • formTitle - 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.
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.

https://mycompany.com/networking/servicedesk/index.jsp?applicationId=123456789#_objectName/new
      /_form_title=formTitle/fieldName1=value1/fieldName2=value1

In this example:
  • domain = mycompany.com
  • appID = 123456789
  • objectName = xx
  • formTitle = xx
  • field #1 = xx, prefill value = xx
  • field #2 = xx, prefill value = xx
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.)
  • 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