La plataforma climática empresarial de Watershed te permite medir, informar y reducir la huella de carbono de tu organización.
Con la Plataforma Workiva, puedes crear cadenas para descargar automáticamente los datos de la huella de carbono de Watershed -por ejemplo, para divulgarlos en tus informes medioambientales, sociales y de gobernanza (ESG) o de sostenibilidad- en una tabla, basándote en un periodo de tiempo especificado en una hoja de cálculo personalizada de Watershed. A continuación, puedes utilizar la tabla como fuente para una consulta o una conexión a una hoja de cálculo, por ejemplo, para incluir los datos en los resultados de los informes.
Nota: Aunque construyas varias cadenas en estas Instrucciones, sólo ejecutarás una cadena -que luego ejecutará automáticamente las demás- para descargar datos de la Cuenca y actualizar la hoja de cálculo.
Nota: La Hoja de cálculo Watershed que utilizan estas Cadenas la proporciona Workiva. Si no lo tienes pero estás interesado, ponte en contacto con tu Gestor de Éxito del Cliente para obtener más detalles.
Requisitos previos
Para construir estas cadenas, necesitarás estos conectores:
- Conector de Workiva
- Conector de transformación de tablas
- Conector JSON
- Conector de solicitudes HTTP
- Conector de utilidades de archivo
Consejo: Todos los comandos de las Cadenas utilizan el CloudRunner por defecto. No se necesitan GroundRunners.
Para ejecutar correctamente las Cadenas, identifica también:
- La clave del proveedor de actividades que se utilizará para autenticarse y realizar acciones con la API de Watershed.
- Las identificaciones de la hoja de cálculo Cuenca , su sección Hoja de control y su tabla conectada.
Construye una cadena para registrar descargas de datos
Para empezar, construye una cadena para actualizar la sección Hoja de control para saber cuándo se suben los datos de la huella de carbono a Workiva.
Paso 1. Crear la cadena
- Desde Cadenas, haz clic en Crear, y selecciona Crear cadena.
- En Configurar, introduce un nombre de
3. Cuencay una descripción para ayudar a identificar que la cadena registra Subidas de datos de la cuenca. - Haz clic en Guardar.
Etapa 2. Comienza con un evento de Entradas en tiempo de ejecución
- Desde: Eventos en cadena, Desplazado a Entradas en tiempo de ejecución a Inicio a.
- Selecciona el evento Entradas en tiempo de ejecución y haz clic en Editar.
- En Información básica, introduce un nombre y una descripción para ayudar a identificar el evento.
- En Variables, añade entradas TextField con estos nombres para mostrar:
RangoID de hoja de cálculoHojaID
Consejo: Deja en blanco estos valores predeterminados de las variables, se generarán cuando ejecutes 1. Cuenca hidrográfica cadena creada posteriormente.
- Selecciona Requerido para las tres variables, y haz clic en Guardar.
Etapa 3. Añadir un comando Utilidades de archivos Crear archivos.
Para crear el archivo de registro de la sección Hoja de control, añade un comando Utilidades de archivo Crear archivo:
- Desde Conectores disponibles, selecciona Utilidades de archivos, y mueve Crear archivo al lienzo.
- Arrastra un vinculo desde Entradas en tiempo de ejecución a Crea un archivo.
- Selecciona el comando Crear archivo y haz clic en Editar.
- En Información básica, introduce un nombre y una descripción para ayudar a identificar el comando.
- Introduce las propiedades del comando y haz clic en Guardar:
Propiedad Valor Conector|Conector Selecciona el conector de Utilidades de Archivos para utilizar. Texto Introduce en los datos de la Huella actualizados por última vez en, y selecciona la variable de tiempo de ejecución System.DateTime.
Etapa 4. Añadir un comando de Workiva Escribir datos en hoja a .
Para actualizar la sección Hoja de control con el archivo de registro, añade un comando Workiva Escribir datos de hoja:
- Desde Conectores disponibles, selecciona Workiva, y mueve Escribir datos de la hoja al lienzo.
- Arrastra un vinculo desde Crea un archivo a Escribe los datos de la hoja.
- Selecciona el comando Escribir datos de la hoja, y haz clic en Editar.
- En Información básica, introduce un nombre y una descripción para ayudar a identificar el comando.
- Introduce las propiedades del comando y haz clic en Guardar:
Propiedad Valor Conector|Conector Selecciona el conector Workiva que vas a utilizar. ID de hoja de cálculo Selecciona la entrada en tiempo de ejecución SpreadsheetID de Disparador. ID/nombre de la hoja Selecciona la entrada en tiempo de ejecución SheetID de Activar. Archivo de datos Selecciona la salida Archivo creado del comando Crear archivo. Delimitador Introduce una coma ( ,).Región Selecciona la entrada de tiempo de ejecución Rango desde Disparador. - Haz clic en Publica, introduce una nota sobre su publicación y haz clic en Publica.
Crea cadenas desde la plantilla de subida de datos a Wdata
A continuación, utiliza la plantilla Cargar datos en Wdata para construir cadenas que actualicen la tabla conectada de la hoja de cálculo Cuenca con los datos descargados de Cuenca. La plantilla Cargar datos en Wdata crea cadenas que funcionan conjuntamente para determinar si el conjunto de datos ya existe en la tabla y actualizar la tabla con el conjunto de datos más reciente.
Para crear las cadenas desde Plantillas, abre la plantilla Cargar datos en Wdata | Cadena primaria, y haz clic en Nueva cadena.
Construye una cadena para descargar datos de Watershed
Por último, construye una cadena para descargar e importar datos sobre la huella de carbono de Watershed.
Nota: Crea las otras dos cadenas antes que ésta, para su Ejecuta la cadena eventos.
Paso 1. Crear la cadena
- Desde Cadenas, haz clic en Crear, y selecciona Crear cadena.
- En Configurar, introduce un nombre de
1. Cuencas hidrográficasy una descripción para ayudar a identificar mejor la cadena. - En Variables, añade variables para la clave de la API de la cuenca y los ID de la hoja de cálculo de la cuenca y de su hoja de control.
Nombre Valor APIKey Introduce la clave API de Watershed. ID de hoja de cálculo Introduce el ID de la hoja de cálculo de Watershed. HojaID Introduce el ID de la sección Hoja de control de la hoja de cálculo de Watershed. - Haz clic en Guardar.
Paso 2. Empezar con un comando Obtener datos de hojas de Workiva
Empieza con un comando de Workiva Obtener datos de la hoja para identificar los datos que hay que descargar, basándose en el periodo de tiempo de la hoja de cálculo de la cuenca Hoja de control:
- Desde Conectores disponibles, selecciona Workiva, y mueve Obtén datos de la hoja a Inicia.
- Selecciona el comando Obtener datos de la hoja, y haz clic en Editar.
- En Información básica, introduce un nombre y una descripción para ayudar a identificar el comando.
- Introduce las propiedades del comando y haz clic en Guardar:
Propiedad Valor Conector|Conector Selecciona el conector Workiva que vas a utilizar. ID de hoja de cálculo Selecciona la variable de cadena ID de hoja de cálculo. ID/nombre de la hoja Selecciona la variable de cadena ID de hoja. Región Introduce A11:.Estilo de valor Selecciona Calculado. Revisión Para asegurarte la última versión, introduce -1.
Paso 3. Añadir comandos para preparar el periodo de tiempo de Watershed
Para identificar el periodo de tiempo de la cuenca, añade los comandos Consulta avanzada y CSV a JSON:
- Desde Conectores disponibles, selecciona Transformación tabular, y desplaza Consulta avanzada al lienzo.
- Arrastra un vinculo de Obtener datos de la hoja a Consulta avanzada.
- Selecciona el comando Consulta avanzada y haz clic en Editar.
- En Información básica, introduce un nombre y una descripción para ayudar a identificar el comando.
- Introduce las propiedades del comando y haz clic en Guardar:
Propiedad Valor Conector|Conector Selecciona el conector de transformación tabular que vas a utilizar. Tablas Añade la tabla para los datos del periodo de tiempo: - En Archivo, selecciona la salida Datos del comando Obtener datos de la hoja.
- En Nombre de tabla, introduce
a.
Consulta Introduce la consulta a ejecutar: selecciona caso cuando `Mes de Inicio` = `Enero` entonces '01' cuando `Mes de Inicio` = `Febrero` entonces '02' cuando `Mes de Inicio` = `Marzo` entonces '03' cuando `Mes de Inicio` = `Abril` entonces '04' cuando `Mes de Inicio` = `Mayo` entonces '05' cuando `Mes de Inicio` = `Junio entonces "06" cuando "Mes de inicio" = "Julio" entonces "07" cuando "Mes de inicio" = "Agosto" entonces "08" cuando "Mes de inicio" = "Septiembre" entonces "09" cuando "Mes de inicio" = "Octubre" entonces "10" cuando "Mes de inicio" = "Noviembre" entonces "11" si no "12" finaliza como "sm", case cuando `Fin de Mes` = `Enero` entonces '01' cuando `Fin de Mes` = `Febrero` entonces '02' cuando `Fin de Mes` = `Marzo` entonces '03' cuando `Fin de Mes` = `Abril` entonces '04' cuando `Fin de Mes` = `Mayo` entonces '05' cuando `Fin de Mes` = `Junio` entonces 06" cuando "Fin de Mes" = "Julio" entonces "07" cuando "Fin de Mes" = "Agosto" entonces "08" cuando "Fin de Mes" = "Septiembre" entonces "09" cuando "Fin de Mes" = "Octubre" entonces "10" cuando "Fin de Mes" = "Noviembre" entonces "11" si no "12" finaliza como "em", Año del informe` como 'ry', TableId como 'tid' de a
Delimitador de entrada Selecciona Coma. Delimitador de salida Selecciona Coma. Vista previa de los resultados Selecciona esta casilla. - Desde Conectores disponibles, selecciona JSON, y desplaza CSV a JSON al lienzo.
- Arrastra una vinculación desde Consulta avanzada a CSV a JSON.
- Selecciona el comando CSV a JSON y haz clic en Editar.
- En Información básica, introduce un nombre y una descripción para ayudar a identificar el comando.
- Introduce las propiedades del comando y haz clic en Guardar:
Propiedad Valor Conector|Conector Selecciona el conector JSON que vas a utilizar. Archivo de entrada. Selecciona la salida Resultado del comando Consulta avanzada. Delimitador Selecciona la Coma (,).
Etapa 4. Añadir un comando GET de solicitud HTTP
Para descargar los datos de la huella de carbono correspondientes al Periodo seleccionado, añade una Solicitud HTTP GET comando:
- Desde Conectores disponibles, selecciona Solicitud HTTP, y desplaza GET al lienzo.
- Arrastra un enlace de CSV a JSON a GET.
- Selecciona el comando GET y haz clic en Editar.
- En Información básica, introduce un nombre y una descripción para ayudar a identificar el comando.
- Introduce las propiedades del comando y haz clic en Guardar:
Propiedad Valor Conector|Conector Selecciona el conector de Solicitudes HTTP que vas a utilizar. Mostrar respuesta Selecciona esta casilla. dirección URL|URL Introduce https://api.watershedclimate.com/v1/report/footprint_detail.Cadena de consulta Introduce la cadena de consulta para indicar los meses de inicio y final de los datos a descargar: - Para el mes de inicio, introduce
startMonth=, y selecciona la salida JSON file del comando CSV to JSON dos veces. - A continuación, para el mes final, introduce
&endMonth=, y selecciona el archivo JSON salida del comando CSV a JSON dos veces más. - Para ambos meses, haz clic en el primer archivo JSON resultado, y aplica una Obtener variable a partir de JSON transformación:
- En Resultado, selecciona Texto.
- En Valor, introduce
0yry.
- Para ambos Meses, haz clic en el segundo archivo JSON Resultado:, y aplica otra transformación Obtener variable a partir de JSON :
- En Resultado, selecciona Texto.
- En Valor, introduce
0ysm.
Encabezados Añadir un Encabezado: - En Tecla, introduce
Autorización. - En Valor, introduce
Portador, y luego selecciona la variable de cadena APIKey.
Tipo de contenido Introduce application/json. - Para el mes de inicio, introduce
Paso 5. Añadir eventos de Ejecutar cadena para realizar y registrar la subida de datos
Para cargar los datos en Wdata y registrar la carga en la sección Hoja de control, añade Ejecutar cadena eventos para las cadenas creadas anteriormente:
- Desde el Encadena eventos, desplaza Ejecuta la cadena al lienzo.
- Arrastra un vínculo desde OBTENER a Ejecutar cadena.
- Selecciona el evento Ejecutar cadena y haz clic en Editar.
- En Información básica, introduce un nombre y una descripción para ayudar a identificar que el evento sube los datos a Wdata.
- En Cadena para ejecutar, selecciona Cargar datos en Wdata | Cadena primaria creada anteriormente a partir de la plantilla Cargar datos en Wdata.
- Introduce las entradas del tiempo en ejecución de la cadena y haz clic en Guardar:
Entrada Valor ID de tabla Para proporcionar el ID de la tabla de Wdata a la que subir los datos: - Selecciona el resultado del archivo JSON del comando CSV a JSON.
- Haz clic en el resultado archivo JSON y aplica una transformación Obtener variable a partir de JSON:
- En Resultado, selecciona Texto.
- En Valor, introduce
0ytid.
Prefijo del archivo Para definir el prefijo del conjunto de datos a subir, en función del período de tiempo de los datos: - Para el mes de inicio, selecciona el archivo JSON resultado del comando CSV a JSON dos veces.
- Introduce un guión bajo (
_). - Para el mes final, selecciona el resultado archivo JSON del comando CSV a JSON dos veces más.
- Introduce
.csv. - Para ambos meses, haz clic en el primer archivo JSON resultado, y aplica una Obtener variable a partir de JSON transformación:
- En Resultado, selecciona Texto.
- En Valor, introduce
0yry.
- Para ambos meses, haz clic en el segundo resultado archivo JSON y aplica otra transformación Obtener variable a partir de JSON:
- En Resultado, selecciona Texto.
- En Valor, introduce
0ysm.
Archivo de datos Selecciona la salida Respuesta del comando GET. Método de carga Selecciona Reemplazar conjunto de datos. Retrocede Selecciona esta casilla. - Desde Encadena eventos, desplaza otro Ejecuta la cadena al lienzo.
- Arrastra una vínculo desde el primer Ejecutar cadena al segundo.
- Selecciona el segundo evento Ejecutar cadena y haz clic en Editar.
- En Información básica, introduce un nombre y una descripción para ayudar a identificar que el evento registra la carga de datos en la hoja de cálculo de la cuenca.
- En Cadena para ejecutar, selecciona la 3. Cadena de Watershed creada anteriormente.
- Introduce las entradas del tiempo en ejecución de la cadena y haz clic en Guardar:
Entrada Valor Rango Introduce F12:F12.ID de hoja de cálculo Selecciona la variable de cadena SpreadsheetID. ID de hoja Selecciona la variable de cadena SheetID. - Haz clic en Publicar, introduce cualquier nota sobre su publicación y haz clic en Publicar.
Ejecutar las cadenas
Para actualizar la hoja de cálculo Cuenca con los datos más recientes de la huella de carbono:
- Desde la sección Hoja de control de la hoja de cálculo Wathershed, selecciona el periodo de tiempo (meses y año) de los datos que quieres descargar de Watershed.
- Desde Cadenas de Wdata, selecciona 1. Cuenca cadena, y haz clic en Ejecutar y Ejecutar cadena.
Nota: Cuando ejecutas esta cadena, automáticamente se ejecutan las otras dos cadenas para actualizar la tabla de Wdata y la hoja de cálculo Watershed con los datos.