タスク用CodeXスクリプト

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

Zoho ProjectsのCodeXスクリプトは、特定のルールや検証を適用するための高度な条件ロジックスクリプトです。ユーザーは、タスクを作成、編集、またはステータス遷移できるタイミングと方法を制御できます。これにより、コンプライアンスの向上とプロセスの整合性確保につながります。

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

使用例：

タスク階層をシンプルで管理しやすい状態に保つため、サブタスクの下にさらにサブタスクを作成できないようにし、サブタスクは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。ステータス。id);
console。log(statusDtl)
if (statusDtl。名前 === 'zp。projstatus。onhold') {
throw 新規 ScriptError('タスク Creation 無効 for オン Hold プロジェクト');
}
}

ステータスがレイアウトのデフォルト値と一致しない場合、開始日、終了日、または期間の編集を制限します。

コード:

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('開始する日付 and End 日付変更する are only allowed in 初期設定ステータス');
}
}

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

コード:

function main() {
console。log(現在。affectedFields。toString());
//基本条件の処理
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?.タスク;
//現在のタスクにサブタスクが存在しない場合
if (!タスク || タスク。length == 0) {
console。log('現在のタスクにサブタスクは存在しません');
返品する;
}
hasMore = タスク。length == range;
index += range;
console。log(タスク);
console。log(タスク。length);
for (let タスク of タスク) {
console。log(task.completed);
if (!task.completed) {
throw 新規 ScriptError('未完了のサブタスクが含まれているため、タスクを完了にできません');
}
}
}
}

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

コード:

function main() {
console。log(現在。affectedFields。toString());
//基本条件の処理
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;
//先行タスクに依存関係が存在しない場合
if(!taskDependencyDtl || !taskDependencyDtl?.predecessor) {
返品する;
}
console。log(taskDependencyDtl);
for(let predecessorId of taskDependencyDtl。predecessor) {
console。log(predecessorId);
if(!taskDependencyDtl。dependencyDetails[predecessorId]?.IS_COMPLETED) {
throw 新規 ScriptError('未完了の先行タスクが存在します。続行するには完了してください');
}
}
}

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

コード:

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

例として、このスクリプトは特定の条件を満たした場合に、タスクの期間とステータスを更新します。

タスクの現在のステータスが「オン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;
}
}