Centro de suporte da Workiva

Para facilitar seu uso como entradas de comando em uma cadeia, você pode aplicar transformações a uma variável ou saída de comando. Você pode aplicar várias transformações a uma entrada de comando, por exemplo, para transformar ainda mais seus dados ou a saída de sua transformação.

Transformações

Observação: Quando você usa uma saída JSON como propriedade de outro comando, pode selecionar um elemento específico da saída em vez de sua cadeia JSON completa. Se você selecionar um elemento em vez da string completa, aplique a transformação Get Value from JSON para converter seu tipo de dados.

Analisar texto como JSON

Para converter uma variável ou saída de texto em JSON, aplique a transformação Parse Text as JSON :

1. Na cadeia, selecione o nó do comando com a entrada a ser transformada e clique em Edit  create.
2. Em Command Properties, clique na variável ou na saída a ser transformada.
3. Selecione Parse text as JSON (Analisar texto como JSON) e clique em Add  add.

   Observação: Para também recuperar um elemento do JSON, selecione Get Value from JSON e clique em Add  add para aplicar uma transformação adicional.

4. Clique em Aceitar.

Atualizar a capitalização de uma string

Para converter uma variável ou saída de cadeia de texto em letras maiúsculas ou minúsculas, aplique a transformação Uppercase ou Lowercase :

To title-case a text string variable or output or convert its characters to all uppercase or lower-case:-->

1. Na cadeia, selecione o comando com a entrada a ser transformada e, em Command Properties, clique na variável ou na saída a ser transformada.
<!--
2. Select whether to convert the string to Uppercase or Lowercase, and click Add&nbsp;&nbsp;add.
-->
3. Selecione a transformação a ser aplicada:
   • Para colocar a primeira letra de cada palavra da cadeia em maiúscula, selecione Titleize.
   • Para converter os caracteres da cadeia de caracteres em letras maiúsculas, selecione Maiúsculas ou Capitalizar.
   • Para converter os caracteres da cadeia de caracteres em todas as letras minúsculas, selecione Lowercase.

   Observação: Para transformar a cadeia de caracteres, selecione a transformação adicional a ser aplicada e clique em Adicionar  adicionar.

4. Clique em Aceitar.

Adicionar ou remover espaços à esquerda ou à direita em uma string

Para adicionar ou remover espaços do início ou do fim de uma variável ou saída de string de texto, aplique uma transformação Pad ou Trim :

1. Na cadeia, selecione o comando com a entrada a ser transformada e, em Command Properties, clique na variável ou na saída a ser transformada.
2. Selecione a transformação a ser aplicada e clique em Adicionar  adicionar:
   • Para adicionar espaços à esquerda no início da cadeia, selecione Pad Left e digite o comprimento total da cadeia.
   • Para adicionar espaços finais ao final da cadeia, selecione Pad Right (Preencher à direita) e digite o comprimento total da cadeia.
   • Para remover espaços à esquerda do início da cadeia de caracteres, selecione Trim Prefix (Aparar prefixo).
   • Para remover os espaços finais do final da cadeia de caracteres, selecione Trim Suffix (Aparar sufixo).
   • Para remover espaços do início e do fim da cadeia de caracteres, selecione Trim.

   Observação: Para transformar a saída da cadeia de caracteres, selecione a transformação adicional a ser aplicada e clique em Adicionar  adicionar.

3. Selecione Aceite.

Dividir uma string

Para dividir uma variável ou saída de cadeia de texto com base em um valor delimitador, aplique a transformação Split:

1. Na cadeia, selecione o comando com a entrada a ser transformada e, em Command Properties, clique na variável ou na saída a ser transformada.
2. Selecione Split e clique em Add  add.
3. Para Delimiter, digite o valor de texto no qual a cadeia de caracteres será dividida.

   Observação: Para transformar a saída da cadeia de caracteres, selecione a transformação adicional a ser aplicada e clique em Adicionar  adicionar.

4. Selecione Aceite.

Substituir um valor em uma string

Para substituir um valor em uma variável de texto ou saída por outro valor, aplique a transformação Replace :

1. Na cadeia, selecione o comando com a entrada a ser transformada e, em Command Properties, clique na variável ou na saída a ser transformada.
2. Selecione Replace (Substituir) e clique em Add  add.
3. Em Find, insira os critérios do valor a ser substituído na string como o texto exato a ser correspondido ou uma expressão regular.
4. Em Replacement(Substituição), digite o valor para substituir o texto que corresponde aos critérios de Find (Localizar ).
5. Em Match Type, selecione se deseja pesquisar os critérios Find por meio de uma correspondência exata ou expressão regular (RegEx).

   Observação: Para transformar a saída da cadeia de caracteres, selecione a transformação adicional a ser aplicada e clique em Adicionar  adicionar.

6. Clique em Aceitar.

Adicionar, subtrair, multiplicar, dividir ou arredondar números

Para realizar uma operação matemática em um valor numérico, aplique uma transformação Add, Subtract, Multiply, Divide, ou Round .

Dica: Para executar uma operação matemática em um valor de cadeia numérica, primeiro aplique uma transformação Parse number .

• Para uma transformação Add ou Subtract , digite o valor do aumento ou da redução do número.
• Para uma transformação Multiply ou Divide , digite por quanto multiplicar ou dividir o número.
• Para uma transformação Round , digite quantas casas decimais serão usadas para arredondar o número.

Analisar uma data ou um registro de data e hora como uma cadeia de caracteres

Para converter uma variável ou saída de data ou carimbo de data/hora em um formato e fuso horário específicos, aplique a transformação Parse Date/Time :

1. Na cadeia, selecione o comando com a entrada a ser transformada e, em Command Properties, clique na variável ou na saída a ser transformada.
2. Selecione Parse Date/Time (Analisar data/hora) e clique em Add  add.
3. Selecione se deseja usar o padrão da International Organization for Standardization (ISO) ou um formato personalizado com a data ou o carimbo de data/hora.
4. Digite como formatar valores de data ou hora usando strftime formats e separadores como ., ,, :, ou /. Por exemplo, %m-%d-%Y para 01-30-2020, ou %H:%M para 21:08.
5. Para alterar o fuso horário da data ou do registro de data e hora, selecione os fusos horários para os valores de entrada e saída.

   Observação: Para transformar a saída da cadeia de caracteres, selecione a transformação adicional a ser aplicada e clique em Adicionar  adicionar.

6. Clique em Aceitar.

Adicionar ou subtrair uma data ou carimbo de data/hora

Para adicionar ou subtrair um valor de intervalo de ou para uma variável ou saída de data ou registro de data e hora, aplique a transformação Add/Subtract Date and Time :

1. Na cadeia, selecione o comando com a entrada a ser transformada e, em Command Properties, clique na variável ou na saída a ser transformada.
2. Selecione Add/Subtract Date and Time (Adicionar/Subtrair data e hora) e clique em Add  add.
3. Selecione se deseja usar o padrão da International Organization for Standardization (ISO) ou um formato personalizado.
4. Para Operation, selecione se deseja adicionar ou subtrair o carimbo de data/hora.
5. Digite o incremento a ser adicionado ou subtraído do registro de data e hora, como 1 dia.

   Observação: Para alterar o formato do carimbo de data/hora, selecione Parse Date/Time (Analisar data/hora) e clique em Add  add para aplicar uma transformação adicional.

6. Clique em Aceitar.

Classificar itens em uma lista

Para classificar os itens em uma variável de lista ou saída em ordem crescente ou decrescente, aplique a transformação Sort List :

1. Na cadeia, selecione o comando com a entrada a ser transformada e, em Command Properties, clique na variável ou na saída a ser transformada.
2. Selecione Sort List e clique em Add  add.
3. Selecione se deseja classificar a lista em ordem crescente ou decrescente.

   Observação: Para selecionar um elemento de cadeia de caracteres da lista, selecione Pick from List (Selecionar da lista) e clique em Add  add para aplicar uma transformação adicional.

4. Clique em Aceitar.

Selecionar elementos de uma lista

Para extrair um elemento individual de uma variável de lista ou saída, aplique a transformação Pick from List :

1. Na cadeia, selecione o comando com a entrada a ser transformada e, em Command Properties, clique na variável ou na saída a ser transformada.
2. Selecione Pick from List e clique em Add  add.
3. Para Value, digite o número de índice do elemento a ser selecionado; 0 para o primeiro elemento, -1 para o último.

   Observação: Para transformar o elemento de cadeia de caracteres, selecione a transformação adicional a ser aplicada e clique em Adicionar  adicionar.

4. Clique em Aceitar.

Obter valores de JSON

Para converter um elemento individual de uma variável ou saída JSON em uma cadeia de caracteres, lista ou JSON, aplique a transformação Get Value from JSON . Ao usar a transformação, os elementos em uma lista dentro do JSON usam um índice baseado em zero, em que o primeiro valor tem um índice de 0.

Observação: Para determinar o índice e o nome do elemento a ser analisado com a transformação, clique em Monitor  flight_takeoffe veja a saída JSON do comando.

1. Na cadeia, selecione o comando com a entrada a ser transformada e, em Command Properties, clique na variável ou na saída a ser transformada.
2. Selecione Get Value from JSON e clique em Add  add. 
    
3. Selecione se deseja gerar o elemento como uma cadeia de texto title, lista list, ou JSON code.
4. Para Value, digite:
   • Se o JSON incluir vários objetos , o índice do objeto a ser extraído, começando com 0. Por exemplo, para o segundo objeto , digite 1.

     Observação: Digite o índice somente se o JSON incluir vários objetos.

   • O nome do elemento a ser selecionado, como id.

   Observação: Para transformar a saída da transformação, por exemplo, para formatar uma cadeia de datas ou classificar uma lista, selecione a transformação adicional a ser aplicada e clique em Adicionar  adicionar.

5. Clique em Aceitar.