コンテンツにスキップ

items.NewIssue

概要

サーバスクリプトで「期限付きテーブル」に対する「apiModelオブジェクト」の新規インスタンスを作成します。

構文

items.NewIssue()

戻り値

「期限付きテーブル」の「apiModelオブジェクト」を返却します。

使用例

下記の例では、サイトID 2 の「期限付きテーブル」にタイトルが "プリザンターのバージョンアップについて" のレコードを作成します。

JavaScript
let siteId = 2;
let item = items.NewIssue();
item.Title = 'プリザンターのバージョンアップについて';
items.Create(siteId, item);
context.Log(item.IssueId); //作成したレコードのIDを出力

サンプルコード

1. 親テーブルにリンクする子テーブルのレコードを作成する

案件を管理する「案件管理」テーブル(親)と、それにリンクする「タスク管理」テーブル(子)を用意します。

親の案件管理レコード作成時に定型タスクとして、「'要件定義', '設計', '開発', 'テスト', 'リリース'」をリンクさせた形で作成します。

そのため、案件管理レコード作成後にレコードIDを取得。そのIDをタスク管理レコードに登録することで、親子関係のリンクを保持したレコードが作成できます。

JavaScript

条件:作成後、更新後 等

コードの途中で return を使っているため、サーバスクリプトの「関数化」を有効にしてください。

// サイトIDキャッシュ
const _siteIdCache = new Map();
// サイト名からSiteIdを取得(キャッシュ)
function getSiteIdOrNull(siteName) {
    if (_siteIdCache.has(siteName)) return _siteIdCache.get(siteName);
    const site = items.GetClosestSite(siteName);
    if (!site || !site.SiteId) {
        logs.LogInfo(`${siteName} サイト情報取得失敗`);
        return null;
    }
    _siteIdCache.set(siteName, site.SiteId);
    return site.SiteId;
}
// レコード作成共通処理
function createAndGetId(siteId, apiModel, fields) {
    // fields を apiModel に流し込む
    for (const [key, value] of Object.entries(fields)) {
        apiModel[key] = value;
    }
    try {
        apiModel.Create(siteId);
    } catch (e) {
        logs.LogException(
            `apiModel.Create Error: ${e && e.stack ? e.stack : e}`
        );
        return null;
    }
    // IDを返却
    const id = apiModel.ResultId ?? apiModel.IssueId ?? null;
    logs.LogInfo(`created id: ${id}`);
    return id;
}
// メイン処理
// 親(案件管理)を作成
const caseSiteId = getSiteIdOrNull('案件管理');
if (!caseSiteId) {
    logs.LogException('案件管理サイトの取得に失敗しました。');
    return;
}
const caseId = createAndGetId(caseSiteId, items.NewResult(), {
    Title: 'サンプル案件',
    Status: '200',
    ClassA: '顧客管理システムの刷新',
    DateA: '2025/01/10',
    NumA: 5,
});
if (!caseId) {
    logs.LogException('案件の作成に失敗しました。');
    return;
}
// 子(タスク管理)を作成(リンク項目に親IDをセット)
const taskSiteId = getSiteIdOrNull('タスク管理');
if (!taskSiteId) {
    logs.LogException('タスク管理サイトの取得に失敗しました。');
    return;
}
const taskList = ['要件定義', '設計', '開発', 'テスト', 'リリース'];
for (const task of taskList) {
    const taskId = createAndGetId(taskSiteId, items.NewIssue(), {
        Title: 'サンプル案件',
        ClassA: task,
        ClassD: String(caseId),
    });
    if (!taskId) {
        logs.LogException('タスクの作成に失敗しました。');
        return;
    }
}
実行結果
(Info):created id: 9001
(Info):created id: 9002
(Info):created id: 9003
(Info):created id: 9004
(Info):created id: 9005
(Info):created id: 9006
2. 問い合わせをエスカレーションしたら、タスク管理にタスクを作る

「問い合わせ管理」のレコードをエスカレーション済みにしたとき、items.NewIssueで「タスク管理」(期限付きテーブル)のレコードを作ります。タスクには、問い合わせの題と内容、問い合わせへのリンク、エスカレーションした人を入れます。

実務での使いどころ

サポート窓口で受けた問い合わせのうち、調査や修正が要るものを、開発・保守のチームのタスクとして渡したいときに使えます。問い合わせを写し直す手間と、渡し忘れを防げます。プロセスのデータの変更では、別のテーブルにレコードを作ることはできません。

事前準備

1:「タスク管理」テーブル(期限付きテーブル)で、以下の項目を有効化してください。

項目コード 内容
分類A(ClassA) 問い合わせ。選択肢一覧に[[「問い合わせ管理」テーブルのサイトID]]を設定し、リンクにする
管理者(Manager) エスカレーションした人

2:「問い合わせ管理」テーブル(記録テーブル)の状況に、300(エスカレーション済み)の選択肢を用意します。

3:「問い合わせ管理」テーブルにスクリプトを登録します。

3-1:「テーブルの管理 > サーバスクリプト」タブで「新規作成」を選択する。
 3-2:タイトル: 任意の名前(例:escalateInquiryToTask)
 3-3:スクリプト: 下記サンプルコードを貼り付け、【タスク管理のサイトID】を書き換える
 3-4:条件: 「更新前」にチェック

JavaScript

条件:更新前

// エスカレーション先の「タスク管理」(期限付きテーブル)のサイトID
const TASK_SITE_ID = 【タスク管理のサイトID】;
// 問い合わせの「エスカレーション済み」の状況の値
const ESCALATED_STATUS = 300;

// 問い合わせをエスカレーション済みにしたとき、タスク管理に、問い合わせへのリンク付きのタスクを作る
function escalateInquiryToTask() {
    // エスカレーション済み「以外」から「へ」変わる更新のときだけ作る(2 回作らない)
    const escalating =
        Number(saved.Status) !== ESCALATED_STATUS &&
        Number(model.Status) === ESCALATED_STATUS;
    if (!escalating) {
        return;
    }
    const task = items.NewIssue();
    task.Title = `【問い合わせ】${model.Title}`;
    task.Body = model.Body;
    task.ClassA = String(model.ResultId);  // 問い合わせ(問い合わせ管理へのリンク)
    task.Manager = context.UserId;         // エスカレーションした人
    if (task.Create(TASK_SITE_ID)) {
        context.AddMessage(`タスク管理にタスク(ID:${task.IssueId})を作成しました。`, 'alert-success');
    } else {
        // タスクを作れなかったときは、エスカレーション済みにしない
        context.Error('タスク管理にタスクを作成できませんでした。タスク管理のサイトIDと権限を確かめてください。');
    }
}

escalateInquiryToTask();

注記

  • 状況がエスカレーション済み「以外」から「へ」変わる更新のときに作ります。エスカレーション済みのまま保存し直しても、タスクは増えません。
  • タスクを作れなかったとき(サイトIDの誤り・権限が無いなど)は、エラーを表示して、エスカレーション済みにしません。
3. 毎月1日に、定期タスクの一覧から今月のタスクを作る

「定期タスク」テーブルに登録した毎月の作業から、バックグラウンドサーバスクリプトで毎月1日に、items.NewIssueで「タスク管理」(期限付きテーブル)に今月のタスクを作ります。タスクには、作業の題と手順、担当者、開始(月の初日)、完了(期限日)、定期タスクへのリンク、対象月を入れます。同じ月にもう一度実行しても、作成済みの作業のタスクは作りません。

実務での使いどころ

月次決算・請求書の発行・勤怠の締め・定例の報告書・月例の設備点検など、毎月同じ時期に必ず行う作業に使えます。月初にタスクを作る手間と、作り忘れを防げます。決まった周期でレコードを作る標準の機能はありません(リマインダーは通知のみです)。作業の追加・担当の交代・停止は、定期タスクのレコードを直すと、翌月から変わります。

事前準備

1:Script.jsonのBackgroundServerScriptをtrueにし、プリザンターを再起動してください。バックグラウンドサーバスクリプトは特権ユーザのみ設定できます。

2:「定期タスク」テーブル(記録テーブル)で、以下の項目を有効化してください。

項目コード 内容
タイトル(Title) 作業名
内容(Body) 手順
担当者(Owner) 作業する人
数値A(NumA) 期限日(その月の何日か。1~31。月の日数を超えるときは月末)
チェックA(CheckA) 停止中(オンにした作業のタスクは作らない)

3:「タスク管理」テーブル(期限付きテーブル)で、以下の項目を有効化してください。

項目コード 内容
分類A(ClassA) 定期タスク。選択肢一覧に[[「定期タスク」テーブルのサイトID]]を設定し、リンクにする
分類B(ClassB) 対象月(2026/11の形)

4:サンプルコードの【定期タスクのサイトID】・【タスク管理のサイトID】を、それぞれのテーブルのサイトIDに書き換えます。

5:バックグラウンドサーバスクリプトを登録します。

5-1:「テナントの管理 > サーバスクリプト」タブで「新規作成」を選択する。
 5-2:実行ユーザ: 定期タスクを読み取り、タスク管理にレコードを作成できるユーザ
 5-3:タイトル: 任意の名前(例:createMonthlyTasks)
 5-4:サーバスクリプト: 下記サンプルコードを貼り付け
 5-5:スケジュール: 「毎月」で、1日と実行する時刻(例:9:00)を設定
 5-6:「追加」をクリックし、画面下部の「更新」をクリックする

6:登録したスクリプトを開き、「今すぐ実行」で動かして、タスク管理に今月のタスクができることを確かめてください。

JavaScript
// 「定期タスク」(記録テーブル)と「タスク管理」(期限付きテーブル)のサイトID
const ROUTINE_SITE_ID = 【定期タスクのサイトID】;
const TASK_SITE_ID = 【タスク管理のサイトID】;

function pad(n) {
    return String(n).padStart(2, '0');
}

function toYmd(d) {
    return `${d.getFullYear()}/${pad(d.getMonth() + 1)}/${pad(d.getDate())}`;
}

// 200件を超えても全件読む
function getAll(siteId, view) {
    const all = [];
    while (true) {
        const results = Array.from(items.Get(siteId, JSON.stringify({ View: view, Offset: all.length })));
        if (results.length === 0) {
            return all;
        }
        results.forEach((item) => all.push(item));
    }
}

// 対象月のタスクを作成済みの定期タスクのID
function getCreatedRoutineIds(month) {
    const tasks = getAll(TASK_SITE_ID, {
        ColumnFilterHash: { ClassB: JSON.stringify([month]) },
        ColumnFilterSearchTypes: { ClassB: 'ExactMatchMultiple' },
    });
    // 完全一致で絞っているが、取得した値でも確かめる
    return tasks.filter((task) => task.ClassB === month).map((task) => task.ClassA);
}

// 毎月1日に、定期タスクの一覧から今月のタスクを作る(バックグラウンドサーバスクリプトで毎月実行する)
function createMonthlyTasks() {
    const now = new Date();
    const year = now.getFullYear();
    const monthIndex = now.getMonth();
    const month = `${year}/${pad(monthIndex + 1)}`;
    const lastDay = new Date(year, monthIndex + 1, 0).getDate();
    const created = getCreatedRoutineIds(month);
    const count = { created: 0, exists: 0, stopped: 0, invalid: 0, failed: 0 };
    for (const routine of getAll(ROUTINE_SITE_ID, {})) {
        const routineId = String(routine.ResultId);
        if (routine.CheckA) {
            count.stopped++;      // 停止中
            continue;
        }
        if (created.includes(routineId)) {
            count.exists++;       // 今月の分は作成済み
            continue;
        }
        const dueDay = Number(routine.NumA);
        if (!Number.isInteger(dueDay) || dueDay < 1 || dueDay > 31) {
            count.invalid++;
            logs.LogUserError(`期限日が1〜31ではないため作りませんでした:定期タスク ${routineId} ${routine.Title}`, 'createMonthlyTasks');
            continue;
        }
        // 期限日が月の日数を超えたら月末にする
        const due = new Date(year, monthIndex, Math.min(dueDay, lastDay));
        const task = items.NewIssue();
        task.Title = `【${month}】${routine.Title}`;
        task.Body = routine.Body;
        task.Owner = routine.Owner;
        task.StartTime = toYmd(new Date(year, monthIndex, 1));
        task.CompletionTime = toYmd(due);
        task.ClassA = routineId;  // 定期タスク(定期タスクへのリンク)
        task.ClassB = month;      // 対象月
        if (task.Create(TASK_SITE_ID)) {
            count.created++;
        } else {
            count.failed++;
            logs.LogUserError(`タスクを作成できませんでした:定期タスク ${routineId} ${routine.Title}`, 'createMonthlyTasks');
        }
    }
    logs.LogInfo(
        `[createMonthlyTasks] 対象月=${month} 作成${count.created}件 作成済み${count.exists}件 停止中${count.stopped}件 期限日の誤り${count.invalid}件 失敗${count.failed}件`,
        'main',
    );
}

createMonthlyTasks();

注記

  • 実行した日の年月を対象月にします。スケジュールの時刻は、日付が変わる0時の前後を避けてください。
  • 作成済みかどうかは、タスク管理の対象月(分類B)と定期タスク(分類A)で確かめます。「今すぐ実行」で試したあとにスケジュールで動いても、同じ月のタスクは増えません。
  • 期限日が空のもの、1~31でないものは作らず、システムログに出します。
  • 完了には期限日を入れます。期限日が月の日数を超える作業(31日など)は、その月の末日にします。
  • バックグラウンドサーバスクリプトはデバッグできません。最初は「今すぐ実行」で結果を確かめてから、スケジュールを設定してください。

関連情報