Etapas de integração

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

    • Habilite ações personalizadas para integração com sistemas externos ativando IntegrationHub, que adiciona etapas de integração à interface Workflow Studio.

    As etapas de integração podem ser executadas na instância ou em um MID Server. Um MID Server é necessário para se comunicar ou mover dados entre uma instância ServiceNow e aplicações externas, fontes de dados e serviços em sua rede.
    Nota:
    O administrador do Flow Designer e o administrador de conexão podem executar fluxos usando IntegrationHub.

    As etapas que executam operações em dados de registro são executadas na instância, enquanto as etapas que se integram aos sistemas em sua rede são executadas em um MID Server. Se uma etapa exigir um MID Server para executar, a instância delega o processamento de fluxo ao apropriado MID Server Enviando o plano de processos em uma chamada REST. . MID Server executa a ação ou etapa no plano de processos e retorna resultados. Exiba mensagens de log e status de execução da instância ou do MID Server.

    Etapas de integração disponíveis

    Essas etapas de integração estão disponíveis em Workflow Studio - Construção de ações personalizadas.

    Etapa de integração Descrição A etapa é executada de
    Etapa JDBC Crie uma ação reutilizável para enviar comandos SQL para um banco de dados relacional. MID Server
    Etapa do Construtor JSON Crie uma carga JSON para usar em outra etapa. Insira valores ou use cápsulas de dados para produzir uma carga dinâmica. Esta etapa oferece suporte a vários tipos de dados, incluindo objetos e matrizes para estruturas aninhadas. Instância
    Etapa do construtor de carga Permita que os designers de ação criem facilmente pares de nome-valor em cargas JSON e XML usando dados dinâmicos.
    • Instância
    • MID Server
    Etapa de PowerShell Execute scripts do PowerShell em máquinas remotas de sua instância ServiceNow por meio de MID Server. MID Server
    Etapa REST Envie uma solicitação de serviço da web REST de saída para um sistema externo.
    • Instância
    • MID Server
    Etapa SOAP Habilite os designers de ação para enviar solicitações de serviço de saída web SOAP para sistemas externos.
    • Instância
    • MID Server
    Etapa de SSH A etapa SSH executa comandos SSH em um sistema externo *nix por meio de um ServiceNow® MID Server. A etapa também armazena scripts e comandos para os sistemas *nix. MID Server
    Etapa do analisador XML Identifique dados estruturados de uma carga XML sem precisar gravar script. Mapeie elementos XML de entrada para uma saída de objeto complexo que você pode usar em outras etapas ou ações. No tempo de execução, os valores de uma carga XML preenchem a saída do objeto complexo.
    • Instância
    • MID Server

    Treinamento

    Conclua um treinamento passo a passo sobre como usar a etapa REST no Treinamento DO desenvolvedor REST no IntegrationHub .

    Atributos da conexão

    Defina variáveis específicas de conexão que você pode usar em IntegrationHub etapas de integração. Ao usar uma etapa de integração, você deve estabelecer uma conexão com um sistema externo. Use um alias de conexão e credencial em vez de definir a conexão em linha. Um alias permite que você atualize os detalhes da conexão uma vez sem precisar reconfigurar todas as ações. Qualquer etapa de ação que usa um alias herda os atributos associados a ele. Workflow Studio exibe atributos como cápsulas de dados que você pode arrastar para sua etapa de ação. Por exemplo, você pode criar um atributo de tamanho de página que se torna um parâmetro de consulta da etapa REST.Para obter mais informações sobre atributos de conexão, consulte Crie atributos de conexão para o IntegrationHub .

    MID Server aliases de conexão

    Designers de ação podem definir MID Server atributos de seleção usando um registro de conexão associado a um alias e associe o alias a uma etapa de integração. Quando o fluxo é executado, o sistema usa os atributos para determinar quais MID Server executa a etapa. Saiba mais sobre Introdução a credenciais, conexões e aliases .

    MID Server E seleção de Cluster do MID

    Para a maioria das etapas de integração, você pode especificar um MID Server Ou Cluster DO MID para a etapa usar quando for executada. Para um MID Server, você pode selecionar um configurado ou fazer com que o sistema escolha um selecionando Seleção automática DO MID Server Na lista Seleção de MID da etapa. Para saber mais sobre como um MID Server é selecionado durante o tempo de execução, consulte Seleção do MID Server. Para clusters DO MID, você pode selecionar um cluster de balanceamento de carga ou failover para a etapa. Para obter mais informações sobre clusters DO MID, consulte Configure um cluster do MID Server . A etapa Construtor de carga e a etapa Analisador XML não são compatíveis com a seleção do MID Server.

    Ao especificar um MID Server Os Flow Designers devem evitar mudar o ambiente de execução de um MID Server para outro quando um fluxo é executado. Configure cada um MID Server para executar operações em vários endpoints ou fornecer vários recursos para cada um MID Server em sua rede. Pode ser necessário um usuário com a função connection_admin para atualizar os registros de conexão associados a uma ação ou um administrador de rede para atualizar o. MID Server configuração de rede.

    Considerações de design

    Projetar etapas de integração usando as diretrizes a seguir.

    • Evite mudar o ambiente de execução entre a instância e o. MID Server várias vezes. Agrupar etapas de ação semelhantes sempre que possível. Por exemplo, agrupe etapas principais que executam operações de registro e etapas de integração que são executadas no MID Server.
    • Ao criar um spoke que usa uma etapa de integração, inclua um registro de alias de conexão e credencial com o tipo de conexão apropriado. Antes que qualquer um possa usar o spoke, um usuário com a função connection_admin deve associar o registro de alias a um registro de conexão compatível com o tipo de conexão. Se estiver definindo a conexão em linha, use entradas para permitir que o analista de processo defina as informações de conexão ao adicionar a ação a um fluxo.
    • O MID Server não tem acesso a todos os valores em um objeto GlideRecord, ele só tem acesso à referência sys_id. Entradas do tipo referência não funcionam em um MID Server. Em vez disso, crie entradas de ação que contenham os valores GlideRecord necessários.

    Funções

    Para criar etapas de integração, um usuário deve ter as funções action_designer ou admin. Se estiver executando etapas em um MID Server. MID Server o usuário deve ter as funções connection_admin e credential_admin para acessar as informações de conexão e credencial associadas à etapa.