items.NewIssue
概要¶
サーバスクリプトで「期限付きテーブル」に対する「apiModelオブジェクト」の新規インスタンスを作成します。
構文¶
戻り値¶
「期限付きテーブル」の「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;
}
}
実行結果¶
2. 問い合わせをエスカレーションしたら、タスク管理にタスクを作る
「問い合わせ管理」のレコードをエスカレーション済みにしたとき、items.NewIssueで「タスク管理」(期限付きテーブル)のレコードを作ります。タスクには、問い合わせの題と内容、問い合わせへのリンク、エスカレーションした人を入れます。
実務での使いどころ¶
サポート窓口で受けた問い合わせのうち、調査や修正が要るものを、開発・保守のチームのタスクとして渡したいときに使えます。問い合わせを写し直す手間と、渡し忘れを防げます。プロセスのデータの変更では、別のテーブルにレコードを作ることはできません。
事前準備¶
1:「タスク管理」テーブル(期限付きテーブル)で、以下の項目を有効化してください。
| 項目コード | 内容 |
|---|---|
| 分類A(ClassA) | 問い合わせ。選択肢一覧に[[「問い合わせ管理」テーブルのサイトID]]を設定し、リンクにする |
| 管理者(Manager) | エスカレーションした人 |
2:「問い合わせ管理」テーブル(記録テーブル)の状況に、300(エスカレーション済み)の選択肢を用意します。
3:「問い合わせ管理」テーブルにスクリプトを登録します。
3-1:「テーブルの管理 > サーバスクリプト」タブで「新規作成」を選択する。
3-2:タイトル: 任意の名前(例:escalateInquiryToTask)
3-3:スクリプト: 下記サンプルコードを貼り付け、【タスク管理のサイトID】を書き換える
3-4:条件: 「更新前」にチェック
JavaScript¶
条件:更新前
注記¶
- 状況がエスカレーション済み「以外」から「へ」変わる更新のときに作ります。エスカレーション済みのまま保存し直しても、タスクは増えません。
- タスクを作れなかったとき(サイト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¶
注記¶
- 実行した日の年月を対象月にします。スケジュールの時刻は、日付が変わる0時の前後を避けてください。
- 作成済みかどうかは、タスク管理の対象月(分類B)と定期タスク(分類A)で確かめます。「今すぐ実行」で試したあとにスケジュールで動いても、同じ月のタスクは増えません。
- 期限日が空のもの、1~31でないものは作らず、システムログに出します。
- 完了には期限日を入れます。期限日が月の日数を超える作業(31日など)は、その月の末日にします。
- バックグラウンドサーバスクリプトはデバッグできません。最初は「今すぐ実行」で結果を確かめてから、スケジュールを設定してください。
