Table of Contents

Search

  1. Preface
  2. Web Services
  3. SOAP Web Services
  4. WSDL Data Object
  5. Schema Object
  6. How to Create a SOAP Web Service
  7. Operation Mappings
  8. Parsing Web Service SOAP Messages
  9. Generating Web Service SOAP Messages
  10. Web Service Consumer Transformation
  11. REST Web Services
  12. How to Create a REST Web Service
  13. REST Web Service Consumer Transformation
  14. REST Web Service Consumer Transformation Use Cases
  15. REST and SOAP Web Service Administration
  16. Appendix A: Datatype Compatibility

Web Services Guide

Web Services Guide

Rules and Guidelines to Map Input Ports to Elements

Rules and Guidelines to Map Input Ports to Elements

Review the following rules when you map input ports to elements in the method input hierarchy:
  • You can map an input port to one element in the hierarchy. You can map the same port to any number of keys in the hierarchy.
  • The input port and the element must have compatible datatypes.
  • You can map ports from one input group to multiple hierarchy levels in the method input.
  • You must map input ports to the keys in the method input. Any port that you map to a key must be of string, integer, or bigint datatype. Map data to the keys in all levels in the method input above the hierarchy level that you are including in the request message. Include the foreign keys for all levels above and including the level you are mapping.
    You do not have to map input ports to keys if you are mapping only the lowest level of the method input hierarchy.
  • You must map the RequestInput root element to the child element of Rest_Consumer_input group for method input definition.
  • You can map multiple string, bigint, or integer input ports to a key in the
    Method Input
    area to create a composite key. When you click the
    Location
    field for a composite key, you can reorder the input ports or remove one of the ports.
  • If the web service produces a JSON document, ensure that xmlRoot is the first node in the response hierarchy. If xmlRoot is not the first node for a web service with JSON response, null values may appear.
Review the following rule when you map the input ports to elements with the method input as JSON:
  • Ensure that the data you pass to an input port does not contain leading zeroes followed by a number. If the data contains leading zeros, the zeroes are truncated in the corresponding values of the generated JSON request and the data type of the value changes from string to the numeric data type.

0 COMMENTS

We’d like to hear from you!