Wdataから、以下を含むSustainability Programのクエリを作成することができます:
- トピック、メトリクス、値、タスク
- カスタムディメンション
- カスタムタグ メトリクスで利用可能
これらのクエリを使えば、以下のことができる:
- フィルター とパラメーター を使って、絞込みによるサステナビリティ・データの探索を行いましょう。
- 持続可能性データをファイルにエクスポートしたり、レポート出力のソースリンクを提供するなど、結果をスプレッドシート に接続する。
- メトリクスのタグやディメンションに追加のコンテキストを提供します。
クエリソースとしてプログラムを追加
番組のデータをクエリで使用する:
- <!--
-
From the query's Sources panel, click
Add sources, and select Add program data.
--> - クエリの[ソース] パネルで、[新規ソース] をクリックし、結果に含めるデータを選択します:
- プログラムおよびそのトピック、測定基準、値、またはタスクに関するデータを含むには、Sustainability 、Sustainability プログラム を選択します。
- プログラムのメトリクス値で利用可能なカスタムディメンションのデータを含むには、Sustainability,プログラムディメンションを選択します。
- プログラムのメトリックスで利用可能なカスタマイズ・タグ のデータを含むには、Sustainability 、 Program tags を選択します。
ヒント プログラムのメトリクスのディメンジョンまたはタグのコンテキストを追加するには、プログラムのデータとそのディメンジョンま たはタグ・データをソースとして追加し、関係を作成してそれらを結合します 。
- クエリで使用するプログラムを検索して選択し、Add をクリックする。
- Sources パネルから、クエリでのデータ列の使用方法を指定します:
- ビルダーで列を結果として使用するには、列を選択し、フィールドを追加を選択するか、フィールドタブにドラッグします。
- 列をフィルターとして使用するには、ビルダー で 列を選択し、フィルターに追加 を選択するか、フィルター タブにドラッグします。
例えば、Sustainability プログラム をソースとするクエリの場合:フィルター 戻り値 プログラム年 特定の年に収集された値のみ ディメンション 特定のカスタム・ディメンションが適用されたメトリクスと、そのディメンションに対して収集された値のみ タスクステータス 特定のデータ収集ステータスのタスクのみ - SQL のクエリの文に列を含めるには、その列を右クリックし、クエリに追加を選択します。
- ビルダーで列を結果として使用するには、列を選択し、フィールドを追加を選択するか、フィールドタブにドラッグします。
- 必要に応じてクエリ を作成する。
ソース列
番組データをソースとして追加すると、そのデータ列をクエリ結果に含めることができます。
ソースとして番組データ追加 を選択すると、クエリにこれらの列を含めることができる:
| 列 | 説明 | タイプ |
|---|---|---|
| プログラム名 | プログラム名称 | テキスト |
| プログラム年 | プログラムデータの年 | 整数 |
| メトリック名 | Program トピック内のメトリックの名称。 | テキスト |
| メートルコード | メトリックに生成される一意の識別子。 | テキスト |
| メートルタイプ | メトリクスに対して収集される値のタイプ - テキスト、通貨、数値、パーセンテージ、または日付。 | テキスト |
| メトリックの説明 | メトリックに入力された説明。 | テキスト |
| ディメンション |
ヒント: メトリクスが複数のディメンジョンをサポートしている場合は、Dimension name およびDimension value フィールドを使用して、ディメンジョン名と値の別々の列を返却できます。 |
テキスト |
| 値テキスト | メトリクスにテキストで入力された値。 | テキスト |
| 値-番号 | メトリクスに入力された数値。 | 小数値 |
| ユニット | タイプ別がCurrency(通貨)、Number(数値)、Percent(パーセンテージ)の測定単位。 | テキスト |
| サポート添付ファイル |
メトリック値に対してアップロードされた添付ファイルのファイル名。 メモ:値に複数の添付ファイルがある場合、それらのファイル名はカンマ区切りのリストとして表示されます。結果には、アップロードされた 添付ファイルのみが含まれます。添付された Workiva ファイルやウェブアドレスは表示されません。 |
テキスト |
| タイプ別ソース |
メトリック値が提供される方法:
|
文字列 |
| ソースファイル | 接続されたソースファイルを持つメトリクスの場合、ソースの名称 | テキスト |
| ソースセクション | 接続されたソースファイルを持つメトリックの場合、値が現れるソースファイルのセクションの名称。 | テキスト |
| フレームワーク |
メトリックで参照されるすべての関連Sustainability Explorer コンテンツ ヒント: Sustainability Explorer, Sustainability Explorer をクエリ ソースとして追加 からの追加詳細で接続コンテンツを補足するには。 |
テキスト |
| タスク名 | メトリクスの値に対して作成されたデータ収集タスクの名称。 | テキスト |
| タスク担当者 |
メトリック値を収集するタスクを割り当てられたワークスペースメンバーのユーザー名。 メモ: 値に複数の担当者がいる場合、 |
テキスト |
| タスク承認者 |
メトリックの収集値を承認するタスクを割り当てられたワークスペースメンバーのユーザー名。
|
テキスト |
| タスク期日 期限 | 値のデータ収集タスクの期日または期限 | 日付 |
| タスク承認者期日 期限 |
値の承認タスクの期限 ヒント: 値に複数の承認ステップ がある場合、これは最終承認の期日です。 |
日付 |
| タスクステータス | 未着手、進行中、完了など、値のデータ収集の全体的なステータス。 | テキスト |
| タスクの指示 | 指標値の担当者と承認者に入力された指示内容 | テキスト |
| メモ | 脚注など、指標に入力されたメモ。 | テキスト |
| トピック | 番組内のトピックの名称 | テキスト |
| トピックパス |
["Climate", "Greenhouse gas (GHG)", "Direct GHG Emissions"]のように、トピックがプログラムのアウトラインに登場する場合。 |
テキスト |
| カスタマイズタグ | すべてのカスタムタグをトピック メトリックに適用 | テキスト |
| 報告年度 | プログラムの指標値のレポート年 | 整数 |
| 報告期間開始 | プログラムの指標値の報告期間の開始月。例えば、年間値の場合は1 、第4四半期の場合は10 。 |
整数 |
| 報告期間終了 | プログラムの指標値の報告期間の終了月。例えば、年間値の場合は12 、四半期値の場合はQ4。 |
整数 |
| ソースの場所 | 接続ソース・スプレッドシートを持つ値の場合は、そのセルの座標。 | テキスト |
| ディメンション名 |
ディメンジョンを適用した値の場合は、ディメンジョンの名称。 メモ : メ ト リ ッ ク が複数のデ ィ メ ン シ ョ ン をサポー ト し てい る 場合、 ク エ リ には、 メ ト リ ッ ク で可能な各デ ィ メ ン シ ョ ンについて 1 つずつ、Dimension name フィールドを最大 7 つまで含める こ と がで き ます。ディメンジョンの位置 -ディメンジョン 1 の名称 、ディメンジョン 2 の名称 など - は、メトリクスのメトリクスの構成 パネル の順序を反映します。 |
テキスト |
| ディメンション値 |
ディメンジョンを適用した値には、そのディメンジョン値 メモ : メ ト リ ッ ク が複数のディメン シ ョ ン をサポー ト し てい る 場合、 ク エ リ には、 メ ト リ ッ ク で可能な各デ ィ メ ン シ ョ ンについて 1 つずつ、 最大 7 つのディメンジョン値 フィールドを含める こ と がで き ます。ディメンジョン 1 の値 、ディメンジョン 2 の値 などのディメンジョンの位置は、メトリックのメトリックの構成 パネル での順序を反映します。 |
テキスト |
メモ: ワークスペースでは、メトリック値の複数のディメンションがまだサポートされていない場合があります。ご期待ください!
ソースとしてプログラム・ディメンション・データの追加 を選択すると、クエリにこれらの列を含めることができます:
| 列 | 説明 | タイプ |
|---|---|---|
| ディメンション名 | 所在地や性別など、番組に設定されたカスタム・ディメンションの名称 | テキスト |
| 値の ID | IA や NB など、ディメンションの値に割り当てられた一意の ID。 | テキスト |
| 値の名称 | Iowa や Non-binary など、ディメンションの値の完全名称。 | テキスト |
| ディメンションステータス | ディメンションがアクティブか非アクティブか | テキスト |
選択番組タグデータの追加 をソースとして追加すると、クエリにこれらの列を含むことができる:
| 列 | 説明 | タイプ |
|---|---|---|
| タグ名称 | プログラム用に設定されたカスタムタグの名称。 | テキスト |
| タグ値 | タグ値の名称 | テキスト |
プログラム・データとディメンションまたはタグ・データの結合
プログラムのディメンジョンまたはタグのコンテキストを追加するには、プログラムのデータとそのディメンジョンま たはタグをソースとして追加し、関係を作成してそれらを結合します。
例えば、プログラムのディメンションにまつわるコンテクストを含むには:
- ソース で、サステナビリティ・プログラム とプログラム・ディメンション を選択し、両方に同じプログラムを選択する。
-
Fields で、各ソースから含める列を追加する。
最低限含む:- ディメンション プログラムデータより
- 値 ID ディメンションから
-
Relationships で、左結合を追加する:
-
左のソースで、計算フィールド を選択し、フィールドプロパティ パネルからディメンション 列に基づいて計算を適用します:
JSON_FORMAT(JSON_ARRAY_GET(JSON_EXTRACT(JSON_PARSE({1} ), '$.*'), 0))ヒント:
JSON関数 を、式 メニューから計算にすばやく追加できます。 - 右のソースで、ディメンションの値 ID フィールドを選択します。
-
- [保存]をクリックします。
特定のフレームワークやタグの列を含む
クエリ・ソースとしてプログラムを使用する場合、そのメトリックに適用されるすべてのフレームワーク参照とカスタ ム・タグの列を含むことができます。わかりやすくするために、特定のフレームワークやタグだけの列を含むように計算を適用することもできる。
クエリにフレームワーク 列を含むと、メトリクスに適用されたすべてのフレームワーク参照が提供されます。例:
| フレームワーク |
|---|
| "gri_2020":[305", "305-1"], "sasb_2021":[EM-CM-110a」、「EM-CM-110a.1] |
わかりやすくするために、フレームワークの参照用に別の列を含むことができます:
| GRI | SASB |
|---|---|
| ["305", "305-1"] | [EM-CM-110a」、「EM-CM-110a.1」]。 |
クエリの結果にフレームワーク参照の列を含むには、この計算を適用する:
-
ソース パネルから、計算 を右クリックし、フィールドに追加 を選択する。
- フィールド の下で、計算 を選択する。
-
Field properties panel から、Sustainability Accounting Board Standards (SASB) を参照する場合は "SASB" のように、クエリ結果の計算の列ヘッダーを入力します。
-
ソース パネルから、ソース・プログラムのフレームワーク 列を右クリックし、計算に含む を選択する。
-
Field properties パネルから、計算を入力します:
JSON_EXTRACT({[field]}, '$.[framework]')-
[field]をIncluded columns の下にあるフレームワーク 列の番号に置換する1のように。 -
[framework]を、sasb_2021のように、含める参照のフレームワークの名称とバージョンに置換する。
-
- [適用]をクリックします。
Custom tags 列をクエリに含むと、メトリクスに適用されたすべてのタグ値が提供されます。例:
| カスタマイズタグ |
|---|
| {"CDP": ["C5.1", "C4.1a"], "Location": ["Ames", "Denver"]} |
わかりやすくするために、タグの列を別に含むこともできます:
| CDP | 場所 |
|---|---|
| ["C5.1", "C4.1a"] | ["Ames", "Denver"] |
クエリの結果にカスタムタグの値の列を含むには、この計算を適用します:
-
ソース パネルから、計算 を右クリックし、フィールドに追加 を選択する。
- フィールド の下で、計算 を選択する。
-
フィールドプロパティパネルから、クエリ結果の計算の列ヘッダー(CDP クエリ項目でタグ付けされたメトリックの場合は "CDP "など)を入力します。
-
ソース パネルから、ソース・プログラムのカスタムタグ 列を右クリックし、計算に含める を選択する。
-
フィールドプロパティ パネルから、計算を入力し、
[tag]を、CDPのように、含める値のカスタムタグの名称に置換する。JSON_EXTRACT({[field]}, '$["tag"]')ヒント: クエリ結果のタグ値からダブルクォートを削除するには、
W_JSON_ARRAY_JOINステートメントW_JSON_ARRAY_JOIN( JSON_EXTRACT( {[field]} , '$["tag"]'), ','). - [適用]をクリックします。
プログラムクエリソースの更新
プログラムが進化し、新規機能が導入された場合、関連する列を含むクエリソースを更新する必要があるかもしれません。
ヒント: プログラムが新規列を含むと、そのクエリソースはソース に警告 を表示します。
プログラムのクエリソースを更新する:
-
ソース で、ソースを右クリックし、ソースの削除 を選択する。
- 番組をソースとして再度追加する。
- 必要に応じてクエリを編集し、プログラムの列を含むようにする。