カスタム関数の操作方法

カスタム関数の操作方法

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

概要

カスタムFunctionsを利用することで、WorkDriveワークフローの自動化をさらに拡張できます。これにより、共有、移動、コピー、項目の更新、アクセス制限などの初期設定ワークフロー処理を超えた高度な自動化が可能です。

カスタムFunctionsでできること:
  1. Delugeスクリプトを実行して、複雑なファイル管理ロジックを自動化
  2. WorkDriveを他のZohoまたはサードパーティアプリケーションと連携
  3. WorkDriveの外部連携を利用し、REST API経由でデータの送信や受信
  4. 詳細かつ複数手順のワークフロー処理を自動でトリガー
ファイルやフォルダーがワークフロー条件を満たすと、WorkDriveは関連付けられたカスタムFunctionを実行し、スクリプト化された処理を自動で行います。

カスタムFunctionsはDelugeスクリプト言語で構築されており、開発者はデータ処理、WorkDriveコンテンツの更新、外部サービスとの連携など、柔軟に対応できます。

カスタムFunctionsの作成

WorkDriveのカスタムFunctionsはDelugeで記述され、管理コンソール > カスタムFunctionsセクションに保存されます。作成した関数は、チーム内の任意のワークフールールに紐付けることができます。
Notesメモ: カスタムFunctionsの作成および管理は、チーム管理者のみが行えます。


カスタムFunctionを作成する手順:
  1. Admin Console > カスタム Functionsに移動します。
  2. + 新規 Functionをクリックします。



  3. 作成 functionフォームで、以下を入力します。
    1. Function 名前(コード内で使用)
      例: calculate_storage_cost

      メモ: Function 名前は英字またはアンダースコアで始める必要があり、英字・数字・アンダースコアのみ使用可能、50文字以内で設定してください。

    2. 表示名(リストに表示されます)
      例: 計算する Storage 費用

    3. 説明(任意)
      Functionの内容について簡単な説明を追加してください。

  4. 作成をクリックしてDelugeスクリプトエディタを開きます。
  5. エディタでFunctionのロジックを記述します。(下記のProgram カスタム Functionsを参照)
  6. 保存をクリックして変更内容を保存します。
Notes
メモ: カスタム Functionは、後でワークフロー ルールに関連付けて自動実行できるようにする必要があります。

Program カスタム Functions

カスタム FunctionsはDeluge(Data Enriched 言語 for the Universal Grid Environment)によって動作します。Delugeを使用してワークフローデータの読み取り、計算の実行、WorkDrive APIの呼び出し、または外部連携を通じてサードパーティサービスとの連携が可能です。



Delugeスクリプトエディタの利用方法

WorkDrive カスタム Functionsエディタには以下が含まれます:
  1. スクリプト作成ペイン
  2. 動的パラメーター用の項目サジェストを参照
  3. 自動構文バリデーション
  4. 引数(string型・int型)のサポート
  5. テスト実行時のコンソールログ

カスタム関数のテスト

カスタム関数をワークフローに関連付ける前に、関数エディタから直接テストできます。

カスタム関数をテストするには:
  1. Admin Console > カスタム関数で関数を開きます。
  2. 保存してテストをクリックします。


  3. 関数で引数が宣言されている場合は、テスト値を入力するダイアログが表示されます。
  4. 確定をクリックして関数を実行します。
  5. コンソールペインで結果を確認します:
    1. 実行ステータス(完了/失敗)
    2. 所要時間
    3. ログおよびデバッグ出力
これによりロジックの検証やAPIエラーの検出、関数が期待通り動作するかの確認が可能です。

カスタム関数をワークフールールに関連付ける

作成したカスタム関数は、ワークフロールールに関連付けておく必要があります。ワークフロールールの条件にデータが一致し、ルールが実行されると、関連付けられたカスタム関数も自動的に実行されます。

カスタム関数をワークフロールールに関連付ける方法
  1. Admin Console > ワークフローに移動します。
  2. 新規ワークフローを作成するか、既存のワークフローを編集します。
  3. Other処理の下で、カスタムfunctionを実行するを選択します。



  4. リストから使用するfunctionを選択します。
  5. functionに引数がある場合:
    各引数を静的な値、または#セレクターを使って動的なワークフロー値にマッピングします。サポートされているワークフロー動的値についてはこちらをクリック



  6. 保存をクリックします。

カスタムFunctionsの管理

作成したすべてのカスタムfunctionは、カスタムFunctionsホームページに一覧表示されます。
  1. Admin Console > カスタムFunctionsにアクセスしてカスタムfunctionウィンドウを開きます。
  2. function名の横にあるその他処理アイコン(...)をクリックして、利用可能な管理設定のリストを表示します。
  3. 利用可能な設定:
    1. Functionの編集: function、スクリプト、またはメタデータを修正します
    2. 削除: functionを削除します(ワークフローに関連付けられていない場合)
Notes
メモ:
  1. カスタムfunctionが現在ワークフローに関連付けられている場合は削除できません。
  2. 削除する前に、すべてのワークフローから削除する必要があります。

Info
制限事項:
  1. 現在、1チームにつき最大50個のカスタム関数を作成できます。
  2. カスタム関数は無効返品する種類のみ使用可能です。他の返品する種類はサポートされていません。
  3. カスタム関数は自動化カテゴリーのみに属することができます。
  4. 関数パラメーターはstringまたはint種類のみ許可されており、他のパラメーター種類は使用できません。
  5. 自動化ワークフローでは、すべての処理がワークフロー作成者の権限で実行されます。カスタム関数は自動化ワークフロー内のワークフロー単位の権限条件には従いません。
  6. すべてのカスタム関数処理(外部API通話を含む)は、関数を設定し関連付け済み外部連携を作成したユーザーの権限で実行されます。

あわせてご覧ください:
  1. WorkDriveで外部連携を作成する方法

    Zoho CRM 管理者向けトレーニング

    「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。

    日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。

    Zoho CRM Training



              Zoho Campaigns Resources

                Zoho WorkDrive Resources




                  • Desk Community Learning Series


                  • Digest


                  • Functions


                  • Meetups


                  • Kbase


                  • Resources


                  • Glossary


                  • Desk Marketplace


                  • MVP Corner


                  • Word of the Day


                  • Ask the Experts









                                  Resources

                                  Videos

                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                  eBooks

                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                  Webinars

                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                  CRM Tips

                                  Make the most of Zoho CRM with these useful tips.