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: Crea una Cadena

• Desde el Módulo Cadenas dentro de tu Espacio de Trabajo, selecciona el Entorno DEV.
• Añade una nueva cadena
  • Nombra la Cadena, CLP | Transformación de variables | Análisis sintáctico 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 contabilizar los años bisiestos.Esta Plantilla utiliza la Transformación Variable para reformatear las Fechas, así como para calcular la Clave de Finalización del Periodo, teniendo en cuenta dinámicamente los años bisiestos.
• Guardar la cadena

Etapa 2: Añadir una Entrada de tiempo de ejecución

Las Entradas en tiempo de ejecución ilustran cómo una cadena puede pedir valores durante la ejecución. Es una forma valiosa de hacer que las Cadenas puedan utilizarse en varios procesos.

• Crear el comando
  • Agregar una Entrada de tiempo de ejecución al nodo Inicio
    Utiliza la barra de Búsqueda para buscar "tiempo de ejecución". A continuación, haz clic dos veces para cargar automáticamente el comando en el círculo de inicio.
  • Haz clic en Añadir Entrada y selecciona DropdownField.
  • Configura el DropdownField con lo siguiente:
    

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

  • Haz clic en Añadir Opción
  • Configura con la opción con lo siguiente:
    

    Valor	{"visualización": "Enero", "valor": "01-01"}
    Mostrar nombre	Enero
    Por defecto	No está en Comprobado

• Completa el campo desplegable
  • Añade opciones para los once meses restantes del año. Actualiza el Valor y Muestra los Nombres según corresponda.
    • Ejemplo: {"display":"February","value":"02-01"}
• Agrega una entrada en tiempo de ejecución NumberField
  • Después de completar la entrada Campo desplegable, añade un NumberField Entrada
  • Configura el NumberField con lo siguiente:
    

    Mostrar nombre	Año
    Obligatorio	Comprobado
    Descripción	Introduce el año actual en formato AAAA
    Valor predeterminado	<leave>
    Valor mín. (Comprobado)	2000
    Valor máx. (Comprobado)	2050

• Guardando la Entrada de tiempo de ejecución

Etapa 3: Agregar un comando para crear una clave de Periodo

Utilizamos el Conector Handlebars para tomar los valores especificados en las Entradas de tiempo de ejecución y crear una clave de periodo en formato DD/AAAA.

• Añade un comando Renderizar plantilla de texto desde el conector Asas a la cadena
• Conecta el Nodo de Inicio (Entradas de Tiempo de Ejecución) al comando Representar Texto de Plantilla.
• Edita el comando
  • Pon nombre al comando: Representar Texto Plantilla - Crear Clave de Periodo
  • En el parámetro Plantilla, introduce lo siguiente:
    

    {{Year}}-{{Period}}

  • En la sección Variables, añade dos variables haciendo clic en el botón Añadir dos veces en la sección Variables
  • Para la primera variable, especifica el Nombre de la variable como Año
    • Nota: Los nombres de las variables distinguen entre mayúsculas y minúsculas.
  • Haz clic en el campo Valor
    • En el panel Variable, amplía Activar ➡ Entradas en tiempo de ejecución y selecciona Año
  • En la segunda variable, especifica el nombre como Periodo
  • Haz clic en el campo Valor
    • En el panel Variable, amplía Activar ➡ Entradas en tiempo de ejecución y selecciona Mes
    • Haz clic en la variable Meses (como indica la burbuja) que se asignó al valor
    • Haz clic en el desplegable Seleccionar transformación.
      • Selecciona Parsear texto como JSON
      • Haz clic en el símbolo más ( )
      • Vuelve a hacer clic en el desplegable Seleccionar transformación.
        • Selecciona Obtener valor de JSON
        • Haz clic en el símbolo más
      • En el menú Obtener valor desde JSON ,
        • Desde el desplegable de la columna Resultado, selecciona "T".
          • Nota: La T es la variable de mes que se estableció en el paso anterior
        • En el campo de la columna Valor, introduce "valor" y pulsa 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.
      • Haz clic en Aceptar
• Guardar el comando

Etapa 4: Añadir un comando para realizar operaciones con fechas.

Utilizamos el conector Handlebars para realizar varias operaciones con fechas, incluidas las matemáticas y el reformateo de fechas.

• Añade un comando Renderizar plantilla de texto desde el conector Asas a la cadena
• Conecta el comando Renderizar plantilla de texto - Crear clave de periodo al comando Renderizar plantilla de texto
• Edita el comando
  • Nombra el comando: Representar Texto Plantilla - Análisis de Fechas
  • En el parámetro Plantilla, introduce lo siguiente:

Periodo de tiempo seleccionado: 

  Mes: {{Month_Name}}
 

  Año: 
 

  Clave de periodo: {{Period_Key}}
 

  Clave de periodo de fin de mes: {{EOM_Key}}

• • En la sección de parámetros Plantilla...
    • Haz clic después de Año
    • A continuación, expande Disparador ➡ Entradas en tiempo de ejecución y selecciona Año .

Etapa 5: Sección de variables

• Añade tres variables haciendo clic en el botón Añadir de la sección Variables
  • Para la primera variable:
    • Especifica el primer Nombre de variable como Nombre_del_mes
      • Haz clic en el Campo de valor
        • En el panel Variable, expande Disparador ➡ Entradas en tiempo de ejecución y selecciona Meses .
      • Haz clic en la burbuja de la variable Meses en el Campo de valor
        • Haz clic en el desplegable Seleccionar transformación.
          • Selecciona Analizar texto como JSON, y haz clic en el símbolo más ( ).
        • Vuelve a hacer clic en el desplegable Seleccionar transformación.
          • Selecciona Obtener valor desde JSON, y haz clic en el símbolo más ( ).
            • En la línea Obtener valor de JSON, selecciona T en el menú desplegable Resultado
            • En la misma línea Obtener valor de JSON, introduce mostrar en el campo Valor y pulsa la tecla Intro
            • Haz clic en Aceptar

• Para la segunda variable:
  • Especifica el Nombre de la variable como Clave_periodo
    • Haz clic en el campo Valor
      • En el panel Variable, despliega Representar texto Plantilla - Crear clave de Periodo.
        • Selecciona Texto representado .
    • Haz clic en la burbuja de la variable Texto representado en el Campo de valor
      • Haz clic en el desplegable Seleccionar transformación y selecciona Analizar fecha / hora, y haz clic en el botón más ( ).
      • En el primer cuadro desplegable, introduce %Y-%m-%d y asegúrate de pulsar Intro
      • En el campo Formato de fecha del Resultado, introduce %m/%d/%Y.
      • En el desplegable Entrada de fecha zona horaria, escribe UTC y, a continuación, selecciona la zona horaria (UTC) Dublín, Edimburgo, Lisboa, Londres.
      • Repite la selección UTC para el campo Zona horaria de la fecha de Resultado.
      • Haz clic en Aceptar

• Para la tercera variable:
  • Especifica el Nombre de variable como EOM_Key
    • Haz clic en el Campo de valor. En el panel Variable, despliega Renderizar Texto Plantilla - Crear Periodo Clave y selecciona Texto Renderizado.
    • Haz clic en la variable Texto representado que se asignó al valor
      • Haz clic en el desplegable Seleccionar transformación y selecciona Añadir/restar Fecha y hora, y haz clic en el símbolo más ( ).
        • En el cuadro desplegable Formato, introduce %Y-%m-%d y asegúrate de pulsar Intro.
        • En el menú desplegable Operación, selecciona Añadir
        • En el campo Importe, introduce 1
        • En el menú desplegable Unidad, selecciona Mes
      • Añade Añadir/Quitar fecha y Transformación de tiempo adicionales
        • En el cuadro desplegable Formato, introduce %Y-%m-%d y asegúrate de pulsar Intro.
        • En el menú desplegable Operación, selecciona Quitar
        • En el campo Importe, introduce 1
        • En el desplegable Unidad, selecciona Día .
      • Campo Zona horaria de la fecha de salida
      • Haz clic en Aceptar
• Guardar el comando

Etapa 6: Evaluar la cadena

Ahora que la Cadena está completa, podemos Evaluar el resultado.

• Publicar en la Cadena
• Haz clic en Ejecutar y selecciona Ejecutar con entradas
• Desde el desplegable Mes, selecciona Febrero. En la entrada Año, introduce 2024
• Haz clic en Iniciar. Revisa los resultados de la cadena en la pestaña Registro del comando Renderizar plantilla de texto - Crear clave de periodo
  • Verifica el Final del Periodo de Meses Tecla: es decir, un año bisiesto.

• Ejecuta de nuevo la cadena utilizando febrero, pero introduce 2025 para el año de esta ejecución
  • Confirma 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 Rutas de aprendizaje conectadas - Introducción a la transformación.