Etapa SOAP
Permita que os designers de ação enviem solicitações de serviço web SOAP de saída para sistemas externos.
Nota:
Etapa SOAP
não está disponível no sistema básico e requer a assinatura de ServiceNow® IntegrationHub.
Depois que o plug-in necessário for ativado, a etapa ficará visível em Integrações.
Funções e disponibilidade
- Disponível como uma etapa de ação de Workflow Studio. Usuários com a função action_designer podem criar uma ação personalizada com uma ou mais etapas de ação.
- Os designers de ação precisam da função web_service_admin para executar essas tarefas de serviços web.
- Selecione WSDL
- Carregar novo WSDL
- Selecione uma política WS-Security
Campos
| Campo | Descrição |
|---|---|
| Detalhes da Conexão | |
| Conexão | O tipo de conexão a ser usado.
Para saber mais sobre conexões e credenciais, consulte Introdução a credenciais, conexões e aliases . |
| Alias de Conexão | Registro de alias de conexão e credencial que o sistema usa para executar a etapa de ação. Os usuários com a função flow_designer ou admin podem criar ou selecionar um registro de conexão associado. Usar um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar uma ação em vários ambientes. Da mesma forma, se as informações de conexão mudarem, você não precisará atualizar sua ação personalizada. Para saber mais sobre conexões e credenciais, consulte credenciais, conexões e aliases .
O valor da credencial é exibido como uma cápsula de dados de senha (criptografia de 2 vias) no painel de dados.
Nota: Este campo estará disponível quando Usar alias de conexão Está selecionado na lista de Conexões. |
| Alias de credencial | Alias de credencial que o sistema usa para executar a etapa de ação. Os usuários com a função flow_designer ou admin podem criar ou selecionar um registro de conexão associado. O uso de um alias elimina a necessidade de configurar várias credenciais ao usar uma ação em vários ambientes. Da mesma forma, se as informações de credencial mudarem, você não precisará atualizar sua ação personalizada. Para saber mais sobre conexões e credenciais, consulte credenciais, conexões e aliases .
O valor da credencial é exibido como uma cápsula de dados de senha (criptografia de 2 vias) no painel de dados.
Nota: Este campo está disponível quando Defina a conexão em linha Selecionado na lista Conexão. |
| Usar MID | Opção para usar um MID Server para executar o. Etapa SOAP. Marque esta caixa de seleção para exibir o. Seleção DO MID , MID e. . campos. Nota: Este campo estará disponível quando Usar alias de conexão Está selecionado na lista de Conexões. |
| Endpoint | O endpoint de URL da solicitação SOAP. Se Usar alias de conexão Está selecionado, este campo é somente leitura e exibe o URL do endpoint associado ao alias. Se Defina a conexão em linha Estiver selecionado, insira um URL de endpoint para a conexão. |
| Testar etapa SOAP | Botão para testar a etapa SOAP. Para testar, selecione Etapa de SOAP de teste botão. Insira os valores de entrada necessários e selecione Executar teste botão. Após a execução do teste, todas as saídas de etapa ou mensagens de erro são exibidas na seção Resultados de teste da janela de teste. |
| Tempo limite de conexão |
Número de milissegundos que o sistema espera por uma conexão de host bem-sucedida. Se a etapa não estabelecer uma conexão bem-sucedida durante esse tempo, a solicitação de conexão atingirá o tempo limite. Se Defina a conexão em linha estiver selecionado, insira um valor de tempo limite para a conexão. Deixe este campo em branco para usar o valor de tempo limite de conexão padrão do sistema.
Nota: Evite definir o valor de Tempo limite de conexão como zero, pois isso pode causar uma conexão obsoleta. |
| Seleção de MID | Opção para selecionar um MID Server ou cluster DO MID específico. Escolha qualquer uma das opções a seguir.
|
| Cluster do MID | Cápsula de dados para o cluster MID que você deseja usar. Este campo fica disponível quando Definir conexão em linha é selecionado na lista Conexão, Usar MID estiver marcado e Cluster de MID específico estiver selecionado na lista Seleção de MID. |
| Detalhes da solicitação | |
| Criar envelope | O método a ser usado ao criar o envelope SOAP.
|
| Selecione um WSDL | O WSDL a ser usado para criar o envelope SOAP. Selecione um registro WSDL existente ou clique em Carregar novo WSDL Para baixar ou inserir manualmente um arquivo WSDL. O WSDL selecionado preenche os valores do Operação , Ação SOAP e. Envelope SOAP campos. Nota: Este campo fica disponível quando você seleciona Do WSDL Da lista Criar envelope. |
| Carregar Novo WSDL | Opção para baixar ou inserir manualmente um arquivo WSDL. |
| Operação | A operação a ser executada a partir do WSDL selecionado. Cada WSDL tem sua própria lista de operações disponíveis. |
| Ação SOAP | A URL para executar a ação SOAP. Se Criar envelope está definido como Do WSDL , Este campo é somente leitura e exibe o URL para executar a ação SOAP. Se Criar envelope está definido como Manualmente , Insira um URL para executar a ação SOAP. |
| Tipo de Solicitação | Formato da solicitação. As opções incluem.
|
| Envelope SOAP | O texto XML enviado para o endpoint. Se Criar envelope está definido como Do WSDL , O sistema adiciona o XML necessário para Operação que você selecionar. Se Criar envelope está definido como Manualmente , Insira o texto XML que você deseja usar. Insira valores de registro nos elementos de envelope SOAP apropriados. Por exemplo, insira uma descrição resumida do incidente em <short_description> elemento.Nota: Este campo está disponível quando Tipo de solicitação é Texto . |
| Anexo | Registro de anexo que contém a solicitação. Você pode pesquisar ou criar este registro em uma etapa anterior e defini-lo como uma variável de entrada. Crie-o usando as APIs JSONStreamingBuilder e XMLStreamingBuilder na etapa de Script. Nota: Este campo está disponível quando Tipo de solicitação é Binário . |
| Redefinir Envelope | Opção para descartar todas as mudanças manuais feitas no envelope SOAP. Marque esta caixa de seleção para reverter o envelope SOAP para seu estado original. Nota: Este campo fica disponível quando você seleciona Do WSDL Da lista Criar envelope. |
| Novo WSDL | |
| Nome | O nome do registro WSDL que você deseja criar. |
| Método de importação | O método para inserir WSDL.
|
| URL do WSDL | O URL para o serviço web SOAP. Nota: Este campo fica disponível quando você seleciona Download da URL Da lista Método de importação. |
| Nome de usuário | O nome de usuário para autenticar com o serviço web SOAP. Nota: Este campo fica disponível quando você seleciona Download da URL Da lista Método de importação. |
| Senha | A senha para autenticar com o serviço web SOAP. O sistema sempre mascara senhas na interface do usuário e impede a exportação delas como texto simples. Nota: Este campo fica disponível quando você seleciona Download da URL Da lista Método de importação. |
| Conteúdo WSDL | O documento XML que descreve o serviço web SOAP e suas operações. Nota: Este campo fica disponível quando você seleciona Preencha manualmente o conteúdo do WSDL Da lista Método de importação. |
| Importar | Opção para adicionar o WSDL do serviço web SOAP à instância. |
| WS-Security | |
| Habilitar Políticas de segurança de serviços web | Opção para restringir o serviço web SOAP a uma política de segurança. Marque esta caixa de seleção para exibir o. Política campo. |
| Política | O registro de política que você deseja usar para restringir conexões de serviço web. Selecione um registro de política existente. |
| Tentar Política Novamente | |
| Habilitar políticas de novas tentativas | Opção para habilitar a política de novas tentativas. Para obter mais informações, consulte Política de novas tentativas . |
| Substituir política padrão para alias | Opção para substituir a política de novas tentativas padrão. Esta caixa de seleção não é aplicável quando Defina a conexão em linha Está selecionado na lista de Conexões. |
| Tentar Política Novamente | Política de novas tentativas padrão associada a. Alias de conexão . Se Substituir política padrão para alias estiver selecionado, você pode substituir a política de novas tentativas padrão e selecionar outra política de novas tentativas existente com base em seu requisito. |
| Opções avançadas | |
| Cabeçalhos | Os pares nome-valor a serem incluídos na mensagem SOAP como cabeçalhos HTTP. Use o ícone de mais para adicionar cabeçalhos. Adicione um Nome e. Valor Para cada cabeçalho HTTP. |
| Opção para excluir um cabeçalho se o valor estiver vazio ou nulo. Nota: Esta caixa de seleção fica disponível depois de clicar na seta para baixo para exibir as opções avançadas. |
|
Avaliação de erro de ação
- Se esta etapa falhar
- Tipo de dados: Choice
Opção para continuar executando a próxima etapa ou ir para a avaliação de erro. Para usar o código de status da etapa ou a mensagem para uma condição de erro de ação personalizada, consulte Avaliação de erro de ação.
Limite de tamanho da resposta SOAP
O sistema limita o tamanho das respostas de SOAP a 5 MB. Respostas de SOAP diretas que excedem este limite geram um erro. Para oferecer suporte a tamanhos de resposta maiores, aumente o limite de tamanho de resposta com glide.pf.soap.response_payload_max_sizepropriedade do sistema. Esta propriedade do sistema oferece suporte a um valor máximo de 10 MB.