|
Los tipos de archivo clásicos dejarán de estar disponibles a partir de enero de 2021. Puedes hacer una transición de tus archivos clásicos o descargar un PDF. Más información

Centro de soporte de Workiva

Descargar datos de emisiones de Enablon® para informes de sostenibilidad.

Descargar datos de emisiones de Enablon® para informes de sostenibilidad.

  • Última actualización

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

download-enablon_08.png

Requisitos previos

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

Nota: Todos los comandos de esta cadena utilizan el CloudRunner por defecto. No se necesita GroundRunner.

Para ejecutar la cadena, necesitarás detalles de Enablon para acceder a los datos:

  • El punto final de la Interfaz de Programación de Aplicaciones (API) del Protocolo Simple de Acceso a Objetos (SOAP) de Enablon que debes utilizar para descargar los datos.
  • El ID del entorno de Enablon al que acceder
  • El nombre de usuario y la contraseña que utilizarás para acceder al entorno.

Paso 1. Crear la cadena

  1. Desde Cadenas, haz clic en Crear, y selecciona Crear cadena.
    download-schneider_01.png
  2. Debajo, en Configurar, introduce un nombre y una descripción que te ayuden a identificar la cadena y su Intención.
    download-enablon_09.png
  3. En Variables, añade variables para los detalles de Enablon necesarios para acceder a los datos:
    • Punto final
      Consejo: Para la variable Endpoint, introduce un valor predeterminado de ExportData o, para descargar los datos en un formato de codificación de 64 bits, ExportBinaryData.
    • Entorno
    • Nombre de usuario
    • Contraseña
  4. Haz clic en Guardar.

Paso 2. Comenzar con el evento desencadenante de Entradas en tiempo de ejecución

Para filtrar la salida cada vez que se ejecuta la cadena, comienza con un evento Entradas en tiempo de ejecución para solicitar los criterios de los datos a descargar.

  1. Desplazar Entradas en tiempo de ejecución de debajo de Eventos desencadenantes a Iniciar.
  2. Selecciona el evento Entradas en tiempo de ejecución y haz clic en Editar.
    download-enablon_10.png
  3. Añade las entradas a solicitar cada vez que se ejecute la cadena:
    Mostrar nombre Tipo ¿Es necesario?
    Fecha de inicio del periodo del informe DateField Sí
    Fecha de finalización del periodo del informe DateField Sí
    Campaña TextField o DropdownField:
    • TextField, para un campo de texto abierto
    • Campo desplegable, para seleccionar de una lista específica de opciones.
    		 Sí
    Entidades ArrayField Sí
  4. Haz clic en Guardar.

Etapa 3. Añadir un comando POST del conector de solicitudes HTTP.

Para recuperar los datos desde el punto final de Enablon, establece un comando HTTP conector POST:

  1. Debajo de Conectores, haz clic en HTTP, y mueve el comando POST al lienzo.
  2. Arrastra un vínculo desde Iniciar al comando PUBLICAR.
  3. Selecciona el comando POST y haz clic en Editar.
  4. Debajo de Propiedades del comando, selecciona el conector HTTP que vas a utilizar.
  5. Introduce las propiedades del comando:
    download-enablon_01.png
    Propiedad Descripción
    Nombre de usuario Selecciona la variable Nombre de usuario en Cadena.
    Contraseña Selecciona la variable Contraseña en Cadena.
    Mostrar respuesta Marca esta casilla.
    URL Selecciona la variable Endpoint en Chain.
    Tipo de contenido Introduce text/xml.
  6. En Cuerpo del texto, introduce esta sintaxis de lenguaje de marcado extensible (XML): 
    <soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:enab="enablon"> <soapenv:Header> <UserInfo xsi:type="wsdl:AuthHeader" xmlns:wsdl="http://enablon/wsdl/"> <EnaHomeSite xsi:type="xsd:string">[Environment]</EnaHomeSite> <EnaUserName xsi:type="xsd:string">[Username]</EnaUserName> <EnaPassword xsi:type="xsd:string">[Password]</EnaPassword> </UserInfo> </soapenv:Header> <soapenv:Body> <enab:ExportData soapenv:encoding:Style="http://schemas.xmlsoap.org/soap/encoding/"> <Table>/sd/Entidades/Datos</Table>       <FolderId>0</FolderId> <Fields>RutaDeCarpeta|PeríodoDeInforme|Ref|NombreDeIndicador|NúmeroDeValor|UnidadLocal|ListaDeValor</Fields> <Filter>ReportingPeriod in ([ReportPeriodEndDate],[ReportPeriodStartDate]) AND Campaign in([Campaign]) AND Entities=[Entities]</Filter> <CSVSeparator>2</CSVSeparator> <FormatOptions>25</FormatOptions> <FormatType>3</FormatType> <ExportOptions>8192</ExportOptions> </enab:ExportData> </soapenv:Body> </soapenv:Envelope>
  7. Actualiza la sintaxis XML con las variables de entrada y cadena en tiempo de ejecución:
    • En el Encabezado, reemplaza [Entorno], [Nombre de usuario], y [Contraseña] por sus respectivas variables bajo Cadena.
    • En el cuerpo, reemplaza [ReportPeriodEndDate], [ReportPeriodStartDate], [Campaign], y [Entities] por sus entradas de tiempo de ejecución en Trigger.
  8. Haz clic en Guardar.

Paso 4. Añadir comandos Buscar y reemplazar conector de servicios de archivos

Para preparar los datos XML descargados, añade Utilidades de Archivos conector Buscar y reemplazar comandos para arreglar los corchetes angulares y las tuberías.

Consejo: Para diferenciar fácilmente los comandos Buscar y reemplazar, introduce nombres que identifiquen el carácter que fija cada comando, como "Buscar y reemplazar corchetes angulares de inicio" o "Buscar y reemplazar tubos".
  1. Debajo de Conectores, haz clic en Utilidades de archivo, y mueve el comando Buscar y reemplazar al lienzo.
  2. Arrastra un vinculo desde el comando POST al comando Buscar y reemplazar .
  3. Selecciona el comando Buscar y reemplazar y haz clic en Editar.
  4. En Propiedades del comando, selecciona el conector Utilidades de archivos que vas a utilizar.
    download-enablon_02.png
  5. Introduce las propiedades del comando y haz clic en Guardar:
    Propiedad Descripción
    Origen Selecciona la salida Respuesta del comando POST.
    Buscar Introduce <.
    Reemplazar Introduce un paréntesis angular de inicio ( <).
    Buscar sintaxis Selecciona Exacto.
  6. Debajo de Conectores, haz clic en Utilidades de archivo, y mueve otro comando Buscar y reemplazar al lienzo.
  7. Arrastra una vinculación entre los comandos Buscar y reemplazar .
  8. Selecciona el nuevo comando Buscar y reemplazar y haz clic en Editar.
  9. En Propiedades del comando, selecciona el mismo conector Utilidades de archivos.
    download-enablon_03.png
  10. Introduce las propiedades del comando y haz clic en Guardar:
    Propiedad Descripción
    Origen Selecciona el resultado Resultado reemplazando del comando Buscar y reemplazar.
    Buscar Introduce >.
    Reemplazar Introduce un paréntesis angular de inicio (>).
    Buscar sintaxis Selecciona Exacto.
  11. Debajo de Conectores, haz clic en Utilidades de archivo, y mueve otro comando Buscar y reemplazar al lienzo.
  12. Arrastra una vinculación entre el segundo y el tercer comando Buscar y reemplazar .
  13. Selecciona el tercer comando Buscar y reemplazar y haz clic en Editar.
  14. En Propiedades del comando, selecciona el mismo conector Utilidades de archivos.
    download-enablon_04.png
  15. Introduce las propiedades del comando y haz clic en Guardar:
    Propiedad Descripción
    Origen Selecciona el resultado Reemplazando del segundo comando Buscar y reemplazar.
    Buscar Introduce >.
    Reemplazar Introduce una tubería (|).
    Buscar sintaxis Selecciona Exacto.

Etapa 5. Añadir un conector XML Lista de elementos al comando CSV.

Para convertir el XML descargado en datos tabulares, añade un comando Conector XML Lista de elementos a CSV:

  1. Debajo de Conectores, haz clic en XML, y mueve otro comando Lista de elementos a CSV al lienzo.
  2. Arrastra un vinculo desde el tercer comando Buscar y reemplazar al comando Lista de elementos a CSV.
  3. Selecciona el comando Lista de elementos a CSV y haz clic en Editar.
  4. Debajo de Propiedades del comando, selecciona el conector XML que vas a utilizar.
    download-enablon_05.png
  5. Introduce las propiedades del comando:
    Propiedad Descripción
    Origen Selecciona el resultado Reemplazando del tercer comando Buscar y reemplazar.
    Ruta a la raíz Introduce //Documento/Registro.
    Vista previa del resultado Marca esta casilla.
  6. En Columnas, añade el nombre de la columna y XPath para cada elemento:
    download-enablon_11.png
    Nombre de la columna XPath
    Periodo /PeríodoDeInforme
    Indicador /Ref
    IndName /NombreIndicador
    NumValor /NúmeroValor
    Unidad /UnidadLocal
  7. En Delimitador multivalor, introduce una coma (,).
  8. Haz clic en Guardar.

Paso 6. Añadir un comando Crear archivo del conector de servicios de archivos

Para crear un archivo de valores separados por comas (CSV) a partir de los datos tabulares, añade un comando Crear archivo del conector de servicios de archivos:

  1. Debajo de Conectores, haz clic en Utilidades de Archivos, y mueve el comando Crear archivo al lienzo.
  2. Arrastra un enlace desde el comando Lista de elementos a CSV al comando Crear archivo .
  3. Selecciona el comando Crear archivo y haz clic en Editar.
  4. En Propiedades del comando, selecciona el mismo Utilidades de archivos conector que los comandos Buscar y reemplazar.
    download-enablon_07.png
  5. Introduce las propiedades del comando y haz clic en Guardar:
    Propiedad Descripción
    Texto Selecciona el Archivo convertido resultado del comando Lista de elementos a CSV.
    Ruta del archivo Selecciona la variable Chain.Espacio de trabajo en Runtime, y añade \test.csv.

Etapa 7. Añade 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 Enablon como conjunto de datos en una tabla de Wdata, añade un evento Ejecutar cadena que utilice una cadena creada a partir de la plantilla Actualizar conjuntos de datos en una tabla. 

Etapa 8. 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 y haz clic en Guardar.
    Nota: Para la variable Endpoint, introduce ExportData o, para descargar los datos en un formato de codificación de 64 bits, ExportBinaryData.
  3. Haz clic en Ejecutar.
  4. Desde Monitoriza, haz clic en Ejecutar con entradas, introduce las entradas del tiempo de ejecución y haz clic en Iniciar.
Desde Generador de cadenas, puedes crear una cadena para descargar datos de Enablon®, como tus emisiones de gases de ...