Initiate Spreadsheet Exportテンプレートを使用すると、PDF、XLSX、または CSV 書式設定で Workiva スプレッドシートをエクスポートできます。この機能は、スプレッドシートをバックアップしたり、オフライン編集を可能にしたり、ワークスペース外のユーザーと Workiva プレゼンテーションを共有したりするためによく使用されます。
要件
- 、OAuth2グラントを通じてクライアントIDとクライアントシークレットにアクセスする必要があります。
- 以下のコネクターをワークスペースに構成する必要があります：
チェーンの構築
Initiate Spreadsheet Export テンプレートは、Templates 画面の Workiva チェーンセクションにある。
検索方法はこうだ：
- チェーンビルダーで、テンプレート タブに移動します。
- 上部のメニューからWorkiva チェーン を選択。
- 右上の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 | プラットフォームAPIホストのオーバーライドURL。 | はい |
ランタイム入力
| ランタイム入力 | 説明 | オプション | 必要ですか？ |
| エクスポートフォーマット | エクスポートの書式設定。 | .pdf または .xlsx または .csv | はい |
| エクスポートID | スプレッドシートのID 。 | はい | |
| エクスポートファイル名 | アップロードやメール送信の際に、ファイルのデフォルト名称を置換するために使用できます。 | いいえ | |
| シート |
エクスポートするスプレッドシート内のシートのID。 このフィールドを空白のままにすると、スプレッドシート全体が、各シートの個別の.CSVファイルを含む.zipファイルとしてエクスポートされます。 |
いいえ | |
| CVSエクスポートオプション | .csv書式設定にエクスポートする場合、エクスポートされたオブジェクトの仕様を提供します。 |
ExportAsFormulas |
いいえ |
| XLSXエクスポートオプション | .xlsx書式設定にエクスポートする場合、エクスポートされたオブジェクトの仕様を提供します。 |
|
いいえ |
| PDFエクスポートオプション | PDFにエクスポートする場合、これはエクスポートされたオブジェクトの仕様を提供します。 |
|
いいえ |
注: オプションフィールドが空白のままだと、指定が適用されずにオブジェクト全体がエクスポートされます。
知っておくべきこと
- スプレッドシート全体を.csvとしてエクスポートする場合、HTTPリクエストの名前を.zip拡張機能に変更する必要があります。その結果、各シートが.CSV書式設定で含まれるフォルダが作成されます。
メール配信通知のセットアップ
エクスポートされたファイルを受信するには、Get (Final Resource) コマンドにEメール通知を追加構成する必要があります：
- Initiate Spreadsheet Export チェーンを編集中に、Get (Final Resource) コマンドを選択し、Edit
- 封筒アイコンをクリックして、通知画面を開きます。
-
+ 新規通知 ボタンをクリックします。
- 条件」のドロップダウン・メニューを開き、成功 を選択する。
- "Recipients"ドロップダウンメニューを開き、エクスポートされたオブジェクトを受け取るべきすべてのユーザーのEメールを選択します。
- 添付ファイル」メニューを開き、「取得（最終リソース）」コマンドから出力されたファイルを選択する。
このプロセスは、メールの受信者にHTTPファイルを送信する。その後、受信者は手動でファイルの拡張機能を希望の書式設定に変更する必要があります：
- File_name.txt. => file_name.pdf
- File_name.txt => file_name.xlsx
トラブルシューティング
チェーンがエラーを引き起こしたり、正しいデータの更新に失敗した場合は、以下を確認してください：
- ワークスペース変数はすべて正しい。サンドボックスのワークスペースを使用している場合は、サンドボックス版のIAM/Platform URLを使用する。
- スプレッドシートやエクスポートIDなど、必要なランタイム入力をすべて含んでいる。
- Get (Final Result) コマンドの電子メール通知設定を構成しました。