Conexões globais¶

Introdução¶

A página Conexões globais é onde você gerencia os endpoints que podem ser usados em projetos em um ambiente (chamados de endpoints globais). Cada ambiente pode ser configurado com uma configuração exclusiva do endpoint global que pode ser usado por qualquer projeto naquele ambiente.

Na página Conexões Globais, você pode visualizar, criar, editar, e apagar endpoints globais dependendo dos níveis de acesso ao ambiente concedido à sua papel. Uma vez que um endpoint global é adicionado a um ambiente, ele 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 pelo menu do portal Harmony ou pela paleta de componentes de design:

• Use o menu do portal Harmony para selecionar Integration Studio > Conexões Globais:

  

• Na paleta de componentes de design aba endpoints globais, clique em Gerenciar endpoints globais:

  

Tabela de conexões globais¶

Os endpoints globais existentes são exibidos na tabela Conexões Globais na aba Conexões:

Esses controles estão localizados na parte superior direita da tabela:

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

• Adicionar novo endpoint: Clique para abrir a configuração global do endpoint tela para uma nova conexão.

• Atualizar: Clique para recarregar a tabela.

A tabela inclui estas colunas:

• Nome: O nome do endpoint global fornecido na configuração.

  A presença de um o ícone de aviso ao lado do nome indica que um endpoint global está usando variáveis em sua configuração de conexão. Usar variáveis em um endpoint global não é recomendado, pois futuras alterações em um nome de variável no nível do projeto não serão refletidas no nível global. Clicar no ícone revela um aviso com um botão Editar endpoint que pode ser usado para abrir a configuração de endpoint global tela para remover a variável.

• Tipo: O conector que o endpoint global usa.

• Descrição: A descrição fornecida na configuração do endpoint global.

• Ambientes: Os ambientes aos quais o endpoint global é adicionado, conforme configurado na configuração.

  Esses ícones estão presentes na pílula do ambiente em certas circunstâncias:

  • O o ícone não implantado está presente quando a configuração de um endpoint global usado por uma operação implantada é editada e qualquer operação que use o endpoint global editado naquele ambiente ainda não foi reimplantada

  • O o ícone de aviso indica que o endpoint global está usando variáveis em sua configuração de conexão. É recomendável remover quaisquer variáveis na configuração de conexão, pois futuras alterações em um nome de variável no nível do projeto não serão refletidas no nível global.

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

• Criado: A data e hora do navegador local em que o endpoint global foi criado e o nome de usuário do usuário que o criou.

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

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

  • Editar endpoint: Clique para abrir a configuração global do endpoint tela para uma conexão existente.

  • Excluir endpoint: Clique para excluir um endpoint global que não é usado em nenhum projeto. Para obter informações adicionais, consulte Excluir um endpoint global mais adiante nesta página.

Gaveta de ambiente¶

A gaveta de ambiente abre na parte inferior da página quando você clica em um ambiente na Tabela de conexões globais:

As guias na parte superior da gaveta são exibidas para cada ambiente onde o endpoint global foi adicionado.

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

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

Esses controles estão localizados na parte superior direita da gaveta:

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

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

• Fechar: Clique para fechar a gaveta do ambiente.

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

• Nome: O ícone e o nome do endpoint global.

• Descrição: A descrição do endpoint global.

• Componentes no ambiente: Uma tabela é exibida para cada projeto no ambiente listado que possui componentes que são dependentes do endpoint global:

  • Projeto: O nome do projeto. A presença de um o ícone de alterações não implantadas ao lado do nome do projeto indica que o projeto contém operações dependentes do endpoint global que tiveram 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ê clicar no botão Implantar para este projeto.

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

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

    Cuidado

    Todas as operações mostradas com um o ícone de alterações não implantadas 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ê clicar neste botão.

  • Ir para o projeto: Clique para abrir o projeto em Integration Studio em uma nova aba.

  • Ocultar ou mostrar projeto: Clique no setas para cima ou para baixo para ocultar ou mostrar a lista de operações que dependem do endpoint global do projeto.

  • Operação: O nome de qualquer operação dependente do endpoint global. A presença de um o ícone de 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 também serão implantadas 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 existam fora dos workflows e sejam dependentes do endpoint global. Esses componentes são listados apenas para fins informativos; embora não afetem nenhuma lógica implantada, sua existência em um projeto impedirá que você remova a conexão neste ambiente.

  • Ações: Passe o mouse e clique em ícone de lançamento para abrir o projeto com a operação selecionada em Integration Studio em uma nova aba. As ações não são aplicáveis a componentes não usados em operações.

• Implementar para projetos sem alterações: Clique para implantar operações dependentes do endpoint global para projetos neste ambiente onde as únicas alterações a serem implantar são aquelas no endpoint global (exclui projetos que têm quaisquer operações com o ícone de alterações não implantadas). Após a implantar, na próxima vez que as operações desses projetos forem executadas, elas usarão a configuração de endpoint global mais recente.

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

  Cuidado

  Todas as operações mostradas com um o ícone de alterações não implantadas 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ê clicar neste botão.

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

Crie um endpoint global¶

Para criar um novo endpoint global, clique em adicionar ícone no canto superior direito da tabela Conexões Globais. A tela de configuração New Global Connection abre. Esta tela é descrita abaixo.

Um endpoint existente em um projeto também pode ser promovido a um endpoint global, que você pode então editar depois de criado. A opção Promover para Conexão Global pode ser acessada nestes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).

A tela de configuração Nova Conexão Global tem 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 um novo endpoint 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 um novo endpoint global. Todos os conectores na organização, exceto para a API, SOAP, e Variável conectores são listados, incluindo conectores personalizados. Os conectores que podem ser usados somente em ambientes associados a um grupo de agentes privados são indicados com um ponto vermelho .

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

• Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a 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 do endpoint global sem criar uma nova conexão.

• Concluir: 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 o endpoint global e adiciona ou remove ambientes onde o endpoint global pode ser usado:

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

• Descrição: Insira uma descrição do endpoint global a ser exibido na tabela Conexões globais.

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

  Dica

  A adição de ambientes e a configuração e o teste de informações de conexão podem ser feitos 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 adicionar ícone para abrir um menu dos ambientes da organização que o endpoint global ainda não foi adicionado. Se o conector selecionado na etapa 1 está disponível somente em agentes privados, os ambientes associados a um grupo de agentes de nuvem ficam esmaecidos e não podem ser selecionados. Selecione um ambiente por vez no menu, usando o adicione ícone para adicionar ambientes adicionais conforme necessário.

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

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

    Os seguintes ícones são exibidos na aba de um ambiente sob certas circunstâncias:

    • O o ícone de alterações não testadas indica que um ambiente tem alterações na configuração de conexão que não foram testadas.
    • O o ícone de erro indica que a conexão testada de um ambiente não foi bem-sucedida.
    • O o ícone de sucesso indica que a conexão testada de um ambiente foi bem-sucedida.

    • O o ícone de aviso indica que um endpoint global está usando variáveis em sua configuração de conexão (não recomendado). É recomendado remover quaisquer variáveis na configuração de conexão, pois futuras alterações em um nome de variável no nível do projeto não serão refletidas no nível global.

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

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

• Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

• Próximo: Este botão está desabilitado, pois não é aplicável a esta etapa.

• Testar todas as conexões: Clique para testar todos os endpoints do ambiente no endpoint global. Após clicar em Testar todas as conexões, uma caixa de diálogo exibe uma lista dos endpoints do ambiente no endpoint global e seus status de conexão, com um ícone de sucesso ou um ícone de erro.

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

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

Editar um endpoint global¶

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

A tela de configuração de um endpoint global existente é aberta:

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

• Descrição: Insira uma descrição do endpoint global a ser exibido na tabela Conexões globais.

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

  • Adicionar um ambiente: Clique no adicionar ícone para abrir um menu dos ambientes da organização que o endpoint global ainda não foi adicionado. Se o conector selecionado na etapa 1 está disponível somente em agentes privados, os ambientes associados a um grupo de agentes de nuvem ficam esmaecidos e não podem ser selecionados. Selecione um ambiente por vez no menu, usando o adicione ícone para adicionar ambientes adicionais conforme necessário.

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

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

    Os seguintes ícones são exibidos na aba de um ambiente sob certas circunstâncias:

    • O o ícone de alterações não testadas indica que um ambiente tem alterações na configuração de conexão que não foram testadas.
    • O o ícone de erro indica que a conexão testada de um ambiente não foi bem-sucedida.
    • O o ícone de sucesso indica que a conexão testada de um ambiente foi bem-sucedida.

    • O o ícone de aviso indica que um endpoint global está usando variáveis em sua configuração de conexão (não recomendado). É recomendado remover quaisquer variáveis na configuração de conexão, pois futuras alterações em um nome de variável no nível do projeto não serão refletidas no nível global.

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

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

• Testar todas as conexões: Clique para testar todos os endpoints do ambiente no endpoint global. Após clicar em Testar todas as conexões, uma caixa de diálogo exibe uma lista dos endpoints do ambiente no endpoint global e seus status de conexão, com um ícone de sucesso ou um ícone de erro.

• Cancelar: Clique para fechar a configuração do endpoint global sem salvar.

• Salvar: Clique para salvar a configuração e fechar a configuração do endpoint global.

  Nota

  Quando um endpoint global é editado e usado em um projeto atualmente aberto no designer, 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 um endpoint global¶

Para excluir um endpoint global, passe o mouse sobre uma linha de endpoint global existente na tabela Conexões globais e clique no ícone excluir para excluir um endpoint global que não é usado em nenhum projeto.

Se um endpoint global for usado em qualquer projeto, o o ícone delete está desabilitado e o endpoint global não pode ser excluído. Para ver uma lista de projetos usando o endpoint global, clique na pílula de ambiente conforme descrito acima em Ambientes na tabela Conexões Globais. Em seguida, abra cada projeto, remova o endpoint global e reimplante as operações do projeto que não usam mais o endpoint global.