CodeXスクリプトの概要

CodeXスクリプトの概要

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

CodeXスクリプトでは、ユーザーが標準タブ（［タスク］、［プロジェクト］、［工数］）やカスタムタブを操作したときに自動実行されるカスタムロジックを定義できます。これにより、特定の条件に基づいてタブの動作を制御できます。JavaScript SDKを使用してスクリプトを記述し、データの作成、複製、更新の前後に処理を実行できます。CodeXスクリプト権限を持つユーザーは、CodeXスクリプトを設定、管理できます。
InfoCodeXスクリプトは、CN、JP、AEを除くすべてのデータセンターで利用できます。

利点

  1. ［プロジェクト］タブと［タスク］タブ内で条件を検証し、独自の制限メッセージを表示できます。
  2. HTTPリクエストを使用して外部アプリに接続できます。
  3. 条件に基づいて、タスクやプロジェクトの詳細を自動更新できます。
  4. ポータル内の他のプロジェクトデータを取得、更新できます。

CodeXスクリプトとカスタム関数の違い

Zoho Projectsでは、CodeXスクリプトとカスタム関数という2つの方法でカスタムロジックを追加できます。どちらもシステムの動作を拡張できますが、それぞれ異なる目的に使用します。

CodeXスクリプト
  1. CodeX SDKを使用し、JavaScriptで記述します。
  2. タスクやプロジェクトが作成、更新、削除される前後など、データのイベントに基づいて自動的に実行されます。
  3. 条件の検証、操作の制限、タブの動作の制御に使用します。
  4. 組織全体でプロセスルールや検証を適用する場合に適しています。
 カスタム関数
  1. Delugeで記述します。詳細はこちら。
  2. データの更新、通知の送信、外部サービスとの連携などの処理を自動化するために使用します。
  3. ワークフロールールやタスクのブループリントに関連付け、条件に基づいて処理を実行することもできます。
たとえば、プロジェクトで、完了したタスクまたは有効なタスクに対してプロジェクトメンバーがサブタスクを作成できないようにする場合、CodeXスクリプトを使用できます。オブジェクトとメソッドを使用してコードを記述し、［作成前］などのトリガーで実行するよう設定して保存します。

スクリプト：


ユーザーがサブタスクを作成しようとすると、このタスクにはサブタスクを作成できないことを示す警告がプロジェクトメンバーに表示されます。

実行：
 
この例で使用するコード：
  1. function main() {
  2. let task = current.record;
  3. /**
  4. *
  5. * @type Number
  6. */
  7. let startDate = task.start_date;
  8. Logger.info('Parent ID: ' + task.parent_task);
  9. Logger.info('Root Task ID: ' + task.root_task);
  10.    
  11. // console.log(JSON.stringify(variables.blockSubTasks));
  12. if(task.parent_task || task.root_task) {
  13. Logger.info('Subtask creation is disabled');
  14. throw new ScriptError('You cannot create a subtask');
  15. }
  16. }
［タスク］タブと［プロジェクト］タブの動作をカスタマイズできる、その他のCodeXスクリプトをご確認ください。