Suporte a várias conexões

oferece suporte a várias conexões com um único provedor de integração. Selecione conexões para fluxos, subfluxos e ações diretamente de um fluxo.

Benefícios

O suporte a várias conexões oferece esses benefícios.

• Ter mais de uma conexão com o mesmo provedor de integração. Por exemplo, você pode estabelecer conexões com vários ambientes Jira diferentes.
• Selecione a conexão que você deseja usar em um fluxo. Substitua conexões predefinidas para fluxos, subfluxos e ações diretamente por meio de Workflow Studio.
• Quando um fluxo for promovido para produção, restabeleça uma conexão com cada conta sem precisar modificar o fluxo.

Para saber mais sobre conexões, consulte Conexões e credenciais.

Aliases de conexão e credencial

Integration Hub usa aliases para gerenciar informações de conexão e credenciais ao integrar com sistemas externos. O uso de um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar vários ambientes. Integration Hub requer apenas um alias, que é resolvido para usar as credenciais e informações de conexão corretas durante o tempo de execução.

Com os aliases de conexão e credencial, você também pode criar aliases adicionais ou conexões chamadas de aliases secundários. Os aliases secundários permitem criar várias conexões na mesma integração de aplicação. Para obter mais informações, consulte Criar um alias de conexão e credencial.

Seleção de conexão no nível de fluxo

Você pode escolher uma conexão para um fluxo ou subfluxo diretamente na página principal do fluxo. Quando você seleciona uma nova conexão, ela substitui qualquer conexão pré-configurada para esse fluxo. Para escolher uma conexão, selecione o ícone de menu Mais ações ( ) e selecione a opção Configurar conexões. Esta opção abre a janela Configurar Conexões, na qual você pode selecionar as conexões para o seu fluxo. A janela Configurar Conexões é exibida:

• Todos os aliases usados no fluxo.
• O ícone e o nome de cada alias.
• Uma lista das conexões configuradas para cada alias. A conexão padrão é listada primeiro. Outras conexões são listadas em ordem alfabética.
• Um ícone de informações para cada alias. Selecionar o ícone abre o registro Aliases de conexão e credencial para a conexão padrão mostrada na lista.
• Uma opção Gerenciar conexões que abre o painel de conexões.
• Opções para Cancelar seleção de conexão ou Atualizar sua escolha de conexão.

Cada alias tem uma entrada na janela Configurar conexões, independentemente de quantas ações ou subfluxos possam usar esse alias. Quando você seleciona uma conexão no nível de fluxo, a nova conexão se aplica a todas as ações e subfluxos que usam esse alias. Por exemplo, se um fluxo tiver várias ações que usam um serviço do Slack, a mudança da conexão do serviço do Slack mudará a conexão de todas as ações de serviço do Slack no fluxo.

Você pode ver quais partes de um fluxo uma mudança de conexão afeta correspondendo os ícones de alias no fluxo aos da janela Configurar conexões. Uma ação que afeta um serviço do Slack tem um ícone do Slack ao lado da ação no fluxo. O ícone do Slack também aparece ao lado do nome do alias na janela Configurar conexões.

A janela Configurar conexões é atualizada automaticamente sempre que você adiciona ou exclui um componente de fluxo que tem conexões. Quando você adiciona uma ação ou subfluxo a um fluxo, a janela Configurar Conexões exibe as conexões da ação ou subfluxo que você acabou de adicionar. Se você remover uma ação ou subfluxo, as informações de conexão serão removidas da janela Configurar conexões.

Você pode escolher se deseja exibir a opção Configurar conexões com a propriedade do sistema sn_flow_designer.connections_override_enabled. Definir a propriedade como verdadeira exibe a opção Configurar conexões, enquanto defini-la como falsa a oculta. Se você excluir a propriedade do sistema ou ela não existir, a opção Configurar conexões será exibida por padrão.

Exiba com qual conexão seu fluxo foi executado examinando a seção Configuração de etapa dos detalhes de execução do fluxo. O alias de conexão listado na coluna CONFIGURAÇÃO é o alias com o qual o fluxo foi originalmente projetado para ser executado. O alias listado na coluna RUNTIME VALUE é aquele com o qual o fluxo foi realmente executado.

Figura 1. Página de detalhes da execução

Seleção de conexão no nível de ação

Você pode selecionar conexões para ações de integração individuais em um fluxo. Essa funcionalidade será útil se um fluxo precisar interagir com várias configurações do mesmo provedor. Por exemplo, baixar um arquivo de uma configuração de um provedor de armazenamento de arquivos e, em seguida, carregar o arquivo em uma configuração diferente do mesmo provedor de armazenamento de arquivos.

As ações de integração têm um ou mais campos de conexão na seção Propriedades da ação, onde você pode editar ou configurar uma conexão. No exemplo a seguir, a ação Criar incidente remoto tem um campo de conexão chamado Conexão da ServiceNow. A conexão padrão ainda não foi configurada, portanto, uma mensagem de Conexão não configurada aparecerá abaixo do campo de conexão. Esta mensagem aparece sempre que a conexão do alias selecionado não está configurada

Figura 2. Exemplo de um campo de conexão em uma ação de integração

Use o ícone de engrenagem ( ) para criar ou configurar um alias.

• Para conexões que usam um modelo de configuração, o ícone de engrenagem abre uma janela na qual você pode criar ou configurar uma conexão.
• Para conexões sem um modelo de configuração, o ícone de engrenagem abre o formulário da plataforma para criar um alias de conexão e credencial.

Use o ícone de adição ( ) para adicionar um novo alias de conexão secundário. Use o ícone de lápis ( , não mostrado na imagem) para editar a conexão selecionada.

Entradas dinâmicas

Você pode selecionar conexões para fluxos e subfluxos que contêm ações com entradas dinâmicas. Quando uma substituição de conexão é especificada no nível de fluxo, a ação dinâmica usa a substituição de nível de fluxo. Por exemplo, em um fluxo com uma ação de coleta de dados, a ação usa a conexão de substituição do fluxo para a etapa de coleta de dados em vez da conexão padrão da ação. Se uma substituição for especificada no nível da ação, a ação dinâmica usará a substituição no nível da ação.

Várias substituições em um fluxo

Quando há mais de uma substituição em um fluxo, elas são aplicadas de acordo com as seguintes regras:

• As substituições no nível da ação sempre se aplicam.
• As substituições no nível de subfluxo sempre se aplicam ao subfluxo. A substituição também se aplica a ações dentro do subfluxo que não têm suas próprias substituições configuradas.
• As substituições no nível de fluxo se aplicam a subfluxos e ações que não têm suas próprias substituições configuradas.

Promoção de fluxo

Quando você move um fluxo para uma instância de produção, as informações de alias são transferidas com ele, mas as informações de conexão subjacentes não são. Um alias funciona como um tipo de contêiner para conexões. O contêiner se move com o fluxo, mas as informações de conexão específicas não. Todas as conexões associadas ao alias são desconfiguradas e devem ser reconfiguradas para que você possa usá-las no novo ambiente.

Você pode configurar conexões sem precisar modificar o fluxo porque já tem o alias base configurado. Para configurar uma conexão:

• Se o alias tiver um modelo de configuração, configure a conexão por meio do painel Conexões. Consulte Configurar uma conexão no painel Conexões para obter instruções.
• Se um alias não tiver um modelo de configuração, configure-o por meio da interface do usuário da plataforma. Para obter mais informações sobre como configurar uma conexão sem um modelo, consulte Introdução a conexões.