Centro de suporte da Workiva

A plataforma climática empresarial da Watershed permite que você meça, relate e reduza a pegada de carbono da sua organização.

Com a Plataforma Workiva, você pode criar cadeias para baixar automaticamente os dados de pegada de carbono do Watershed - por exemplo, para divulgação em seu relatório de sustentabilidade ou ambiental, social e de governança (ESG) - em uma tabela, com base em um período de tempo especificado em uma planilha personalizada Watershed. Em seguida, você pode usar a tabela como fonte para uma consulta ou conexão de planilha, como, por exemplo, para incluir os dados em saídas de relatórios.

Observação: Ao criar várias cadeias nestas instruções, você executará apenas uma cadeia - que, por sua vez, executará automaticamente as outras - para fazer download dos dados do Watershed e atualizar a planilha.

Observação: A planilha Watershed usada por essas cadeias é fornecida pela Workiva. Se não o tiver, mas estiver interessado, entre em contato com o Customer Success Manager (CSM) para obter detalhes.

Pré-requisitos

Para construir essas correntes, você precisará desses conectores:

• Workiva conector
• Transformação tabular conector
• Conector JSON
• Solicitação HTTP conector
• Utilitários de arquivo conector

Dica: Todos os comandos das cadeias usam o CloudExecutarner padrão. Não são necessários GroundExecutarners.

Para executar as cadeias com sucesso, identifique também:

• A chave para o provedor de atividade usar para autenticar e executar ações com a API do Watershed
• Os IDs da planilha Watershed , sua seção Control sheet e sua tabela conectada

Crie uma cadeia para registrar downloads de dados

Para começar, crie uma cadeia para atualizar a seção Control sheet para acompanhar quando os dados de pegada de carbono são carregados na Workiva.

Etapa 1. Criar a cadeia

1. Em Cadeias, clique em Criar e selecione Criar cadeia.
   
2. Em Setup, digite um nome para 3. Watershed e uma descrição para ajudar a identificar que a cadeia registra os carregamentos de dados do Watershed.
   
3. Clique em Salvar.
   
   

Etapa 2. Comece com um evento Entradas de tempo de execução

1. De Eventos em cadeia, mova Entradas de tempo de execução para Iniciar.
2. Selecione o evento Entradas de tempo de execução e clique em Editar.
3. Em Informações básicas, digite um nome e uma descrição para ajudar a identificar o evento.
   
4. Em Variáveis, adicione entradas TextField com esses nomes de exibição:
   • Faixa
   • SpreadsheetID
   • SheetID

   Dica: Deixe os valores padrão dessas variáveis em branco; eles serão gerados quando você executar o 1. Cadeia da bacia hidrográfica criada mais tarde.

5. Selecione Obrigatório para todas as três variáveis e clique em Salvar.
   
   

Etapa 3. Adicionar um comando Utilidades de arquivos Criar Arquivo

Para criar o arquivo de log para a seção Planilha de controle, adicione um comando Utilidades de arquivos Criar arquivos:

1. Em Available connectors, selecione File Utilities e mova Create file para a tela.
2. Arraste um link de Entradas de tempo de execução para Criar arquivo.
3. Selecione o comando Criar arquivos e clique em Editar.
4. Em Informações básicas, digite um nome e uma descrição para ajudar a identificar o comando.
   
5. Digite as propriedades do comando e clique em Salvar:
   

   Propriedade	Valor
   Conector	Selecione o conector de utilitários de arquivo a ser usado.
   Texto	Digite Footprint data last refreshed on e selecione a variável de tempo de execução System.DateTime.

Etapa 4. Adicionar um comando Workiva Write Sheet Data

Para atualizar a seção Planilha de controle com o arquivo de registro, adicione um comando Workiva Digitar dados da planilha:

1. Em Available connectors, selecione Workiva e mova Write sheet data para a tela.
2. Arraste um link de Crie um arquivo para Digitar dados da planilha.
3. Selecione o comando Digitar dados da planilha e clique em Editar.
4. Em Informações básicas, digite um nome e uma descrição para ajudar a identificar o comando.
5. Digite as propriedades do comando e clique em Salvar:
   
   

   Propriedade	Valor
   Conector	Selecione o conector Workiva a ser usado.
   ID da planilha	Selecione a entrada de tempo de execução SpreadsheetID em Acionar.
   ID/nome da planilha	Selecione a entrada de tempo de execução SheetID de Acionar.
   Arquivo de dados	Selecione a saída Arquivo criado do comando Criar arquivos.
   Delimitador	Digite uma vírgula (,).
   Região	Selecione a entrada de tempo de execução Faixa em Acionar.

6. Clique em Publicar, insira uma nota sobre sua publicação e clique em Publicar.

Criar cadeias a partir do modelo Carregar dados no Wdata

Em seguida, use o modelo Load Data to Wdata para criar cadeias para atualizar a tabela conectada da planilha Watershed com os dados baixados do Watershed. O modelo Carregar dados no Wdata cria cadeias que funcionam em conjunto para determinar se o conjunto de dados já existe na tabela e atualizar a tabela com o conjunto de dados mais recente.

Para criar as cadeias a partir de Modelos, abra o modelo Carregar dados no Wdata | Cadeia primária e clique em Nova cadeia.

Crie uma cadeia para fazer download de dados do Watershed

Por fim, crie uma cadeia para fazer download e importar dados de pegada de carbono do Watershed.

Observação: Crie as outras duas cadeias antes desta, para seus eventos Executar cadeia.

Etapa 1. Criar a cadeia

1. Em Cadeias, clique em Criar e selecione Criar cadeia.
2. Em Setup, digite um nome de 1. Watershed e uma descrição para ajudar a identificar melhor a cadeia.
   
3. Em Variables, adicione variáveis para a chave da API do Watershed e os IDs da planilha do Watershed e sua planilha de controle.
   

   Nome	Valor
   APIKey	Digite a chave da API do Watershed.
   ID da planilha	Insira o ID da planilha do Watershed.
   ID da planilha	Digite o ID da seção Control sheet da planilha Watershed.

4. Clique em Salvar.
   
   

Etapa 2. Comece com um comando Workiva Get Sheet Data

Comece com um comando Workiva Get sheet data para identificar os dados a serem baixados, com base no período de tempo na planilha Watershed Control sheet:

1. De Conectores disponíveis, selecione Workiva, e mova Obter dados da planilha para Iniciar.
2. Selecione o comando Obter dados da planilha e clique em Editar.
3. Em Informações básicas, digite um nome e uma descrição para ajudar a identificar o comando.
4. Digite as propriedades do comando e clique em Salvar:
   
   

   Propriedade	Valor
   Conector	Selecione o conector Workiva a ser usado.
   ID da planilha	Selecione a variável de cadeia Spreadsheet ID.
   ID/nome da planilha	Selecione a variável de cadeia Sheet ID.
   Região	Digite A11:.
   Estilo de valor	Selecione Calculado.
   Revisão	Para garantir a versão mais recente, digite -1.

Etapa 3. Adicione comandos para preparar o período de tempo para o Watershed

Para identificar o período de tempo para a bacia hidrográfica, adicione Consulta avançada e CSV para comandos JSON:

1. Em Available connectors, selecione Tabular Transformation e mova Advanced query para a tela.
2. Arraste um link de Obter dados da planilha para Consulta avançada.
3. Selecione o comando Busca avançada e clique em Editar.
4. Em Informações básicas, digite um nome e uma descrição para ajudar a identificar o comando.
5. Digite as propriedades do comando e clique em Salvar:
   
   

   Propriedade	Valor
   Conector	Selecione o conector de Transformação Tabular a ser usado.
   Tabelas	Adicione a tabela para os dados do período de tempo: Em Arquivo, selecione a saída Data do comando Obter dados da planilha. Em Nome da tabela, digite a.
   Consulta	Digite a consulta a ser executada: select case when `Start Month` = 'January' then '01' when `Start Month` = 'February' then '02' when `Start Month` = 'March' then '03' when `Start Month` = 'April' then '04' when `Start Month` = 'May' then '05' when `Start Month` = 'June' then '06' when `Start Month` = 'July' then '07' when `Start Month` = 'August' then '08' when `Start Month` = 'September' then '09' when `Start Month` = 'October' then '10' when `Start Month` = 'November' then '11' else '12' end as 'sm', case when `End Month` = 'January' then '01' when `End Month` = 'February' then '02' when `End Month` = 'March' then '03' when `End Month` = 'April' then '04' when `End Month` = 'May' then '05' when `End Month` = 'June' then '06' quando `Final do Mês` = 'Julho' então '07' quando `Final do Mês` = 'Agosto' então '08' quando `Final do Mês` = 'Setembro' então '09' quando `Final do Mês` = 'Outubro' então '10' quando `Final do Mês` = 'Novembro' então '11' senão '12' finalizar como 'em', `Reporting Year` as 'ry', TableId as 'tid' from a
   Delimitador de entrada	Selecione Vírgula.
   Delimitador de saída	Selecione Vírgula.
   Prévia dos resultados	Marque essa caixa de seleção.

6. Em Conectores disponíveis, selecione JSON e mova CSV para JSON para a tela.
7. Arraste um link de Consulta avançada para CSV para JSON.
8. Selecione o comando CSV para JSON e clique em Editar.
9. Em Informações básicas, digite um nome e uma descrição para ajudar a identificar o comando.
   
10. Digite as propriedades do comando e clique em Salvar:
    

    Propriedade	Valor
    Conector	Selecione o conector JSON a ser usado.
    Arquivo de entrada	Selecione a saída Resultado do comando Busca avançada.
    Delimitador	Selecione Comma (,).

Etapa 4. Adicionar um comando GET de solicitação HTTP

Para fazer download dos dados de pegada de carbono do período selecionado, adicione um comando HTTP Request GET:

1. Em Conectores disponíveis, selecione HTTP Request e mova GET para a tela.
2. Arraste um link de CSV para JSON para GET.
3. Selecione o comando GET e clique em Editar.
4. Em Informações básicas, digite um nome e uma descrição para ajudar a identificar o comando.
5. Digite as propriedades do comando e clique em Salvar:
   
   

   Propriedade	Valor
   Conector	Selecione o conector de solicitação HTTP a ser usado.
   Mostrar resposta	Marque essa caixa de seleção.
   URL	Digite https://api.watershedclimate.com/v1/report/footprint_detail.
   Cadeia de consulta	Digite a string de consulta para indicar os meses de início e fim dos dados a serem baixados: Para o mês inicial, digite startMonth= e selecione o arquivo JSON, resultado do comando CSV to JSON duas vezes. Em seguida, para o mês final, digite &endMonth= e selecione o arquivo JSON saída do comando CSV to JSON mais duas vezes. Para ambos os meses, clique na primeira saída do arquivo JSON e aplique uma transformação Obter variável de JSON: Em Saída, selecione Texto. Em Valor, digite 0 e ry. Para ambos os meses, clique na segunda saída do arquivo JSON e aplique outra transformação Obter variável de JSON: Em Saída, selecione Texto. Em Value, digite 0 e sm.
   Headers	Adicione um header: Em Chave, digite Authorization. Em Value, insira Bearer e, em seguida, selecione a variável de cadeia APIKey.
   Tipo de conteúdo	Digite application/json.

Etapa 5. Adicione eventos de cadeia de execução para realizar e registrar o upload de dados

Para carregar os dados no Wdata e registrar o carregamento na seção Planilha de controle, adicione eventos Executar cadeia para as cadeias criadas anteriormente:

1. Em Eventos em cadeia, mova Executar cadeia para a tela.
2. Arraste um link de GET para Execute a cadeia.
3. Selecione o evento Executar cadeia e clique em Editar.
4. Em Informações básicas, digite um nome e uma descrição para ajudar a identificar que o evento carrega os dados no Wdata.
5. Em Cadeia para executar, selecione Carregar dados no Wdata | Cadeia primária criado anteriormente a partir do modelo Carregar dados no Wdata.
   
6. Digite as entradas de tempo de execução da cadeia e clique em Salvar:

   Entrada	Valor
   ID da tabela	Para fornecer o ID da tabela Wdata para a qual você fará o upload dos dados: Selecione o arquivo JSON saída do comando CSV para JSON. Clique na saída do arquivo JSON e aplique uma transformação Get variable from JSON: Em Saída, selecione Texto. Em Valor, digite 0 e tid.
   Prefixo do arquivo	Para definir o prefixo do conjunto de dados a ser carregado, com base no período de tempo dos dados: Para o mês inicial, selecione o arquivo JSON saída do comando CSV to JSON duas vezes. Digite um sublinhado (_). Para o final do mês, selecione o arquivo JSON saída do comando CSV to JSON mais duas vezes. Digite . csv. Para ambos os meses, clique na primeira saída do arquivo JSON e aplique uma transformação Obter variável de JSON: Em Saída, selecione Texto. Em Valor, digite 0 e ry. Para ambos os meses, clique na segunda saída do arquivo JSON e aplique outra transformação Obter variável de JSON: Em Saída, selecione Texto. Em Value, digite 0 e sm.
   Arquivo de dados	Selecione a saída Response do comando GET.
   Método de carga	Selecione Substituir conjunto de dados.
   Reversão	Marque essa caixa de seleção.

7. Em Eventos em cadeia, mova outro Executar cadeia para a tela.
8. Arraste um link da primeira corrente Executar para a segunda.
9. Selecione o segundo evento Executar cadeia e clique em Editar.
10. Em Informações básicas, digite um nome e uma descrição para ajudar a identificar que o evento registra o upload de dados na planilha Watershed.
11. Em Cadeia para executar, selecione 3. Watershed chain criada anteriormente.
    
12. Digite as entradas de tempo de execução da cadeia e clique em Salvar:

    Entrada	Valor
    Faixa	Digite F12:F12.
    ID da planilha	Selecione a variável de cadeia SpreadsheetID.
    Sheet ID	Selecione a variável de cadeia SheetID.

13. Clique em Publicar, insira as observações sobre a publicação e clique em Publicar.
    
    

Executar as correntes

Para atualizar a planilha Watershed com os dados mais recentes de pegada de carbono:

1. Na seção Control sheet da planilha Watershed, selecione o período de tempo - meses e ano - dos dados a serem baixados do Watershed.
   
2. Em Wdata Chains, selecione a cadeia 1. Cadeia da bacia hidrográfica e clique em Execute e Execute a cadeia.
   
   

   Observação: Quando você executa essa cadeia, ela executa automaticamente as duas outras cadeias para atualizar a tabela Wdata e a planilha Watershed com os dados.