CodeXスクリプトの概要

CodeXスクリプトの概要

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

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

メリット

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

CodeX Scriptsとカスタム関数の違い

Zoho Projectsには、カスタムロジックを追加する方法として、CodeX Scriptsとカスタム関数の2つがあります。どちらもシステムの動作を拡張できますが、それぞれ用途が異なります。

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

スクリプト：


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

実行結果：
 
この例で使用したコード。
  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 Scriptsを確認してください。