Centro de soporte de Workiva

Desde Generador de cadenas, puedes crear una cadena para descargar datos de Schneider Electric® en Workiva, como tus emisiones de gases de efecto invernadero (GEI) para informes medioambientales, sociales y de gobernanza (ESG) o de sostenibilidad.

Requisitos previos

Para construir esta cadena, utilizarás estos conectores principales:

• Conector de solicitudes HTTP
• Conector JSON
• Conector de utilidades de archivo
• Conector de Workiva

Notas: Todos los conectores utilizan el CloudRunner. No se necesitan GroundRunners para esta cadena.

Para descargar los datos de emisiones, también necesitarás el Nombre de usuario y la Contraseña utilizados para la autentificación básica con Schneider Electric.

Paso 1. Crear la cadena

1. Desde Cadenas, haz clic en Crear, y selecciona Crear cadena.
   
2.  En Configurar, introduce un nombre y una descripción para identificar la cadena.
   
3. En Variables, añade variables para especificar los datos que quieres descargar de Schneider Electric:

   Nombre	Valor
   clientHierIds	Establece el ID de la jerarquía de clientes de tu empresa, tal y como se ha establecido para Schneider Electric en el Asesor de Recursos.
   serviceIds	Para descargar solo los datos de una fuente concreta, introduce el ID de la fuente de GEI para descargar los datos de emisiones de .
   desdeMes	Introduce el mes más antiguo del periodo de tiempo del que quieres descargar datos, en formato aaaa-MM.
   toMonth	Introduce el último mes del periodo de tiempo del que quieres descargar los datos, en formato aaaa-MM.
   tipoMapaDeCarbono	Introduce el mapa de carbono desde el Asesor de Recursos para utilizarlo: Primario o Secundario. Si se deja en blanco, el comando utiliza el mapa de carbono principal.
   emissionUOMId	Introduce la unidad de medida preferida para utilizar con los datos de emisiones descargados.
   emissionURL	Introduce la URL de Punto final de la API de Schneider Electric desde el que solicitar los datos.

4. Haz clic en Guardar.

Paso 2. Comenzar con una solicitud HTTP

Para solicitar los datos a descargar a Schneider Electric, comienza con un comando HTTP POST.

1. En Conectores, selecciona HTTP, y desplaza POST a Inicia.
2. Selecciona el comando POST y haz clic en Editar.
3. Debajo de Información básica, introduce un nombre y una descripción para ayudar a identificar el comando.
4. En Propiedades del comando, selecciona el conector de Solicitudes HTTP que vas a utilizar.
5. Introduce las propiedades del comando:
   
   

   Propiedad	Descripción
   Nombre de usuario	Introduce el nombre de usuario utilizado para la autenticación básica con Schneider Electric.
   Contraseña	Introduce la Contraseña utilizada para la Autenticación básica con Schneider Electric.
   Mostrar respuesta	Marca esta casilla.
   dirección URL|URL	Selecciona la variable emissionsURL en Cadena.
   Tipo de contenido	Selecciona application/json.
   Cuerpo del texto	Introduce la solicitud como una cadena en Notación de Objetos JavaScript (JSON), seleccionando la variable aplicable en Cadena como valor de cada par nombre/valor: { "clientHierIds": [<clientHierId>], "serviceIds": [<serviceIds>], "fromMonth": "<fromMonth>", "toMonth": "<toMonth>", "carbonMapType": "<carbonMapType>", "emissionsUOMId": "<emissionUOMId>" }
   Esquema de resultado	Introduce la respuesta JSON de muestra de Schneider Electric: { "serviceOutput": [ { "divisionClientHierId": 0, "divisionName": "string", "siteClientHierId": 0, "siteName": "string", "dataSourceLevel": "string", "serviceId": 0, "serviceName": "string", "scope": "string", "usage": 0, "emission": 0, "emissionUOM": "string", "usageUOM": "string", "serviceMonth": "string" } ], "errorMessage": "string", "errorCode": "string" }

6. Haz clic en Guardar.

Paso 3. Añadir un comando Matriz a CSV

Para convertir la respuesta JSON de Schneider Electric a un formato de valores separados por comas (CSV), añade un comando Matriz a CSV:

1. Debajo de Conectores, selecciona JSON, y desplaza Matriz a CSV al lienzo.
2. Arrastra una vinculación desde Inicia al comando Matriz a CSV.
3. Selecciona el comando Array to CSV, y haz clic en Editar.
4. Debajo de Información básica, introduce un nombre y una descripción para ayudar a identificar el comando.
5. Debajo de Propiedades del comando, selecciona el conector JSON que vas a utilizar.
   
6. Para datos JSON, selecciona la salida Respuesta del comando POST.
7. En Columnas, añade columnas para los datos descargados de Schneider Electric:
   
   

   Nombre de columna	JSONPath
   utilización	.Utilización
   emisiones	.Emisiones

8. Para Delimitador, selecciona Coma.
9. Haz clic en Guardar.

Paso 4. Añadir un comando Crear archivo

Para crear un archivo CSV a partir de los datos, añade un comando Crear archivo:

1. En Conectores, selecciona Utilidades de Archivos, y mueve Crear archivo al lienzo.
2. Arrastra un enlace desde el comando Array to CSV al comando Crear archivo.
3. Selecciona el comando Crear archivo y haz clic en Editar.
4. Debajo de Información básica, introduce un nombre y una descripción para ayudar a identificar el comando.
5. En Propiedades del comando, selecciona el conector de Utilidades de Archivos que vas a utilizar.
   
6. Introduce las propiedades del comando:
   

   Propiedad	Descripción
   Texto	Selecciona el Archivo convertido resultado del comando Matriz a CSV.
   Ruta del archivo	Selecciona la variable Chain.Workspace en Runtime, e introduce \ y el nombre del archivo con extensión .csv.

7. Haz clic en Guardar.

Etapa 5. Añadir comandos para utilizar los datos en Workiva

Para utilizar los datos CSV en la plataforma Workiva, añade los comandos del conector Workiva para utilizar la salida variable Archivo creado del comando Crear archivo con una hoja de cálculo o una tabla Wdata. Por ejemplo, para añadir los datos de Schneider Electric como conjunto de datos en una tabla Wdata, añade un evento Ejecutar cadena que utilice una cadena creada a partir de la plantilla. 

Etapa 6. Publica y ejecuta la cadena.

Para permitir la ejecución de la cadena:

1. Haz clic en Publicar.
2. Introduce cualquier comentario sobre la publicación y haz clic en Publicar.

Ejecutar la cadena:

1. Desde Cadenas, selecciona Editar en el menú de la cadena.
2. Haz clic en Configuración de Cadenas, introduce los valores de las variables para especificar los datos a descargar y haz clic en Guardar como....
3. Haz clic en Ejecutar y Ejecutar cadena.