Em Construtor de Cadeia, você pode criar uma cadeia para baixar dados da Schneider Electric® para a Workiva, como suas emissões de gases de efeito estufa (GHG) para relatórios ambientais, sociais e de governança (ESG).
Pré-requisitos
Para construir essa cadeia, você usará esses conectores principais:
Observação: Todos os conectores usam o CloudExecutarner. Não são necessários GroundExecutarners para essa cadeia.
Para fazer o download dos dados de emissões, você também precisará do nome de usuário e da senha usados para a autenticação básica com a Schneider Electric.
Etapa 1. Criar a cadeia
- Em Cadeias, clique em Criar e selecione Criar cadeia.
- Em Configurar, digite um nome e uma descrição para identificar a cadeia.
- Em Variáveis, adicione variáveis para especificar os dados a serem baixados da Schneider Electric:
Nome Valor clientHierIds Digite o ID da hierarquia de clientes de sua empresa, conforme configurado para a Schneider Electric no Resource Advisor. serviceIds Para fazer o download de dados apenas para uma fonte específica, insira a ID da fonte de GEE para a qual deseja fazer o download dos dados de emissões. fromMonth Insira o primeiro mês do período de tempo para o qual deseja fazer o download dos dados, em um formato aaaa-MM.toMonth Insira o último mês do período de tempo para o qual deseja fazer o download dos dados, em um formato aaaa-MM.carbonMapType Digite o mapa de carbono do Resource Advisor a ser usado - Primário ou Secundário. Se for deixado em branco, o comando usará o mapa de carbono primário. emissionUOMId Digite a unidade de medida preferida a ser usada com os dados de emissões baixados. emissionURL Digite o URL do endpoint da API da Schneider Electric para solicitar dados. - Clique em Salvar.
Etapa 2. Comece com uma solicitação HTTP
Para solicitar o download dos dados da Schneider Electric, comece com um comando HTTP POST.
- Em Connectors, selecione HTTP, e mova POST para Start.
- Selecione o comando POST e clique em Editar.
- Em Informações básicas, digite um nome e uma descrição para ajudar a identificar o comando.
- Em Propriedades do comando, selecione o conector de solicitação HTTP a ser usado.
- Digite as propriedades do comando:
Propriedade Descrição Nome do usuário Digite o nome de usuário usado para autenticação básica com a Schneider Electric. Senha Digite a senha usada para a autenticação básica com a Schneider Electric. Mostrar resposta Marque esta caixa. URL Selecione a variável emissionsURL em Cadeia. Tipo de conteúdo Selecione application/json. Texto do corpo Insira a solicitação como uma cadeia de caracteres JSON (JavaScript Object Notation), selecionando a variável aplicável em Cadeia como valor de cada par nome/valor: { "clientHierIds": [<clientHierId variable>], "serviceIds": [<serviceIds variable>], "fromMonth": "<fromMonth variable>", "toMonth": "<toMonth variable>", "carbonMapType": "<carbonMapType variable>", "emissionsUOMId": "<emissionUOMId variable>" }Esquema de saída Insira o exemplo de resposta JSON da 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" } - Clique em Salvar.
Etapa 3. Adicionar uma matriz ao comando CSV
Para converter a resposta JSON da Schneider Electric em um formato de valores separados por vírgula (CSV), adicione um comando Array para CSV:
- Em Connectors, selecione JSON, e mova Array to CSV para a tela.
- Arraste um link de Iniciar para o comando Array para CSV.
- Selecione o comando Array para CSV e clique em Editar.
- Em Informações básicas, digite um nome e uma descrição para ajudar a identificar o comando.
- Em Propriedades do comando, selecione o conector JSON a ser usado.
- Para dados JSON, selecione a saída Resposta do comando POST.
- Em Colunas, adicione colunas para os dados baixados da Schneider Electric:
Nome da coluna JSONPath usage .usage emissões .emissions - Para Delimitador, selecione Vírgula.
- Clique em Salvar.
Etapa 4. Adicionar um comando Criar Arquivo
Para criar um arquivo CSV a partir dos dados, adicione um comando Criar arquivos:
- Em Connectors, selecione File Utilities, e mova Create file para a tela.
- Arraste um link do comando Array para CSV para o comando Criar arquivos.
- Selecione o comando Criar arquivos e clique em Editar.
- Em Informações básicas, digite um nome e uma descrição para ajudar a identificar o comando.
- Em Propriedades de comando, selecione o conector Utilidades de arquivos a ser usado.
- Digite as propriedades do comando:
Propriedade Descrição Texto Selecione a saída Arquivo convertido do comando Array para CSV. Caminho do arquivo Selecione a variável Chain.Workspace em Tempo de execução e digite \e o nome do arquivo com extensão. csv. - Clique em Salvar.
Etapa 5. Adicionar comandos para usar os dados no Workiva
Para usar os dados CSV na plataforma Workiva, adicione os comandos do conector Workiva para usar a saída da variável Arquivo criado do comando Criar arquivos com uma planilha ou tabela Wdata. Por exemplo, para adicionar os dados da Schneider Electric como um conjunto de dados em uma tabela Wdata, adicione um evento Executar cadeia que use uma cadeia criada a partir de e Atualizar conjuntos de dados em uma tabela modelo.
Etapa 6. Publicar e executar a cadeia
Para permitir a execução da cadeia:
- Clique em Publicar.
- Insira qualquer comentário sobre sua publicação e clique em Publicar.
Para executar a corrente:
- Em Cadeias, selecione Editar no menu da cadeia.
- Clique em Configurações da cadeia, digite os valores das variáveis para especificar os dados a serem baixados e clique em Salvar.
- Clique em Executar e Executar cadeia.