タスク用CodeXスクリプト

タスク用CodeXスクリプト

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

Zoho Projects の CodeX Script は、高度な条件ロジックスクリプトで、特定のルールやバリデーションを強制できます。ユーザーは、タスクをいつ・どのように作成、編集、またはステータス変更できるかを制御できます。これにより、コンプライアンスの向上とプロセスの一貫性が確保されます。

Info
CodeX Script は、CN、JP、AE を除くすべてのデータセンターでサポートされています。

ユースケース：

サブタスクの階層を 1 レベルまでに制限する

サブタスクの下にさらにサブタスクを作成できないようにし、サブタスクは 1 階層までに制限して、シンプルで管理しやすいタスク階層を維持します。
Code:
  1. function main() {
  2. if(current.データ.parent_task !== current.データ.root_task) {
  3. throw new ScriptError('Disable subtasks creation with more than 1 level');
  4. }
  5. }

ステータスが「保留中」のプロジェクトでタスク作成を禁止する

関連付けられているプロジェクトが「保留中」に設定されている場合、タスクを作成できないように制限します。
Code:
  1. function main() {
  2. const projectId = current.データ.projectId;
  3. const moduleItr = client.getModules();
  4. let タブ
  5. console.log('started');
  6. for (let mod of moduleItr) {
  7. console.log(`${mod}`);
  8. if (mod.name === 'Projects') {
  9. タブ = mod;
  10. }
  11. }
  12. if (!タブ) {
  13. return;
  14. }
  15. let projectDtl = client.getRecordById(タブ.id, projectId);
  16. let statusDtl = client.getStatusDetails(タブ.id, projectDtl.layoutId, projectDtl.status.id);
  17. console.log(statusDtl)
  18. if (statusDtl.name === 'zp.projstatus.onhold') {
  19. throw new ScriptError('Task Creation disabled for On Hold Projects');
  20. }
  21. }

 ステータス更新後の手動日付変更を制限する

レイアウトのデフォルトステータス以外の場合、開始日、終了日、または期間を編集できないように制限します。
Code:
  1. function main() {
  2.  
  3. //base condition #1
  4. if (!current.affectedFields.start_date
  5. && !current.affectedFields.end_date
  6. && !current.affectedFields.duration_value
  7. && !current.affectedFields.duration_unit) {
  8. return;
  9. }
  10.  
  11. const statusDtl = client.getStatusDetails(current.タブ.id, current.データ.layoutId, current.データ.status);
  12. console.log(`${statusDtl}`);
  13.     
  14. if (!statusDtl.isLayoutDefault) {
  15. throw new ScriptError('Start Date and End date change are only allowed in default status');
  16. }
  17. }
  18.  

未完了のサブタスクがある場合はタスクをクローズできないようにする

未完了のサブタスクが存在する場合、親タスクのステータスを「クローズ」に変更できないように制限します。これにより、すべてのサブタスクがクローズされるまで、親タスクを完了としてマークできないようにします。
コード:
  1.  
  2. function main() {
  3.  
  4. console.log(current.affectedFields.toString());
  5.  
  6. // 基本条件の処理
  7. if (!current.affectedFields?.status) {
  8. return;
  9. }
  10.  
  11. const url = `https://projects.zoho.com/restapi/portal/${current.org.zohoOrgId}/projects/${current.record.projectId}/tasks/${current.record.id}/subtasks/`;
  12. let hasMore = true;
  13. const range = 200;
  14. let index = 1;
  15. console.log(url);
  16.  
  17. while (hasMore) {
  18. let 要求 = new HttpRequest();
  19. 要求.url(url);
  20. 要求.connection('zprojects');
  21. 要求.params({ index, range });
  22.  
  23. const response = 要求.execute();
  24.  
  25. console.log(response.asText());
  26. /**
  27. * @type {[]}
  28. */
  29. const tasks = response.asJson()?.statusMessage?.responseText?.tasks;
  30.  
  31. // 現在のタスクにサブタスクが存在しない場合
  32. if (!tasks || tasks.length == 0) {
  33. console.log('現在のタスクにはサブタスクがありません');
  34. return;
  35. }
  36.  
  37. hasMore = tasks.length == range;
  38. index += range;
  39.  
  40. console.log(tasks);
  41. console.log(tasks.length);
  42.  
  43. for (let task of tasks) {
  44. console.log(task.completed);
  45. if (!task.completed) {
  46. throw new ScriptError('未完了のサブタスクがあるため、このタスクはクローズできません');
  47. }
  48. }
  49. }
  50.  
  51.  
  52. }

先行タスクが未完了の場合はステータス変更を制限する

後続タスクが、先行タスクがクローズされてからのみ進行できるように、いずれかの先行タスクが未完了の場合はステータス更新を制限します。
コード:
  1. function main() {

  3. console.log(current.affectedFields.toString());
  4.     
  5. // 基本条件の処理
  6. if(!current.affectedFields?.status) {
  7. return;
  8. }

  10. const url = `https://projects.zoho.com/restapi/portal/${current.org.zohoOrgId}/projects/${current.record.projectId}/tasks/${current.record.id}/`;
  11. console.log(url);
  12.     
  13. let 要求 = new HttpRequest();
  14. 要求.url(url);
  15. 要求.connection('zprojects');

  17. const response = 要求.execute();
  18. const taskDependencyDtl = response.asJson()?.statusMessage?.responseText?.tasks[0]?.dependency;

  20. // 先行タスクに依存関係が存在しない場合
  21. if(!taskDependencyDtl || !taskDependencyDtl?.predecessor) {
  22. return;
  23. }

  25. console.log(taskDependencyDtl);

  27. for(let predecessorId of taskDependencyDtl.predecessor) {
  28. console.log(predecessorId);
  29. if(!taskDependencyDtl.dependencyDetails[predecessorId]?.IS_COMPLETED) {
  30. throw new ScriptError('未完了の先行タスクがあるため、続行するには先にクローズしてください');
  31. }
  32. }

  34. }

 サブタスク作成を制限する

タスク構造をフラットに保つために、サブタスクの作成を制限します。
コード:
  1. function main() {
  2. let task = current.データ;
  3. let startDate = task.start_date;
  4. if(task.parent_task || task.root_task) {
  5. Logger.info('サブタスクの作成は無効化されています');
  6. throw new ScriptError('サブタスクの作成は無効化されています');
  7. }
  8. }
  9.  

条件に基づいてタスクの期間とステータスを更新する

特定のカスタム項目と現在のステータスに基づいて、タスクの期間とステータスを更新します。
たとえば、このスクリプトは、特定の条件が満たされたときにタスクの期間とステータスを更新します。
  1. タスクの現在のステータスが「保留中」の場合、自動的に特定のステータス ID（例:「進行中」）に変更します。
  2. マルチセレクト型のカスタム項目で特定の値が選択されている場合、期間を 30 日に設定します。
  3. また、タスクの請求タイプと影響を受けた項目を確認してログに出力します。
コード:
  1. function main() {
  2. let task = current.データ;
  3. const statusDetails = client.getStatusDetails(task.moduleId, task.layoutId, task.status);
  4. if(statusDetails.name === 'On Hold') {
  5. task.status = '5000000000362';
  6. client.save(task);
  7. }
  8. console.log(JSON.stringify(statusDetails));
  9.     if(task.weightage.includes('Medium') {//マルチセレクト項目に特定のオプションが含まれているかをチェック
  10. console.log('setting status to In Progress');
  11. task.duration_unit = TaskDurationUnit.DAYS;
  12. task.duration_value = 30;
  13. }
  14. }

アーカイブ済みプロジェクトでの編集を制限

プロジェクトがアーカイブされている場合、そのプロジェクト配下のタスクには一切更新が行えないようにし、タスクの編集を防ぎます。
コード:
  1. function main() {
  2. let task = current.データ;
  3. let projectId = task.projectId;
  4. const moduleItr = client.getModules(0, 10);
  5. let moduleId;
  6. console.log(JSON.stringify(current.affectedFields));
  7. while(moduleItr.hasNext()) {
  8. let moduleObj = moduleItr.next();
  9. if(moduleObj.name == 'Projects') {
  10. moduleId = moduleObj.id;
  11. }
  12. }
  13. let project = client.getRecordById(moduleId, projectId);
  14. if(project.project_type == 'archived') {
  15. throw new ScriptError('アーカイブ済みプロジェクトでは編集できません');
  16. }
  17. }

過去日の開始日に制限を設定

選択した開始日が過去日の場合にエラーを表示し、スケジュールの整合性を保ちます。
コード:
  1. function main() {
  2. let task = current.データ;
  3. let date = Date.now();
  4. for(let key of Object.keys(current)) {
  5. console.log(key);
  6. }
  7. const startDate = new Date(task.start_date)
  8. if(date > startDate) {
  9. console.log('Start date is in past date');
  10. throw new ScriptError('開始日に過去の日付は設定できません');
  11. }
  12. }

条件付きでタスクの編集を制限

チェックボックス項目が有効な場合、そのチェックボックス自体を変更する場合を除き、タスクへの更新を禁止して意図しない変更を防ぎます。
コード:
  1. function main() {
  2.  
  3. const affectedFields = current.affectedFields;
  4. const task = current.データ;
  5.  
  6. if(affectedFields && typeof affectedFields['checkbox_cf'] != 'undefined') {
  7. return; //チェックボックス自体が更新されている場合は何もしません。
  8. }
  9.  
  10. //チェックボックスタイプ項目のブール値
  11. if(task.checkbox_cf) {
  12. throw new ScriptError('チェックボックスが有効のため、このタスクはロックされています。 ')
  13. }
  14. }
  15.  
プロジェクトのセットアップでの CodeX の使い方についてアイデアがありますか？ぜひ、下のコメント欄にユースケースをお寄せください。
関連ドキュメント
ヘルプに戻る
CodeX スクリプト（プロジェクト向け）
CodeX スクリプトの利用方法