Centro de soporte de Workiva

En esta ruta de aprendizaje conectada, crearemos una cadena que ilustra cómo contabilizar dinámicamente un año bisiesto.

Paso 1: Crear una cadena

• Desde el módulo Cadenas dentro de su espacio de trabajo, seleccione el entorno DEV
• Agregar una nueva Cadena
  • Nombra la cadena, CLP | Transformación de variable | Análisis de fecha y hora.
  • Añadir descripción: La plantilla Cadena de Rutas de Aprendizaje Conectadas 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 de Variables para reformatear fechas y calcular la clave del período final, a la vez que tiene en cuenta dinámicamente los años bisiestos.
• Salva la cadena

Paso 2: Agregar una entrada de tiempo de ejecución

Entradas de tiempo de ejecución ilustran cómo una cadena puede solicitar valores durante la ejecución. Esta es una forma valiosa de hacer que las cadenas se puedan usar en múltiples procesos.

• Crear el comando
  • Agregue una entrada de tiempo de ejecución al nodo Inicio
    Utilice la barra de búsqueda para buscar "tiempo de ejecución". Luego, haga doble clic para cargar automáticamente el comando en el círculo de Inicio.
  • Haga clic en Agregar entrada y seleccione Campo desplegable.
  • Configure DropdownField con lo siguiente:
    

    Mostrar nombre	Mes
    Obligatorio	Comprobado
    Descripción	Seleccione el mes actual

  • Haga clic en Agregar opción
  • Configurar con la opción con lo siguiente:
    

    Valor	{"display":"Enero","value":"01-01"}
    Mostrar nombre	Enero
    Por defecto	No marcado

• Complete el campo desplegable
  • Añadir opciones para los once meses restantes del año. Actualice el valor y los nombres para mostrar según corresponda
    • Ejemplo: {"display":"Febrero","valor":"02-01"}
• Agregar una entrada de tiempo de ejecución NumberField
  • Después de completar la entrada del campo desplegable, agregue una entrada NumberField
  • Configure el NumberField con lo siguiente:
    

    Mostrar nombre	Año
    Obligatorio	Comprobado
    Descripción	Ingrese el año actual en formato AAAA
    Valor predeterminado	<dejar en blanco&gt
    Valor mínimo (marcado)	2000
    Valor máximo (marcado)	2050

• Guardar la entrada de tiempo de ejecución

Paso 3: Agregar un comando para crear una clave de período

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

• Agregue un comando Render Text Template desde el conector Handlebars a la cadena
• Conecte el nodo de inicio (entradas de tiempo de ejecución) al comando Render Text Template
• Editar el comando
  • Nombre del comando: Renderizar plantilla de texto - Crear clave de período
  • En el parámetro Plantilla, ingrese lo siguiente:
    

    {{Año}}-{{Periodo}}

  • En la sección Variables, agregue dos variables haciendo clic en el botón Agregar dos veces 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 Variable, expanda Disparador ➡ Tiempo de ejecución Entradas y seleccione Año
  • En la segunda variable, especifique el nombre como Periodo
  • Haga clic en el campo Valor
    • En el panel Variable, expanda Trigger ➡ Entradas de tiempo de ejecución y seleccione Mes
    • Haga clic en la variable Mes (como lo indica la burbuja) que se asignó al valor
    • Haga clic en el menú desplegable Seleccionar transformación
      • Seleccionar Analizar texto como JSON
      • Haga clic en el símbolo más (+)
      • Haga clic nuevamente en el menú desplegable Seleccionar transformación
        • Seleccione Obtener valor de JSON
        • Haga clic en el símbolo más
      • En Obtener valor de JSON,
        • En el menú desplegable de la columna Salida, seleccione "T"
          • Nota: La T es la variable mes que se estableció en el paso anterior
        • En el campo de la columna Valor, ingrese "valor" y presione la tecla Enter
          • Nota: El valor del texto debe estar en minúsculas y aparecerá como una burbuja gris después de presionar la tecla Enter.
      • Haga clic en Aceptar
• Guardar el comando

Paso 4: Agregar un comando para realizar operaciones de fecha

Usamos el conector Handlebars para realizar varias operaciones de fecha, incluidos cálculos de fechas y reformateo.

• Agregue un comando Render Text Template desde el conector Handlebars a la cadena
• Conecte el comando Plantilla de texto de renderizado - Crear clave de período al comando Plantilla de texto de renderizado
• Editar el comando
  • Nombre del comando: Renderizar plantilla de texto - Análisis de fecha
  • En el parámetro Plantilla , ingrese lo siguiente:

Periodo de tiempo seleccionado:

Mes: {{Month_Name}}

Año:

Clave de período: {{Period_Key}}

Clave del período de fin de mes: {{EOM_Key}}

• • En la sección de parámetros de plantilla
    • Haga clic después del año
    • Luego expanda Trigger ➡ Runtime Inputs y seleccione Año

Paso 5: Sección de variables

• Agregue tres variables haciendo clic en el botón Agregar 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 Variable, expanda Disparador ➡ Entradas de tiempo de ejecución y seleccione Mes
      • Haga clic en la burbuja de la variable Mes en el campo Valor
        • Haga clic en el menú desplegable Seleccionar transformación
          • Seleccione Analizar texto como JSONy haga clic en el símbolo más (+)
        • Haga clic nuevamente en el menú desplegable Seleccionar transformación
          • Seleccione Obtener valor de JSONy haga clic en el símbolo más (+)
            • En la línea Obtener valor de JSON, seleccione T en el menú desplegable Salida
            • En la misma línea Obtener valor de JSON, ingrese display en el campo Valor y presione la tecla Enter
            • Haga clic en Aceptar

• Para la segunda variable:
  • Especifique el nombre de la variable como Period_Key
    • Haga clic en el campo Valor
      • En el panel Variable, expanda Plantilla de texto de representación - Crear clave de período
        • Seleccionar Texto renderizado
    • Haga clic en la burbuja de la variable Texto representado en el campo Valor
      • Haga clic en el menú desplegable Seleccionar transformación y seleccione Analizar fecha/hora, y haga clic en el botón más (+).
      • En el primer cuadro desplegable, ingrese %Y-%m-%d y asegúrese de presionar Enter
      • En el campo Formato de fecha de salida, ingrese %m/%d/%Y
      • En el menú desplegable de zona horaria de fecha de entrada, escriba UTC y luego seleccione la zona horaria (UTC) Dublín, Edimburgo, Lisboa, Londres
      • Repita la selección de UTC para el campo de zona horaria de fecha de salida
      • Haga clic en Aceptar

• Para la tercera variable:
  • Especifique el nombre de la variable como EOM_Key
    • Haga clic en el campo Valor. En el panel Variable, expanda Plantilla de texto renderizado - Crear clave de período y seleccione Texto renderizado
    • Haga clic en la variable Texto representado que se asignó al valor
      • Haga clic en el menú desplegable Seleccionar transformación y seleccione Agregar/Restar fecha y hora, y haga clic en el símbolo más (+).
        • En el cuadro desplegable Formato, ingrese %Y-%m-%d y asegúrese de presionar Enter
        • En el menú desplegable Operación, seleccione Agregar
        • En el campo Monto, ingrese 1
        • En el menú desplegable Unidad, seleccione Mes
      • Agregar una transformación adicional Agregar/Restar fecha y hora
        • En el cuadro desplegable Formato, ingrese %Y-%m-%d y asegúrese de presionar Enter
        • En el menú desplegable Operación, seleccione Restar
        • En el campo Monto, ingrese 1
        • En el menú desplegable Unidad, seleccione Día
      • Campo de zona horaria y fecha de salida
      • Haga clic en Aceptar
• Guardar el comando

Paso 6: Pruebe la cadena

Ahora que la cadena está completa, podemos probar el resultado.

• Publicar la Cadena
• Haga clic en Ejecutar y luego seleccione Ejecutar con entradas
• En el menú desplegable Mes , seleccione Febrero. En la entrada Año, ingrese 2024
• Haz clic en Iniciar. Revise los resultados de la Cadena en la pestaña Registro del comando Plantilla de texto de renderizado - Crear clave de período
  • Verifique la clave Fin del período de mes , es decir, un año bisiesto

• Ejecute la cadena nuevamente usando febrero pero ingrese 2025 para el año de esta ejecución
  • Confirme que el mes terminó en el día correcto, es decir, no en un año bisiesto.

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!