Ir para o conteúdo

Endpoints globais no Jitterbit Integration Studio

Introdução

A página Global Endpoints é onde você gerencia endpoints que podem ser usados em projetos em um ambiente (chamados de pontos de extremidade globais). Cada ambiente pode ser configurado com uma configuração exclusiva do endpoint global, que pode ser usada por qualquer projeto naquele ambiente.

Na página Global Endpoints, você pode visualizar, criar, editar e excluir endpoints globais dependendo dos níveis de acesso ao ambiente concedido à sua papel. Depois 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.

Dica

Quando o ciclo de vida do seu projeto envolve migração de projeto, é recomendado usar endpoints globais em vez de usar variáveis de projeto em campos de configuração de endpoint não globais. Embora os valores das variáveis do projeto possam ser excluídos seletivamente durante a migração, esse processo pode ser trabalhoso com um grande número de variáveis.

Acesse a página de Endpoints globais

A página Global Endpoints 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 > Global Endpoints:

    endpoints globais do Integration Studio

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

    e-email de endpoints globais disponíveis

Tabela de Endpoints globais

Os endpoints globais existentes são exibidos na tabela Global Endpoints **na aba Endpoints**:

Estes controles estão localizados no canto superior direito 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 os endpoints.

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

  • 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 na configuração de conexão do endpoint. O uso de variáveis em um endpoint global não é recomendado, pois futuras alterações no nome de uma 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 nesse ambiente ainda não foi reimplantada

    • O O ícone de aviso indica que o endpoint global está usando variáveis na configuração de conexão do endpoint. Recomenda-se remover quaisquer variáveis na configuração de conexão do endpoint, pois futuras alterações no nome de uma 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 tomar, como implantar alterações, abrir o projeto ou operação no Integration Studio ou remover o endpoint.

  • 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 o endpoint:

Gaveta de ambiente

A gaveta de ambiente abre na parte inferior da página quando você clica em um ambiente na tabela Endpoints 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 "não implantado" é exibido em uma aba de ambiente quando o endpoint global do qual as operações do projeto dependem sofreu uma alteração de configuração desde a última endpoint neste projeto. Isso significa que você precisa reimplantar as operações dependentes do endpoint neste projeto para usar a configuração mais recente do endpoint.

Importante

O azul circular ícone não implantado e o triângulo azul O ícone de alterações não implantadas tem significados distintos. Enquanto o ícone circular azul O ícone não implantado indica que as operações dependentes do endpoint global devem ser reimplantadas no projeto, o ícone triangular azul O ícone de alterações não implantadas alerta você sobre quais dessas operações têm 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.

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

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

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

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

  • Fechar: Clique para fechar a gaveta de 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 dependem 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 da última modificação do projeto. 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.

    • Implantar para este projeto: Clique para implantar operações dependentes do endpoint 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 endpoint global mais recente.

      Cuidado

      Quaisquer 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 no Integration Studio em uma nova aba.

    • Ocultar ou mostrar projeto: Clique em 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 quaisquer operações dependentes 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 o endpoint neste ambiente.

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

  • Implantar 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.

  • Implantar para todos os projetos: Clique para implantar operações dependentes do endpoint global para todos os projetos neste ambiente. 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.

    Cuidado

    Quaisquer 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 só é habilitado após a primeira exclusão de componentes que fazem referência ao endpoint de todos os projetos listados na aba.

Crie um endpoint global

especial Para criar um novo endpoint global, clique em adicionar ícone no canto superior direito da tabela de Endpoints globais. A tela de configuração do Novo Endpoint Global é aberta. 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 após a criação. A opção Promover para endpoint global pode ser acessada nestes locais:

A tela de configuração do Novo Endpoint Global tem duas etapas de configuração:

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 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 somente agente privado 3.

  • Voltar: Este botão está desabilitado, pois não se aplica a esta etapa.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima. 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 um novo endpoint.

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

Etapa 2: configurar e testar o endpoint 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 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 a um endpoint específico e suas atividades.

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

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

    Dica

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

    • Adicionar um ambiente: Clique no adicionar ícone para abrir um menu dos ambientes da organização ao qual o endpoint global ainda não foi adicionado. 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 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 do 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 em determinadas circunstâncias:

      • O O ícone de alterações não testadas indica que um ambiente tem alterações na configuração de conexão de endpoint que não foram testadas.
      • O O ícone de erro indica que a conexão do endpoint testado de um ambiente não foi bem-sucedida.
      • O O ícone de sucesso indica que a conexão do endpoint testado de um ambiente foi bem-sucedida.
      • O O ícone de aviso indica que um endpoint global está usando variáveis na configuração de conexão do endpoint (não recomendado). Recomenda-se remover quaisquer variáveis na configuração de conexão, pois futuras alterações no nome de uma 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 Endpoints globais.)

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

  • Voltar: Clique para armazenar temporariamente a configuração desta 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 um novo endpoint.

  • 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 Endpoints globais e clique no ícone de edição.

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

  • Nome: Insira um nome 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 a um endpoint específico e suas atividades.

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

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

    • Adicionar um ambiente: Clique no adicionar ícone para abrir um menu dos ambientes da organização ao qual o endpoint global ainda não foi adicionado. 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 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 do 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 em determinadas circunstâncias:

      • O O ícone de alterações não testadas indica que um ambiente tem alterações na configuração de conexão de endpoint que não foram testadas.
      • O O ícone de erro indica que a conexão do endpoint testado de um ambiente não foi bem-sucedida.
      • O O ícone de sucesso indica que a conexão do endpoint testado de um ambiente foi bem-sucedida.
      • O O ícone de aviso indica que um endpoint global está usando variáveis na configuração de conexão do endpoint (não recomendado). Recomenda-se remover quaisquer variáveis na configuração de conexão do endpoint, pois futuras alterações no nome de uma 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 Endpoints globais.)

      • Testar conexão: Clique para testar a conexão do endpoint 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 o endpoint foi alterado e deve ser reimplantado 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 Endpoints 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 de exclusão está desabilitado e o endpoint global não pode ser excluído. Para ver uma lista de projetos que usam o endpoint global, clique na pílula de ambiente, conforme descrito acima em Ambientes na tabela Endpoints 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.