Form Augmenter

Note: Effective March 10, 2012, Adobe is deprecating the Guides capabilities of Adobe® Livecycle® ES. The Guides functionality is available for upgrade purposes only and will be removed from the product after two major releases.

Provides operations that are useful for integrating forms into processes, and enabling them for use with Workspace. For example, Form Augmenter service operations are useful in custom render and submit services for Form, Document Form, or xfaForm variables.

In general, you would call Form Augmenter service operations in the following order:

  1. Retrieve the form as a document value, for example, a PDF file.

  2. Use the Insert Workflow XFO Data operation operation or Lookup and Insert Workflow XFO Data operation operation to insert values into the form.

  3. Merge data with the form by using the importData operation operation.

  4. Enable the form for Workspace by using the Inject Form Bridge operation operation.

For more information about using the Form Augmenter service, see Services Reference for Adobe LiveCycle.

Get value of a form field operation

Retrieves a value from a field on a form. The PDF form must be created within Designer 8.2 or later, or Adobe Acrobat 7.0.5 or later.

For information about the General and Route Evaluation property groups, see Common operation properties.

Input properties

Properties to specify the form and form field.

Input Form Data Document

A document value that represents the XDP data that is merged with the form.

If you provide a literal value, clicking the ellipsis button  opens the Select Asset dialog box. (See About Select Asset.)

Name Of Form Field

A string value that represents the name of the field on a form. For example, in a form design, in a field named mortgageAmount, you would type mortgageAmount.

Output properties

Property to store the value from a form field.

Value Of Form Field

The location to save the value from a form field. The data type is string.

Exceptions

This operation can throw a Java.lang.Exception exception.

Inject Form Bridge operation

Adds JavaScript code to enable Flex applications and AIR applications to communicate with the PDF form. The service operation enables:

  • Adobe PDF form or Adobe Acrobat form to function with Workspace.

  • Adobe PDF for Adobe Acrobat form to function with Guides.

  • Adobe PDF form to be used with the Document Portfolio Managementbuilding block from the Unified Workspace Solution

If your process uses Adobe XML forms (XDP files), you can render the form to PDF and then use the Inject Form Bridge operation. To render to PDF, you use the renderPDFForm operation operation that the Forms service provides. For more information on writing JavaScript in Designer, see Preparing a form for use in Workspace.

The functioning of the operation depending on the form:
  • If the form already has a Form Bridge XFO component, JavaScript would not be added to the form.

  • If the form is certified, the certification will break. The form has to be certified only after adding the Form Bridge XFO component.

  • If the form is rights enabled, the encryption will not function. The form has to be rights enabled only after adding the Form Bridge XFO component.

  • If the form is digitally signed, the signature will be broken. The form has to be digitally signed only after adding the Form Bridge XFO component.

Workspace provides a Complete button that users click to submit their forms. However, forms can also include submit buttons. When the Inject Form Bridge operation is used on a form, Workspace hides the submit button.

Form design

Result

The form includes no submit button.

Workspace disables the Complete button and users cannot submit the form. The form can be submitted without the Submit button by enabling the Reader Submit option in the Assign Task and Assign Multiple Tasks service operations. See Assign Task operation and Assign Multiple Tasks operationfor more information.

The form includes one submit button.

Workspace hides the submit button and enables the Workspace Complete button.

The form includes a button (indirect submit) that points to a submit button (direct submit)

Indirect-submit buttons always take precedence over direct-submit buttons, even if multiple submit buttons exist. Workspace always shows the indirect submit buttons.

Workspace hides the submit button and enables the Workspace Complete button.

The form includes multiple indirect-submit buttons that point to one or more direct-submit buttons.

Workspace disables the Workspace Complete button. The user must click the appropriate button on the form to submit it.

The user can still save a draft version of the form or take the form offline

The form includes either an indirect- or direct-submit button in a repeating subform.

Workspace excludes these buttons for submitting the form in Workspace.

Note: When the Submit button that was added to the form with the Process Fields form object is hidden, the button still provides the functionality for submitting the form.

Submit requests are handled by Workspace, which acts as an intermediary between the LiveCycle Server and the form which can be used both offline and online. To understand more about designing your form for Workspace, see Preparing a form for use in Workspace.

Input properties

Properties to enable the PDF form to be used in Workspace.

Input PDF Document

A document value that specifies the PDF form to which the Form Bridge will be injected.

If you provide a literal value, clicking the ellipsis button opens the Select Asset dialog box. (See About Select Asset.)

Output properties

Properties to specify the location to store the PDF form.

Augmented PDF Document

The location to save the augmented PDF document. The data type is document.

Exceptions

This operation can throw a Java.lang.Exception exception.

Insert Workflow XFO Data operation

Adds data fields to the form data, which enables a PDF form created in Designer to be used offline in Workspace. You cannot specify an Acrobat form.

For information about the General and Route Evaluation property groups, see Common operation properties.

Input properties

Properties to specify the form data as an XDP (XML format) data file.

Input Form Data Document

An xml value that refers to the form data. This is formatted as an XDP (XML format) data file.

If you provide a literal value, clicking the ellipsis button opens the Select Asset dialog box. (See About Select Asset.)

Submit Target Url

A string value that identifies the location of the Workspace servlet used to handle submit requests for a form.

If you provide a literal value, type the location server name of the LiveCycle Server. For example, to access Workspace, type http://[server name]:[port]/ /rest/services/ProcessManagementDocumentHandlingService/submit where [server name] specifies the name of the LiveCycle Server and [port] specifies the port number. The following default port numbers are used by LiveCycle for each application server:

  • JBoss: 8080

  • WebLogic: 7001

  • WebSphere: 9080

    Note: You can also use HTTP over Secure Socket Layer (SSL) for the Submit Target Url property.

Task Id

A string value that represents the unique identifier of the task.

If you provide a literal value, type the unique identifier representing the task.

Return Server Email Address

A string value that represents the email address used by the LiveCycle Server.

If you provide a literal value, type the email address used by the LiveCycle Server. For example, you can type myadministrator@example.com.

Task Status

A string value that represents the status of the assigned task.

If you provide a literal value, type the status of the task using one of the following values.

1:
Task was created.

2:
Task was created and saved.

3:
Task was assigned.

4:
Task was assigned and saved.

100:
Task was completed.

101:
Task deadline has passed.

102:
Task was terminated.

List of Routes

A string value represents a list of routes that the user can choose from. A route represents the actions that occur before the task is considered complete.

If you provide a literal value, type the list of routes, delimited by commas, that are to be selected by the user. For example, you could type Accept, Deny, Cancel.

Assigned User Id

A string value that represents the Global Unique Identifier (GUID) of the user who is assigned the task. You would typically use this to save the GUID of the user who completed the task.

If you provide a literal value, type the GUID that represents the user.

Output properties

Properties to specify the location to store the modified form data.

Modified Data Document

The location to save the modified form. The data type is xml.

Exceptions

This operation can throw a Java.lang.Exception exception.

Lookup and Insert Workflow XFO Data operation

Enables a PDF form created in Designer to be used offline in Workspace. You cannot specify an Acrobat form. The user profile assigned to submit the form, the list of available routes, and the task status are determined by looking up the information using the input Task Id value.

For information about the General and Route Evaluation property groups, see Common operation properties.

Input properties

Properties to specify the form data as an Acrobat form or an Adobe XML form.

Input Form Data Document

An xml value that refers to the form data. This is formatted as an XDP data file.

If you provide a literal value, clicking the ellipsis button opens the Select Asset dialog box. (See About Select Asset.)

Submit Target Url

A string value that represents the location of the Workspace servlet used to handle submit requests for a form.

If you provide a literal value, type the location server name of the LiveCycle Server. For example, to access Workspace, type http://[server name]:[port]/rest/services/ProcessManagementDocumentHandlingService/submit where server name specifies the name of the LiveCycle Server, and [port] specifies the port. The following default port numbers are used by LiveCycle for each application server.

  • JBoss: 8080

  • WebLogic: 7001

  • WebSphere: 9080

    Note: You can also use HTTP over Secure Socket Layer for the Submit Target Url property.

Task Id

A string value that represents the unique identifier of the task.

If you provide a literal value, type the unique identifier representing the task.

Return Server Email Address

A string value that represents the email address used by the LiveCycle Server.

If you provide a literal value, type the email address used by the LiveCycle Server. For example, you can type myadministrator@sampleOrganization.com.

Output properties

Properties to specify the location to store the modified form data document.

Modified Data Document

The location to store the modified form data. The data type is xml.

Exceptions

This operation can throw a Java.lang.Exception exception.

Remove Data Fields operation

Removes a set of data fields from the form data.

For information about the General and Route Evaluation property groups, see Common operation properties.

Input properties

Properties to specify the form data and fields to remove.

Input Data Document

An xml value that represents the form data.

If you provide a literal value, clicking the ellipsis button opens the Select Asset dialog box. (See About Select Asset.)

Input Field Map

A map value of sub-type string that specifies the data fields to remove from the form data.

Output properties

Properties to specify the location to store the modified form data document.

Modified Data Document

The location to save a form data. The data type is xml.

Exceptions

This operation can throw a Java.lang.Exception exception.

Form Augmenter exceptions

The Form Augmenter service provides the following exception for throwing exception events.

Java.lang.Exception

Thrown when an error occurs when augmenting a form.

// Ethnio survey code removed