Em Chain Builder, você pode usar esses modelos de cadeia que, juntos, simplificam o roll forward de dados ambientais, sociais e de governança (ESG) ou de sustentabilidade:
- 1a. ESG roll forward | Primário | Comece aqui
- 1b. Roll forward do ESG | Atualizar conexões & status
- 1c. Reversão do ESG | Atualizar conexão | Execução
Dica: Embora você crie três cadeias a partir desses modelos, você executará apenas a primeira cadeia criada, que executa automaticamente todas elas.
Observação: Essas cadeias transferem apenas as planilhas de coleta de dados - não a Programa de Sustentabilidade. Para saber como transferir valores em um programa, consulte Transferir e gerenciar anos de relatório no Programa de Sustentabilidade.
Quando você executa cadeias criadas a partir desses modelos, elas trabalham juntas para arquivar e importar automaticamente o conjunto de dados ESG do ano anterior para uma tabela. Ao executar as cadeias, você também pode optar por:
- Atualize as conexões da planilha de origem antes de importar o conjunto de dados, por exemplo, para garantir os valores mais recentes
- Limpar valores na planilha de origem (exceto aqueles vinculados a origens ou destinos), como preparação para a coleta de dados do próximo ano
Observação: Essas cadeias substituem automaticamente qualquer conjunto de dados do mesmo período na tabela Wdata conectada. Se ocorrer um erro ao importar o novo conjunto de dados, a tabela será revertida para o conjunto de dados anterior.
Pré-requisitos
As cadeias criadas a partir desses modelos exigem conectores específicos para executar seus comandos.
Antes de criar cadeias a partir desses modelos, configure esses conectores no Construtor de Cadeia:
- Workiva conector
- Cadeias Workiva conector
- Transformação tabular conector
- Conector JSON
- Handlebars conector
- Utilitários de arquivo conector
- Solicitação HTTP conector
Observação: Todos os conectores usados nas cadeias desses modelos usam o CloudGroundRunner padrão. Não são necessários GroundRunners.
Observação: Para executar seus comandos, o conector de solicitação HTTP exige o ID do cliente e o segredo da concessão do OAuth criada para o usuário de integração do conector Workiva. Certifique-se de que a concessão do OAuth tenha o escopo apropriado.
Etapa 1. Configurar os arquivos do Workiva
As cadeias criadas a partir desses modelos requerem uma configuração específica dos arquivos Workiva para dados de sustentabilidade. Antes de executar as cadeias desses modelos, configure os arquivos Workiva para coletar e transferir os dados ESG:
- Em Planilhas, identifique a planilha de coleta de dados usada para o relatório de sustentabilidade.
- No Wdata, crie uma tabela que use a planilha como um conjunto de dados conectado , e registre o ID da tabela para quando você executar as cadeias.
- Na planilha, adicione uma planilha para rastrear o status de atualização da conexão de saída com a tabela Wdata e registre o nome da planilha para quando você executar as cadeias.
- Crie uma consulta para ser executada quando as cadeias arquivarem dados:
- Use a tabela Wdata conectada à planilha de coleta de dados como uma fonte de dados .
- Na consulta, inclui um parâmetro de seleção múltipla para Year, com o mesmo tipo de dados da coluna Year da tabela.
- Registre o ID da consulta para quando você executar as cadeias.
Etapa 2. Determinar valores para variáveis e entradas de tempo de execução
Para permitir que as cadeias trabalhem com vários espaços de trabalho, elas usam variáveis para identificar o usuário e os ambientes de integração do conector Workiva. Em Construtor de Cadeia, crie essas variáveis de espaço de trabalho:
| Variável | Valor |
|---|---|
| wsv-ClientID | O ID do cliente da concessão OAuth2 criada para o usuário de integração da Workiva |
| wsv-ClientSecret | O segredo do cliente gerado para a concessão OAuth2 criada para o usuário de integração |
| wsv-BaseURL-Wdata | A base do host do URL e o caminho da base para os comandos Wdata, com base na região do ambiente:
|
| wsv-BaseURL-IAM | A base do host de URL e o caminho da base para os comandos do Identity and Access Management, com base na região do ambiente:
|
| wsv-BaseURL-OC | O URL do host base e o caminho base para os comandos Cadeias, com base na região do ambiente:
|
Quando você executa a cadeia criada a partir do site 1a. ESG roll forward | Primário | Inicie aqui modelo, ele solicita entradas de tempo de execução para identificar os arquivos Workiva com os quais interagir e como identificar o conjunto de dados:
| Entrada em tempo de execução | Valor |
|---|---|
| Coleta de dados - ID da tabela progressiva | O ID da tabela Wdata - conectada à planilha de coleta de dados - para importar o conjunto de dados para você |
| Coleta de dados - ID da consulta de encaminhamento | A ID da consulta Wdata a ser executada para arquivar dados |
| Ano PY | O ano dos dados a serem arquivados |
| Valor da tag | O nome do conjunto de dados arquivado Observação: As cadeias usam a entrada Tag value com a entrada PY year para criar o nome do arquivo do conjunto de dados, como |
| Status—SheetName | O nome da planilha para rastrear o status de atualização da conexão de saída da planilha com a tabela Wdata |
Etapa 3. Criar as correntes
Para criar as cadeias necessárias para avançar na coleta de dados de ESG, use o site 1a. ESG roll forward | Primário | Inicie aqui modelo:
- Em Modelos em Construtor de Cadeia, abra o 1a. ESG roll forward | Primário | Iniciar here modelo, e clique em Nova cadeia.
- Digite um nome para ajudar a identificar a cadeia.
- Selecione o ambiente para usar a cadeia e clique em Próximo.
- Para a variável dcv-clearSuccess, digite o nome
dvc-clearSuccesse clique em Próximo. - Para cada conexão, selecione o conector a ser usado e clique em Próxima cadeia.
Observação: Para cada conector, use o CloudGroundRunner padrão.
- Configure cada variável e clique em Próximo.
Variável Tipo de variável Nova variável wsv-ClientID Espaço de trabalho Selecione wsv-ClientID. cv-TimeToCheck Cadeia cv-TimeToCheckwsv-ClientSecret Espaço de trabalho Selecione wsv-ClientSecret. dcv-RefreshStatus Dinâmica da cadeia dcv-RefreshStatuswsv-BaseURL-IAM Espaço de trabalho Selecione wsv-BaseURL-IAM. wsv-BaseURL-OC Espaço de trabalho Selecione wsv-BaseURL-OC. - Para cada conexão, selecione o conector a ser usado e clique em Próxima cadeia.
Observação: Para cada conector, use o CloudGroundRunner padrão.
- Configure cada variável e clique em Próximo.
Variável Tipo de variável Nova variável dcv-srcStatus Dinâmica da cadeia dcv-srcStatuswsv-ClientID Espaço de trabalho Selecione wsv-ClientID. dcv-destStatus Dinâmica da cadeia dcv-destStatuswsv-ClientSecret Espaço de trabalho Selecione wsv-ClientSecret. wsv-BaseURL-Wdata Espaço de trabalho Selecione wsv-BaseURL-Wdata. wsv-BaseURL-IAM Espaço de trabalho Selecione wsv-BaseURL-IAM. - Para cada conexão, selecione o conector a ser usado e clique em Enviar.
Observação: Para cada conector, use o CloudGroundRunner padrão.
Etapa 4. Publicar as cadeias
Observação: Para facilitar a instalação, o modelo Atualizar conexões & status tem um evento Executar cadeia. Antes de publicar as cadeias criadas a partir dos modelos, exclua esse evento estranho Executar cadeia.
- Em Cadeias, para a cadeia criada a partir do modelo Atualizar conexões & status, selecione Editar.
- Selecione o evento Executar cadeia - Excluir e clique em Excluir e Excluir.
- Clique em Publicar e Publicar.
- Em Cadeias, para a cadeia criada a partir do modelo Primário, selecione Editar.
- Clique em Publicar e Publicar.
- Em Cadeias, para a cadeia criada a partir do modelo Execução, selecione Editar.
- Clique em Publicar e Publicar.
Executar as correntes
Arquivar seus dados ESG e se preparar para a coleta de dados do próximo ano:
- Em Construtor de Cadeia, em Cadeias, selecione Executar para a cadeia criada a partir de 1a.ESG roll forward | Primário | Inicie aqui modelo.
- Clique em Executar with inputs e insira os inputs de tempo de execução:
Entrada em tempo de execução Valor Coleta de dados - ID da tabela progressiva Digite o ID da tabela Wdata para importar o conjunto de dados. Coleta de dados - ID da consulta de encaminhamento Digite o ID da consulta a ser executada para arquivar dados. Ano PY Digite o ano dos dados a serem arquivados. Valor da tag Digite o nome do conjunto de dados arquivado. Observação: Com a entrada PY year, essa entrada cria o nome de arquivo do conjunto de dados como
[Tag value]_[PY year].csv. Por exemplo, um PY year de 2021 e Tag value de Arquivado cria o nome de arquivoArchived_2021.csv.Atualizar as conexões da planilha antes do arquivamento dos dados Selecione se deseja atualizar as conexões de saída da planilha com a tabela Wdata antes da execução da consulta de rolagem, por exemplo, para atualizar o conjunto de dados antes do arquivamento. Status—SheetName Digite o nome da planilha que rastreia o status de atualização das conexões de saída da planilha para a tabela Wdata. RefreshExecution—ChainName Digite o nome da cadeia criada a partir do modelo ESG Rollforward | Atualizar conexão | Execução. Limpar coluna Valor da planilha Selecione se deseja excluir os valores de input da planilha como parte da rolagem. Observação: Nenhum valor com um link de origem ou destino será excluído.
- Para garantir os valores mais recentes antes de importar o conjunto de dados, selecione Atualizar conexões antes do arquivamento dos dados.
Se você selecionar essa opção, as cadeias atualizarão as conexões de saída da planilha e acompanharão seu status de atualização em uma planilha de controle:- Em Status—SheetName, digite o nome da planilha na planilha de origem onde as cadeias podem salvar o status de atualização das conexões de saída.
- Em RefreshExecution—ChainName, digite o nome da cadeia criada a partir do modelo ESG Rollforward | Atualizar conexão | Execução.
Dica: A atualização pode levar até alguns minutos, dependendo do número de conexões de saída da planilha. Para ajustar o tempo de espera, edite o evento Pausar cadeia da cadeia criada a partir do evento 1b. ESG roll forward | Atualizar conexões & status modelo.
- Para excluir valores de entrada da planilha de origem como parte do arquivamento, por exemplo, para preparar a coleta de dados do próximo ano, selecione Limpar coluna de valores da planilha.
Observação: A cadeia retém todos os valores vinculados a uma origem ou destino. Não é possível recuperar nenhum valor excluído da planilha. Recomendamos que você selecione essa opção somente para o rollforward final do ano, a fim de preparar a planilha para a coleta de dados do ano seguinte.
Dica: Por padrão, a cadeia exclui os valores que começam na linha 2 das planilhas da planilha. Para ajustar isso, edite a propriedade Região do comando Limpar dados da planilha.
- Clique em Iniciar.