Use os dados do Programa de Sustentabilidade na Consulta

Em Wdata, você pode criar consultas com base em dados em Sustainability Program, incluindo:

Tópicos, métricas, valores e tarefas
Dimensões personalizadas disponíveis para valores métricos
Tags personalizadas disponíveis para métricas

Com essas consultas, você pode:

Explore seus dados de sustentabilidade por meio de uma lente focada, usando os filtros e parâmetros.
Conecte os resultados a uma planilha, por exemplo, para exportar dados de sustentabilidade para um arquivo ou fornecer links de origem para os resultados do relatório.
Fornecer contexto adicional para as tags ou dimensões das métricas.

Adicionar programa como fonte de consulta

Para usar os dados de um programa em uma consulta:

From the query's Sources panel, click Add sources, and select Add program data.
No painel Sources da consulta, clique em New source e selecione os dados a serem incluídos nos resultados:
- Para incluir dados sobre um programa e seus tópicos, métricas, valores ou tarefas, selecione Sustainability, Sustainability program.
- Para incluir dados sobre as dimensões personalizadas disponíveis para os valores de métrica de um programa, selecione Sustainability, Program dimensions.
- Para incluir dados sobre as tags personalizadas disponíveis para as métricas de um programa, selecione Sustentabilidade, Tags do programa.
Dica: Para obter contexto adicional sobre as dimensões ou tags das métricas de um programa, adicione os dados do programa e seus dados de dimensão ou tag como fontes e crie um relacionamento para uni-los.
Procure e selecione o programa a ser usado na consulta e clique em Add.

No painel Sources, especifique como usar as colunas de dados na consulta:

Para usar colunas como resultados no Construtor, selecione-as e, em seguida, selecione Adicionar a campos ou arraste-as para a guia Campos.

Para usar colunas como filtros no Adicionar a filtros ou arraste-as para a guia Filtros.

Por exemplo, para uma consulta com uma fonte Sustainability program:

Filtrar	Devoluções
Ano do programa	Somente valores coletados para anos específicos
Dimensões	Somente métricas com dimensões personalizadas específicas aplicadas e os valores coletados para essas dimensões
Status da tarefa	Somente tarefas com status de coleta de dados específicos

Para incluir uma coluna na instrução da consulta em SQL, clique com o botão direito do mouse nela e selecione Adicionar à consulta.

Crie a consulta conforme necessário.

Colunas de origem

Quando você adiciona dados do programa como fonte, pode incluir suas colunas de dados nos resultados da consulta.

Quando você seleciona Adicionar dados do programa como fonte, a consulta pode incluir estas colunas:

Coluna	Descrição	Tipo
Nome do programa	O nome do programa	Texto
Ano do programa	O ano dos dados do programa	Inteiro
Nome da métrica	O nome de uma métrica em um tópico do programa	Texto
Código da métrica	O identificador exclusivo gerado para um índice de avaliação	Texto
Tipo de métrica	O tipo de valor coletado para um índice de avaliação - Texto, Moeda, Número, Porcentagem ou Data	Texto
Descrição da métrica	A descrição inserida para uma métrica	Texto
Dimensões	O nome e o valor da dimensão personalizada aplicados a um valor de métrica, como `{"Location": "South"}` Dica: Se suas métricas suportam várias dimensões, você pode usar os campos Dimension name e Dimension value para retornar colunas separadas para nomes e valores dimensionais.	Texto
Valor-texto	O valor inserido para um índice de avaliação, como texto	Texto
Número-valor	O valor quantitativo inserido para um índice de avaliação, como um número	Decimal
Unidade	Para um índice de avaliação com um tipo de Moeda, Número ou Porcentagem, sua unidade de medida	Texto
Anexos de apoio	Os nomes de arquivo dos anexos carregados para um valor de métrica Observação: Se um valor tiver vários anexos, seus nomes de arquivo aparecerão como uma lista separada por vírgulas. Os resultados incluem apenas os anexos uploaded; não aparecem arquivos Workiva ou endereços da Web anexados.	Texto
Tipo de fonte	Como um valor de métrica é fornecido: Manual, se inserido diretamente na métrica Fonte conectada, se for de uma planilha ou documento conectado ao site Tarefa, se você estiver no site Workiva Tasks	Texto
Arquivo de origem	Para uma métrica com um arquivo de origem conectado, o nome da origem	Texto
Seção de origem	Para uma métrica com um arquivo de origem conectado, o nome da seção no arquivo de origem em que o valor aparece	Texto
Estruturas	Todos os conteúdos relacionados Sustainability Explorer referenciados por uma métrica Dica: Para complementar o conteúdo conectado com detalhes adicionais de Sustainability Explorer, adicione Sustainability Explorer como uma fonte de consulta.	Texto
Nome da tarefa	O nome de uma tarefa de coleta de dados criada para o valor de um índice de avaliação	Texto
Responsável pela tarefa	O nome de usuário do membro do espaço de trabalho atribuído a uma tarefa para coletar o valor da métrica Nota: Se um valor tiver vários destinatários, eles aparecerão como uma lista separada por vírgulas, como `homer@org.com,marge@org.com`. Se a consulta retornar apenas um membro para vários destinatários, entre em contato com o Gerente de Sucesso do Cliente (CSM) da Workiva.	Texto
Aprovador da tarefa	O nome de usuário do membro do espaço de trabalho atribuído a uma tarefa para aprovar o valor coletado para uma métrica Se um valor tiver vários aprovadores ou etapas de aprovação: Uma vírgula (,) separa os aprovadores selecionados para uma etapa específica, como `homer@org.com,marge@org.com` Um pipe (\|) separa os aprovadores selecionados para cada etapa - como `homer@org.com, marge@org.com \| bart@org.com, lisa@org.com` - na sequência da aprovação	Texto
Prazo da tarefa	A data de vencimento da tarefa de coleta de dados de um valor	Data
Data de vencimento do aprovador de tarefas	A data de vencimento da tarefa de aprovação de um valor Dica: Se um valor tiver várias etapas de aprovação, esta é a data de vencimento de sua aprovação final.	Data
Status da tarefa	O status geral da coleta de dados de um valor, como Não iniciado, Em andamento ou Concluído	Texto
Instruções da tarefa	As instruções inseridas para o responsável e o aprovador de um valor de índice de avaliação	Texto
Notas	Quaisquer notas inseridas para uma métrica, como notas de rodapé	Texto
Tópico	O nome de um tópico dentro do programa	Texto
Caminho do tópico	Onde um tópico aparece no esboço do Programa, como `["Climate", "Greenhouse gas (GHG)", "Direct GHG Emissions"]`	Texto
Etiquetas personalizadas	Todas as tags personalizadas aplicadas a um tópico de métrica	Texto
Ano de relatório	O ano do relatório dos valores de métrica do Programa	Inteiro
Início do período do relatório	O mês inicial do período de relatório dos valores de métrica do programa; por exemplo, `1` para um valor anual, ou `10` para um valor trimestral do quarto trimestre	Inteiro
Encerramento do período do relatório	O mês final do período de relatório dos valores de métrica do Programa; por exemplo, `12` para um valor anual ou um valor trimestral do quarto trimestre	Inteiro
Local de origem	Para um valor com uma planilha de origem conectada, as coordenadas de sua célula	Texto
Nome da dimensão	Para um valor com uma dimensão aplicada, o nome da dimensão Observação: Se suas métricas suportarem várias dimensões, a consulta poderá incluir até sete campos Dimension name - um para cada dimensão possível para uma métrica. A posição de uma dimensão - como em Dimension 1 name, Dimension 2 name, e assim por diante - reflete sua ordem em o painel Configure metric da métrica.	Texto
Valor da dimensão	Para um valor com uma dimensão aplicada, seu valor dimensional Observação: Se suas métricas suportarem várias dimensões, a consulta poderá incluir até sete campos Dimension value - um para cada dimensão possível para uma métrica. A posição de uma dimensão - como em Dimension 1 value, Dimension 2 value, e assim por diante - reflete sua ordem em the metric's Configure metric panel.	Texto

Observação: É possível que seu espaço de trabalho ainda não ofereça suporte a várias dimensões para valores métricos. Fique atento!

Quando você seleciona Adicionar dados de dimensão do programa como uma fonte, a consulta pode incluir estas colunas:

Coluna	Descrição	Tipo
Nome da dimensão	O nome de uma dimensão personalizada configurada para o Programa, como Localização ou Gênero	Texto
ID do valor*	A ID exclusiva atribuída ao valor de uma dimensão, como IA ou NB	Texto
Nome do valor	O nome completo do valor de uma dimensão, como Iowa ou Não binário	Texto
Status da dimensão	Se uma dimensão está ativa ou inativa	Texto

Quando você adiciona select Add program tag data como uma fonte, a consulta pode incluir estas colunas:

Coluna	Descrição	Tipo
Nome da etiqueta	O nome de uma tag personalizada configurada para o programa	Texto
Valor da tag	O nome do valor da tag	Texto

Juntar dados do programa com dados de dimensão ou tag

Para obter contexto adicional sobre as dimensões ou tags de um programa, adicione os dados do programa e suas dimensões ou tags como fontes e, em seguida, crie um relacionamento para uni-los.

Por exemplo, para incluir o contexto em torno das dimensões de um programa:

Em Sources, selecione Sustainability program e Program dimensions, e escolha o mesmo programa para ambos.
Em Fields, adicione as colunas a serem incluídas de cada fonte.

No mínimo, inclua:
- Dimensões dos dados do programa
- Value ID a partir das dimensões
Em Relationships, adicione uma união à esquerda:
- Na fonte à esquerda, selecione Calculated field e, em seguida, aplique um cálculo com base na coluna Dimensions do painel Field Properties :
```
JSON_FORMAT(JSON_ARRAY_GET(JSON_EXTRACT(JSON_PARSE( {1} ), '$.*'), 0))
```
  Dica: Você pode adicionar rapidamente as funções JSON ao cálculo no menu Formula .
- Na fonte à direita, selecione o campo Value ID da dimensão.
Clique em Salvar.

Incluir colunas para estruturas ou tags específicas

Quando você usa um programa como fonte de consulta, pode incluir colunas para todas as referências de estrutura e tags personalizadas aplicadas às suas métricas. Para maior clareza, você pode aplicar cálculos para incluir colunas apenas para estruturas ou tags específicas.

Estruturas
Etiquetas

Quando você inclui a coluna Frameworks em uma consulta, ela fornece todas as referências de estrutura aplicadas às métricas. Por exemplo:

Estruturas
"gri_2020": ["305", "305-1"], "sasb_2021": ["EM-CM-110a", "EM-CM-110a.1"]

Para maior clareza, você pode incluir uma coluna separada para as referências de uma estrutura, como:

GRI	SASB
["305", "305-1"]	["EM-CM-110a", "EM-CM-110a.1"] ["EM-CM-110a", "EM-CM-110a.1"]

Para incluir uma coluna para as referências de uma estrutura nos resultados de uma consulta, aplique este cálculo:

No painel Sources, clique com o botão direito do mouse em Calculation e selecione Add to Fields.
Em Fields, selecione Calculation.
No painel Field properties, insira o cabeçalho da coluna do cálculo nos resultados da consulta, como "SASB" para referências a Sustainability Accounting Board Standards (SASB).
No painel Sources, clique com o botão direito do mouse na coluna Frameworks do programa de origem e selecione Incluir no cálculo.
No painel Field properties, insira o cálculo:
```
 JSON_EXTRACT({[field]}, '$.[framework]') 
```
- Substitua [field] pelo número da coluna Frameworks em Colunas incluídas, como 1.
- Substitua [framework] pelo nome e versão da estrutura das referências a serem incluídas, como sasb_2021.
Clique em Aplicar.

Quando você inclui a coluna Custom tags em uma consulta, ela fornece todos os valores de tag aplicados às métricas. Por exemplo:

Etiquetas personalizadas
{"CDP": ["C5.1", "C4.1a"], "Location": ["Ames", "Denver"]}

Para maior clareza, você pode incluir uma coluna separada para uma tag, como, por exemplo:

CDP	Localização
["C5.1", "C4.1a"] ["Ames", "Denver"] ["C5.1", "C4.1a"]	["Ames", "Denver"]

Para incluir uma coluna para os valores de uma tag personalizada nos resultados de uma consulta, aplique este cálculo:

No painel Sources, clique com o botão direito do mouse em Calculation e selecione Add to Fields.
Em Fields, selecione Calculation.
No painel Propriedades de campo, insira o cabeçalho da coluna do cálculo nos resultados da consulta, como "CDP" para métricas marcadas com itens do questionário CDP.
No painel Sources, clique com o botão direito do mouse na coluna Custom tags do programa de origem e selecione Include in calculation.
No painel Field properties, insira o cálculo e substitua [tag] pelo nome da tag personalizada dos valores a serem incluídos, como CDP.
```
 JSON_EXTRACT({[field]}, '$["tag"]') 
```
Dica: Para remover as aspas duplas dos valores de tag nos resultados da consulta, anexe a instrução W_JSON_ARRAY_JOIN W_JSON_ARRAY_JOIN( JSON_EXTRACT( {[field]} , '$["tag"]'), ',')).
Clique em Aplicar.

Atualizar fontes de consulta do programa

À medida que o programa evolui e apresenta novos recursos, talvez você precise atualizar a fonte de consulta para incluir as colunas relacionadas.

Dica: Quando um programa tem novas colunas a serem incluídas, sua fonte de consulta exibe um aviso em Sources.

Para atualizar a fonte de consulta de um programa:

Em Sources, clique com o botão direito do mouse na fonte e selecione Remove source.
Adicione o programa como fonte novamente.
Edite a consulta para incluir as colunas do programa, conforme necessário.

Suporte

Comunidade

Centro de suporte da Workiva