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.

Criar conexões

Existem duas maneiras de adicionar uma conexão secundária a um alias primário.

Por meio do painel Conexões

O painel Conexões fornece uma maneira simplificada de adicionar uma conexão a um alias. Para obter mais informações sobre o painel Conexões, incluindo como adicionar uma conexão, consulte Usando o painel Conexões.

Por meio da interface do usuário da plataforma

Crie manualmente uma conexão secundária configurando registros de conexão e credencial. Para criar uma conexão com este método, consulte Criação de 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, clique no ícone de menu ) 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. Clicar no ícone abre o registro Aliases de conexão e credencial da 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 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.

Para selecionar uma conexão para uma ação individual em um fluxo ou subfluxo, clique em Opções avançadas. Esta opção mostra o nome do alias que a ação usa e uma lista de todas as conexões associadas do alias. A primeira conexão na lista é a conexão padrão. Outras conexões são listadas em ordem alfabética. Selecionar uma conexão na lista substitui a conexão para essa ação e para todas as entradas dinâmicas dentro da ação.

Você pode habilitar ou desabilitar substituições no nível de ação clicando no ícone Mais ações (ícone ) e selecionando Preferências de fluxo. A janela Configurações tem uma opção Mostrar opções de conexão avançadas. Esta opção está desabilitada por padrão, portanto, as ações não mostram o botão Opções avançadas. Quando habilitada, a opção estará disponível se a ação tiver um alias de conexão que possa ser substituído.

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, 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, 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.

Considerações adicionais

Para adicionar uma conexão por meio do painel Conexões, o alias primário deve ter um modelo de configuração. Os modelos se tornaram disponíveis pela primeira vez na versão Orlando, portanto, os aliases de versões anteriores podem ainda não ter modelos. Para obter mais informações sobre modelos de configuração, consulte Modelos de configuração de conexão e credencial.