SystemDocument - スコープ対象、グローバル

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：15分

    • SystemDocument API は、ドキュメント [ds_document] テーブルのレコードのフィールドを設定するためのメソッドを提供します。

    この API は ドキュメント管理 プラグイン (com.snc.platform_document_management) を必要とし、 sn_doc_services 名前空間内で提供されます。詳細については、「 ドキュメント サービス」を参照してください。

    ドキュメントを作成するには、 DocumentService API を使用します。

    SystemDocument - SystemDocument(文字列 docName)

    SystemDocument オブジェクトをインスタンス化します。

    表 : 1. パラメーター
    名前 タイプ 説明
    docName 文字列 ドキュメントの名前。
    表 : 2. 返される内容
    タイプ 説明
    なし

    次の例は、 SystemDocument オブジェクトをインスタンス化し、ドキュメントレコードの複数のフィールドを設定する方法を示しています。「 DocumentService API」も参照してください。

    var d = new sn_doc_services.SystemDocument('My document');

// Define the document fields
var reviewers = '62826bf03710200044e0bfc8bcbe5df1,a8f98bb0eb32010045e1a5115206fe3a';
d.description('description');
d.classification('restricted');
d.state('review');
d.department('93b25282c0a8000b0b55c8ab34e2f1e6');
d.template(false);
d.type('policy');
d.reviewers(reviewers);
d.audience('external');

var s = new sn_doc_services.DocumentService();
gs.info(JSON.stringify(s.createDocument(d), null, 2));
    出力：
    {
  "message": "Create document sysId : 1040420224503410f877a6fed1c2b031 is successful.",
  "request_id": "1040420224503410f877a6fed1c2b031",
  "status": "success"
}

    SystemDocument - audience(文字列 audience)

    ドキュメントレコードの [対象者] フィールドを設定して、外部または内部の可用性を指定します。ドキュメント管理フォームの [対象者] フィールドを表します。

    表 : 3. パラメーター
    名前 タイプ 説明
    対象者 文字列 ドキュメントの対象者を表す文字列。
    可能な値：
    • 外部
    • 内部
    デフォルト:internal
    表 : 4. 返される内容
    タイプ 説明
    なし

    次の例は、新しいドキュメントレコードの [対象者] フィールドを設定する方法を示しています。「DocumentService:スコープ指定、グローバル」も参照してください。

    var d = new sn_doc_services.SystemDocument('My document');
var s = new sn_doc_services.DocumentService();

d.audience('external');

gs.info(JSON.stringify(s.createDocument(d), null, 2));
    出力：
    {
  "message": "Create document sysId : 1193fd4624103410f877a6fed1c2b016 is successful.",
  "request_id": "1193fd4624103410f877a6fed1c2b016",
  "status": "success"
}

    SystemDocument:分類 (文字列分類)

    ドキュメントレコードの [分類] フィールドを設定して、情報の機密性のレベルを識別します。[分類] フィールドを ドキュメント管理 形式で表します。

    表 : 5. パラメーター
    名前 タイプ 説明
    分類 文字列 ドキュメントの分類。
    可能な値：
    • 機密
    • 公開
    • 制限付き
    デフォルト：public
    表 : 6. 返される内容
    タイプ 説明
    文字列 SystemDocument オブジェクトの分類プロパティの値。

    次の例は、新しいドキュメントレコードの分類フィールドを設定する方法を示しています。「 DocumentService API」も参照してください。

    var d = new sn_doc_services.SystemDocument('My restricted document');
var s = new sn_doc_services.DocumentService();

d.classification('restricted');

gs.info(JSON.stringify(s.createDocument(d), null, 2));
    出力：
    {
  "message": "Create document sysId : d80435c624103410f877a6fed1c2b0d0 is successful.",
  "request_id": "d80435c624103410f877a6fed1c2b0d0",
  "status": "success"
}

    SystemDocument - createdFromTemplate(文字列 docTemplate)

    ドキュメントを生成するテンプレートを設定します。ドキュメントが生成されると、指定されたテンプレートがドキュメント [ds_document_list] テーブルの [テンプレートから作成] フィールドに一覧表示されます。

    表 : 7. パラメーター
    名前 タイプ 説明
    docTemplate 文字列 ドキュメント [ds_document_list] テーブルにリストされているドキュメントのSys_id。ドキュメントでは、[テンプレート] チェックボックスをオン (true) にする必要があります。「 DocumentVersionService API」も参照してください。
    表 : 8. 返される内容
    タイプ 説明
    なし

    次の例は、既存のテンプレートから新しいドキュメントレコードを作成する方法を示しています。「 DocumentService API」も参照してください。

    var d = new sn_doc_services.SystemDocument('New doc from template');
var s = new sn_doc_services.DocumentService();

d.createdFromTemplate('<doc_template_sys_id>');

gs.info(JSON.stringify(s.createDocument(d), null, 2));
    出力：
    {
  "message": "Create document sysId : deaef1ce24103410f877a6fed1c2b085 is successful.",
  "request_id": "deaef1ce24103410f877a6fed1c2b085",
  "status": "success"
}

    SystemDocument - department(文字列 docDept)

    ドキュメントレコードの [部門] フィールドを設定します。

    表 : 9. パラメーター
    名前 タイプ 説明
    docDept 文字列 部門 [cmn_department] テーブルにリストされている部門のSys_id。
    表 : 10. 返される内容
    タイプ 説明
    なし

    次の例は、新しいドキュメントレコードの [部門] フィールドを設定する方法を示しています。「 DocumentService API」も参照してください。

    var d = new sn_doc_services.SystemDocument('My document');

// Assign the doc to the human resources department
d.department('<dept_sys_id>');

var s = new sn_doc_services.DocumentService();
gs.info(JSON.stringify(s.createDocument(d), null, 2));
    出力：
    {
  "message": "Create document sysId : 491efbee24187410f877a6fed1c2b0a9 is successful.",
  "request_id": "491efbee24187410f877a6fed1c2b0a9",
  "status": "success"
}

    SystemDocument - description(文字列の説明)

    ドキュメントレコードの [説明] フィールドを設定します。

    表 : 11. パラメーター
    名前 タイプ 説明
    description 文字列 ドキュメントの説明。
    表 : 12. 返される内容
    タイプ 説明
    なし

    次の例は、ドキュメントレコードの説明フィールドを設定する方法を示しています。「 DocumentService API」も参照してください。

    var d = new sn_doc_services.SystemDocument('My document');

d.description('Information describing the doc.');

var s = new sn_doc_services.DocumentService();
gs.info(JSON.stringify(s.createDocument(d), null, 2));
    出力：
    {
  "message": "Create document sysId : 9acd7fea24587410f877a6fed1c2b060 is successful.",
  "request_id": "9acd7fea24587410f877a6fed1c2b060",
  "status": "success"
}

    SystemDocument - name(文字列 docName)

    ドキュメントレコードの [名前] フィールドを設定します。

    注:
    SystemDocument() コンストラクタで名前をパラメータとして設定することもできます。
    表 : 13. パラメーター
    名前 タイプ 説明
    docName 文字列 ドキュメントの名前。
    表 : 14. 返される内容
    タイプ 説明
    なし

    次の例は、新しいドキュメントレコードの [名前] フィールドを設定する方法を示しています。「 DocumentService API」も参照してください。

    var d = new sn_doc_services.SystemDocument();

d.name('Document named using method instead of constructor');

var s = new sn_doc_services.DocumentService();
gs.info(JSON.stringify(s.createDocument(d), null, 2));
    出力：
    {
  "message": "Create document sysId : c19d7f2624587410f877a6fed1c2b0eb is successful.",
  "request_id": "c19d7f2624587410f877a6fed1c2b0eb",
  "status": "success"
}

    SystemDocument - owner(文字列 owner)

    ドキュメントレコードの [オーナー] フィールドを設定します。

    表 : 15. パラメーター
    名前 タイプ 説明
    owner 文字列 ユーザー [sys_user] テーブルにリストされているユーザーのSys_id。

    必要なロール：admin

    デフォルト:現在のユーザー
    表 : 16. 返される内容
    タイプ 説明
    なし

    次の例は、新しいドキュメントレコードでオーナーフィールドを設定する方法を示しています。「 DocumentService API」も参照してください。

    var d = new sn_doc_services.SystemDocument('My document');
var s = new sn_doc_services.DocumentService();

d.owner('aa826bf03710200044e0bfc8bcbe5dd6');

gs.info(JSON.stringify(s.createDocument(d), null, 2));
    出力：
    {
  "message": "Create document sysId : 4235318a24103410f877a6fed1c2b0ff is successful.",
  "request_id": "4235318a24103410f877a6fed1c2b0ff",
  "status": "success"
}

    SystemDocument - レビュー担当者 (文字列レビュー担当者)

    ドキュメントレコードの [レビュー担当者] フィールドを設定します。

    表 : 17. パラメーター
    名前 タイプ 説明
    レビュー担当者 文字列 sys_id別の 1 人以上のドキュメントレビュー担当者のリスト。レビュー担当者は、ユーザー [sys_user] テーブルにリストされているユーザーである必要があります。
    表 : 18. 返される内容
    タイプ 説明
    なし

    次の例は、新しいドキュメントレコードの [レビュー担当者] フィールドを設定する方法を示しています。「 DocumentService API」も参照してください。

    var d = new sn_doc_services.SystemDocument('My document');

var reviewers = '62826bf03710200044e0bfc8bcbe5df1,a8f98bb0eb32010045e1a5115206fe3a';
d.reviewers(reviewers);

var s = new sn_doc_services.DocumentService();
gs.info(JSON.stringify(s.createDocument(d), null, 2));
    出力：
    {
  "message": "Create document sysId : 8d19f9ca24103410f877a6fed1c2b0aa is successful.",
  "request_id": "8d19f9ca24103410f877a6fed1c2b0aa",
  "status": "success"
}

    SystemDocument - state(文字列ステータス)

    ドキュメントレコードの [ステータス] フィールドを設定します。

    表 : 19. パラメーター
    名前 タイプ 説明
    state 文字列 ドキュメントがワークフロー内のどこにあるかを表すドキュメントの状態。
    有効な値：
    • ドラフト
    • 送信
    • review
    • complete
    デフォルト:ドラフト
    表 : 20. 返される内容
    タイプ 説明
    なし

    次の例は、新しいドキュメントレコードのステータスフィールドを設定する方法を示しています。「 DocumentService API」も参照してください。

    var d = new sn_doc_services.SystemDocument('My document');
var s = new sn_doc_services.DocumentService();

d.state('submit');

gs.info(JSON.stringify(s.createDocument(d), null, 2));
    出力：
    {
  "message": "Create document sysId : 19aab54e24103410f877a6fed1c2b03d is successful.",
  "request_id": "19aab54e24103410f877a6fed1c2b03d",
  "status": "success"
}

    SystemDocument - template(ブールテンプレート)

    ドキュメントレコードがテンプレートであるかどうかを指定します。

    表 : 21. パラメーター
    名前 タイプ 説明
    template ブーリアン

    ドキュメントレコードがテンプレートであるかどうかを指定するフラグ。

    有効な値：
    • true:このドキュメントのデフォルトバージョンはテンプレートです。
    • false:このドキュメントはテンプレートではありません。

    デフォルト値：false
    表 : 22. 返される内容
    タイプ 説明
    なし

    次の例は、ドキュメントレコードがテンプレートであることを示す方法を示しています。「 DocumentService API」も参照してください。

    var d = new sn_doc_services.SystemDocument('My document');

d.template(true);

var s = new sn_doc_services.DocumentService();
gs.info(JSON.stringify(s.createDocument(d), null, 2));
    出力：
    {
  "message": "Create document sysId : f7f006ce24103410f877a6fed1c2b053 is successful.",
  "request_id": "f7f006ce24103410f877a6fed1c2b053",
  "status": "success"
}

    SystemDocument - type(文字列 docType)

    ドキュメントレコードの [タイプ] フィールドを設定します。

    表 : 23. パラメーター
    名前 タイプ 説明
    docType 文字列 ドキュメントのタイプ。
    有効な値：
    • contract
    • 指針
    • policy
    • 手順
    デフォルト：なし
    表 : 24. 返される内容
    タイプ 説明
    なし

    次の例は、新しいドキュメントレコードのタイプフィールドを設定する方法を示しています。「 DocumentService API」も参照してください。

    var d = new sn_doc_services.SystemDocument('How to use the document mgmt API');
var s = new sn_doc_services.DocumentService();

d.type('guideline');

gs.info(JSON.stringify(s.createDocument(d), null, 2));
    出力：
    {
  "message": "Create document sysId : 8adfb10224503410f877a6fed1c2b0e4 is successful.",
  "request_id": "8adfb10224503410f877a6fed1c2b0e4",
  "status": "success"
}