Workiva サポートセンター

チェーンビルダー から、環境・社会・ガバナンス（ESG）またはサステナビリティレポートのための温室効果ガス（GHG）排出量など、Enablon®からデータをダウンロードするチェーンを作成することができます。 

前提条件

このチェーンを構築するには、これらのコアコネクターを使用します：

• HTTP リクエスト コネクター
• ファイルユーティリティ コネクター
• XML コネクター
• Workiva コネクター, データをスプレッドシートやWdataテーブルで使用する必要がある場合。

メモ： このチェーンのコマンドはすべてデフォルトのCloudRunnerを使用します。GroundRunnerは不要です。

チェーンを実行するには、データに使用するためのEnablonからの詳細が必要です：

• データをダウンロードするために使用するEnablon Simple Object Access Protocol (SOAP) Application Programming Interface (API) エンドポイント。
• 使用するEnablon環境のID
• 環境に使用するユーザー名称とパスワード。

ステップ1：チェーンを作成する

1. チェーン から、作成 をクリックし、チェーンの作成 を選択する。
   
2. セットアップの下で名称と説明を入力し、チェーンの識別とその意図を手助けします。
   
3. 変数 で、データを使用するために必要な Enablon 詳細の変数を追加する：
   • エンドポイント

     ヒント： Endpoint変数には、ExportDataのデフォルト値を入力するか、64ビットの暗号書式設定でデータをダウンロードするには、ExportBinaryDataを入力します。

   • 環境
   • ユーザー名
   • パスワード
4. [保存]をクリックします。

ステップ2.Runtime Inputsトリガーイベントで開始する。

チェーンが実行されるたびに出力をフィルターするには、Runtime Inputs イベントを開始し、ダウンロードするデータの条件を求める。

1. ランタイム入力をTrigger Eventsの下から開始 に移動します。
2. ランタイム入力イベントを選択し、編集をクリックします。
   
3. チェーンが実行されるたびに、リクエストに入力を追加します：

   表示名	タイプ	必要ですか？
   レポート期間開始日	日付フィールド	はい
   レポート期間終了日	日付フィールド	はい
   キャンペーン	TextField または DropdownField： オープンなテキストフィールド向けにTextField 特定のオプションのリストから選択するDropdownField	はい
   法人	配列フィールド	はい

4. [保存]をクリックします。

ステップ3.HTTPリクエストコネクターのPOSTコマンドを追加する。

Enablon エンドポイントからデータを取得するには、HTTP コネクターPOST コマンドを設定します：

1. コネクターの下で、HTTPをクリックし、POSTコマンドをキャンバスに移動します。
2. Start からPOSTコマンドにリンクをドラッグする。
3. POST コマンドを選択し、Edit をクリックする。
4. コマンドプロパティ で、使用するHTTP コネクターを選択します。
5. コマンドのプロパティを入力する：
   
   

   プロパティ	説明
   ユーザー名称	チェーン の下にあるユーザー名 変数を選択する。
   パスワード	チェーン の下にあるパスワード 変数を選択する。
   回答表示	このボックスをチェックしてください。
   URL	チェーン の下にあるエンドポイント 変数を選択。
   コンテンツタイプ	text/xmlを入力します。

6. 本文 に、次の拡張機能マークアップ言語（XML）構文を入力します：

   <soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:enab="enablon"> <soapenv:Header> <UserInfo xsi:type="wsdl:AuthHeader" xmlns:wsdl="http://enablon/wsdl/"> <EnaHomeSite xsi:type="xsd:string">[Environment]</EnaHomeSite> <EnaUserName xsi:type="xsd:string">[Username]</EnaUserName> <EnaPassword xsi:type="xsd:string">[Password]</EnaPassword> </UserInfo> </soapenv:Header> <soapenv:Body> <enab:ExportData soapenv:encoding:Style="http://schemas.xmlsoap.org/soap/encoding/"> <Table>/sd/法人/データ</Table>       <FolderId>0</FolderId> <Fields>FolderPath|ReportingPeriod|Ref|IndicatorName|ValueNumber|LocalUnit|ValueList。</Fields> <Filter>ReportingPeriod in ([ReportPeriodEndDate],[ReportPeriodStartDate]) AND Campaign in([Campaign]) AND Entities=[Entities].</Filter> <CSVSeparator>2</CSVSeparator> <FormatOptions>25</FormatOptions> <FormatType>3</FormatType> <ExportOptions>8192</ExportOptions> </enab:ExportData> </soapenv:Body> </soapenv:Envelope>

7. XML 構文をランタイム入力とチェーン変数で更新する：
   • ヘッダーで、[Environment] 、[ユーザー名] 、[パスワード] を、チェーン のそれぞれの変数に置換する。
   • 本文では、[ReportPeriodEndDate] 、[ReportPeriodStartDate] 、[Campaign] 、[Entities] を、Trigger の下にある実行時入力に置換する。
8. [保存]をクリックします。

ステップ 4.ファイル・ユーティリティ・コネクターの検索と置換コマンドを追加する。

ダウンロードしたXMLデータを準備するために、ファイルユーティリティ コネクター検索と置換 コマンドを追加し、角括弧とパイプを修正する。

ヒント: 検索と置換 コマンドを簡単に区別するには、「開始角括弧の検索と置換」や「パイプの検索と置換」のように、各コマンドが修正する文字を識別する名称を入力する。

1. コネクターの下でファイルユーティリティをクリックし、検索と置換コマンドをキャンバスに移動します。
2. POSTコマンドから検索と置換コマンドにリンクをドラッグします。
3. 検索と置換 コマンドを選択し、編集 をクリックする。
4. コマンドプロパティ で、使用するファイルユーティリティ コネクターを選択します。
   
5. コマンドのプロパティを入力し、Saveをクリックします：
   

   プロパティ	説明
   ソース	POST コマンドのResponse 出力を選択。
   検索	< と入力。
   置換	開始角括弧 ( <) を入力する。
   構文の検索	正確を選択。

6. コネクターの下でファイルユーティリティをクリックし、検索と置換コマンドをキャンバスに移動します。
7. 検索と置換コマンド間のリンクをドラッグする。
8. 新規検索と置換 コマンドを選択し、編集 をクリックする。
9. コマンドプロパティ で、同じファイルユーティリティ コネクターを選択する。
   
10. コマンドのプロパティを入力し、Saveをクリックします：
    

    プロパティ	説明
    ソース	検索と置換コマンドの置換結果出力を選択します。
    検索	>と入力します。
    置換	開始角括弧 (>) を入力します。
    構文の検索	正確を選択。

11. コネクターの下でファイルユーティリティをクリックし、検索と置換コマンドをキャンバスに移動します。
12. 2番目と3番目の検索と置換コマンドの間にリンクをドラッグする。
13. 3番目の検索と置換 コマンドを選択し、編集 をクリックする。
14. コマンドプロパティ で、同じファイルユーティリティ コネクターを選択する。
    
15. コマンドのプロパティを入力し、Saveをクリックします：
    

    プロパティ	説明
    ソース	置換された結果 2番目の検索と置換 コマンドの出力を選択する。
    検索	>と入力します。
    置換	パイプ (|) を入力する。
    構文の検索	正確を選択。

ステップ5.CSVコマンドへのXMLコネクター要素リストの追加

ダウンロードしたXMLを表形式データに変換するには、XMLコネクターElement list to CSVコマンドを追加します：

1. コネクター で、XML をクリックし、CSVへの要素リスト コマンドをキャンバスに移動します。
2. 3番目の検索と置換コマンドからCSVへの要素リスト コマンドへリンクをドラッグする。
3. Element list to CSV コマンドを選択し、Edit をクリックする。
4. コマンドプロパティ で、使用するXML コネクターを選択します。
   
5. コマンドのプロパティを入力する：
   

   プロパティ	説明
   ソース	置換された結果 3番目の検索と置換 コマンドの出力を選択する。
   ルートへのパス	//Document/Recordを入力します。
   プレビュー結果	このボックスをチェックしてください。

6. 列 の下に、各要素の列名称とXPathを追加する：
   
   

   列名	XPath
   期間	/報告期間
   インジケーター	/参照
   IndName	/インジケータ名
   数値	/数値
   ユニット	/ローカルユニット

7. 複数値の区切り文字 に、カンマ (,) を入力する。
8. [保存]をクリックします。

ステップ6.ファイル・ユーティリティ・コネクタの追加 ファイル作成コマンド

表データからカンマ区切り値（CSV）ファイルを作成するには、File Utilities コネクターCreate file コマンドを追加します：

1. コネクターの下でファイルユーティリティをクリックし、ファイルを作成コマンドをキャンバスに移動します。
2. CSVへの要素リストコマンドからファイルを作成コマンドにリンクをドラッグします。
3. ファイル作成 コマンドを選択し、編集 をクリックする。
4. コマンドのプロパティ で、検索と置換 コマンドと同じファイルユーティリティ コネクターを選択します。
   
5. コマンドのプロパティを入力し、Saveをクリックします：
   

   プロパティ	説明
   テキスト	CSVへの要素リストコマンドの変換済みファイル出力を変更します。
   ファイルパス	Runtime の下にあるChain.Workspace 変数を選択し、 \test.csv を追加する。

ステップ 7.Workivaでデータを使用するコマンドを追加する。

Workiva プラットフォームで CSV データを使用するには、Workiva コネクターコマンドを追加し、ファイルを作成コマンドの作成ファイル変数出力を、スプレッドシートまたは Wdata テーブルで使用します。例えば、WdataテーブルのデータセットとしてEnablonデータを追加するには、 テーブルのデータセット更新 テンプレート から作成されたチェーンを使用する、実行チェーン イベントを追加します。 

ステップ8.チェーンの更新と実行

チェーンを実行できるようにする：

1. [公開]をクリックします。
2. 更新に関するコメントを入力し、更新をクリックします。

チェーンを実行する手順は次の通りです。

1. チェーン から、チェーンのメニューから編集 を選択する。
2. チェーン設定 をクリックし、変数値を入力し、保存 をクリックする。

   メモ： Endpoint 変数には、ExportData と入力するか、64ビット・エンコーディング書式でデータをダウンロードするには、ExportBinaryData と入力する。

3. Execute をクリックする。
4. Monitor から、Run with inputs をクリックして実行入力を入力し、Start をクリックする。