Insert related records using SOAP

Support is available for inserting hierarchical data into tables or web service import set tables. The hierarchical data in the Insert API is automatically mapped to related records of the targeted table.

Before you begin

Role required: admin

Procedure

Create and set the property glide.web_service.hierarchical to true.

The client of the API can also override this value by invoking the SOAP web service with the URL parameter hierarchical=true.

Example

For example, when a related list is created for the incident table called u_custom_comments:

Figure 1. Hierarchical Incident

And u_comment_items is created as a related list for u_custom_comments:

Figure 2. Hierarchical Custom Comments

• WSDL Schema with related records
  When a WSDL for the target Incident table is requested with an additional parameter of hierarchical=true, the WSDL schema for the Insert function will reflect available related records that may participate in the hierarchical data payload.
• Hierarchical SOAP Message
  When the SOAP message is constructed from the hierarchical web service described by the WSDL and invoked, it will create the incident, u_custom_comments, and u_comment_items records.

Related reference

• WSDL Schema with related records
• Hierarchical SOAP Message