---
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


---

# Funções da API de serviço web direto SOAP

# Funções da API de serviço web direto 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

A SOAP API padrão é um conjunto de pequenas funções definidas globalmente que podem ser executadas em um recurso de destino.
O recurso de destino (ou tabela) é definido no URL pelo formato `https://<table name>`\<instance name\> .service-now.com/.do .
{#r_DirectWebServiceAPIFunctions__id_brv_hgt_3xb__entry__2}

| Resumo do Método | Descrição |
|-|-|
| [inserir](https://servicenow-prod.fluidtopics.net/21EebAxP0~DEIp3T7aB4Qw "Cria um novo registro para a tabela de destino no URL.") | Cria um novo registro para a tabela de destino no URL. |
| [inserirvários](https://servicenow-prod.fluidtopics.net/xVDYkg1Sb6FTYd8eDc9GOQ "Cria vários novos registros para a tabela de destino na URL.") | Cria vários novos registros para a tabela de destino no URL. Para habilitar várias inserções, ative os [conjuntos para importação de serviço web](https://www.servicenow.com/docs/access?context=c_WebServiceImportSets&version=xanadu&pubname=xanadu-integrate-applications&ft:locale=en-US). |
| [atualizar](https://servicenow-prod.fluidtopics.net/vTn3ukuFudZa3YDtfEBQEQ "Atualiza um registro existente na tabela de destino no URL, identificado pelo campo sys_id obrigatório.") | Atualiza um registro existente na tabela de destino no URL, identificado pelo campo sys_id obrigatório. |
| [excluirRegistro](https://servicenow-prod.fluidtopics.net/YieWNhp~qIwZTbwRFblWoQ "Exclua um registro da tabela de destino fornecendo seu sys_id.") | Exclui um registro da tabela de destino fornecendo seu `sys_id`. |
| [excluirvários](https://servicenow-prod.fluidtopics.net/Ilvbnl2g7E~M6cVrS9GKPw "Exclua vários registros da tabela de destino por valores de exemplo.") | Exclua vários registros da tabela de destino por valores de exemplo. |
[Tabela 1. API de modificação de dados]

{#r_DirectWebServiceAPIFunctions__id_brv_hgt_3xb} {#r_DirectWebServiceAPIFunctions__id_wz4_3gt_3xb__entry__2}

| Resumo do Método | Descrição |
|-|-|
| [getKeys](https://servicenow-prod.fluidtopics.net/hnuJo5xr4WXe96GiH4TJjw "Consulte a tabela de destino por valores de exemplo e retorne uma lista de sys_id delimitada por vírgulas.") | Consulte a tabela de destino por valores de exemplo e retorne uma lista `de sys_id` delimitada por vírgulas. |
| [obterRegistros](https://servicenow-prod.fluidtopics.net/sxksGZ6UF0TcqsuF~k4t2g "Consulte a tabela de destino por valores de exemplo e retorne todos os registros correspondentes e seus campos.") | Consulte a tabela de destino por valores de exemplo e retorne todos os registros correspondentes e seus campos. |
| obter | Consulte um único registro da tabela de destino por `sys_id` e retorne o registro e seus campos. |
| [agregado](https://servicenow-prod.fluidtopics.net/CnEJG7WDBcFxL2KZaQbMew "Consulte uma tabela usando uma função agregada, incluindo SUM, COUNT, MIN, MAX, LAST e AVG.") | Consulta usando e agrega as funções SUM, COUNT MIN, MAX, LAST e AVG. Para habilitar as funções agregadas, ative o plug-in Aggregate Web Service. |
[Tabela 2. API de recuperação de dados]

{#r_DirectWebServiceAPIFunctions__id_wz4_3gt_3xb}
* **[API de recuperação de dados](https://servicenow-prod.fluidtopics.net/1CbKPh8U6N2ifgb7zQVkBQ)**   
  Resumos e descrições do método da API de recuperação de dados.
* **[API de modificação de dados](https://servicenow-prod.fluidtopics.net/3ZysmnfnsSGW70mcTiNtPw)**   
  Resumos e descrições do método da API de modificação de dados.

**Conceitos relacionados**   

* [Use formulários para limitar ou estender a resposta da consulta](https://servicenow-prod.fluidtopics.net/o1e9kRi7B9hqDn0tbarilQ "Ocasionalmente, é necessário limitar o número de valores de campo que uma consulta SOAP retorna.")
* [Retornar o valor de exibição para variáveis de referência](https://servicenow-prod.fluidtopics.net/535msHt6r1Iyl3qBTcIGwQ "Quando você consulta um registro usando uma função get ou getRecords, a instância retorna todos os campos associados a esse registro. Os campos geralmente são campos de referência que contêm um sys_id para um registro em outra tabela.")
* [Limpar valores de uma instância de destino](https://servicenow-prod.fluidtopics.net/HafjrMZUUt0OPHzXmCP79A "Você pode passar um valor vazio por meio de um parâmetro SOAP para limpar o respectivo valor na instância de destino.")
* [Recuperar entradas de registro usando serviços web diretos](https://servicenow-prod.fluidtopics.net/VuS6Vy7ZWsVYoWxB1h~clg "Para obter o conteúdo de um campo de diário, faça uma segunda solicitação soap na tabela sys_journal_field para extrair os registros de diário apropriados de volta para o registro em questão.")
* [Recuperar campos de opção usando serviços web diretos](https://servicenow-prod.fluidtopics.net/mThfpAtMyDDJtBQj7iWhKw "Para recuperar ou definir campos de opção, use o Valorde opção , não o Rótulo.")
* [Persistir uma sessão HTTP em todas as chamadas SOAP](https://servicenow-prod.fluidtopics.net/xOKPAvKGiBwHe7MMfq83rg "Nas circunstâncias em que um cliente SOAP faz muitas chamadas em um curto período de tempo, convém reutilizar uma única sessão HTTP para todas as chamadas SOAP.")