Centro de suporte da Workiva

Para definir valores para entradas que aparecem repetidamente em várias cadeias ou comandos em uma única cadeia, você pode usar variables. Em vez de inserir o mesmo valor em várias cadeias ou comandos, você pode defini-lo como uma variável e gerenciar seu valor em um único local.

• Variáveis de espaço de trabalho definem valores que aparecem em várias cadeias.
• Variáveis de cadeia definem valores que aparecem em vários comandos de uma cadeia e podem mudar com frequência.
• Variáveis dinâmicas definem valores a serem definidos quando uma cadeia é executada ou durante a execução de uma cadeia, como, por exemplo, com base na saída de um comando anterior.

Treinamento adicional disponível
Você pode aprender sobre o poder das cadeias com nosso curso individualizado no Workiva Learning Hub. Este curso abrangente o orienta no processo de criação de uma cadeia do início ao fim, proporcionando experiência prática e um profundo conhecimento da plataforma Construtor de Cadeia.

Visite o Centro de Aprendizagem Workiva

Gerenciar as variáveis do seu espaço de trabalho

No seu espaço de trabalho, você pode definir as variáveis usadas por várias cadeias:

1. Em Chain Builder, selecione Settings no canto superior esquerdo.
2. À direita de Variables, clique em Add.
   
3. Para ajudar a identificar a variável, digite o nome e, se necessário, o valor padrão e a descrição. Esses valores padrão podem ser personalizados posteriormente para cadeias individuais.
4. Para aumentar a segurança, selecione Encrypt - isso ocultará todos os valores confidenciais, como senhas.
5. Clique em Salvar.

Depois de adicionar uma variável ao seu espaço de trabalho, você pode editar seu nome, valor ou criptografia conforme necessário. Para remover uma variável do espaço de trabalho, clique em Excluir.

Gerenciar as variáveis de uma cadeia

Para valores que aparecem em vários comandos de uma cadeia e mudam com frequência, adicione-os como variáveis da cadeia. Não há limite rígido para o número de variáveis em uma cadeia, mas a capacidade de resposta degradada é observada quando as cadeias se aproximam de 1.000 variáveis.

1. Na cadeia, clique em Configurações da cadeia. 
2. Em Variables, clique em Add.
   
3. Digite um nome e uma descrição exclusivos para ajudar a identificar a variável e sua intenção.
4. Digite o valor padrão da variável.
5. Para permitir que somente os administradores visualizem o valor da variável, como no caso de senhas, selecione Encrypt.
6. Clique em Salvar.

Para atualizar uma variável, clique em Edit para a cadeia e ajuste o valor em Variables.

Para remover uma variável de que você não precisa mais, clique em Excluir.

Gerenciar as variáveis dinâmicas de uma cadeia

Para definir valores quando a cadeia for executada ou para basear valores na saída de outro comando, adicione-os como variáveis dinâmicas para a cadeia.

Observação: Para facilitar as execuções consecutivas, as variáveis dinâmicas retêm os valores definidos durante a execução anterior da cadeia.

1. Na cadeia, clique em Configurações da cadeia.
2. Em Dynamic Variables, clique em Add.
3. Digite um nome exclusivo para ajudar a identificar a variável e sua intenção.

   Observação: O campo Initial Value (Valor inicial) não se aplica aqui e deve ser deixado em branco.

4. Clique em Salvar.

Observação: Para definir os valores das variáveis dinâmicas quando uma cadeia começar a ser executada, inicie-a com a Runtime Inputs trigger event. Para pausar uma cadeia para definir o valor de uma variável dinâmica antes de prosseguir para a próxima etapa, adicione a Set Dynamic Chain Variables event.

Para remover uma variável de que você não precisa mais, clique em Delete.

Usar variáveis como entradas de comando

Para usar variáveis como entradas baseadas em texto para um comando:

1. Na cadeia, selecione o comando que usará as variáveis.
2. Na entrada baseada em texto para usar uma variável, clique em Variable e selecione a variável.

   Observação: Para concatenar várias variáveis em uma entrada, selecione as variáveis a serem usadas e insira o texto que deve aparecer antes ou depois de cada uma.

3. Clique em Salvar.

   Observação: Para modificar ou formatar uma variável para uso como entrada de comando, aplique uma transformação de variável .

Variáveis de tempo de execução

Para incluir dados relacionados a quando uma cadeia é executada, você pode usar diversas variáveis de tempo de execução.