Globals

Saiba mais sobre globals e como elas são usadas para armazenar variáveis na Digibee Integration Platform.

Visão geral

Globals são variáveis armazenadas na Plataforma que podem ser reutilizadas em vários pipelines e cápsulas. Após criar uma global, você pode referenciá-la em qualquer campo de texto dentro dos formulários de configuração de conectores.

Esse recurso ajuda a acelerar o desenvolvimento: ao atualizar o valor de uma global em um único lugar, a alteração é aplicada em todos os pontos onde a variável é usada.

Globals são atualizadas automaticamente apenas em pipelines que ainda não foram implantados. Se um pipeline que usa a global atualizada já estiver implantado, um aviso aparecerá no card da página Run para lembrar você de reimplantá-lo.

Gerenciando globals

Página de configuração para adicionar uma nova global na Plataforma.

Criando uma global

Na página inicial da Plataforma, clique em Configurações no canto superior direito e, na página seguinte, selecione Globals.

1. Clique em Criar e preencha os campos:

• Nome da global: Nome da variável a ser referenciada em pipelines ou cápsulas. Use apenas letras minúsculas, até 60 caracteres, com letras, números, - (hífen) ou . (ponto). Acentos não são permitidos.

• Categoria: Define como o valor será validado:

  • URL: Deve ser uma URL válida.

  • JDBC: Deve ser uma string de conexão válida.

  • Email: Deve ser um endereço de e-mail válido.

  • ID: Deve conter apenas números.

  • Other: Aceita qualquer valor. Use esta opção para listas, mas evite informações sensíveis (não há criptografia disponível).

1. Descrição: Uma breve explicação sobre a finalidade da global.

2. Disponibilidade do Projeto: Define se a conta pode ser usada em todos os projetos ou apenas em projetos selecionados. Na página de listagem de globals, você verá apenas as globals disponíveis para todos os projetos ou aquelas às quais você tem permissão de acesso.

Pipelines só funcionam com globals disponíveis em seu projeto. Se um pipeline for movido para outro projeto, a global será desconectada até que um novo seja configurado ou que o projeto seja autorizado.

1. Ambiente Prod/ Test / Outros: Informe o valor para cada ambiente (até 10.000 caracteres por campo).

2. Clique em Salvar.

3. Uma janela de confirmação aparecerá. Digite “Quero criar a global” no campo Mensagem de confirmação e clique em Criar.

Globals são visíveis para todos os usuários com acesso e não são criptografados no banco de dados. Não adicione dados sensíveis. Use Contas se for necessário criptografar.

Editando uma global

Para editar uma conta, vá até a página Globals e clique no ícone de lápis no menu Ações.

Você pode:

• Atualizar a categoria.

• Atualizar a descrição.

• Marcar a global como descontinuada. Saiba mais sobre a descontinuação de uma global.

• Definir novas regras para Disponibilidade do Projeto.

• Editar os valores dos ambientes.

• Visualizar todos os pipelines que usam a global.

Lembre-se de que, se a global for editada, pipelines já implantados precisam ser reimplantados para aplicar as mudanças.

Após editar a global, uma janela de confirmação aparece. Digite “Quero editar a global” no campo Mensagem de confirmação e clique em Editar.

Todas as alterações são aplicadas imediatamente a pipelines que usam a global e ainda não foram implantados.

Descontinuando uma global

Descontinuar uma global a torna indisponível para novos pipelines ou novas versões de pipelines. Implantações existentes continuarão funcionando, a menos que sejam reimplantadas.

Para descontinuar uma global:

1. Abra a página Globals e clique no ícone de lápis ao lado da conta.

2. Ative a opção Descontinuada.

3. Clique em Salvar.

Essa ação é irreversível.

Excluindo uma global

Excluir uma global a remove permanentemente da Plataforma. Não é possível excluir globals que estejam em uso em pipelines, implantados ou não. Para prosseguir, remova ou substitua a global em todos os pipelines antes de excluí-la.

Para excluir uma conta:

1. Abra a página Globals.

2. Clique no ícone de lixeira ao lado da conta.

3. Clique em Delete na janela de confirmação.

Usando globals

Globals podem ser referenciadas em qualquer campo de texto dentro do formulário de configuração de um conector.

Para usar uma global:

1. Abra o pipeline ou cápsula.

2. Selecione o conector que deseja configurar.

3. No campo desejado, inicie uma expressão com {{. Na lista de preenchimento automático, escolha global e digite um ponto (.) para exibir as variáveis disponíveis.

Você também pode inserir a referência manualmente:

{{global.GlobalName}}

Substitua GlobalName pelo nome que você atribuiu ao criar a global. Por exemplo:

{{global.db-timeout}}

Exemplo

O parâmetro Database URL no conector DB V2 oferece suporte a globals. Ao começar a digitar a expressão, o recurso de autocompletar exibe as variáveis disponíveis, permitindo que você selecione e utilize aquela que configurou.