Scripted SOAP Web Services

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura

    • SOAP Web Services com script permitem um ServiceNow Administrador para criar 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 ou Conjuntos de importação de serviço web SOAP sempre que possível, já que são mais simples de implementar e manter.

    Segurança

    SOAP Web Services 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 dos serviços web SOAP, consulte Segurança de serviços web SOAP.

    Quando segurança estrita Imposto em um sistema, o usuário autenticado HTTP deve ter soap_script função para executar o serviço web com script.

    WSDL

    Todos ServiceNow Tabelas e conjuntos de importação geram dinamicamente documentos XML WSDL (Web Service Definition Language) que descrevem o esquema de tabela e as operações disponíveis.

    Impor a conformidade do WSDL

    Você pode forçar a resposta a listar 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 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, selecione Conformidade do WSDL caixa de seleção. Quando esta caixa de seleção é 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 Conformidade do WSDL selecionado.
    Tabela 1. Lista relacionada Parâmetros de saída
    Parâmetro Ordem
    Parâmetro 1 200
    Parâmetro 2 300
    Parâmetro 3 100

    A seguir está o script que define valores para os parâmetros de saída definidos. 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 param4que não está definido na lista relacionada.

    Response.param1 = 1;
Response.param4 = 4;
Response.param3 = 3;

    . Conformidade do WSDL a caixa de seleção é falso , A resposta SOAP gerada pelo script é a seguinte:

    <response>
                <param1>1</param1>
                <param4>4</param1>
                <param3>3</param1>
</response>
    . Conformidade do WSDL a caixa de seleção é verdadeiro , A resposta SOAP gerada pelo script é a seguinte:
    <response>
                <param3>3</param1>
                <param1>1</param1>
</response>

    WSDL Estático

    Alguns clientes de serviço da Web exigem acesso SOAP à sua instância por meio de um formato WSDL específico. Este formato obrigatório pode ser diferente do formato WSDL padrão da ServiceNow. 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 recebidas, as seguintes variáveis globais estão disponíveis no contexto do 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.
    • solicitação Objeto JavaScript que contém valores mapeados (mapeados para nomes de parâmetros de entrada) do envelope SOAP de entrada.
    • resposta Objeto JavaScript que permite personalizar os valores de resposta. Consulte Personalizar resposta