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 da cadeia de caracteres JSON completa. Se você selecionar um elemento em vez da cadeia completa, aplique a transformação Get Value from JSON para converter seu tipo de dados.

Analisar texto como JSON

Para converter uma variável de texto ou saída 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 Analisar texto como JSON e clique em Adicionar adicionar.

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

4. Clique em Aceitar.

Atualizar a capitalização de uma cadeia de caracteres

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 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 em maiúscula em cada palavra da cadeia de caracteres, selecione Titleize.
   • Para converter os caracteres da cadeia em todas as letras maiúsculas, selecione Maiúsculas ou Capitalizar.
   • Para converter os caracteres da cadeia de caracteres em todas as letras minúsculas, selecione Minúsculas.

   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 à direita ou à esquerda em uma string

Para adicionar ou remover espaços do início ou do fim de uma variável ou saída de cadeia 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 Preencher à esquerda e digite o comprimento total da cadeia.
   • Para adicionar espaços finais ao fim da cadeia, selecione Preencher à direita e digite o comprimento total da cadeia.
   • Para remover espaços à esquerda do início da cadeia, selecione Aparar prefixo.
   • Para remover espaços no final da cadeia de caracteres, selecione Aparar sufixo.
   • Para remover espaços do início e do fim da cadeia de caracteres, selecione Aparar.

   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 Aceitar.

Dividir uma cadeia de caracteres

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 Delimitador, digite o valor de texto no qual você deseja dividir a cadeia de caracteres.

   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 Aceitar.

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, digite os critérios do valor a ser substituído na cadeia de caracteres como o texto exato a ser correspondido ou uma expressão regular.
4. Em Replacement, digite o valor para substituir o texto que corresponde aos critérios de Find.
5. Em Match Type, selecione se você 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.

Você pode 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 realizar uma operação matemática em um valor numérico de cadeia de caracteres, primeiro aplique uma transformação Parse number.

• Para uma transformação Add ou Subtract, digite por quanto você quer aumentar ou diminuir o número.
• Para uma transformação Multiply ou Divide, digite por quanto você deve multiplicar ou dividir o número.
• Para uma transformação Round, digite quantas casas decimais você deve arredondar o número.

Analisar uma data ou um carimbo de data/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 você deseja usar o padrão ISO (International Organization for Standardization) ou um formato personalizado com a data ou o carimbo de data/hora.
4. Informe 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 carimbo de data/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 um carimbo de data/hora

Para adicionar ou subtrair um valor de intervalo de ou para uma variável ou saída de data ou carimbo de data/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 você quer usar o formato padrão da International Organization for Standardization (ISO) ou um formato personalizado.
4. Para Operação, selecione se você 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.

Ordenar 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 saída a ser transformada.
2. Selecione Sort List e clique em Add add.
3. Selecione se você deseja classificar a lista em ordem crescente ou decrescente.

   Observação: Para escolher um elemento de cadeia de caracteres da lista, selecione Pick from List (Escolher 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 ou saída de lista, 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 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_takeoff e visualize 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 você deseja gerar o elemento como uma cadeia de texto title, list 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.