En esta ruta de aprendizaje conectada, crearemos una cadena que ilustre cómo aprovechar el conector Handlebars para analizar datos de una respuesta HTTP y crear plantillas de variables que se puedan usar en toda una cadena.
Objetivo de aprendizaje principal | Capacidades de comando del manillar |
Objetivos de aprendizaje secundarios | Conector de cadenas Workiva |
Prerrequisitos |
Configurar Conector del manillar Conexión Configurar Conector de cadenas Workiva Conexión |
Plantilla de apoyo | CLP | Configuración del manillar |
Paso 1: Crea una cadena
- Agregar una nueva Cadena
- Nombre de la cadena: CLP | Configuración del manillar
- Crear una variable de cadena
- Nombre: cv-AllStations
- Valor: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/station_information.json
- Salvar la cadena
Paso 2: Recuperar datos JSON
Utilizamos el conector HTTP para recuperar datos relacionados con las bicicletas de la ciudad en formato JSON desde una ubicación web.
- Agregue un comando GET desde el Conector HTTP al nodo Inicio
- Configure el comando con lo siguiente:
Nombre | GET - Todas las estaciones |
Nombre de usuario | <dejar en blanco> |
Contraseña | <dejar en blanco> |
Certificado CA | <dejar en blanco> |
Certificado | <dejar en blanco> |
Clave privada del certificado | <dejar en blanco> |
Mostrar respuesta | Comprobado |
dirección URL|URL | cv-AllStations Variable de cadena |
Cadena de consulta | <dejar en blanco> |
Tipo de contenido | aplicación/json |
Respuesta | <dejar en blanco> |
- Guardar el comando
Paso 3: Iterar a través de los datos JSON
Utilice el comando Manillar - Plantilla de texto de representación para iterar a través de los datos de la estación CitiBike para proporcionar un formato que proporcione los datos de cada estación individual combinados.
- Agregue el comando Handlebars - Render Text Template al lienzo Cadena
- Conecte el comando GET - All Stations al comando Handlebars - Render Text Template
- Haga doble clic en el comando para editarlo
- Nombre del comando: RTT - Análisis de la respuesta JSON
- Agregue una variable JSON y nómbrela “citibikeData”
- Para el campo Valor utilice la variable Respuesta del comando Obtener - Todas las estaciones
- Complete el campo de plantilla con el siguiente valor:
{{#each citibikeData.data.stations}}
{{@index}} | {{nombre}} | {{capacidad}}
{{/each}}
-
-
- Esto permitirá que el comando itere a través de la respuesta JSON, utilizando una ruta raíz de data.stations para proporcionar valores de texto de cada clave: (“nombre”, “capacidad”)
- Además, agregará un valor de índicepara cada fila procesada
- Esto permitirá que el comando itere a través de la respuesta JSON, utilizando una ruta raíz de data.stations para proporcionar valores de texto de cada clave: (“nombre”, “capacidad”)
-
- Guardar el comando
Paso 4: Creación de plantillas para variables de tiempo de ejecución
Utilice la plantilla Handlebars - Render Text para crear plantillas de variables. Esto permitirá al usuario generar una plantilla de texto que proporcione contexto sobre diferentes componentes de la Cadena en función de su tiempo de ejecución.
- Agregue el comando Handlebars - Render Text Template al lienzo Cadena
- Conecte el comando GET - All Stations al comando Handlebars - Render Text Template
- Haga doble clic en el comando para editarlo
- Nombre del comando: RTT - Variables de creación de plantillas
- Agregue y complete la siguiente información para la sección variables :
- Los campos “Valor” se completarán desde el menú desplegable “Tiempo de ejecución” del panel de variables izquierdo
- Variable 1
- Nombre de la variable: Cadena-Env
- Valor: <Cadena.Entorno> (Variable de tiempo de ejecución)
- Variable 2
- Nombre de la variable: Chain-Exec-Time
- Valor: <Chain.ExecutionDateTime> (Variable de tiempo de ejecución)
- Variable 3
- Nombre de la variable: System-RunTime-Month
- Valor: <System.DateTime> (Variable de tiempo de ejecución)
- Haga clic en la variable de tiempo de ejecución <System.DateTime> para transformar la variable
- En Seleccionar transformación, elija Analizar fecha/hora
- Haga clic en el “+”
- En el primer campo de valor, seleccione “ISO Extended (Platform Standard)”
- En el campo Formato de fecha de salida, ingrese “%m”
- En el campo de zona horaria de fecha de entrada, seleccione “UTC (Etc/UTC)”
- En el campo Zona horaria de fecha de salida, seleccione “UTC (Etc/UTC)”
- Haga clic en Aceptar
- Variable 4
- Nombre de la variable: “System-RunTime-Year”
- Valor: <System.DateTime> (Variable de tiempo de ejecución)
- Haga clic en la variable de tiempo de ejecución <System.DateTime> para transformar la variable
- En Seleccionar transformación, elija Analizar fecha/hora
- Haga clic en el “+”
- En el primer campo de valor, seleccione “ISO Extended (Platform Standard)”
- En el campo Formato de fecha de salida, ingrese “%Y”
- En el campo Fecha de entrada de zona horaria, seleccione “UTC (Etc/UTC)”
- En el campo Zona horaria de fecha de salida, seleccione “UTC (Etc/UTC)”
- Haga clic en Aceptar
- Complete el campo de plantilla con el siguiente valor
Entorno de cadena: {{Chain-Env}}
Fecha de ejecución de la cadena: {{Chain-Exec-Time}}
Tiempo de ejecución del sistema Mes-año: {{System-RunTime-Month}}-{{System-RunTime-Year}}
- Guardar el comando
Paso 5: Creación de plantillas de variables del espacio de trabajo - Obtener espacios de trabajo
Utilice la plantilla Handlebars - Render Text para crear plantillas de componentes de un espacio de trabajo. Esto permitirá al usuario generar una plantilla de texto que proporcione contexto desde diferentes componentes del espacio de trabajo en el que se encuentra la cadena.
- Agregue el comando Obtener espacios de trabajo desde el conector de cadenas de Workiva al lienzo de la cadena
- Conecte el comando GET - All Stations al comando Get Workspaces
- Haga doble clic en el comando para editarlo
- Verifique nuevamente que la conexión sea correcta
- Guardar el comando
Paso 6: Creación de plantillas para variables del espacio de trabajo - RTT - WorkspaceID
- Agregue el comando Handlebars - Render Text Template al lienzo Cadena
- Conecte el comando Obtener espacios de trabajo al comando Manillar - Plantilla de texto de representación
- Haga doble clic en el comando para editarlo
- Nombre el comando “RTT - WorkspaceID”
- Introduzca el siguiente valor en el campo “Plantilla”:
- Nombre el comando “RTT - WorkspaceID”
{{#cada espacio de trabajo}}
{{#if (igual nombre "<(Chain.Workspace)>") }}
{{id}}{{/if}}{{/each}}
-
- Seleccione el<Chain.Workspace> variable de la sección de variables de tiempo de ejecución en el panel izquierdo
- Agregar una variable JSON
- Complete la siguiente información:
- Nombre: espacios de trabajo
- Valor:<Workspaces>
- Expande la variable Obtener espacios de trabajo desde el panel de variables de la izquierda y selecciona Espacios de trabajo
- Complete la siguiente información:
- Guardar el comando
Paso 7: Creación de plantillas de variables del espacio de trabajo - Obtener entornos
- Agregue el comando Obtener entornos desde el conector de cadenas de Workiva al lienzo de la cadena
- Conecte el comando RTT - WorkspaceID al comando Obtener entornos
- Haga doble clic en el comando para editarlo
- Agregue la variable Texto representado desde el comando RTT-WorkspaceID dentro del campo ID del espacio de trabajo
- Guardar el comando
Paso 8: Creación de plantillas para variables del espacio de trabajo - RTT - EnvironmentID
- Agregue el comando Handlebars - Render Text Template al lienzo Cadena
- Conecte el comando Obtener entornos al comando Handlebars - Renderizar plantilla de texto
- Haga doble clic en el comando para editarlo
- Llámelo “RTT - EnvironmentID”
- Introduzca el siguiente valor en el campo “Plantilla”:
{{#cada entorno}}
{{#if (igual nombre "<(Chain.Environment)>") }}
{{id}}{{/if}}{{/each}}
-
-
- El<Chain.Environment> es una variable de tiempo de ejecución, que se encuentra en el panel izquierdo
- Agregar una variable JSON
- Complete la siguiente información:
- Nombre: entornos
- Valor:<Environments>
- Esto se encuentra en el panel de variables izquierdo bajo el comando Obtener entornos
- Complete la siguiente información:
-
- Guardar el comando
Paso 9: Pruebe el ejercicio
- Publicar la Cadena
- Haga clic en Ejecutar y luego seleccione Ejecutar cadena
- Una vez completada la Cadena:
- Confirmar que todos los nodos se ejecutaron correctamente
- Haga clic en el comando RTT - Análisis de respuesta JSON ejecutado
- Verifique que las primeras líneas de la salida sean las siguientes:
- Haga clic en el comando RTT - Análisis de respuesta JSON ejecutado
- Confirmar que todos los nodos se ejecutaron correctamente
-
-
- Haga clic en el comando RTT - Variables de plantillas ejecutado
- Verifique que el texto representado sea preciso dentro de la pestaña “Registros”
- Haga clic en el comando RTT - Variables de plantillas ejecutado
-
-
-
-
- Estos valores cambiarán según el entorno en el que se ejecute la cadena y cuándo se ejecute.
- Haga clic en el nodo RTT - Identificación del entorno y seleccione la pestaña Salidas
- Confirme que se haya completado un valor para la variable de texto representado (este resultado variará según el entorno del usuario)
-
-
Para obtener más información sobre la transformación de datos mediante cadenas, consulte Rutas de aprendizaje conectadas: Introducción a la transformación!