Zoho WriterでDelugeスクリプトを使用してカスタムワークフローを設定する方法

Zoho WriterでDelugeスクリプトを使用してカスタムワークフローを設定する方法

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

概要

Zoho WriterのカスタムFunctionsを利用すると、ドキュメントワークフローに自動化、ロジック、各種連携を追加できます。Delugeスクリプトを使うことで、ドキュメントがマージ、入力、署名、PDFへの結合、またはワークフローが完了したタイミングで、さまざまな処理を自動実行できます。

カスタムFunctionsは自動化のどこで使用できますか?

Zoho Writerでは、ドキュメントワークフローのさまざまな段階でカスタム関数を実行できます。
  • マージが完了した後
  • マージ済みドキュメントが保存された後
  • ユーザーが入力可能なドキュメントを送信した後
  • ドキュメントの署名プロセスが完了したタイミング
上記のトリガーポイントでは、ファイルの保存、データの更新、関係者への通知、その他のアプリやサービスとの連携など、後続の処理を自動化できます。

API利用時の前提条件

APIの Merge and メール, Merge and Sign, Sign, または Combine and Store を利用する前に、WriterのUIから「Automate」パネルへ最低1回はアクセスしておく必要があります。APIリクエスト送信前にこの操作を行ってください。

カスタム処理の設定手順

手順 1: Delugeエディターを開く
  • Mergeテンプレートの場合:必要なマージ出力オプションを選択し、「実行するFunctionを設定」を選んでDelugeエディターを開きます。

  1. 入力可能テンプレートの場合:「オンSubmission」セクションで、Webhookとカスタム関数のトリガーを選択します。
  1. Sign テンプレートの場合:「Sign 送信」を選択 > カスタム関数を有効化 > 設定します。

手順 2:関数を選択 または作成する
  • Delugeスクリプトを使って新しいカスタム関数を作成します。

  1. または、ギャラリーから事前構築済み関数を利用します

手順 3:コネクションの作成

外部連携は、外部サービスへのリクエスト認証のために使用され、Zoho Writerのカスタム関数に組み込むことができます。これにより、他サービスからデータを取得し、ドキュメントのワークフローに直接取り込むことが可能です。

カスタム関数で connection を使用するには:
  1. Zoho Writer と外部サービスを連携する connection を作成してください。
  2. 次に、この connection を利用して必要なデータを取得または送信するカスタム関数を作成します。
connection の作成方法については、こちらのヘルプ リンクをご参照ください。

手順 4: 保存 & リンクで関数を保存
  • Deluge スクリプトの作成後、保存 & リンクをクリックして、該当する出力イベント(例: Merge 後)に関数を関連付けます。

Deluge カスタム関数の制限事項

制限事項
説明
実行タイムアウト

1 関数の実行につき最大 5 分まで。
invoke URL タスクごとに最大 40 秒まで。

ファイル処理サイズ
最大 20MB まで
Recursive 通話

Recursion が次の値と等しくない場合はサポートされません。

マルチスレッド不可

スクリプトは順次実行され、並列実行はできません。

よくある質問

1. テンプレートやドキュメントでカスタム関数を自分に共有されたものに実行できますか?
はい。関数は作成者の認証情報およびアクセス権で実行されます。

2. Delugeを使用して動的テーブルを作成し、サブフォームデータを取得するには?
サブフォームデータの扱いについては、
こちらの記事をご参照ください。

3. 承認ワークフローが完了した後にDeluge関数をトリガーできますか?
はい。マージテンプレートで、
Merge > 承認に送信を選択し、カスタム関数を実行するを有効にして、ドキュメントをZoho Contractsに移動するよう設定してください。

4. マージしたドキュメントをCRMデータに添付する方法は?
Merge & Store > マージ後 > カスタム関数を実行するを使用し、CRMデータに添付ギャラリーファンクションで設定してください。

トラブルシューティング

エラー/症状

考えられる原因

推奨される解決策

マージ中のエラー R6000

Deluge スクリプトでの構文エラー

merge_data をマッピングする際はカンマではなくコロンを使用してください。
例:merge_values.put('merge_data', {'data': mp});
エラーの詳細についてはこの記事をご参照ください。

在庫からの画像が表示されない

在庫画像URLにアクセスできない

画像をDeluge経由でWorkDriveにアップロードし、公開用URLを取得してマージ項目で使用してください。
その他の詳細についてはこの記事をご参照ください。
WorkDriveへのマージ・保存時のエラー R3000

スコープが不足しています

OAuthスコープにWorkDrive フォルダー用の WorkDrive.files.すべて を含めてください。