Centro de suporte da Workiva

Para criar uma variável a partir da saída de um comando, use saídas dinâmicas. As saídas dinâmicas são regras para extrair um valor ou uma lista de valores da saída de um comando, por exemplo, para uso posterior na cadeia. Você pode adicionar várias saídas dinâmicas a um comando usando:

• Uma correspondência exata, com base em um texto específico no início ou no final dos valores a serem extraídos
• Expressão regular (regex), para corresponder valores com base em um padrão ou uma sequência específica

Por exemplo, se um comando gerar um arquivo de texto com valores usados com comandos posteriores na cadeia, extraia esses valores por meio de uma saída dinâmica para o comando List File Content do conector File Utils.

Observação: As saídas dinâmicas têm um tamanho máximo de correspondência de cadeia de caracteres de 1024 caracteres. Se a correspondência exceder esse tamanho, nada será retornado.

Teste uma saída dinâmica

Para ajudar a garantir que uma saída dinâmica crie o resultado desejado, teste seus critérios com valores de amostra antes de você criá-la. Por exemplo, você pode testar uma saída dinâmica com dados de números de telefone:

(381) 782-5259 (511) 545-6132 (220) 476-8339 (837) 516-4312 

1. Na cadeia, selecione o comando com a saída a ser extraída e clique em Edit create.
2. Selecione Dynamic Outputs flash_on e clique em Test.
3. Em Value to test, insira o conteúdo de amostra indicativo da saída de comando usada com a saída dinâmica.
4. Digite o regex ou o critério de correspondência exata a ser usado com a saída dinâmica. Por exemplo, para extrair os códigos de área dos números de telefone de amostra:
   • Como Correspondência exata:
     • Em Start e End, insira os parênteses de abertura e fechamento, ( e ), respectivamente.
     • Para incluir os parênteses no valor extraído, selecione Include start e Include End.
   • Como Expressão regular (regex) match:
     • Em Match type, digite a expressão regular \(([0-9]*)\), que corresponde aos dígitos entre parênteses.
     • Em Match result, digite $0 para exibir todo o valor correspondente incluindo os parênteses, ou $1 para exibir somente os dígitos correspondentes sem os parênteses.
5. Clique em Envie e verifique se os resultados correspondem à saída desejada.

Crie uma saída dinâmica com base em uma correspondência exata

1. Na cadeia, selecione o comando com a saída da qual você deseja extrair e clique em Edit create.
2. Selecione Dynamic Outputs flash_on e clique em Add Dynamic Output.
3. Digite um nome exclusivo para ajudar a identificar a saída dinâmica.
4. Em Original output, selecione de qual das saídas do comando você deseja extrair.
5. Em Match type, selecione Exact.
6. Digite o texto que indica o início ou o fim das cadeias a serem extraídas e selecione se o texto correspondente deve ser incluído no valor extraído.
7. Para fazer a correspondência de texto somente em cadeias de caracteres específicas da saída, digite as linhas a serem verificadas.
   • Para incluir um intervalo de linhas, use um traço -, como 1-10 para as linhas de 1 a 10.
   • Para separar linhas ou intervalos, use uma vírgula ,, como 1-10,13 para as linhas de 1 a 10 e a linha 13.
8. Em Output type, selecione se você deseja extrair um único valor ou vários valores.

   Observação: Um tipo de saída Multiple cria uma matriz JSON de até 1.000 itens, que você pode usar com iterações de comandos ou de grupos de comandos.

9. Para considerar a caixa de caracteres ao fazer a correspondência de texto, selecione Maiúsculas e minúsculas.
10. Para cortar o espaço em branco à esquerda ou à direita do texto correspondente, selecione Trim matches.
11. Clique em Salvar.

Você pode criar uma saída dinâmica com base em uma expressão regular

1. Na cadeia, selecione o comando com a saída da qual você deseja extrair e clique em Edit create.
2. Selecione Dynamic Outputs flash_on e clique em Add Dynamic Output.
3. Digite um nome exclusivo para ajudar a identificar a saída dinâmica.
4. Em Original output, selecione de qual das saídas do comando você deseja extrair.
5. Em Match type, selecione Regular Expression (regex) (Expressão regular (regex)).
   
6. Em Match text, digite a sintaxe regex a ser usada para corresponder aos valores a serem extraídos.
7. Em Match result, digite a sintaxe de como exibir o valor correspondente. Por exemplo:
   • Para todo o valor correspondente, digite $0.
   • Para o valor correspondente entre parênteses, digite $1.
8. Para fazer a correspondência de texto somente em cadeias de caracteres específicas da saída, digite as linhas a serem verificadas.
   • Para incluir um intervalo de linhas, use um traço -, como 1-10 para as linhas de 1 a 10.
   • Para separar linhas ou intervalos, use uma vírgula ,, como 1-10, 13 para as linhas de 1 a 10 e linha 13.
9. Em Output type, selecione se você deseja extrair um único valor ou vários valores.

   Observação: Um tipo de saída Multiple cria uma matriz JSON de até 1.000 itens, que você pode usar com iterações de comando ou de grupo de comandos.

10. Clique em Salvar.

Excluir uma saída dinâmica

Para remover uma saída dinâmica de um comando:

1. Na cadeia, selecione o comando com a saída da qual você deseja extrair, clique em Edit create e selecione Dynamic Outputs flash_on.
2. Para remover a saída dinâmica, clique em Delete delete.