En esta Ruta de aprendizaje conectada, crearemos una Cadena que ilustra cómo contabilizar dinámicamente un año bisiesto.
Objetivo principal de aprendizaje | Destacar la potencia de la Transformación de Variables para las operaciones con fechas, incluido el análisis sintáctico, el formateo y la realización de operaciones matemáticas |
Objetivos de aprendizaje secundarios | Para destacar el uso de Runtime Inputs, Handlebars, y JSON parsing in Variables |
Requisitos previos | Configurar el conector del manillar |
Plantilla de apoyo | CLP | Transformación de variables |
Paso 1: Crear una cadena
- En el módulo "Cadenas" de su espacio de trabajo, seleccione el entorno DEV
- Añadir una nueva cadena
- Nombre de la cadena, CLP | Transformación de variables | Análisis de fecha y hora.
- Añadir Descripción: La plantilla Cadena de aprendizaje conectada ilustra cómo una Entrada de tiempo de ejecución para el Mes y el Año puede generar dinámicamente varios formatos de clave de período y tener en cuenta los años bisiestos.esta Plantilla utiliza la Transformación Variable para reformatear las fechas y calcular la clave del período final, teniendo en cuenta dinámicamente los años bisiestos.
- Salvar la cadena
Paso 2: Añadir una entrada de tiempo de ejecución
Entradas en tiempo de ejecución ilustra cómo una Cadena puede solicitar valores en la ejecución. Esta es una forma valiosa de hacer que las cadenas puedan utilizarse en múltiples procesos.
- Crear el mando
- Añada una entrada de tiempo de ejecución al nodo Inicio
Utilice la barra de búsqueda para buscar "tiempo de ejecución". A continuación, haz doble clic para cargar automáticamente el comando en el círculo de inicio. - Haga clic en Add Input y seleccione DropdownField.
- Configure el DropdownField con lo siguiente:
Mostrar nombre Mes Requerido Comprobado Descripción Seleccione el mes en curso - Haga clic en Opción Añadir
- Configure con la opción con lo siguiente:
Valor {"display":"January","value":"01-01"} Mostrar nombre Enero Por defecto No comprobado
- Añada una entrada de tiempo de ejecución al nodo Inicio
- Complete el campo desplegable
- Añade opciones para los once meses restantes del año. Actualice el valor y los nombres para mostrar en consecuencia
- Ejemplo: {"display":"February","value":"02-01"}
- Añade opciones para los once meses restantes del año. Actualice el valor y los nombres para mostrar en consecuencia
- Añadir un NumberField Entrada en tiempo de ejecución
- Después de completar la entrada Dropdown Field, añada un NumberField Input
- Configure el NumberField con lo siguiente:
Mostrar nombre Año Requerido Comprobado Descripción Introduzca el año actual en formato AAAA Valor predeterminado <dejar en blanco> Valor mínimo (comprobado) 2000 Valor máximo (Comprobado) 2050
- Guardar la entrada de tiempo de ejecución
Paso 3: Añadir un comando para crear una clave de período
Utilizamos el conector Handlebars para tomar los valores especificados en las entradas de tiempo de ejecución y crear una clave de período en formato AAAA-MM-DD.
- Añada un Render Text Template Comando desde el Manillar Conector a la Cadena
- Conecte el nodo de inicio (entradas de tiempo de ejecución) al comando Renderizar plantilla de texto
- Editar el comando
- Nombre el comando: Renderizar Plantilla de Texto - Crear Clave de Período
- En el parámetro Plantilla, introduzca lo siguiente:
{{Año}}-{Periodo}} - En la sección Variables, añada dos variables haciendo clic dos veces en el botón Añadir en la sección Variables
- Para la primera variable, especifique el Nombre de la variable como Año
- Nota: Los nombres de las variables distinguen entre mayúsculas y minúsculas
- Haga clic en el campo Valor
- En el panel de variables, expanda Trigger ➡ Runtime Inputs y seleccione Year
- En la segunda variable, especifique el nombre como Periodo
- Haga clic en el campo Valor
- En el panel de variables, expanda Trigger ➡ Runtime Inputs y seleccione Mes
- Haga clic en la variable Mes (indicada por la burbuja) a la que se asignó el valor
- Haga clic en el desplegable Seleccione la transformación
- Seleccione Parse text as JSON
- Haga clic en el símbolo más (+)
- Haga clic de nuevo en el desplegable Seleccionar transformación
- Seleccione Obtener valor de JSON
- Haga clic en el símbolo más
- En el campo Obtener valor de JSON ,
- En el desplegable de la columna Salida, seleccione "T".
- Nota: La T es la variable de mes que se estableció en el paso anterior
- En el campo de la columna Valor, introduzca "valor" y pulse la tecla Intro
- Nota: El valor del texto debe estar en minúsculas y aparecerá como una burbuja gris después de pulsar la tecla Intro
- En el desplegable de la columna Salida, seleccione "T".
- Haga clic en Aceptar
- Guardar el comando
Paso 4: Añadir un comando para realizar operaciones con fechas
Utilizamos el conector Handlebars para realizar varias operaciones con fechas, como el cálculo matemático de fechas y el reformateo.
- Añada un comando Render Text Template del conector Handlebars a la cadena
- Conecte el comando Render Text Template - Create Period Key al comando Render Text Template
- Editar el comando
- Nombre del comando: Render Text Template - Date Parsing
- En el parámetro Template , introduzca lo siguiente:
Periodo de tiempo seleccionado
Mes: {{Month_Name}}
Año
Clave de período: {{Period_Key}}
Clave de fin de mes: {{EOM_Key}}
-
- En la sección de parámetros Plantilla
- Clic tras año
- A continuación, expanda Trigger ➡ Entradas en tiempo de ejecución y seleccione Año
- En la sección de parámetros Plantilla
Paso 5: Sección de variables
- Añada tres variables pulsando el botón Añadir en la sección Variables
- Para la primera variable:
- Especifique el primer Nombre de Variable como Month_Name
- Haga clic en el campo Valor
- En el panel de variables, expanda Trigger ➡ Runtime Inputs y seleccione Month
- Haga clic en la burbuja de la variable Mes en el campo Valor
- Haga clic en el desplegable Seleccione la transformación
- Seleccione Parse text as JSON, y haga clic en el símbolo más (+)
- Haga clic de nuevo en el desplegable Seleccionar transformación
- Seleccione Obtener valor de JSON, y haga clic en el símbolo más (+)
- En la línea Obtener valor de JSON, seleccione T en el desplegable Salida
- En la misma línea Get Value from JSON, introduzca display en el campo Value y pulse la tecla Enter
- Haga clic en Aceptar
- Seleccione Obtener valor de JSON, y haga clic en el símbolo más (+)
- Haga clic en el desplegable Seleccione la transformación
- Haga clic en el campo Valor
- Especifique el primer Nombre de Variable como Month_Name
- Para la primera variable:
- Para la segunda variable:
- Especifique el nombre de la variable como Period_Key
- Haga clic en el campo Valor
- En el panel Variable, expanda Render Text Template - Create Period Key
- Seleccione Rendered Text
- En el panel Variable, expanda Render Text Template - Create Period Key
- Haga clic en la burbuja de la variable Rendered Text en el campo Valor
- Haga clic en el menú desplegable Seleccionar transformación y seleccione Parse Date / Time, y haga clic en el botón más (+)
- En el primer cuadro desplegable, introduzca %Y-%m-%d y asegúrese de pulsar Intro
- En el campo Formato de fecha de salida, introduzca %m/%d/%Y
- En el menú desplegable Zona horaria de la fecha de entrada, escriba UTC y seleccione la zona horaria (UTC) de Dublín, Edimburgo, Lisboa, Londres
- Repita la selección UTC para el campo Zona horaria de la fecha de salida
- Haga clic en Aceptar
- Haga clic en el campo Valor
- Especifique el nombre de la variable como Period_Key
- Para la tercera variable:
- Especifique el nombre de la variable como EOM_Key
- Haga clic en el campo Valor. En el panel Variable, expanda Render Text Template - Create Period Key y seleccione Rendered Text
- Haga clic en la variable Rendered Text a la que se asignó el valor
- Haga clic en el menú desplegable Seleccionar transformación y seleccione Añadir / Restar fecha y hora, y haga clic en el símbolo más (+)
- En el cuadro desplegable Formato, introduzca %Y-%m-%d y asegúrese de pulsar Intro
- En el menú desplegable Operación, seleccione Añadir
- En el campo Importe, introduzca 1
- En el menú desplegable Unidad, seleccione Mes
- Añada un adicional Añada / Sustraiga la fecha y la transformación de la hora
- En el cuadro desplegable Formato, introduzca %Y-%m-%d y asegúrese de pulsar Intro
- En el desplegable Operación, seleccione Restar
- En el campo Importe, introduzca 1
- En el menú desplegable Unidad, seleccione Día
- Campo de zona horaria de la fecha de salida
- Haga clic en Aceptar
- Haga clic en el menú desplegable Seleccionar transformación y seleccione Añadir / Restar fecha y hora, y haga clic en el símbolo más (+)
- Especifique el nombre de la variable como EOM_Key
- Guardar el comando
Paso 6: Probar la cadena
Ahora que la cadena está completa, podemos probar el resultado.
- Publicar la cadena
- Haga clic en Ejecutar y, a continuación, seleccione Ejecutar con entradas
- En el menú desplegable Mes , seleccione Febrero. En la entrada Año, introduzca 2024
- Haga clic en Inicio. Revise los resultados de la Cadena en la pestaña Log del comando Render Text Template - Create Period Key
- Verifique el Período de fin de mes Clave es decir un año bisiesto
- Ejecute la Cadena de nuevo usando Febrero pero introduzca 2025 para el Año para esta ejecución
- Confirme que el mes terminó en el día correcto, es decir, que no es un año bisiesto
Para obtener más información sobre la transformación de datos mediante cadenas, consulta Connected Learning Paths - Transformation Introduction