---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Inserir registros relacionados usando SOAP

# Inserir registros relacionados usando SOAP {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

O suporte está disponível para inserir dados hierárquicos em tabelas ou tabelas de conjunto de importação de serviço web. Os dados hierárquicos na API de inserção são mapeados automaticamente para registros relacionados da tabela de destino.

## Antes de Iniciar

Função necessária: administrador

## Procedimento

Crie e defina a propriedade glide.web_service.hierarchical como verdadeira.  
O cliente da API também pode substituir esse valor invocando o serviço web SOAP com o parâmetro de URL hierarchical=true.

## Exemplo

Por exemplo, quando uma lista relacionada é criada para a tabela de incidentes chamada `u_custom_comments`:  
Figura 1. Incidente hierárquico

E `u_comment_items` é criado como uma lista relacionada para `u_custom_comments`:  
Figura 2. Comentários personalizados hierárquicos
* **[Esquema WSDL com registros relacionados](https://servicenow-prod.fluidtopics.net/hTfjgkA98pnSjaBXAChlpg)**   
  Quando um WSDL para a tabela Incidente de destino for solicitado com um parâmetro adicional de hierarchical=true, o esquema WSDL para a função Inserir refletirá os registros relacionados disponíveis que podem participar da carga de dados hierárquicos.
* **[Mensagem SOAP hierárquica](https://servicenow-prod.fluidtopics.net/OHCNvKYVwYCdtk2DC1TdGg)**   
  Quando a mensagem SOAP for criada a partir do serviço Web hierárquico descrito pelo WSDL e invocado, ela criará os registros `incident`, `u_custom_comments`e `u_comment_items`.

**Referência relacionada**   

* [Esquema WSDL com registros relacionados](https://servicenow-prod.fluidtopics.net/hTfjgkA98pnSjaBXAChlpg "Quando um WSDL para a tabela Incidente de destino for solicitado com um parâmetro adicional de hierarchical=true, o esquema WSDL para a função Inserir refletirá os registros relacionados disponíveis que podem participar da carga de dados hierárquicos.")
* [Mensagem SOAP hierárquica](https://servicenow-prod.fluidtopics.net/OHCNvKYVwYCdtk2DC1TdGg "Quando a mensagem SOAP for criada a partir do serviço Web hierárquico descrito pelo WSDL e invocado, ela criará os registros incident, u_custom_commentse u_comment_items.")