ProjectsのCodeXスクリプト

ProjectsのCodeXスクリプト

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

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

Info

ユースケース:

新しいプロジェクトを作成

所有者、日付、予算、カスタム項目などのプロジェクト情報を設定した新しいプロジェクトを作成します。
コード:
  1. function main() {
  2. try {
  3. const layoutId = current.データ.layoutId;
  4. const moduleId = current.データ.moduleId;
  5. const layout = client.getLayoutById(layoutId, moduleId);

  7. const newProject = new データ(layout);
  8. newProject.name = 'Explore Zoho ';

  10. const projectOwnerId = variables.projectowner.value;

  12. const user1 = variables.user1.value; // user1 の ZPUID は variables に保存されています
  13. const user2 = variables.user2.value; // user2 の ZPUID は variables に保存されています

  15. const addedProject = client.save(newProject);
  16. addedProject.name = 'Explore Zoho Projects';
  17. addedProject.説明 =
  18. 'Zoho Projects の機能を確認するプロジェクトです';
  19. addedProject.owner = projectOwnerId;
  20. addedProject.status = '242942000000027095'; // レイアウトに基づくステータス ID。こちらの 242942000000040005 は「進行中」ステータスに対応します
  21. addedProject.start_date = '2025-12-08';
  22. addedProject.end_date = '2025-12-25';
  23. addedProject.project_group = '242942000000025001'; // プロジェクトグループ ID
  24. addedProject.completed_time = '2025-12-31T00:00:00+05:30'; // 完了日時は ISO の日付・時刻形式で指定する必要があります
  25. addedProject.currency = 'INR'; // 通貨コード
  26. addedProject.budget_type = '1'; // 予算タイプ
  27. addedProject.hourly_budget = '5.000';
  28. addedProject.hourly_budget_threshold = '3.000';
  29. addedProject.cost_budget = '5600';
  30. addedProject.cost_budget_threshold = '5000';
  31. addedProject.revenue_budget = '4000';
  32. addedProject.billing_method = '1'; // 請求方法。IDE の BillingMethod 列挙型を参照してください。
  33. addedProject.rate_per_hour = '800';
  34. addedProject.cost_per_hour = '600';

  36. addedProject.single_line_text = 'Sample Single Line Text';
  37. addedProject.pick_list = 'Option 1'; // レイアウトの選択リストのオプションに基づく値
  38. addedProject.multi_line_text =
  39. 'Lorem sunt Duis dolor laborum \n eu magna incididunt ipsum qui sit pariatur \n aute officia nisi irure nostrud sit commodo esse';
  40. addedProject.multi_select_field = ['Option 1', 'Option 2', 'Option 3']; // レイアウトの複数選択オプションに基づく値
  41. addedProject.user_pick_list_all_users = user1;
  42. addedProject.user_pick_list_select_roles = '242942000000082031'; // 組織ロールに基づくロール ID
  43. addedProject.user_pick_list_selected_users = user2;
  44. addedProject.multi_user_picklist_all_users = [user1, user2];
  45. addedProject.multi_user_picklist_selected_roles = [
  46. '242942000000082031',
  47. '242942000000082001',
  48. ];
  49. addedProject.multi_user_picklist_selected_users = [user1, user2];
  50. addedProject.date_field = '2025-12-08'; // 日付項目の値（ISO 日付形式）
  51. addedProject.checkbox_field = 'true';
  52. addedProject.currency_field = '4300';
  53. addedProject.percentage_field = '25'; // % 記号を含まないパーセンテージ値
  54. addedProject.decimal_field = '130.24';
  55. addedProject.number_field = '430020';
  56. addedProject.email_field = 'vishal@yahoo.com';
  57. addedProject.phone_field = '1234567890';
  58. addedProject.url_field = 'https://zlyker.com/';
  59. client.save(addedProject);
  60. } catch (err) {
  61. console.log(err);
  62. throw new ScriptError(err);
  63. }
  64. }

新しいエンティティを作成

任意のタブで、名前項目だけが設定された空のデータを作成します。デバッグや検証用途に使用します。
コード:
  1. function main() {

  3. try {

  5. let layout = client.getLayoutById(current.データ.layoutId, current.データ.moduleId);

  7. let データ = new データ(layout);

  9. データ.name = 'created project from script'

  11. client.save(データ);

  13. } catch (err) {

  15. throw new ScriptError(err);

  17. }

  19. }
  20.  

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

関連付けられたプロジェクトがアーカイブされている場合、タスクの編集を制限します。
コード：
  1. function main() {
  2. let task = current.データ;
  3.  
  4. let projectId = task.projectId;
  5. const moduleItr = client.getModules(0, 10);
  6. //projects タブ id: 5000000000380
  7. let moduleId;
  8. console.log(JSON.stringify(current.affectedFields));
  9. while(moduleItr.hasNext()) {
  10. let moduleObj = moduleItr.next();
  11. if(moduleObj.name == 'Projects') {
  12. moduleId = moduleObj.id;
  13. }
  14.         
  15. }
  16. let project = client.getRecordById(moduleId, projectId);
  17.  
  18. if(project._status == 'archived') {
  19. throw new ScriptError('アーカイブ済みプロジェクトは編集できません');
  20. }
  21.  
  22.  
  23. }
  24.  
プロジェクトのセットアップで、CodeX の動作についてアイデアがありますか？コメント欄にユースケースをお寄せください。
関連記事
ヘルプに戻る
CodeX スクリプト（Projects）