タスク用CodeXスクリプト

タスク用CodeXスクリプト

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

CodeX Scripts は Zoho プロジェクトで使用できる詳細な条件ロジックスクリプトで、特定のルールや検証を適用するのに役立ちます。ユーザーは、タスクがいつ・どのように作成、編集、またはステータス変更されるかを制御できます。これにより、コンプライアンスの向上とプロセスの整合性が確保されます。こちらから、プロジェクト向け CodeX Scripts の詳細をご確認ください。

Info
CodeX Scripts は現在、限定リリースとして提供されています。この機能をポータルで有効化したい場合は、support@zohoprojects.com までお問い合わせください。

ユースケース:

タスクを作成する

選択したレイアウトとタスクリストを使用してタスクを作成し、必要な情報でタスクを更新します。
コード:
  1. function main() {
  2. try {
  3. const layoutId = 現在。データ。layoutId; // 選択したレイアウト ID
  4. const moduleId = 現在。データ。moduleId; // 選択したタブ ID
  5. const layout = client。getLayoutById(layoutId, moduleId);

  7. const newTask = 新規 データ(layout);

  9. newTask。projectId = 現在。データ。projectId;
  10. newTask。名前 = 'Roles and responsib';
  11.     newTask。tasklistId = '242942000000297017'// タスクリスト ID

  13. const user1 = variables。user1。値; // user1 の ZPUID は変数に保存されています
  14. const user2 = variables。user2。値; // user2 の ZPUID は変数に保存されています

  16. const addedTask = client。保存(newTask);

  18. addedTask。名前 = 'Roles and responsibilities';
  19. addedTask。ステータス = '242942000000040005'; // レイアウトに基づくステータス ID。ここでは 242942000000040005 は「進行中」ステータスに対応します
  20. addedTask。説明 =
  21. 'This is a タスク to define roles and responsibilities.';
  22. addedTask。start_date = '2025-12-09T12:00:00+05:30'; // 開始日付は ISO 日付・時間形式で指定する必要があります
  23. addedTask。end_date = '2025-12-12T12:00:00+05:30'; // 終了日付は ISO 日付・時間形式で指定する必要があります
  24. addedTask。owners_and_work = {
  25. work_unit: 'hours_per_day', // 使用可能な値: %, 時間, %_per_day, hours_per_day
  26. total_work_value: '2160', // 作業単位に基づく合計作業量の値
  27. work_type: 'standard_work', // 使用可能な値: standard_work, flexible_work
  28. owners: [
  29. {
  30. 担当者: {
  31. id: user1,
  32. },
  33. work_value: '540', // 作業単位に基づく、この担当者の作業量の値
  34. },
  35. ],
  36. };
  37. addedTask。teams = ['242942000000090845', '242942000000090855']; // チーム ID

  39. addedTask.completion_percentage = '50'; // 完了率 (%) の値は 0 〜 100 の間で指定します
  40. addedTask。billing_type = '1'; // 使用可能な値: 0 (なし), 1 (請求対象), 2 (非請求対象)
  41. addedTask。single_line = '1 行テキストのカスタム項目';
  42. addedTask。pick_list = 'Option 1'; // ピックリストの選択肢名
  43. addedTask。multi_line = '複数行テキストの\nカスタム項目';
  44. addedTask。multi_select = ['Option 1', 'Option 2', 'Option 3']; // 複数選択ピックリストの選択肢名
  45. addedTask。user_pick_list_select_roles = '242942000000082031'; // 役割 ID
  46. addedTask。user_pick_list_all_users = user1;
  47. addedTask。user_pick_list_select_users = user2;
  48. addedTask。multi_user_pick_list_all_users = [user1, user2];
  49. addedTask。multi_user_pick_list_select_users = [user1, user2];
  50. addedTask。date_field = '2025-12-09'; // 日付は ISO 日付形式で指定する必要があります
  51. addedTask。date_time_field = '2025-12-09T12:00:00+05:30'; // 日付時刻は ISO 日付・時間形式で指定する必要があります
  52. addedTask。checkbox_field = '真';
  53. addedTask。currency_field = '40000'; // 通貨の値
  54. addedTask。percentage_field = '25'; // 割合 (%) の値は 0 〜 100 の間で指定します
  55. addedTask。number_field = '450'; // 数値の値
  56. addedTask。decimal_field = '1。234'; // 小数の値
  57. addedTask。email_field = 'zylker@zoho.com'; // メールアドレス
  58. addedTask。phone_field = '1234567890'; // 電話番号
  59. addedTask。url_field = 'https://zylker.com/';// URL
  60. client。保存(addedTask);
  61. } catch (エラー) {
  62. console。log(エラー);
  63. throw 新規 ScriptError(エラー); // エラーを ScriptError として再スローし、プロジェクトの UI に表示します。
  64. }
  65. }

プロジェクトのベースライン設定後のタスク作成を制限する:

プロジェクトにベースラインが既に存在する場合はタスクの作成を制限し、プロジェクトの元の計画の整合性を維持します。
コード:
  1. function main() {
  2.  
  3. const url = `https://projects.zoho.com/api/v3/portal/${current.org.zohoOrgId}/projects/${current.record.projectId}/baselines`
  4. const request = 新規 HttpRequest();
  5. request。url(url);
  6. request。method('取得する');
  7. request。connection('zprojects')
  8.  
  9. const response = request。実行する();
  10. const baselines = response。asJson()?.statusMessage?.responseText?.BASELINEDETAILS;
  11.  
  12. if(baselines && baselines instanceof Array && baselines。length > 0) {
  13. throw 新規 ScriptError('Cannot 作成 新規 タスク が次の後 baseline is set');
  14. }
  15. }

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

サブタスクの下にさらにサブタスクを作成できないように制限し、シンプルで管理しやすいタスク階層を維持します（サブタスクは 1 レベルまで）。
コード:
  1. function main() {
  2. if(現在。データ。parent_task !== 現在。データ。root_task) {
  3. throw 新規 ScriptError('1 階層を超えるサブタスクの作成は無効です');
  4. }
  5. }
  6.  
  7. 未解決の課題があるタスクの完了を制限する
  8. 関連付けられている課題のステータスが「完了」または「キャンセル」となっていない場合はタスクをクローズできないようにし、すべての関連課題が解決済みであることを保証します。
  9.  
  10. function main() {
  11.  
  12. console。log('started');
  13. console。log(`${現在。affectedFields}`);
  14.  
  15. if (!現在。affectedFields。ステータス) {
  16. 返品する;
  17. }
  18.  
  19. const statusDtl = client。getStatusDetails(現在。タブ。id, 現在。データ。layoutId, 現在。affectedFields。ステータス。newValue);
  20.  
  21. if (!statusDtl。isClosedStatus) {
  22. 返品する;
  23. }
  24.     
  25. const タスク = 現在。データ;
  26. const url = `https://projects.zoho.com/api/v3/portal/${current.org.zohoOrgId}/projects/${task.projectId}/tasks/${current.record.id}/associated-bugs`;
  27.  
  28. const request = 新規 HttpRequest();
  29. request。url(url);
  30. request。connection('zprojects');
  31. const response = request。実行する();
  32. const associatedBugs = response。asJson()?.statusMessage?.responseText?.associated_bugs;
  33.  
  34. if(!associatedBugs) {
  35. 返品する;
  36. }
  37.  
  38. for(let bug of associatedBugs) {
  39. if(bug。issue。status_name !== '完了済み' && bug。issue。status_name !== 'キャンセル済み') {
  40. throw 新規 ScriptError('このタスクには未解決の課題があります');
  41. }
  42. }
  43.  
  44. console。log(response。asJson()?.statusMessage?.responseText);
  45. }

オンホールドのプロジェクトでのタスク作成を無効にする

関連付けられているプロジェクトが「保留」に設定されている場合、タスクの作成を制限します。
コード:
  1. function main() {
  2.  
  3. const projectId = 現在。データ。projectId;
  4. const moduleItr = client。getModules();
  5.  
  6. /**
  7. * @種類 {タブ}
  8. */
  9. let タブ
  10.  
  11. console。log('started');
  12. for (let mod of moduleItr) {
  13. console。log(`${mod}`);
  14. if (mod。名前 === 'プロジェクト') {
  15. タブ = mod;
  16. }
  17. }
  18.  
  19. if (!タブ) {
  20. 返品する;
  21. }
  22.  
  23. let projectDtl = client。getRecordById(タブ。id, projectId);
  24. let statusDtl = client。getStatusDetails(タブ。id, projectDtl。layoutId, projectDtl。ステータス);
  25.  
  26. if (statusDtl。名前 === 'zp。projstatus。onhold') {
  27. throw 新規 ScriptError('オンホールドのプロジェクトではタスク作成は無効です');
  28. }
  29. }
  30.  

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

ステータスがレイアウトの初期ステータスと異なる場合、開始日、終了日、または期間の編集を制限します。
コード:
  1. function main() {
  2.  
  3. //base 条件 #1
  4. if (!現在。affectedFields。start_date
  5. && !現在。affectedFields。end_date
  6. && !現在。affectedFields。duration_value
  7. && !現在。affectedFields。duration_unit) {
  8. 返品する;
  9. }
  10.  
  11. const statusDtl = client。getStatusDetails(現在。タブ。id, 現在。データ。layoutId, 現在。データ。ステータス);
  12. console。log(`${statusDtl}`);
  13.     
  14. if (!statusDtl。isLayoutDefault) {
  15. throw 新規 ScriptError('開始日と終了日の変更は、初期ステータスでのみ許可されます');
  16. }
  17. }
  18.  

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

親タスクに未完了のサブタスクがある場合、親タスクのステータスを「完了」に変更できないように制限します。これにより、すべてのサブタスクが完了するまで親タスクを完了としてマークできないようにします。
コード:
  1.  
  2. function main() {
  3.  
  4. console。log(現在。affectedFields。toString());
  5.  
  6. //ベース条件の処理
  7. if (!現在。affectedFields?.ステータス) {
  8. 返品する;
  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 = 真;
  13. const range = 200;
  14. let index = 1;
  15. console。log(url);
  16.  
  17. while (hasMore) {
  18. let request = 新規 HttpRequest();
  19. request。url(url);
  20. request。connection('zprojects');
  21. request。params({ index, range });
  22.  
  23. const response = request。実行する();
  24.  
  25. console。log(response。asText());
  26. /**
  27. * @種類 {[]}
  28. */
  29. const タスク = response。asJson()?.statusMessage?.responseText?.タスク;
  30.  
  31. //現在のタスクにサブタスクが存在しない場合
  32. if (!タスク || タスク。length == 0) {
  33. console。log('現在のタスクにはサブタスクがありません');
  34. 返品する;
  35. }
  36.  
  37. hasMore = タスク。length == range;
  38. index += range;
  39.  
  40. console。log(タスク);
  41. console。log(タスク。length);
  42.  
  43. for (let タスク of タスク) {
  44. console。log(task.completed);
  45. if (!task.completed) {
  46. throw 新規 ScriptError('このタスクには未完了のサブタスクが残っています。');
  47. }
  48. }
  49. }
  50.  
  51.  
  52. }

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

いずれかの先行タスクが未完了の場合はステータス更新を制限し、依存関係のロジックを維持します。これにより、後続タスクは先行タスクがすべて完了してからのみ進行できます。
コード:
  1. function main() {

  3. console。log(現在。affectedFields。toString());
  4.     
  5. //ベース条件の処理
  6. if(!現在。affectedFields?.ステータス) {
  7. 返品する;
  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 request = 新規 HttpRequest();
  14. request。url(url);
  15. request。connection('zprojects');

  17. const response = request。実行する();
  18. const taskDependencyDtl = response。asJson()?.statusMessage?.responseText?.タスク[0]?.dependency;

  20. //前のタスクに依存関係が存在しない場合
  21. if(!taskDependencyDtl || !taskDependencyDtl?.predecessor) {
  22. 返品する;
  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 新規 ScriptError('未完了の先行タスクがあります。続行する前に先行タスクを完了してください。');
  31. }
  32. }

  34. }

  36. task_owner_status_update_restrict
  37. function main() {

  39. const タスク = 現在。データ;
  40. const affectedFields = 現在。affectedFields;

  42. if(affectedFields。ステータス) {
  43. if(!タスク。_owners || !タスク。_owners。includes(現在。ユーザー。id)) {
  44. throw 新規 ScriptError('ステータスを編集できるのはタスク担当者のみです');
  45. }
  46. }

  48. }

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

サブタスクの作成を制限し、一定のタスク構造を維持します。
コード:
  1. function main() {
  2.     
  3. let タスク = 現在。データ;
  4.  
  5. /**
  6. *
  7. * @種類 番号
  8. */
  9. let startDate = タスク。start_date;
  10. Logger。info('Parent ID: ' + タスク。parent_task);
  11. Logger。info('Root タスク ID: ' + タスク。root_task);
  12.  
  13. // console。log(JSON。stringify(variables。blockSubTasks));
  14. if(タスク。parent_task || タスク。root_task) {
  15. Logger。info('Subtask creation is 無効');
  16. throw 新規 ScriptError(JSON。stringify(variables。blockSubTasks。値));
  17. }
  18.  
  19. //Similar case >>> Subtasks shouldn't be 作成 under the 完了済み parent タスク.
  20. }
  21.  

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

特定のカスタム項目と現在のステータスに基づいて、タスクの期間とステータスを更新します。
例えば、次の条件を満たした場合に、このスクリプトはタスクの期間とステータスを更新します。
  1. タスクの現在のステータスが「オン Hold」の場合、自動的にステータスを特定の ID（例:「進行中」）に変更します。
  2. 複数選択のカスタム項目で特定の値が選択されている場合、期間を 30 日に設定します。
  3. また、タスクの請求種別と影響を受ける項目を確認してログに記録します。
コード:
  1. function main() {
  2.  
  3. /**
  4. * @種類 {CurrentTask}
  5. */
  6. // const タスク = client。getRecordById('5000000000134', '5000000291025');
  7. // console。log(タスク。名前);
  8. // throw 新規 エラー(タスク);
  9. //5000000179016 = corn
  10. let タスク = 現在。データ;
  11. console。log(`id: ${タスク。id}`);
  12. console。log(現在。affectedFields);
  13. console。log(`タスク Billing 種類 ${タスク。billing_type}`);
  14. console。log(`タスク Biling 種類 請求対象 ${TaskBillingType。請求対象}`);
  15. console。log(`タスク Biling 種類 NON_BILLABLE ${TaskBillingType。NON_BILLABLE}`);
  16. console。log(`タスク Biling 種類 なし ${TaskBillingType。なし}`);
  17.  
  18. const statusDetails = client。getStatusDetails(タスク。moduleId, タスク。layoutId, タスク。ステータス);
  19. if(statusDetails。名前 === 'オン Hold') {
  20. タスク。ステータス = '5000000000362';
  21. client。保存(タスク);
  22. }
  23. console。log(JSON。stringify(statusDetails));
  24.     if(タスク。weightage。includes('中') {//check if the multi 選択する 項目 is some 設定
  25. console。log('setting ステータス to 進行中');
  26. タスク。duration_unit = TaskDurationUnit。日;
  27. タスク。duration_value = 30;
  28. }
  29.  
  30.  
  31. }

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

プロジェクトがアーカイブ済みの場合、そのプロジェクト配下のタスクには一切更新を行えないように制限します。
コード:
  1. function main() {
  2. let タスク = 現在。データ;
  3.  
  4. let projectId = タスク。projectId;
  5. const moduleItr = client。getModules(0, 10);
  6. //projects タブ id: 5000000000380
  7. let moduleId;
  8. console。log(JSON。stringify(現在。affectedFields));
  9. while(moduleItr。hasNext()) {
  10. let moduleObj = moduleItr。次();
  11. if(moduleObj。名前 == 'プロジェクト') {
  12. moduleId = moduleObj。id;
  13. }
  14.         
  15. }
  16. let プロジェクト = client。getRecordById(moduleId, projectId);
  17.  
  18. if(プロジェクト。_status == 'アーカイブ済み') {
  19. throw 新規 ScriptError('Edits are 無効 for アーカイブ済み プロジェクト');
  20. }
  21.  
  22.  
  23. }
  24.  

過去の日付での開始日を制限する

正確なスケジュールを維持するため、選択された開始日が過去の日付の場合はエラーをスローします。
コード:
  1. function main() {
  2. let タスク = 現在。データ;
  3. let 日付 = 日付。now();
  4. for(let キー of Object。keys(現在)) {
  5. console。log(キー);
  6. }
  7.  
  8. console。log('現在を確認中');
  9. console。log('現在。ユーザー を確認中');
  10. console。log(`現在。ユーザー。zuid: ${現在。ユーザー。zuid}`);
  11. console。log(`現在。ユーザー。メール ${現在。ユーザー。メール}`);
  12. console。log(`現在。ユーザー。id ${現在。ユーザー。id}`);
  13. console。log('現在。タブ を確認中');
  14. console。log(`現在。タブ。名前 ${現在。タブ。名前}`);
  15. console。log(`現在。タブ。id ${現在。タブ。id}`);

  17. console。log('org を確認中');
  18. console。log(`current.org.名前 ${current.org.zohoOrgId}`);
  19. console。log(`current.org.id ${current.org.orgId}`);
  20. console。log(`current.org.portalName ${current.org.portalName}`);
  21. console。log(`current.org.id ${current.org.名前}`);
  22.  
  23. /**********この下にロジックがあります*************/
  24.  
  25. const startDate = 新規 日付(タスク。start_date)
  26. if(日付 > startDate) {
  27. console。log('開始 日付 が過去日付になっています');
  28. throw 新規 ScriptError('開始 日付 を過去に設定することはできません');
  29. }
  30. }

条件に基づいてタスクの編集を制限する

チェックボックス項目が有効な場合、チェックボックス自体の変更を除き、そのタスクへの更新をすべて制限します。これにより、意図しない変更を防止できます。
コード:
  1. function main() {
  2.  
  3. const affectedFields = 現在。affectedFields;
  4. const タスク = 現在。データ;
  5.  
  6. if(affectedFields && typeof affectedFields['checkbox_cf'] != 'undefined') {
  7. 返品する; //チェックボックス自体が更新された場合は何もしません。
  8. }
  9.  
  10. //チェックボックスタイプ項目の boolean 値
  11. if(タスク。checkbox_cf) {
  12. throw 新規 ScriptError('チェックボックスが有効なため、タスクはロックされています。 ')
  13. }
  14. }
  15.  
CodeX をプロジェクト設定でどのように動作させたいか、アイデアはありますか？下のコメントにユースケースをお寄せください。
その他の関連記事

    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






                          Latest Feature Updates



                                  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.