CLP - Transformación del manillar – Centro de asistencia

En esta Ruta de aprendizaje conectada, crearemos una Cadena que ilustra cómo aprovechar el Conector Handlebars para analizar datos de una respuesta HTTP y planificar variables que pueden utilizarse en toda una Cadena.

Objetivo principal de aprendizaje	Capacidades de comando de asas
Objetivos de aprendizaje secundarios	Conector Cadenas Workiva
Requisitos previos	Configurar la conexión Conector de manillares. Configurar la conexión Conector Cadenas Workiva.
Plantilla de ayuda	CLP \| Configuración de asas

Paso 1: Crea una Cadena

Añadir una nueva Cadena .
Nombra la Cadena CLP | Configuración del Manillar.
Crea una variable Cadena. Introduce los siguientes valores para el nombre de variable y el valor:
- Nombre de la variable: cv-AllStations
- Valor de la variable: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/station_information.json
Guarda la cadena.

Etapa 2: Recuperar datos JSON

Esta etapa utiliza el Conector HTTP para recuperar datos relacionados con Citibike en formato JSON desde una ubicación web.

Añade un comando GET desde el conector HTTP al nodo Iniciar.

Configura el comando utilizando los siguientes valores:

Nombre	GET - Todas las estaciones
Nombre de usuario	<leave>
Contraseña	<leave>
Certificado CA	<leave>
Certificado	<leave>
Certificado Clave Privada	<leave>
Mostrar respuesta	Comprobado
URL	cv-AllStations Variable en cadena
Cadena de consulta	<leave>
Tipo de contenido	aplicación/json
Respuesta	<leave>

Guarda el comando.

Etapa 3: Iterar a través de los datos JSON

Utiliza el comando Manillar - Plantilla de texto representado para iterar a través de los datos de la estación CitiBike y obtener un formato que proporcione datos combinados de cada una de las estaciones.

Añade el comando Manillares - Representar plantilla de texto al lienzo Cadena.
Conecta el comando GET - Todas las estaciones al comando Manillares - Plantilla de texto renderizado.
Haz doble clic en el Comando para editarlo.
1. Ponle Nombre al Comando: RTT - Analizar respuesta JSON.
2. Añade un JSON Variable y nómbrala citibikeData.
3. Para el campo Valor utiliza la variable Respuesta del comando Obtener - Todas las estaciones.
4. Rellena el campo de la plantilla con el valor siguiente:
```
{{#each citibikeData.data.stations}} {{@index}} | {{name}} | {{capacity}} {{/each}}
```
  Esto permitirá al comando iterar a través de la respuesta JSON, utilizando una ruta raíz de data.stations para proporcionar valores de texto desde cada clave: ("name", "capacity"). Además, añadirá un valor index por cada fila procesada.
Guarda el comando.

Etapa 4: Plantilla de variables de tiempo de ejecución

Utiliza el comando Manillares - Representar plantilla de texto para modelar variables. Al hacerlo: la Cadena podrá representar una plantilla de texto que proporcione contexto a distintos componentes de la Cadena en función de su tiempo de ejecución.

Añade el comando Manillares - Representar plantilla de texto al lienzo Cadena.
Conecta el comando GET - Todas las estaciones al comando Manillares - Representar plantilla de texto.
Haz doble clic en el Comando para editarlo, utilizando los siguientes valores:
1. Pon nombre al comando: RTT - Plantilla de variables.
2. Añade y rellena la siguiente información para las variables sección:
  Los campos Valor se rellenarán desde el desplegable Tiempo de ejecución del panel izquierdo de variables.
  - Variable 1
    - Nombre de variable: Cadena-Env
    - Valor: <Cadena.Entorno> (Variable en tiempo de ejecución)
  - Variable 2
    - Nombre de variable: Hora-Ejecución-Cadena
    - Valor: <Chain.ExecutionDateTime> (Variable en tiempo de ejecución)
  - Variable 3
    - Nombre de variable: System-RunTime-Mes
    - Valor: <System.DateTime> (Variable en tiempo de ejecución)
      1. Haz clic en la variable en tiempo de ejecución <System.DateTime> para transformar la variable.
      2. En Selecciona la transformación, elige Parse Date/Time, y haz clic en "+".
      3. En el primer campo de valor, elige "ISO Extendida (Norma de plataforma)".
      4. En el campo Formato de fecha de salida, introduce "%m".
      5. En el campo Entrada de fecha zona horaria, elige "UTC (Etc/UTC)".
      6. En el campo Zona horaria de la fecha de salida, elige "UTC (Etc/UTC)".
      7. Haz clic en Aceptar.
  - Variable 4
    - Nombre de variable: System-RunTime-Año
    - Valor: <System.DateTime> (Variable en tiempo de ejecución)
      1. Haz clic en la variable de tiempo de ejecución <System.DateTime> para transformar la variable
      2. En Seleccionar transformación, elige Parse Date/Time, y haz clic en "+".
      3. En el primer campo de valor, elige "ISO Extendida (Norma de plataforma)".
      4. En el campo Formato de fecha de salida, introduce "%Y".
      5. En el campo Entrada de fecha zona horaria, elige "UTC (Etc/UTC)".
      6. En el campo Zona horaria de la fecha de salida, elige "UTC (Etc/UTC)".
      7. Haz clic en Aceptar.
3. Rellena el campo de plantilla con los siguientes valores:
  - Entorno de la cadena: {{Chain-Env}}
  - Fecha de ejecución de la cadena: {{Chain-Exec-Time}}
  - Tiempo de ejecución del sistema Mes-año: {{Hora de ejecución del sistema-Mes}}-{{Hora de ejecución del sistema-Año}}
Guarda el comando.

Paso 5: Plantilla de Variables del Espacio de Trabajo - Obtener Espacios de Trabajo

Utiliza Manillares - Representar Plantilla de Texto para crear plantillas de componentes de un Espacio de trabajo. Esto permitirá a la Cadena representar una plantilla de texto que proporcione contexto desde distintos componentes del Espacio de trabajo en el que se encuentra la Cadena.

Añade el comando Obtener espacios de trabajo desde el conector de Cadenas Workiva al lienzo Cadena.
Conecta el comando GET - Todas las estaciones al comando Obtener espacios de trabajo.
Haz clic dos veces en el comando para editarlo y confirma que la conexión es correcta.
Guarda el comando.

Etapa 6: Variables de la Plantilla del Espacio de Trabajo - RTT - ID del Espacio de Trabajo.

Añade el comando Manillares - Representar plantilla de texto al lienzo Cadena.
Conecta el comando Obtener espacios de trabajo al comando Manillares - Plantilla de texto renderizado.
Haz doble clic en el Comando para editarlo.
- Nombre del comando RTT - WorkspaceID.
- Introduce el siguiente valor en el campo Plantilla:
```
{{#cada espacios de trabajo}} {{#if (igual nombre "<(chain.workspace)>") }} {{id}}{{/if}}{{/cada uno}}
```
Selecciona la variable <Chain.Workspace> de la sección de variables de tiempo de ejecución del panel izquierdo
En el campo Variables JSON, introduce la siguiente información:
- Nombre de variable: espacios de trabajo.
- Valor de la variable:: <Espacios de trabajo>
Despliega la variable Obtener espacios de trabajo desde el panel de variables de la izquierda y selecciona Espacios de trabajo.
Guarda el comando.

Etapa 7: Variables de la Plantilla del Espacio de Trabajo - Obtener Entornos.

Añade el comando Obtener Entornos desde el conector de Cadenas Workiva al lienzo Cadena.
Conecta el comando RTT - WorkspaceID al comando Obtener entornos.
Haz doble clic en el comando para editarlo e introduce la variable Texto renderizado del comando RTT-WorkspaceID en el campo ID del espacio de trabajo.
Guarda el comando.

Etapa 8: Variables de la Plantilla del Espacio de trabajo - RTT - EnvironmentID.

Añade el comando Manillares - Representar plantilla de texto al lienzo Cadena.
Conecta el comando Obtener Entornos al comando Manillares - Representar plantilla de texto.
Haz doble clic en este Comando para editarlo, utilizando los siguientes valores:
1. Nombre del Comando: RTT - EnvironmentID.
2. Introduce el siguiente valor en el campo Plantilla:
```
{{#each entornos}} {{#if (igual nombre "<(chain.environment)>") }} {{id}}{{/if}}{{/each}}
```
  El <Chain.Environment> es una variable Runtime, y se puede encontrar en el panel izquierdo.
3. En el campo Variables JSON, introduce la siguiente información:
  - Nombre de variable: entornos
  - Valor de la variable: <Entornos>
    Este valor se encuentra en el panel izquierdo de variables bajo el comando Obtener Entornos.
4. Guarda el comando.
Etapa 9: Evaluar el ejercicio
1. Publica en la Cadena.
2. Haz clic en Ejecutar, y luego selecciona Ejecutar cadena.
3. Una vez que la Cadena ha completado su ejecución:
  Confirma que todos los nodos se han ejecutado correctamente haciendo clic en el comando ejecutado RTT - Análisis sintáctico de la respuesta JSON y verificando que las primeras líneas del resultado son como sigue:
4. Haz clic en el comando ejecutado RTT - Templatizing Variables, y comprueba que el texto representado es correcto en la pestaña "Registros".
  
  Nota: Estos valores cambiarán en función del Entorno en el que se ejecute la Cadena y de cuándo se ejecute.
5. Haz clic en el nodo RTT - ID de entorno y selecciona la pestaña Resultados.
6. Confirma que se ha rellenado un valor para la variable de texto representada (de nuevo, este resultado variará dependiendo de tu Entorno).
Más información: (en inglés)

Para saber más sobre la transformación de datos mediante Cadenas, consulta Rutas de aprendizaje conectadas - Introducción a la transformación

Soporte técnico

Comunidad

Centro de soporte de Workiva