--- 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 --- # Scripted SOAP Web Services # Scripted SOAP Web Services {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura Os serviços web SOAP com script permitem que um administrador ServiceNow crie serviços web SOAP personalizados. Você pode definir parâmetros de entrada e saída para o serviço web SOAP e usar JavaScript para executar operações. Embora este recurso seja muito poderoso, use [serviços web diretos](https://servicenow-prod.fluidtopics.net/pB3G2X2s04helLp1ikJ6jw "Um serviço web direto estará disponível para qualquer tabela no sistema se a lista de controle de acesso correta estiver configurada.") ou [conjuntos para importação de serviços web SOAP](https://servicenow-prod.fluidtopics.net/7aAAPuAEEqrzUuJX1iV2OQ "Os conjuntos para importação de serviços web complementam os serviços web diretos e os serviços web SOAP com script, fornecendo uma interface de serviço web para tabelas de conjuntos de importação.") sempre que possível, pois eles são mais simples de implementar e manter. ## Segurança Os serviços web SOAP com script têm as mesmas opções de segurança de base que todos os serviços web SOAP. Para obter detalhes sobre a segurança de serviços web SOAP, consulte [Segurança de serviços web SOAP](https://servicenow-prod.fluidtopics.net/ulD7LS4EcE9mzBLrVmaEZw#c_SOAPWebService__SOAP-web-services-security). Quando [a segurança estrita](https://servicenow-prod.fluidtopics.net/ulD7LS4EcE9mzBLrVmaEZw "O SOAP (Simple Object Access Protocol) é um protocolo baseado em XML para acessar serviços da Web em HTTP.") é imposta em um sistema, o usuário autenticado por HTTP deve ter a função [soap_script](https://servicenow-prod.fluidtopics.net/ulD7LS4EcE9mzBLrVmaEZw "O SOAP (Simple Object Access Protocol) é um protocolo baseado em XML para acessar serviços da Web em HTTP.") para executar o serviço web com script. ## WSDL {#c_ScriptedWebServices__section_px4_kjf_f3b} Todas as tabelas ServiceNow e conjuntos para importação geram dinamicamente documentos XML de WSDL (Web Service Definition Language, Linguagem de definição de serviço web) que descrevem seu esquema de tabela e as operações disponíveis. ## Impor conformidade com WSDL {#c_ScriptedWebServices__section_ay4_vff_f3b} Você pode forçar a resposta para listar os valores de saída na mesma ordem definida no WSDL. Quando você cria um serviço web SOAP com script, o WSDL gerado é baseado nas listas relacionadas a Parâmetros de entrada e Parâmetros de saída. A resposta SOAP real enviada pelo serviço com script é determinada pelo Script. Este comportamento pode fazer com que o script retorne valores de saída em uma ordem diferente da definida no WSDL. Para impor a ordem dos parâmetros de saída conforme definido na lista relacionada, marque a caixa de seleção Conformidade de WSDL. Quando esta caixa de seleção está marcada, o serviço Web reordena os parâmetros retornados pelo script para corresponder à ordem no WSDL. Nota: Se parâmetros de resposta adicionais forem retornados pelo script, mas não estiverem definidos na lista relacionada Parâmetros de resposta, esses parâmetros serão excluídos da resposta quando a Conformidade de WSDL for selecionada. {#c_ScriptedWebServices__table_ump_jgf_f3b__entry__2} | Parâmetro | Ordem | |-|-| | Parâmetro 1 | 200 | | Parâmetro 2 | 300 | | Parâmetro 3 | 100 | [Tabela 1. Lista relacionada de parâmetros de saída] {#c_ScriptedWebServices__table_ump_jgf_f3b} A seguir está o script que define valores para os parâmetros de saída definidos. Observe que neste script de exemplo os parâmetros são definidos em uma ordem diferente da definida na lista relacionada Parâmetros de saída. Observe também o parâmetro adicional param4 que não está definido na lista relacionada. Response.param1 = 1; Response.param4 = 4; Response.param3 = 3; Quando a caixa de seleção Conformidade de WSDL está definida como falsa, a resposta SOAP gerada pelo script é a seguinte: 1 4 3 Quando a caixa de seleção Conformidade de WSDL é verdadeira, a resposta SOAP gerada pelo script é a seguinte: 3 1 ## WSDL Estático {#c_ScriptedWebServices__section_yfd_p2f_f3b} Alguns clientes de serviço web exigem acesso SOAP à sua instância por meio de um formato WSDL específico. Este formato necessário pode ser diferente do formato WSDL da ServiceNow padrão. Nesses casos, você pode criar um WSDL estático que corresponda ao formato necessário. ## Variáveis globais Para facilitar o processamento personalizado de solicitações SOAP de entrada, as seguintes variáveis globais estão disponíveis no contexto de script: * soapRequestDocument: objeto Java org.w3c.dom.Document que representa o envelope SOAP de entrada. * soapRequestXML: objeto de cadeia de caracteres que representa o XML de envelope SOAP de entrada. * request: objeto Javascript que contém valores mapeados (mapeados para nomes de parâmetro de entrada) do envelope SOAP de entrada. * response: objeto Javascript que permite personalizar os valores de resposta. Consulte [Personalizar resposta](https://servicenow-prod.fluidtopics.net/5WNl8G4FPiF_I35N_sJoZA "Siga este exemplo para personalizar e controlar a carga XML de uma resposta SOAP.") {#c_ScriptedWebServices__ul_qxr_xw2_f3b} * **[Criar um novo serviço web SOAP com script](https://servicenow-prod.fluidtopics.net/d_NiqYrrZjLcVqEFELGy3w)** Siga estes exemplos para criar um novo serviço web SOAP com script. * **[Personalizar resposta](https://servicenow-prod.fluidtopics.net/5WNl8G4FPiF_I35N_sJoZA)** Siga este exemplo para personalizar e controlar a carga XML de uma resposta SOAP. * **[Criar um serviço web SOAP com script usando um WSDL estático](https://servicenow-prod.fluidtopics.net/j3SCXXYCV3m6NriGLv3Fbw)** Siga estes exemplos para criar um serviço web SOAP com script usando um WSDL estático.