Etapas de integração

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

As etapas de integração podem ser executadas na instância ou em uma 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:

Somente o administrador do Flow Designer e o administrador de conexão podem executar fluxos usando Integration Hub.

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 que um MID Server seja executado, a instância delega o processamento de fluxo ao MID Server apropriado, enviando o plano de processo em uma chamada REST. O MID Server executa a ação ou etapa no plano do processo e retorna resultados. Exiba mensagens de log e o 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 - Como criar ações personalizadas.

Etapa de integração	Descrição	Etapas executadas 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 analisador de 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 para desenvolvedores REST no IntegrationHub.

Atributos da conexão

Defina variáveis específicas de conexão que você pode usar em Integration Hub 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 Criação de atributos de conexão para IntegrationHub.

MID Server aliases de conexão

Os designers de ação podem definir MID Server atributos de seleção usando um registro de conexão associado a um alias e associar o alias a uma etapa de integração. Quando o fluxo é executado, o sistema usa os atributos para determinar qual 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 MID para a etapa usar quando for executada. Para um MID Server, você pode selecionar um que você configurou ou fazer com que o sistema escolha um selecionando Seleção automática de MID Server na lista de 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 MID Clusters, você pode selecionar um cluster de balanceamento de carga ou de failover para a etapa. Para obter mais informações sobre clusters do MID, consulte Configuração de um cluster do MID Server. A etapa do Construtor de carga e a etapa do Analisador de XML não são compatíveis com a seleção do MID Server.

Ao especificar um MID Server, os designers de fluxo devem evitar mudar o ambiente de execução de um MID Server para outro quando um fluxo for executado. Configure cada MID Server para executar operações em vários endpoints ou forneça vários recursos para cada 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 a configuração de rede MID Server.

Considerações de design

Etapas de integração de design usando as seguintes diretrizes.

• Evite alternar o ambiente de execução entre a instância e o MID Server várias vezes. Sempre que possível, agrupe etapas de ação semelhantes. Por exemplo, agrupar 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 de administrador ou action_designer. Se estiver executando etapas em um MID Server, o usuário MID Server deverá ter as funções connection_admin e credential_admin para acessar as informações de conexão e credencial associadas à etapa.