Centro de suporte da Workiva

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:

1. Em Planilhas, identifique a planilha de coleta de dados usada para o relatório de sustentabilidade.
2. 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.
3. 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. 
4. 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:

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:

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:

1. Em Modelos em Construtor de Cadeia, abra o 1a. ESG roll forward | Primário | Iniciar here modelo, e clique em Nova cadeia.
2. Digite um nome para ajudar a identificar a cadeia.
   
3. Selecione o ambiente para usar a cadeia e clique em Próximo.
4. Para a variável dcv-clearSuccess, digite o nome dvc-clearSuccess e clique em Próximo.
   
5. 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.

   
6. 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-TimeToCheck
   wsv-ClientSecret	Espaço de trabalho	Selecione wsv-ClientSecret.
   dcv-RefreshStatus	Dinâmica da cadeia	dcv-RefreshStatus
   wsv-BaseURL-IAM	Espaço de trabalho	Selecione wsv-BaseURL-IAM.
   wsv-BaseURL-OC	Espaço de trabalho	Selecione wsv-BaseURL-OC.

7. 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.

8. 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-srcStatus
   wsv-ClientID	Espaço de trabalho	Selecione wsv-ClientID.
   dcv-destStatus	Dinâmica da cadeia	dcv-destStatus
   wsv-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.

9. 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.

1. Em Cadeias, para a cadeia criada a partir do modelo Atualizar conexões & status, selecione Editar.
   
2. Selecione o evento Executar cadeia - Excluir e clique em Excluir e Excluir.
   
3. Clique em Publicar e Publicar.
4. Em Cadeias, para a cadeia criada a partir do modelo Primário, selecione Editar.
5. Clique em Publicar e Publicar.
6. Em Cadeias, para a cadeia criada a partir do modelo Execução, selecione Editar.
7. Clique em Publicar e Publicar.

Executar as correntes

Arquivar seus dados ESG e se preparar para a coleta de dados do próximo ano:

1. Em Construtor de Cadeia, em Cadeias, selecione Executar para a cadeia criada a partir de 1a.ESG roll forward | Primário | Inicie aqui modelo.
   
2. 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 arquivo Archived_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.

3. 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.

4. 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.

5. Clique em Iniciar.