Mapping to simple documents


With a simple XML schema, you can map the fields from one form to the XML element names. The map is displayed as a list of ARFieldName/XMLElementName pairs.

To map to simple documents

  1. In Developer Studio, open a web service for editing.
  2. In the web services editor, expand the WSDL Ports panel, the Port panel, and the WSDL Operations panel.
  3. Click the operation you want to map, expanding the corresponding panel.
    Tables for input mapping and output mapping appear.
  4. Set the Data Source Type to Generated.
    If you did not specify an XML Schema for the web service, the Data Source Type is automatically set to Generated.
  5. Click Auto Map to regenerate default mappings.
    The XML element names are displayed in the XML Data Type column. The base form name and fields are displayed in the Form/Field column.

    AR Systemsets default mappings automatically when you create a web service, or when you add an operation to a web service. If the existing mappings are satisfactory, you do not need to regenerate them.

    Mapping for a Get operation (simple document)
    web_services_mapping001.gif

  6. Review the mappings, and make any necessary adjustments to forms, fields, and elements in your XML schema. 
    To modify the properties of an object in the XML Data Type column, select the object, and click the adjacent ellipsis button (...). To view XML properties, hover over the object.
    To replace a form or field in the Form/Field column, select the object, and click the adjacent ellipsis button (...).
    Mapped items must be of the same data type. For more information, see Automatically-mapping-XML-elements.
  7. Make any adjustments to the mapping, or to the form, fields, and elements in your XML schema.
  8. Save your web service.

To remove existing mappings

  1. Right-click a row in the Input Mapping or Output Mapping table.
  2. Click Remove Selected.

    Tip

    If you remove a mapping by mistake, you can re-create it. Right-click the ROOT element in the XML Data Type column, select New > Element > Field, rename the new field element, then map it to the appropriate field.

  3. Save your web service.

To map a field to an XML element name

  1. In the Input Mapping or Output Mapping table, locate the XML element to which you want to map a field, and highlight the corresponding row.
  2. In the highlighted row, click the current field name that is mapped to your XML element.
  3. Click the ellipsis button (...), and then select the field you want to map and click OK.
  4. Save your web service.
    To add fields or make other modifications to the XML schema, see Adding-or-modifying-web-service-elements-and-attributes. To remove fields, see Automatically-mapping-XML-elements.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*