Centro de soporte de Workiva

Desde Generador de cadenas, puedes utilizar estas plantillas de cadenas, que juntas simplifican el despliegue de los datos medioambientales, sociales y de gobierno (ASG) o de sostenibilidad:

• 1a. Traspaso de ESG | Principal | Empezar aquí
• 1b. Traspaso de ESG | Actualizar conexiones y estado
• 1c. Traspaso de ESG | Actualizar conexión | Ejecución

Consejo: Aunque crees tres cadenas a partir de estas plantillas, solo ejecutarás la primera cadena creada, que las ejecuta todas automáticamente.

Nota: Estas cadenas solo arrastran hojas de cálculo de recopilación de datos - no a Programa de sostenibilidad. Para saber cómo traspasar valores en un Programa, consulta Traspasar y gestionar los años de informe en el Programa de sostenibilidad.

Cuando ejecutas cadenas creadas a partir de estas plantillas, trabajan juntas para archivar e importar automáticamente el conjunto de datos del año anterior en una tabla. Cuando ejecutas las cadenas, también puedes seleccionar:

• Actualizar las conexiones de la hoja de cálculo de origen antes de importar el conjunto de datos, por ejemplo, para asegurarte de que los valores son los más recientes.
• Borrar los valores en la hoja de cálculo de origen (excepto los vinculados a orígenes o destinos), por ejemplo, para preparar la recopilación de datos del año siguiente.

Nota: Estas cadenas sustituyen automáticamente cualquier conjunto de datos del mismo período en la tabla de Wdata conectada. Si se produce un error al importar el nuevo conjunto de datos, la tabla vuelve al conjunto de datos anterior.

Requisitos previos

Las cadenas creadas a partir de estas plantillas requieren conectores específicos para ejecutar sus comandos.

Antes de crear cadenas a partir de estas plantillas, configura estos conectores en el Generador de cadenas:

• Conector de Workiva
• Conector de cadenas de Workiva
• Conector de transformación de tablas
• Conector JSON
• Conector de asas
• Conector de utilidades de archivo
• Conector de solicitudes HTTP

Nota: Todos los conectores utilizados en las cadenas de estas plantillas utilizan el CloudRunner predeterminado. No se necesitan GroundRunners.

Nota: Para realizar sus comandos, el conector de solicitudes HTTP requiere el ID de cliente y el secreto de la concesión OAuth creada para el usuario de integración del conector de Workiva. Asegúrate de que la concesión OAuth tiene el alcance adecuado.

Paso 1. Configurar los archivos de Workiva

Las Cadenas creadas a partir de estas plantillas requieren una configuración específica de los archivos de Workiva para los datos de sostenibilidad. Antes de ejecutar las cadenas de estas plantillas, configura los archivos Workiva para recopilar y transferir datos:

1. En las Hojas de cálculo, identifica la hoja de recopilación de datos utilizada para los informes de sostenibilidad.
2. En Wdata, crea una tabla que utilice la hoja de cálculo como conjunto de datos conectado, y registra el ID de la tabla para cuando ejecutes las cadenas.
3. En la hoja de cálculo, añade una hoja para seguir el estado de actualización de la conexión saliente a la tabla de Wdata, y anota el nombre de la hoja para cuando ejecutes las cadenas. 
4. Crea una consulta para que se ejecute cuando las cadenas archiven datos:
   • Utiliza la tabla de Wdata conectada a la hoja de cálculo de recopilación de datos como origen de datos.
   • En la consulta, incluye un parámetro de selección múltiple para Año, con el mismo tipo de datos que la columna Año de la tabla.
   • Registra el ID de la consulta para cuando ejecutes las cadenas.

Paso 2. Determinar los valores de las variables y las entradas en tiempo de ejecución

Para permitir que las cadenas trabajen con múltiples espacios de trabajo, utilizan variables para identificar el usuario de integración y los entornos para el conector de Workiva. En el Generador de cadenas, crea estas variables de espacio de trabajo:

Al ejecutar la cadena creada a partir de 1a. La plantilla Traspaso de ESG | Principal | Empezar aquí solicita entradas de ejecución para identificar los archivos de Workiva con los que interactuar y cómo identificar el conjunto de datos:

Paso 3. Crear las cadenas

Para crear las cadenas necesarias para hacer avanzar la recopilación de datos, utiliza el enlace 1a. Traspaso de ESG | Principal | Empezar aquí:

1. Desde Plantillas en el Generador de cadenas, abre la plantilla 1a. Traspaso de ESG | Principal | Empezar aquí y haz clic en Nueva cadena.
2. Ingresa un nombre para ayudar a identificar la cadena.
   
3. Selecciona el entorno para utilizar la cadena y haz clic en Siguiente.
4. Para la variable dcv-clearSuccess, ingresa el nombre dvc-clearSuccess y haz clic en Siguiente.
   
5. Para cada conexión, selecciona el conector que quieres utilizar y haz clic en Cadena siguiente.

   Nota: Para cada conector, utiliza el CloudRunner predeterminado.

   
6. Configura cada variable y haz clic en Siguiente.
   
   

   Variable	Tipo de variable	Nueva variable
   wsv-ClientID	Espacio de trabajo	Selecciona wsv-ClientID.
   cv-TimeToCheck	Cadena	cv-TimeToCheck
   wsv-ClientSecret	Espacio de trabajo	Selecciona wsv-ClientSecret.
   dcv-RefreshStatus	Cadena dinámica	dcv-RefreshStatus
   wsv-BaseURL-IAM	Espacio de trabajo	Selecciona wsv-BaseURL-IAM.
   wsv-BaseURL-OC	Espacio de trabajo	Selecciona wsv-BaseURL-OC.

7. Para cada conexión, selecciona el conector que quieres utilizar y haz clic en Cadena siguiente.

   Nota: Para cada conector, utiliza el CloudRunner predeterminado.

8. Configura cada variable y haz clic en Siguiente.
   

   Variable	Tipo de variable	Nueva variable
   dcv-srcStatus	Cadena dinámica	dcv-srcStatus
   wsv-ClientID	Espacio de trabajo	Selecciona wsv-ClientID.
   dcv-destStatus	Cadena dinámica	dcv-destStatus
   wsv-ClientSecret	Espacio de trabajo	Selecciona wsv-ClientSecret.
   wsv-BaseURL-Wdata	Espacio de trabajo	Selecciona wsv-BaseURL-Wdata.
   wsv-BaseURL-IAM	Espacio de trabajo	Selecciona wsv-BaseURL-IAM.

9. Para cada conexión, selecciona el conector que quieres utilizar y haz clic en Enviar.

   Nota: Para cada conector, utiliza el CloudRunner predeterminado.

Paso 4. Publicar las cadenas

Nota: Para facilitar la instalación, la plantilla Actualizar conexiones y estado tiene un evento Ejecutar cadena. Antes de publicar las cadenas creadas a partir de las plantillas, elimina este evento ajeno Ejecutar cadena.

1. En Cadenas, para la cadena creada a partir de la plantilla Actualizar conexiones y estado, selecciona Editar.
   
2. Selecciona el evento Ejecutar cadena - Eliminar y haz clic en Eliminar y Eliminar.
   
3. Haz clic en Publicar y Publicar.
4. En Cadenas, para la cadena creada a partir de la plantilla Principal, selecciona Editar.
5. Haz clic en Publicar y Publicar.
6. En Cadenas, para la cadena creada a partir de la plantilla Ejecución, selecciona Editar.
7. Haz clic en Publicar y Publicar.

Ejecutar las cadenas

Archivar tus datos y prepararte para la recopilación de datos del año siguiente:

1. En Generador de cadenas, desde Cadenas, selecciona Ejecutar para la cadena creada a partir de la plantilla 1a.Traspaso de ESG | Principal | Empezar aquí plantilla.
   
2. Haz clic en Ejecutar con entradas e introduce las entradas en tiempo de ejecución:
   
   

   Entrada en tiempo de ejecución	Valor
   Recopilación de datos: ID de tabla de traspaso	Introduce el ID de la tabla de Wdata a la que quieres importar el conjunto de datos.
   Recopilación de datos: ID de consulta de traspaso	Introduce el ID de la consulta a ejecutar para archivar datos.
   Año de presentación	Introduce el año de los datos a archivar.
   Valor de etiqueta	Introduce el nombre del conjunto de datos archivado. Nota: Con la entrada Año de presentación, esta entrada crea el nombre de archivo del conjunto de datos como [Valor de etiqueta]_[Año de presentación].csv. Por ejemplo, un año de presentación de 2021 y un valor de etiqueta de Archivado crea el nombre de archivo Archivado_2021.csv.
   Actualizar las conexiones de las hojas antes de archivar los datos	Selecciona si quieres actualizar las conexiones salientes de la hoja de cálculo con la tabla de Wdata antes de que se ejecute la consulta de traspaso, por ejemplo, para actualizar el conjunto de datos antes de archivarlo.
   Status—SheetName	Introduce el nombre de la hoja que realiza el seguimiento del estado de actualización de las conexiones salientes de la hoja de cálculo a la tabla de Wdata.
   RefreshExecution—ChainName	Introduce el nombre de la cadena creada a partir de la plantilla Traspaso de ESG | Actualizar conexión | Ejecución.
   Borrar la columna Valor de la hoja de cálculo	Selecciona si desea eliminar los valores de entrada de la hoja de cálculo como parte del traspaso. Nota: No se borrará ningún valor con vínculo de origen o destino.

3. Para garantizar los últimos valores antes de importar el conjunto de datos, selecciona Actualizar conexiones antes de archivar los datos.
   
   Si seleccionas esta opción, las cadenas actualizan las conexiones salientes de la Hoja de Cálculo y realizan un seguimiento de su estado de actualización en una hoja de control:
   • En Status-SheetName, introduce el nombre de la hoja en la Hoja de cálculo de origen donde las cadenas pueden guardar el estado de actualización de las conexiones salientes.
   • En RefreshExecution-ChainName, introduce el nombre de la cadena creada a partir de la plantilla Traspaso de ESG | Actualizar conexión | Ejecución.

   Consejo: La actualización puede tardar unos minutos dependiendo del número de conexiones salientes de la hoja de cálculo. Para ajustar el tiempo de espera, edita el evento Pausar cadena de la cadena creada a partir de la plantilla 1b. Traspaso de ESG | Actualizar conexiones y estado.

4. Para borrar valores de entrada de la Hoja de Cálculo de origen como parte del archivo, por ejemplo para preparar la recogida de datos del año siguiente, selecciona Borrar columna de valores de la hoja de cálculo.
   
   

   Nota: La cadena conserva los valores vinculados a un origen o destino. No se pueden recuperar los valores eliminados de la hoja de cálculo. Te recomendamos que selecciones esta opción solo para el último desglose del año, con el objetivo de preparar la hoja de cálculo para la recopilación de datos del año siguiente.

   Consejo: Por defecto, la cadena elimina los valores a partir de la fila 2 de las hojas de la hoja de cálculo. Para ajustar este parámetro, edita la propiedad Región del comando Borrar datos de la hoja.

5. Haz clic en Iniciar.