Conexões Globais¶

Introdução¶

A página Conexões Globais é onde você gerencia conexões que podem ser usadas entre projetos em um ambiente. Cada ambiente pode ser configurado com uma configuração exclusiva de conexão global que pode ser usada por qualquer projeto nesse ambiente.

Na página Conexões Globais, você pode visualizar, criar, editar e excluir conexões globais dependendo dos níveis de acesso ao ambiente concedido à sua papel. Depois que uma conexão global é adicionada a um ambiente, ela se torna visível para os usuários na paleta de componentes de design para usar em um projeto.

Acesse a Página Conexões Globais¶

A página Conexões Globais pode ser acessada no menu do Harmony Portal ou na paleta de componentes de design:

• Use o menu do Harmony Portal para selecionar Cloud Studio > Conexões Globais:

  

• Na paleta de componentes de design aba Conexões Globais, clique em Gerenciar Conexões Globais:

  

Tabela de Conexões Globais¶

As conexões globais existentes são exibidas na tabela Conexões globais na aba Conexões:

Esses controles estão localizados no canto superior direito da tabela:

• Pesquisar conexões: Clique no ícone de pesquisa para expandir uma caixa de pesquisa. Insira qualquer parte do nome, tipo ou descrição da conexão global na caixa de pesquisa para filtrar as conexões.

• Adicionar nova conexão: Clique no ícone adicionar para abrir a configuração de conexão global tela para uma nova conexão.

• Atualizar: Clique no ícone de atualização para recarregar a tabela.

A tabela inclui estas colunas:

• Nome: O nome da conexão global fornecida na configuração.

• Tipo: O conector que a conexão global usa.

• Descrição: A descrição fornecida na configuração da conexão global.

• Ambientes: Os ambientes aos quais a conexão global é adicionada, conforme configurado na configuração.

  Quando a configuração de uma conexão global usada por uma operação implementada é editada e qualquer operação que use a conexão global editada nesse ambiente ainda não tenha sido reimplantada, um ícone azul Undeployed será exibido na parte superior do painel do ambiente:

  

  Além disso, cada ambiente pode ser clicado para abrir uma gaveta de ambiente na parte inferior da página que fornece informações e ações adicionais que você pode realizar, como implantar alterações, abrir o projeto ou operação no Cloud Studio ou remover a conexão.

• Criado: A data e hora do navegador local em que a conexão global foi criada e o nome de usuário do usuário que a criou.

• Modificado: A data e hora do navegador local em que a conexão global foi modificada pela última vez e o nome de usuário do usuário que a modificou pela última vez.

• Ações: Passe o mouse sobre a linha de conexão global para mostrar as ações disponíveis para a conexão:

  • Editar conexão: Clique no ícone de edição para abrir a configuração de conexão global tela para uma conexão existente.

  • Excluir conexão: Clique no ícone excluir para excluir uma conexão global que não é usada em nenhum projeto. Para obter informações adicionais, consulte Excluir uma conexão global mais adiante nesta página.

Gaveta de Ambiente¶

A gaveta de ambiente é aberta na parte inferior da página quando você clica em um ambiente na tabela Conexões Globais:

As guias na parte superior da gaveta são exibidas para cada ambiente onde a conexão global foi adicionada.

Um ícone circular azul Não implantado é exibido em uma aba de ambiente quando a conexão global da qual as operações do projeto dependem teve uma alteração de configuração desde a última implantação da conexão global neste projeto. Isto significa que você precisa reimplantar operações dependentes da conexão neste projeto para usar a configuração mais recente da conexão.

Você pode percorrer as guias usando as setas para a esquerda e para a direita .

Esses controles estão localizados no canto superior direito da gaveta:

• Recolher: Clique no ícone Recolher para recolher a gaveta do ambiente para a parte inferior da página para que apenas a parte superior da gaveta fique visível. Para restaurar a gaveta ao estado anterior, clique no ícone Return .

• Expandir: Clique no ícone Expandir para expandir a gaveta do ambiente para o topo da página. Para restaurar a gaveta ao estado anterior, clique no ícone Return .

• Fechar: Clique no ícone Fechar para fechar a gaveta do ambiente.

Cada aba inclui estas informações e estas ações:

• Nome: O ícone e o nome da conexão global.

• Descrição: A descrição da conexão global.

• Componentes no ambiente: Uma tabela é exibida para cada projeto no ambiente listado que possui componentes que dependem da conexão global:

  • Projeto: O nome do projeto. A presença de um ícone Alterações não implantadas ao lado do nome do projeto indica que o projeto contém operações dependentes da conexão global que tiveram outras alterações de configuração (como uma atividade não relacionada ou etapa de operação de script) que não foram ainda foi implantado e também será implantado quando você clicar no botão Implantar para este projeto.

  • Data da última modificação do projeto: A data e hora em que o projeto foi modificado pela última vez. A data e a hora são locais do projeto e não são afetadas por modificações em quaisquer conexões globais em uso pelo projeto.

  • Implantar para este projeto: Clique para implantar operações dependentes da conexão global somente neste projeto. Após a implantar, na próxima vez que as operações deste projeto forem executadas, elas usarão a configuração de conexão global mais recente.

    Cuidado

    Quaisquer operações mostradas com um ícone Alterações não implementadas ao lado do nome da operação tem outras alterações de configuração (como uma atividade não relacionada ou etapa de operação de script) que ainda não foram implantadas e também serão implantadas quando você clica neste botão.

  • Vá para o Projeto: Clique no ícone do link para abrir o projeto no Cloud Studio em uma nova aba.

  • Ocultar ou Mostrar Projeto: Clique nas setas para cima ou para baixo para ocultar ou mostrar a lista de operações que dependem da conexão global do projeto.

  • Operação: O nome de quaisquer operações dependentes da conexão global. A presença de um ícone Alterações não implantadas ao lado do nome da operação indica que a operação teve outras alterações de configuração (como uma atividade não relacionada ou etapa de operação de script) que ainda não foram implantadas e serão também será implantado quando você clicar no botão Implantar para este projeto.

  • Componentes não usados em operações: O tipo e o nome de quaisquer componentes que existem fora dos workflows e dependem da conexão global. Esses componentes são listados apenas para fins informativos; embora não afetem nenhuma lógica implementada, sua existência em um projeto impedirá que você remova a conexão neste ambiente.

  • Ações: Passe o mouse e clique no ícone do link para abrir o projeto com a operação selecionada no Cloud Studio em uma nova aba. As ações não são aplicáveis a componentes não utilizados nas operações.

• Implantar para projetos sem alterações: Clique para implantar operações dependentes da conexão global para projetos neste ambiente em que as únicas alterações a serem implantar são aquelas na conexão global (exclui projetos que possuem operações com a opção Alterações não implementadas ícone ). Após a implantar, na próxima vez que as operações desses projetos forem executadas, eles usarão a configuração de conexão global mais recente.

• Implantar para todos os projetos: Clique para implantar operações dependentes da conexão global para todos os projetos neste ambiente. Após a implantar, na próxima vez que as operações desses projetos forem executadas, eles usarão a configuração de conexão global mais recente.

  Cuidado

  Quaisquer operações mostradas com um ícone Alterações não implementadas ao lado do nome da operação tem outras alterações de configuração (como uma atividade não relacionada ou etapa de operação de script) que ainda não foram implantadas e também serão implantadas quando você clica neste botão.

• Remover conexão: Clique para remover a conexão global do ambiente. Este botão é habilitado somente após excluir componentes que fazem referência à conexão de todos os projetos listados na aba.

Crie uma Conexão Global¶

Para criar uma nova conexão global, clique no ícone adicionar no canto superior direito da tabela Conexões Globais. A tela de configuração Nova conexão global é aberta. Esta tela é descrita abaixo.

Uma conexão existente em um projeto também pode ser promovida para uma conexão global, que você pode então editar depois de criada. A opção Promover para conexão global pode ser acessada nestes locais:

• A aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).
• A aba Componentes do painel do projeto (consulte Menu Ações do componente em Guia Componentes do painel do projeto).

A tela de configuração Nova Conexão Global possui duas etapas de configuração:

• Etapa 1: Selecione um conector
• Etapa 2: Configurar e testar a conexão e adicionar ou remover ambientes

Etapa 1: Selecione um Conector¶

Nesta etapa, você seleciona um conector a partir do qual criar uma nova conexão global:

• Pesquisar: Insira qualquer parte do nome de exibição do conector na caixa de pesquisa para filtrar os conectores.

• Conectores: Clique para selecionar um conector a partir do qual criar uma nova conexão global. Todos os conectores na organização, exceto a API, SOAP e Variável conectores estão listados, incluindo conectores personalizados. Conectores que podem ser usados apenas em ambientes associados a um Grupo de Agentes Privados são indicados com um ponto vermelho .

• Voltar: O ícone de voltar está desabilitado, pois não é aplicável a esta etapa.

• Próximo: Clique no próximo ícone para armazenar temporariamente a configuração desta etapa e continuar na próxima etapa. A configuração não será salva até que você clique no botão Concluir na última etapa.

• Cancelar: Clique para fechar a configuração da conexão global sem criar uma nova conexão.

• Terminar: Este controle está desabilitado, pois não é aplicável a esta etapa.

Etapa 2: Configurar e Testar a Conexão e Adicionar Ou Remover Ambientes¶

Nesta etapa, você configura e testa a conexão global e adiciona ou remove ambientes onde a conexão global pode ser usada:

• Nome: Insira um nome a ser usado para identificar a conexão global. O nome deve ser exclusivo para cada conexão global de um conector específico e não deve conter barras / ou dois pontos :. Esse nome também é usado para identificar o endpoint do conector, que se refere tanto a uma conexão específica quanto a suas atividades.

• Descrição: Insira uma descrição da conexão global a ser exibida na tabela Conexões Globais.

• Environment Endpoints: Nesta área, você adiciona ambientes um por vez e configura e testa a conexão global em cada ambiente. Dentro da configuração de cada ambiente, você também pode remover a conexão do ambiente.

  Dica

  A adição de ambientes e a configuração e teste de informações de conexão podem ser feitas posteriormente, permitindo que um usuário crie conexões e outro usuário crie conexões e as adicione aos ambientes posteriormente.

  • Adicionar um ambiente: Clique no ícone adicionar para abrir um menu dos ambientes à qual a conexão global ainda não foi adicionada. Se o conector selecionado na etapa 1 está disponível apenas em Agentes Privados, os ambientes associados a um Grupo de Agentes em Nuvem ficam esmaecidos e não podem ser selecionados. Selecione um ambiente por vez no menu, usando o ícone de adição para adicionar ambientes adicionais conforme necessário.

  • Guia Ambiente: À medida que cada ambiente é adicionado, uma aba é adicionada à seção Ambientes contendo a configuração de conexão global para esse ambiente.

    • Campos de configuração: Configure cada campo para o conector específico conforme descrito na documentação do conector específico selecionado na etapa 1. A documentação de cada conector está em Conectores seção.

    • Status do teste de conexão: Os ícones a seguir são exibidos na aba de um ambiente quando determinadas condições são atendidas. Os ícones não persistem após o fechamento da tela de configuração.

      • Alterações não testadas: Quando um ambiente tem alterações na configuração de conexão que não foram testadas, sua aba exibe um ícone Alterações não testadas .
      • Conexão malsucedida: Quando a conexão testada de um ambiente não é bem-sucedida, sua aba exibe um ícone Erro .
      • Conexão bem-sucedida: Quando a conexão testada de um ambiente é bem-sucedida, sua aba exibe um ícone de Sucesso .

    • Remover Conexão: Clique para remover a conexão global do ambiente. (A exclusão da conexão global pode ser feita na tabela Conexões Globais.)

    • Testar conexão: Clique para testar a conexão global usando a configuração fornecida.

• Voltar: Clique no ícone Voltar para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

• Próximo: O próximo ícone está desabilitado, pois não é aplicável a esta etapa.

• Testar todas as conexões: Clique para testar todos os endpoints do ambiente na conexão global. Depois de clicar em Testar todas as conexões, uma caixa de diálogo exibe uma lista dos endpoints do ambiente na conexão global e seu status de conexão, com um ícone de Sucesso ou um ícone Erro .

• Cancelar: Clique para fechar a configuração da conexão global sem criar uma nova conexão.

• Concluir: Clique para salvar a configuração de todas as etapas e fechar a configuração da conexão global.

Editar uma Conexão Global¶

Para editar uma conexão global, passe o mouse sobre uma linha de conexão global existente na tabela Conexões Globais e clique no ícone de edição .

A tela de configuração de uma conexão global existente é aberta:

• Nome: Insira um nome a ser usado para identificar a conexão global. O nome deve ser exclusivo para cada conexão global de um conector específico e não deve conter barras / ou dois pontos :. Esse nome também é usado para identificar o endpoint do conector, que se refere tanto a uma conexão específica quanto a suas atividades.

• Descrição: Insira uma descrição da conexão global a ser exibida na tabela Conexões Globais.

• Environment Endpoints: Nesta área, você adiciona ambientes um por vez e configura e testa a conexão global em cada ambiente. Dentro da configuração de cada ambiente, você também pode remover a conexão do ambiente:

  • Adicionar um ambiente: Clique no ícone adicionar para abrir um menu dos ambientes à qual a conexão global ainda não foi adicionada. Se o conector selecionado na etapa 1 está disponível apenas em Agentes Privados, os ambientes associados a um Grupo de Agentes em Nuvem ficam esmaecidos e não podem ser selecionados. Selecione um ambiente por vez no menu, usando o ícone de adição para adicionar ambientes adicionais conforme necessário.

  • Guia Ambiente: À medida que cada ambiente é adicionado, uma aba é adicionada à seção Ambientes contendo a configuração de conexão global para esse ambiente.

    • Campos de configuração: Configure cada campo para o conector específico conforme descrito na documentação do conector específico selecionado na etapa 1. A documentação de cada conector está em Conectores seção.

    • Status do teste de conexão: Os ícones a seguir são exibidos na aba de um ambiente quando determinadas condições são atendidas. Os ícones não persistem após o fechamento da tela de configuração.

      • Alterações não testadas: Quando um ambiente tem alterações na configuração de conexão que não foram testadas, sua aba exibe um ícone Alterações não testadas .
      • Conexão malsucedida: Quando a conexão testada de um ambiente não é bem-sucedida, sua aba exibe um ícone Erro .
      • Conexão bem-sucedida: Quando a conexão testada de um ambiente é bem-sucedida, sua aba exibe um ícone de Sucesso .

    • Remover conexão: Clique para remover a conexão global do ambiente. (A exclusão da conexão global pode ser feita na tabela Conexões Globais.)

    • Testar conexão: Clique para testar a conexão global usando a configuração fornecida.

• Testar todas as conexões: Clique para testar todos os endpoints do ambiente na conexão global. Depois de clicar em Testar todas as conexões, uma caixa de diálogo exibe uma lista dos endpoints do ambiente na conexão global e seu status de conexão, com um ícone de Sucesso ou um ícone Erro .

• Cancelar: Clique para fechar a configuração da conexão global sem salvar.

• Salvar: Clique para salvar a configuração e fechar a configuração da conexão global.

  Nota

  Quando uma conexão global usada em um projeto atualmente aberto no designer é editada, uma mensagem é exibida no designer para notificar os usuários de que a conexão foi alterada e deve ser reimplantada para que as alterações entrem em vigor.

Excluir uma Conexão Global¶

Para excluir uma conexão global, passe o mouse sobre uma linha de conexão global existente na tabela Conexões Globais e clique no ícone de exclusão para excluir uma conexão global que não é usada em nenhum projeto.

Se uma conexão global for usada em algum projeto, o ícone de exclusão está desabilitado e a conexão global não pode ser excluída. Para ver uma lista de projetos que usam a conexão global, clique no ícone de ambiente conforme descrito acima em Ambientes na tabela Conexões Globais. Em seguida, abra cada projeto, remova a conexão global e reimplante as operações do projeto que não usam mais a conexão global.