Centro de soporte de Workiva

Para facilitar su utilización como entradas de comandos dentro de una cadena, puedes aplicar transformaciones a una variable o a la salida de un comando. Puedes aplicar varias transformaciones a la entrada de un comando, por ejemplo para transformar aún más sus datos o el resultado de su transformación.

Transformaciones

Nota: Cuando utilizas un resultado JSON como propiedad de otro comando, puedes Seleccionar un elemento concreto del resultado desde el XML (.xml) en lugar de su cadena JSON completa. Si seleccionas un elemento en lugar de la cadena completa, aplica la transformación Obtener valor de JSON para convertir su tipo de datos.

Parsear texto como JSON

Para convertir una variable de texto o de salida a JSON, aplica la transformación Parse Text as JSON:

1. En la cadena, selecciona el nodo del comando con la entrada a transformar y haz clic en Editar crear.
2. Debajo de Propiedades del comando, haz clic en la variable o salida que quieras transformar.
3. Selecciona Analizar texto como JSON, y haz clic en Añadir añadir.

   Nota: Para recuperar también un elemento desde el JSON, selecciona Obtener valor del JSON y haz clic en Añadir añadir para aplicar una transformación adicional.

4. Haz clic en Aceptar.

Actualiza las mayúsculas de una cadena de caracteres

Para convertir una variable o salida de cadena de texto a todo mayúsculas o minúsculas, aplica la transformación Mayúsculas o Minúsculas:

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

1. En la cadena, selecciona el comando con la entrada a transformar y, en Propiedades del comando, haz clic en la variable o salida a transformar.
<!--
2. Select whether to convert the string to Uppercase or Lowercase, and click Add&nbsp;&nbsp;add.
-->
3. Selecciona la transformación para aplicarla:
   • Para poner en mayúsculas la primera letra de cada palabra de la cadena, selecciona Poner título.
   • Para convertir todos los caracteres de la cadena a mayúsculas, selecciona Mayúsculas.
   • Para convertir todos los caracteres de la cadena a minúsculas, selecciona Minúsculas.

   Nota: Para transformar la cadena, selecciona la transformación adicional a aplicar y haz clic en Añadir Añadir.

4. Haz clic en Aceptar.

Añade o elimina los espacios finales o iniciales de una cadena.

Para añadir/agregar espacios al principio o al final de una variable de cadena de texto o de un Resultado, aplica una transformación Pad o Trim:

1. En la cadena, selecciona el comando con la entrada a transformar y, en Propiedades del comando, haz clic en la variable o salida a transformar.
2. Selecciona la transformación a aplicar y haz clic en Añadir añadir:
   • Para añadir espacios a la izquierda al principio de la cadena, selecciona Rellenar a la izquierda e introduce la longitud total de la cadena.
   • Para añadir espacios finales al final de la cadena, selecciona Espaciado a la derecha e introduce la longitud total de la cadena.
   • Para eliminar los espacios a la izquierda desde el principio de la cadena, selecciona Recortar Prefijo.
   • Para eliminar los espacios finales desde el final de la cadena, selecciona Recortar sufijo.
   • Para eliminar espacios tanto del principio como del final de la cadena, selecciona Recortar.

   Nota: Para transformar el Resultado de cadena, selecciona la transformación adicional a aplicar y haz clic en Añadir Añadir.

3. Selecciona Aceptar.

Dividir una cadena

Para dividir una variable o salida de cadena de texto en función del valor de un delimitador, aplica la transformación Dividir:

1. En la cadena, selecciona el comando con la entrada a transformar y, en Propiedades del comando, haz clic en la variable o salida a transformar.
2. Selecciona Dividir y haz clic en Añadir añadir.
3. En Delimitador, introduce el valor del texto en el que dividir la cadena.

   Nota: Para transformar el Resultado de cadena, selecciona la transformación adicional a aplicar y haz clic en Añadir Añadir.

4. Selecciona Aceptar.

Reemplazar un valor en una cadena de caracteres

Para reemplazar un valor dentro de una variable de texto o de salida por otro valor, aplica la transformación Reemplazar:

1. En la cadena, selecciona el comando con la entrada a transformar y, en Propiedades del comando, haz clic en la variable o salida a transformar.
2. Selecciona Reemplazar y haz clic en Añadir añadir.
3. En Buscar, introduce los criterios del valor a reemplazar en la cadena como el texto exacto a coincidir o una expresión regular.
4. En Reemplazando, introduce el valor para reemplazar el texto que coincida con los criterios de Buscando en.
5. En Tipo de coincidencia, selecciona si deseas buscar los criterios de Buscar en mediante una coincidencia exacta o una expresión regular (RegEx).

   Nota: Para transformar el Resultado de cadena, selecciona la transformación adicional a aplicar y haz clic en Añadir Añadir.

6. Haz clic en Aceptar.

Sumar, restar, multiplicar, dividir o redondear números

Para realizar una operación matemática sobre un valor numérico, aplica una transformación Añadir, Restar, Multiplicar, Dividir, o Redondear.

Consejo: Para realizar una operación matemática sobre un valor de cadena numérico, aplica primero una transformación Parse number.

• Para una transformación Añadir o Restar, introduce en cuánto aumentar o disminuir el número.
• Para una transformación Multiplicar o Dividir, introduce por cuánto multiplicar o dividir el número.
• Para una transformación Redondear, introduce a cuántos espacios decimales hay que redondear el número.

Analiza una fecha o una fecha y hora como una cadena de caracteres.

Para convertir una variable o un resultado de fecha o de hora a un formato y una zona horaria concretos, aplica la transformación Parse Date/Time:

1. En la cadena, selecciona el comando con la entrada a transformar y, en Propiedades del comando, haz clic en la variable o salida a transformar.
2. Selecciona Parse Date/Time, y haz clic en Añadir Añadir.
3. Selecciona si quieres utilizar la norma de la Organización Internacional de Normalización (ISO) o un formato personalizado con la fecha o la hora.
4. Introduce cómo dar formato a valores de fecha u hora utilizando strftime formatos y separadores como ., ,, :, o /. Por ejemplo, %m-%d-%Y para 01-30-2020, o %H:%M para 21:08.
5. Para cambiar la zona horaria de la fecha o la hora, selecciona las zonas horarias de los valores de entrada y salida.

   Nota: Para transformar el Resultado de cadena, selecciona la transformación adicional a aplicar y haz clic en Añadir Añadir.

6. Haz clic en Aceptar.

Sumar o restar una fecha o marca de tiempo

Para añadir o restar un valor de intervalo a o desde una variable o salida de fecha o marca de tiempo, aplica la transformación Añadir/Sustraer Fecha y hora:

1. En la cadena, selecciona el comando con la entrada a transformar y, en Propiedades del comando, haz clic en la variable o salida a transformar.
2. Selecciona Añadir/agregar fecha y hora, y haz clic en Añadir añade.
3. Selecciona si quieres utilizar la norma de la Organización Internacional de Normalización (ISO) o un formato personalizado.
4. Para Operación, selecciona si quieres sumar o restar la marca de tiempo.
5. Introduce el incremento a añadir o restar de la Marca de tiempo, como 1 Día.

   Nota: Para cambiar el formato de la marca de tiempo, selecciona Analizar fecha/hora y haz clic en Añadir añadir para aplicar una transformación adicional.

6. Haz clic en Aceptar.

Ordenar elementos en una lista.

Para ordenar los elementos de una variable de lista o Resultado en orden ascendente o descendente, aplica la transformación Ordenar por lista:

1. En la cadena, selecciona el comando con la entrada a transformar y, en Propiedades del comando, haz clic en la variable o salida a transformar.
2. Selecciona Ordenar lista y haz clic en Añadir Añadir a.
3. Selecciona si quieres ordenar la lista en orden Ascendente o Descendente.

   Nota: Para elegir un elemento de cadena de la lista, selecciona Elegir de la lista y haz clic en Añadir añadir para aplicar una transformación adicional.

4. Haz clic en Aceptar.

Elige elementos de una lista

Para extraer un elemento individual de una variable o Resultado de una lista, aplica la transformación Recoger de la lista:

1. En la cadena, selecciona el comando con la entrada a transformar y, en Propiedades del comando, haz clic en la variable o salida a transformar.
2. Selecciona Elegir de la lista y haz clic en Añadir Añadir.
3. Para Valor, introduce el número de índice del elemento a elegir; 0 para el primer elemento, -1 para el último.

   Nota: Para transformar el elemento cadena, selecciona la transformación adicional a aplicar y haz clic en Añadir añadir.

4. Haz clic en Aceptar.

Obtener valores desde JSON

Para convertir un elemento individual desde una variable o un resultado JSON a una cadena, lista o JSON, aplica la transformación Obtener valor desde JSON. Al utilizar la transformación. los elementos de una lista dentro del JSON utilizan un índice basado en cero, donde el primer valor tiene un índice de 0.

Nota: Para determinar el índice y el nombre del elemento a analizar con la transformación, haz clic en Monitor flight_takeoff, y visualiza el resultado JSON del comando.

1. En la cadena, selecciona el comando con la entrada a transformar y, en Propiedades del comando, haz clic en la variable o salida a transformar.
2. Selecciona Obtener valor de JSON, y haz clic en Añadir añadir. 
   
3. Selecciona si deseas mostrar el elemento como una cadena de texto título, lista lista, o JSON código.
4. Para Valor, introduce:
   • Si el JSON incluye varios objetos, el índice del objeto a extraer, empezando por 0. Por ejemplo, para el segundo objeto, introduce 1.

     Nota: Introduce el índice solo si el JSON incluye varios objetos.

   • El nombre del elemento a elegir, como id.

   Nota: Para transformar el resultado de la transformación como, por ejemplo, para dar formato a una cadena de fecha u ordenar una lista, selecciona la transformación adicional que quieras aplicar y haz clic en Añadir Añadir.

5. Haz clic en Aceptar.