Gathering Inputs from a User Using the Work Item Form




Procedure

  1. Define an HTML input element. You can use any type for input element.
  2. Assign the input element an 'ID'. For example, 'ID=myuserinput'.
  3. Set an 'OutputTo' XPATH in the XML form being used by the work item. For example: 
    <OutputTo>(//Form/Field/ID[text()='myuserinput'])/following-sibling::Value</OutputTo>

Result

The work item generates two outputs, one is the result XML, and the other is a merged document.

  • Result XML: This is a copy of the XML form. The difference being, any user inputs given are part of it.
  • Merged Document: Apart from the above configurations, if the user had also provided a valid 'InputFrom' XPATH into the input work item document, the work item activity will merge the user input into the input document (which in most cases will be a MLXML document).
    Note:
    • The form that you write only displays the body of the page. It does not control either the left hand menu or the top banner.
    • The IDs used in the form should NOT be substrings of one another. That is, you cannot have two IDs like 'MasterCatalogHeader' and 'MasterCatalogHeader2'. IDs of this kind are used for cloning of nodes (refer to 'Defining Repeating sections in a form'). Instead, in this example, you could use 'MasterCatalogHeader' and '2MasterCatalogHeader'.
    • For merging the result, it is mandatory that all XML nodes (except text nodes) given in the 'InputFrom' XPATH are present in the input document.