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. JavaScript で記述し、CodeX SDKを使用します。
  2. タスク／プロジェクトの作成・更新・削除の前後など、データイベントに基づいて自動的に実行されます。
  3. 条件の検証、アクションの制限、タブの動作制御などに使用します。
  4. 組織レベルでのプロセスルールやバリデーションの適用に適しています。
 カスタム関数
  1. Deluge で記述します。詳細はこちら。
  2. レコードの更新、通知の送信、外部サービスとの連携などのアクションを自動化するために使用します。
  3. ワークフロールールやタスクブループリントに関連付けて、条件に基づきアクションを実行することもできます。
たとえば、プロジェクトで、クローズ済みタスクや有効なタスクに対してサブタスクを作成できないように制限したい場合、CodeX Scripts を使用してオブジェクトやメソッドを用いたコードを作成し、「作成前」などのトリガーで実行されるように保存できます。

スクリプト:


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

実行結果:
 
このケースで使用しているコード:
  1. function main() {
  2. let task = current.データ;
  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 スクリプトを確認して、タスクタブやプロジェクトタブの動作をカスタマイズできます。