Centro de suporte da Workiva

O Urjanet Utility Cloud® permite que as empresas atuem em seu impacto climático com dados precisos e sob demanda de fornecedores de serviços públicos em todo o mundo. 

Com a Workiva, é possível criar cadeias para baixar automaticamente dados de serviços públicos do Urjanet em uma tabela, com base em um período de tempo especificado em uma planilha personalizada Urjanet planilha de controle. Você pode usar essa tabela como fonte para uma consulta ou conexão de planilha para incluir seus dados em resultados de relatórios ambientais, sociais e de governança (ESG) ou de sustentabilidade.

Observação: Embora crie várias cadeias nestas instruções, você executará apenas uma cadeia - que, em seguida, executará automaticamente as outras - para baixar dados do Urjanet e atualizar a planilha.

Observação: A planilha de controle Urjanet 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
• Handlebars 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:

• O nome de usuário e a senha a serem usados para autenticar e acessar os serviços Urjanet
• Os IDs do Urjanet planilha de controle planilha, sua seção Planilha de controle e sua tabela conectada

Crie uma cadeia para registrar downloads de dados

Para começar, crie uma cadeia para atualizar a seção Planilha de controle para acompanhar quando os dados do utilitário são carregados na Workiva.

Etapa 1. Criar a cadeia

1. Em Cadeias, clique em Criar e selecione Criar cadeia.
   
2. Em Configurar, digite um nome para 3. Urjanet e uma descrição para ajudar a identificar que a cadeia registra uploads de dados de utilitários.
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. Urjanet cadeia criada posteriormente.

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 Site usage data last atualizared 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 Carregar dados no Wdata para criar cadeias e atualizar a tabela conectada da planilha Urjanet planilha de controle com os dados baixados da Urjanet. 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 baixar dados do Urjanet

Por fim, crie uma cadeia para baixar e importar dados de utilitários do Urjanet.

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 Configurar, digite um nome de 1. Urjanet e uma descrição para ajudar a identificar melhor a cadeia.
   
3. Em Variáveis, adicione variáveis para suas credenciais Urjanet e os IDs da planilha Urjanet planilha de controle e sua seção Planilha de controle.
   

   Nome	Valor
   Nome de usuário do Urjanet	Digite o nome de usuário a ser usado para acessar os serviços do Urjanet.
   Senha do Urjanet	Digite a senha a ser usada para acessar os serviços do Urjanet.
   ID da planilha	Insira o ID da planilha de controle Urjanet.
   ID da planilha	Digite o ID da planilha Planilha de controle seção da planilha.

4. Clique em Salvar.
   
   

Etapa 2. Comece com um comando Workiva Get Sheet Data

Comece com um comando Workiva Obter dados da planilha para identificar os dados a serem baixados, com base no período de tempo na planilha Urjanet planilha de controle:

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 mesmo conector Workiva da cadeia anterior.
   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:E12.
   Estilo de valor	Selecione Calculado.
   Revisão	Para garantir a versão mais recente, digite -1.

Etapa 3. Adicionar comandos para preparar o período de tempo para o Urjanet

Para identificar o período de tempo para o Urjanet, 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-01' when `Start Month` = 'February' then '02-01' when `Start Month` = 'March' then '03-01' when `Start Month` = 'April' then '04-01' when `Start Month` = 'May' then '05-01' when `Start Month` = 'June' then '06-01' when `Start Month` = 'July' then '07-01' when `Start Month` = 'August' then '08-01' when `Start Month` = 'September' then '09-01' when `Start Month` = 'October' then '10-01' when `Start Month` = 'November' then '11-01' else '12-01' end as 'sm', case when `End Month` = 'January' then '01-31' when `End Month` = 'February' then '02-28' when `End Month` = 'March' then '03-31' when `End Month` = 'April' then '04-30' when `End Month` = 'May' then '05-31' when `End Month` = 'June' then '06-30' when `End Month` = 'July' then '07-31' when `End Month` = 'August' then '08-31' when `End Month` = 'September' then '09-30' when `End Month` = 'October' then '10-31' when `End Month` = 'November' then '11-30' else '12-31' end as '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. Adicione um comando POST para enviar um token de portador para o Urjanet

Para fornecer ao Urjanet o token de portador para autenticação, adicione um comando HTTP POST:

1. De Conectores disponíveis, selecione HTTP e mova POST para a tela.
2. Arraste um link de CSV para JSON para POST.
3. Selecione o comando POST 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 HTTP a ser usado.
   Mostrar resposta	Marque essa caixa de seleção.
   URL	Digite https://api.urjanet.com/auth/login.
   Tipo de conteúdo	Digite application/json.
   Texto do corpo	Digite a string para criar o token de portador: Digite {"password":". Selecione a variável Urjanetpassword em Cadeia. Digite ", "username":" Selecione a variável Urjanetusername em Cadeia. Digite "}.
   Esquema de saída	Digite este exemplo de resposta: {"status":200,"message":"Authentication Successful","type":"Bearer","token":"abc","expires":"1694017012"}

Etapa 5. Adicionar comandos para obter sites do Urjanet

Para recuperar e analisar os sites de sua conta Urjanet, adicione um comando HTTP GET e Handlebars Renderizar modelo de texto:

1. De Conectores disponíveis, selecione HTTP e mova GET para a tela.
2. Arraste um link de POST 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 mesmo conector HTTP usado anteriormente.
   Mostrar resposta	Marque essa caixa de seleção.
   URL	Digite https://api.urjanet.com/utility/sites.
   Headers	Adicione este cabeçalho: Em Chave, digite authorization. Em Valor, selecione Tipo e, em seguida, Token na saída Resposta do comando POST.
   Tipo de conteúdo	Digite application/json.
   Esquema de saída	Digite este exemplo de resposta: { "_embedded" : { "sites" : [ { "createdBy" : "jack.doe", "createdDate" : "2023-08-29T18:49:32.000+00:00", "entityId" : "1ee469cc-a606-d007-9415-eeeb8714a7ae", "facilityType" : "Office", "lastModifiedBy" : "jack.doe", "lastModifiedDate" : "2023-08-29T18:49:32.000+00:00", "region" : null, "serviceAddress" : { "addressType" : "RAW", "city" : "CHICAGO", "country" : "USA", "fullAddress" : "123 EVERGREEN TERRACE, CHICAGO, IL, 60603, USA", "postalCode" : "60603", "recipient" : null, "state" : "IL", "streetLine1" : "123 EVERGREEN TERRACE", "streetLine2" : null }, "siteCode" : "DIO", "siteName" : "Doe, Inc.", "siteNumber" : "1", "subRegion" : null, "_links" : { "self" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae" }, "accounts" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/accounts" }, "credentials" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/credentials" }, "events" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/events" }, "meters" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/meters" }, "statements" : { "href" : "https://api.urjanet.com/utility/sites/1ee469cc-a606-d007-9415-eeeb8714a7ae/statements" } } } ] }, "_links" : { "self" : { "href" : "https://api.urjanet.com/utility/sites?page=0&size=20" } }, "page" : { "size" : 20, "totalElements" : 1, "totalPages" : 1, "number" : 0 } }

6. Em Available connectors, selecione Handlebars e mova Render text template para a tela.
7. Arraste um link de GET para Renderizar modelo de texto.
8. Selecione o comando Renderizar texto modelo 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 do guidão a ser usado.
    Modelo	Digite este modelo de texto: [{{#each a}} "{{entityId}}" {{#unless @last}}, {{/unless}}{{/each}}]
    Variáveis JSON	Adicione esta variável: Em Nome, digite a. Em Valor, selecione sites de _embedded da Resposta saída do comando GET.

Etapa 6. Adicione comandos para solicitar dados do site do Urjanet

Para solicitar os dados do site da sua empresa ao Urjanet, adicione outro comando HTTP POST, seguido de um evento Pausar cadeia para dar tempo ao processamento da solicitação:

1. De Conectores disponíveis, selecione HTTP e mova POST para a tela.
2. Arraste um link de Renderizar modelo de texto para POST.
3. Selecione o comando POST 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 mesmo conector HTTP usado anteriormente.
   Mostrar resposta	Marque essa caixa de seleção.
   URL	Digite https://api.urjanet.com/utility/sites/downloads/usages.
   Tipo de conteúdo	Digite application/json.
   Texto do corpo	Digite a string para criar o token de portador: Digite {"siteIds":. Selecione a saída Texto renderizado do comando Renderizar texto modelo. Digite , "startDate":" Selecione a saída do arquivo JSON do comando CSV para JSON e aplique uma transformação de variável Obter valor de JSON: Em Saída, selecione Texto. Em Valor, digite 0 e, em seguida, ry. Digite -. Selecione a saída do arquivo JSON do comando CSV para JSON e aplique uma transformação de variável Obter valor de JSON: Em Saída, selecione Texto. Em Valor, digite 0 e, em seguida, sm. Digite ", "endDate":". Selecione a saída do arquivo JSON do comando CSV para JSON e aplique uma transformação de variável Obter valor de JSON: Em Saída, selecione Texto. Em Valor, digite 0 e, em seguida, ry. Digite -. Selecione a saída do arquivo JSON do comando CSV para JSON e aplique uma transformação de variável Obter valor de JSON: Em Saída, selecione Texto. Em Valor, digite 0 e, em seguida, em. Digite ", "saídaFormat": "CSV"}.
   Headers	Adicione dois cabeçalhos: Um headerauthorization: Em Chave, digite authorization. Em Valor, selecione Tipo e, em seguida, Token na saída Resposta do primeiro comando POST. Um header accept: Em Chave, digite accept. Em Valor, digite application/json.
   Esquema de saída	Digite este exemplo de resposta: { "createdDate" : "2023-09-19T15:11:09.944+00:00", "entityId" : "1ee56fec-3a9c-d96e-a849-a6c381b08d2b", "_links" : { "download" : { "href" : "https://api.urjanet.com/utility/downloads/1ee56fec-3a9c-d96e-a849-a6c381b08d2btpnu" } }}

6. Em Eventos em cadeia, mova Pausar cadeia para a tela.
7. Arraste um link de POST para Pausar cadeia.
8. Selecione o evento Pausar cadeia 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 os detalhes do evento e clique em Salvar:
    

    Detalhes	Valor
    Tempo de espera	Digite 6.
    Unidade de tempo de espera	Selecione Seconds (Segundos).

Etapa 7. Adicione comandos para baixar os dados do site como um CSV

Para fazer download dos dados do site do Urjanet como um arquivo CSV, adicione outro comando HTTP GET e um comando Transformação tabular Headers de mapa:

1. De Conectores disponíveis, selecione HTTP e mova GET para a tela.
2. Arraste um link de POST 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 mesmo conector de solicitação HTTP usado anteriormente.
   Mostrar resposta	Marque essa caixa de seleção.
   URL	Selecione href em _links da saída Resposta do segundo comando POST.
   Headers	Adicione este cabeçalho: Em Chave, digite authorization. Em Valor, selecione Tipo e, em seguida, Token na saída Resposta do primeiro comando POST.
   Tipo de conteúdo	Digite application/json.

6. Em Available connectors, selecione Tabular Transformation e mova Map headers para a tela.
7. Arraste um link de GET para Headers de mapa.
8. Selecione o comando Headers de mapa 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 mesmo conector de Transformação Tabular usado anteriormente.
    Arquivo de entrada	Selecione a saída Resposta do segundo comando GET.
    Arquivo de saída	Digite urjanet.csv.
    Prévia dos resultados	Marque essa caixa de seleção.
    Delimitador	Selecione Vírgula.
    Cabeçalhos de entrada	Adicione os cabeçalhos do arquivo CSV baixado do Urjanet, nesta ordem: Declaração Id Início do intervalo Fim do intervalo Tipo de serviço Identificação do medidor Número do medidor Status do medidor Número da conta bruta Número de conta normalizado Nome do provedor Endereço de serviço Cidade de serviço Estado do serviço Serviço Código postal País de serviço Código do site Nome do site Número do local Região do site Sub-região do local Tipo de instalação do local Endereço do site Cidade do local Estado do site Código postal do site País do site Nome da tarifa Consumo Unidade de medida de consumo Nome do provedor adicional Número adicional da conta do provedor Classificação do provedor Encargos totais Total de cobranças Código da moeda
    Cabeçalhos de saída	Adicione os headers correspondentes à tabela que conterá os dados, nesta ordem: statement_id interval_start interval_end service_type meter_id meter_number meter_status raw_account_number normalized_account_number provider_name service_address service_city service_state service_postal_code service_country site_code site_name site_number site_region site_sub_region site_facility_type site_address site_city site_state site_postal_code site_country tariff_name consumption consumption_unit_of_measure additional_provider_name additional_provider_account_number provider_classification total_charges total_charges_currency_code

Etapa 8. Adicione eventos de cadeia de execução para as outras cadeias

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 Headers de mapa para Executar 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 carregar os dados, selecione o arquivo JSON saída do comando CSV para JSON e aplique uma transformação de variável Obter variável de JSON: Em Saída, selecione Texto. Em Valor, digite 0 e tid.
   Nome do arquivo	Para definir o nome do conjunto de dados a ser carregado, com base no período de tempo dos dados: Digite Site Usage_. Para o mês inicial, selecione o arquivo JSON saída do comando CSV para JSON, insira um traço (- e selecione o arquivo JSON saída do comando CSV para JSON novamente. Digite um sublinhado (_). Para o mês final, selecione o arquivo JSON saída do comando CSV para JSON, insira um traço (- e selecione o arquivo JSON saída do comando CSV para JSON novamente. 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 Valor, digite 0 e em.
   Arquivo de dados	Selecione a saída Headers de mapa do comando Headers de mapa.
   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 Urjanet planilha de controle.
11. Em Cadeia para executar, selecione 3. Urjanet cadeia 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 tabela com os dados mais recentes do utilitário:

1. Na seção Planilha de controle da planilha Urjanet planilha de controle, selecione o período de tempo - meses e ano - dos dados a serem baixados do Urjanet.
   
2. Em Cadeias, selecione a opção 1. Urjanet cadeia e clique em Executar e Executar cadeia.
   
   

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