Workiva サポートセンター

Chain Builder から、環境・社会・ガバナンス（ESG）または持続可能性報告のための温室効果ガス（GHG）排出量など、Enablon®からデータをダウンロードするチェーンを作成することができます。 

前提条件

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

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

注： このチェーンのコマンドはすべてデフォルトのCloudRunnerを使用します。GroundRunnerは必要ない。

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

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

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

1.  Chains から、Create を クリックし、Create chain を選択する。
   
2. Setup で、チェーンとその意図を識別するのに役立つ名前と説明を入力する。
   
3. Variables の下に、データへのアクセスに必要な Enablon 詳細用の変数を追加する：
   • エンドポイント

     ヒント：Endpoint 変数には、デフォルト値としてExportData を入力するか、64 ビットエンコーディング形式でデータをダウンロードするには、ExportBinaryData を入力します。

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

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

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

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

   表示名	タイプ	必要ですか？
   報告期間開始日	日付フィールド	はい
   報告期間終了日	日付フィールド	はい
   キャンペーン	TextField または DropdownField： テキストフィールド。 ドロップダウン・フィールド。	はい
   エンティティ	配列フィールド	はい

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

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

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

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

   プロパティ	説明
   ユーザー名	Chain の下にあるUsername 変数を選択する。
   パスワード	Chain の下にあるPassword 変数を選択する。
   回答を表示する	このボックスをチェックしてください。
   URL	Chain の下にあるEndpoint 変数を選択する。
   コンテンツタイプ	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> </soapenv:Envelope

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

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

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

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

1. Connectors の下で、File Utilities をクリックし、Find and replace コマンドをキャンバスに移動します。
2. POST コマンドからFind and replaceコマンドにリンクをドラッグします。
3. 「検索と置換」 コマンドを選択し、「編集」 をクリックする。
4. Command properties で、使用するFile Utilities コネクタを選択します。
   
5. コマンドのプロパティを入力し、Save をクリックする：
   

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

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

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

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

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

ステップ5.XMLコネクター要素リストをCSVコマンドに追加する

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

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

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

6. Columns の下に、各要素のカラム名とXPathを追加します：
   
   

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

7. 複数値の区切り記号 には、カンマ (,) を入力してください。
8. [保存]をクリックします。

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

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

1. Connectors の下で、File Utilities をクリックし、Create file コマンドをキャンバスに移動する。
2. Element list to CSV コマンドからCreate fileコマンドにリンクをドラッグします。
3. Create file コマンドを選択し、Edit をクリックする。
4. Command properties で、Find and replace コマンドと同じFile Utilities コネクタを選択します。
   
5. コマンドのプロパティを入力し、Save をクリックする：
   

   プロパティ	説明
   テキスト	Element list to CSV コマンドのConverted file 出力を選択します。
   ファイルパス	Runtime の下にあるChain.Workspace 変数を選択し、\test.csv を追加する。

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

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

ステップ8.チェーンを公開し、実行する

チェーンを走らせる

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

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

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

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

3. Execute をクリックする。
4. Monitor から、Run with inputs をクリックし、ランタイム入力を入力し、Start をクリックする。