タスク用CodeXスクリプト

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

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

CodeX Scripts は CN、JP、AE を除くすべてのデータセンターでサポートされています。
ただし、これらのデータセンターのポータルで CodeX Scripts を有効化したい場合は、support@zohoprojects.com までお問い合わせください。

利用シナリオ:

サブタスクを 1 階層以上作成できないように制限する

サブタスクの下にさらにサブタスクを作成できないように制限し、サブタスクは 1 階層までに抑えたシンプルで管理しやすいタスク階層を維持します。

コード:

function main() {
if(現在。データ。parent_task !== 現在。データ。root_task) {
throw 新規 ScriptError('1 階層を超えるサブタスクの作成は無効です');
}
}

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

関連付けられているプロジェクトが「保留中」に設定されている場合、そのプロジェクトでのタスク作成を制限します。

コード:

function main() {
const projectId = 現在。データ。projectId;
const moduleItr = client。getModules();
/**
* @種類 {タブ}
*/
let タブ
console。log('started');
for (let mod of moduleItr) {
console。log(`${mod}`);
if (mod。名前 === 'プロジェクト') {
タブ = mod;
}
}
if (!タブ) {
返品する;
}
let projectDtl = client。getRecordById(タブ。id, projectId);
let statusDtl = client。getStatusDetails(タブ。id, projectDtl。layoutId, projectDtl。ステータス);
if (statusDtl。名前 === 'zp。projstatus。onhold') {
throw 新規 ScriptError('保留中のプロジェクトではタスク作成は無効です');
}
}

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

レイアウトの初期ステータスと異なるステータスの場合、開始日、終了日、または期間を編集できないように制限します。

コード:

function main() {
//base 条件 #1
if (!現在。affectedFields。start_date
&& !現在。affectedFields。end_date
&& !現在。affectedFields。duration_value
&& !現在。affectedFields。duration_unit) {
返品する;
}
const statusDtl = client。getStatusDetails(現在。タブ。id, 現在。データ。layoutId, 現在。データ。ステータス);
console。log(`${statusDtl}`);
if (!statusDtl。isLayoutDefault) {
throw 新規 ScriptError('開始日と終了日の変更は、初期ステータスでのみ許可されています');
}
}

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

未完了のサブタスクが存在する場合、親タスクのステータスを「完了」に変更できないように制限します。これにより、すべてのサブタスクが完了するまで、親タスクを完了としてマークできないようにします。

コード:

function main() {
console。log(現在。affectedFields。toString());
//base 条件 handling
if (!現在。affectedFields?.ステータス) {
返品する;
}
const url = `https://projects.zoho.com/restapi/portal/${current.org.zohoOrgId}/projects/${current.record.projectId}/tasks/${current.record.id}/subtasks/`;
let hasMore = 真;
const range = 200;
let index = 1;
console。log(url);
while (hasMore) {
let request = 新規 HttpRequest();
request。url(url);
request。connection('zprojects');
request。params({ index, range });
const response = request。実行する();
console。log(response。asText());
/**
* @種類 {[]}
*/
const タスク = response。asJson()?.statusMessage?.responseText?.タスク;
//no subtasks present for 現在タスク
if (!タスク || タスク。length == 0) {
console。log('いいえ subtasks 既存 for 現在タスク');
返品する;
}
hasMore = タスク。length == range;
index += range;
console。log(タスク);
console。log(タスク。length);
for (let タスク of タスク) {
console。log(task.completed);
if (!task.completed) {
throw 新規 ScriptError('タスク cannot be 完了済み since it contains 開く subtask(s)');
}
}
}
}

前提タスクが未完了の場合にステータス変更を制限する

いずれかの前提タスクが未完了の場合、依存関係のロジックを維持するためにステータス更新を制限し、後続タスクは前提タスクが完了してからのみ進行できるようにします。

コード:

function main() {
console。log(現在。affectedFields。toString());
//base 条件 handling
if(!現在。affectedFields?.ステータス) {
返品する;
}
const url = `https://projects.zoho.com/restapi/portal/${current.org.zohoOrgId}/projects/${current.record.projectId}/tasks/${current.record.id}/`;
console。log(url);
let request = 新規 HttpRequest();
request。url(url);
request。connection('zprojects');
const response = request。実行する();
const taskDependencyDtl = response。asJson()?.statusMessage?.responseText?.タスク[0]?.dependency;
//no dependency present in 前へタスク
if(!taskDependencyDtl || !taskDependencyDtl?.predecessor) {
返品する;
}
console。log(taskDependencyDtl);
for(let predecessorId of taskDependencyDtl。predecessor) {
console。log(predecessorId);
if(!taskDependencyDtl。dependencyDetails[predecessorId]?.IS_COMPLETED) {
throw 新規 ScriptError('開く predecessor タスク既存, please 閉じる them to 続ける');
}
}
}

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

サブタスクの作成を制限し、一定のタスク構造を維持します。

コード:

function main() {
let タスク = 現在。データ;
let startDate = タスク。start_date;
if(タスク。parent_task || タスク。root_task) {
Logger。info('Subtask creation is 無効');
throw 新規 ScriptError('Subtask creation is 無効'));
}
}

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

特定のカスタム項目と現在のステータスに基づいて、タスクの期間とステータスを更新します。

例えば、このスクリプトは、特定の条件を満たしたときにタスクの期間とステータスを次のように更新します。

タスクの現在のステータスが「オン Hold」の場合、自動的にステータスを特定のID（例：「進行中」）に変更します。

複数選択のカスタム項目で特定の値が選択されている場合、期間を30日に設定します。

また、タスクの請求種別と影響を受けた項目を確認してログに記録します。

コード:

function main() {
let タスク = 現在。データ;
const statusDetails = client。getStatusDetails(タスク。moduleId, タスク。layoutId, タスク。ステータス);
if(statusDetails。名前 === 'オン Hold') {
タスク。ステータス = '5000000000362';
client。保存(タスク);
}
console。log(JSON。stringify(statusDetails));
if(タスク。weightage。includes('中') {//マルチ選択項目に特定の設定が含まれているかを確認
console。log('ステータスを進行中に設定');
タスク。duration_unit = TaskDurationUnit。日;
タスク。duration_value = 30;
}
}