Initiate Spreadsheet Exportテンプレートを使用すると、PDF、XLSX、または CSV 形式で Workiva スプレッドシートをエクスポートできます。この機能は、スプレッドシートをバックアップしたり、オフライン編集を可能にしたり、ワークスペース外のユーザーと Workiva プレゼンテーションを共有したりするためによく使用されます。
要件
- 、OAuth2グラントを通じてクライアントIDとクライアントシークレットにアクセスできる必要があります。
- 以下のコネクタをワークスペースに設定する必要があります：
チェーンの構築
Initiate Spreadsheet Export テンプレートは、Templates 画面の Workiva Chains セクションにあります。
探し方はこうだ：
- Chain Builder で、Templates タブを開きます。
- 上部のメニューからWorkiva Chains を選択。
- 右上でInitiate Spreadsheet Exportを検索し、テンプレートを開く。
テンプレートが見つかったら、以下の変数と実行時入力を使用して、ワークスペース用に設定する。
注： テンプレートからチェーンを作成する詳細な手順については、チェーンの作成と管理 の記事を参照してください。
変数
| 可変タイプ | 変数名 | 説明 | 必要ですか？ |
| ダイナミック・チェーン | dcv-exportStatus | スプレッドシートのエクスポートステータスを取得するために使用する。 | はい |
| ダイナミック・チェーン | dcv-resourceURL | シート名またはID値。 | はい |
| ワークスペース | wsv-ClientID | Workiva コネクタの OAuth2 Grant から生成された ID。 | はい |
| ワークスペース | wsvシークレット | Workiva コネクタの OAuth2 Grant から生成されたシークレットトークン。 | はい |
| ワークスペース | wsv-IAMURL | IAM Host Override URL。 | はい |
| ワークスペース | wsv-PlatformURL | Platform API Host Override URL。 | はい |
ランタイム入力
| ランタイム入力 | 説明 | オプション | 必要ですか？ |
| エクスポートフォーマット | エクスポートのフォーマットを示す。 | .pdf または .xlsx または .csv | はい |
| エクスポートID | スプレッドシートのID 。 | はい | |
| エクスポートファイル名 | アップロードまたはメール送信時に、デフォルトのファイル名を置き換えるために使用できます。 | いいえ | |
| シート |
エクスポートするスプレッドシート内のシートの ID。 このフィールドを空白のままにすると、スプレッドシート全体が、各シートの個別の.csvファイルを含む.zipファイルとしてエクスポートされます。 |
いいえ | |
| CVSエクスポートオプション | .csv形式でエクスポートする場合、エクスポートされたオブジェクトの仕様を提供します。 |
ExportAsFormulas |
いいえ |
| XLSXエクスポートオプション | .xlsx形式でエクスポートする場合、エクスポートされるオブジェクトの仕様を提供します。 |
|
いいえ |
| PDFエクスポートオプション | PDFにエクスポートする場合、これはエクスポートされたオブジェクトの仕様を提供します。 |
|
いいえ |
注: オプションフィールドが空白のままだと、オブジェクト全体が指定なしでエクスポートされます。
知っておくべきこと
- スプレッドシート全体を.csvとしてエクスポートする場合、HTTPリクエストの名前を.zip拡張子に変更する必要があります。その結果、各シートを.csv形式で含むフォルダが作成されます。
メール配信通知の設定
エクスポートされたファイルを受信するには、Get (Final Resource) コマンドに電子メール通知を追加設定する必要があります：
- Initiate Spreadsheet Export チェーンの編集中に、Get (Final Resource) コマンドを選択し、Edit
- 封筒のアイコンをクリックして、Notifications 画面を開きます。
-
+ 新規通知 ボタンをクリックします。
- 条件」ドロップダウンメニューを開き、成功 を選択する。
- Recipients "ドロップダウンメニューを開き、エクスポートされたオブジェクトを受け取るべきすべてのユーザーのEメールを選択します。
- Attachments "メニューを開き、"Get (Final Resource) "コマンドから出力されたファイルを選択する。
この処理は、電子メールの受信者にHTTPファイルを送信する。受信者は、ファイルの拡張子を希望の形式に手動で変更する必要があります：
- File_name.txt. => file_name.pdf
- File_name.txt => file_name.xlsx
トラブルシューティング
チェーンがエラーを引き起こしたり、正しいデータの更新に失敗した場合は、以下を確認してください：
- ワークスペース変数はすべて正しい。サンドボックスのワークスペースを使用している場合は、サンドボックス版のIAM/Platform URLを使用する。
- スプレッドシートやエクスポートIDなど、必要なランタイム入力はすべて含まれています。
- Get (Final Result) コマンドの電子メール通知設定を構成しました。