---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CdmEditorApi

# CdmEditorApi {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：62分

CdmEditorApi は、ノードの作成、ノードの更新、既存のノードを他のノードの下に含め、ノードの削除、ノードとノードインクルードの取得を行うことができるエンドポイントを提供します。  
この API にアクセスするには、次のいずれかのロールが必要です。

* スクリプト済み REST CDM ビュー ACL (sn_cdm.cdm.viewer)
* スクリプト済み REST CDM エディター ACL (sn_cdm.cdm_editor)

暗号化されたフィールドを表示するには、CDM シークレットロールが必要です。

さらに、この API をインスタンスで使用するには、 構成データ管理 (CDM) プラグインをアクティブ化する必要があります。  
注:  
CdmEditorApi API を使用してファイルを変更することはできません。現在許可されているのはファイルの削除のみです。

## CdmEditorApi - 削除 /sn_cdm/editor/nodes {#ariaid-title2}

指定されたノードを削除します。
このエンドポイントの呼び出し元には、CDM エディターロールが必要です。

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/editor/nodes

デフォルト URL: /api/sn_cdm/editor/nodes  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#editor-DELETE-nodes__entry__2}{#editor-DELETE-nodes__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 1. パスパラメーター]

{#editor-DELETE-nodes__entry__6}{#editor-DELETE-nodes__changesetNumber-changeset-entry}{#editor-DELETE-nodes__fullNamePath-node-editor-entry}

| 名前 | 説明 |
|-|-|
| changesetNumber | 必須です。 関連する変更セットの一意の識別子 (「Chset-10」など)。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| fullNamePath | 必須です。削除するノードのパス名。 次のいずれかの形式で名前パスを渡すことができます。たとえば、 `testApp/deployables/Development1/cdi1` というノードを削除するには、次のようにします。 * バックスラッシュ形式: testApp/deployables/Development1/cdi1 注: ノード名にバックスラッシュ ("/") が含まれている場合、この形式は使用できません。 * 置換文字を含むバックエンド名のパス: testApp deployables Development1 cdi1 * アレイ: \['testApp','deployables','Development1','cdi1'\] {#editor-DELETE-nodes__ul_xrv_rc1_cyb} データタイプ：文字列 |
[表 : 2. クエリパラメーター]

{#editor-DELETE-nodes__entry__12}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 3. 要求本文のパラメーター]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#editor-DELETE-nodes__entry__16}{#editor-DELETE-nodes__accept-JSON-only-entry-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
[表 : 4. 要求ヘッダー]

{#editor-DELETE-nodes__entry__20}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 5. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#editor-DELETE-nodes__entry__24}{#editor-DELETE-nodes__entry-200-status-code}{#editor-DELETE-nodes__entry-400-status-code}{#editor-DELETE-nodes__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 6. ステータスコード]

### 応答本文のパラメーター

{#editor-DELETE-nodes__entry__32}

| 名前 | 説明 |
|-|-|
| なし |   |
[ ]

### cURL 要求

次のコード例は、ノード「cdi88」を削除する方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/editor/nodes?changesetNumber=Chset783&fullNamePath=%2FtestApp%2Fdeployables%2FDevelopment-1%2Fcdi88" \
    --request DELETE \
    --header "Accept:application/json" \
    --user 'username':'password'

結果を返します:

    None - just the associated HTTP status code

## CdmEditorApi - GET /sn_cdm/editor/includes {#ariaid-title3}

指定されたノードパス内に含まれていたノードのリストを返します。
このエンドポイントの呼び出し元には、CDM ビューアーロールが必要です。

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/editor/includes

デフォルト URL: /api/sn_cdm/editor/includes  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#editor-GET-includes__entry__2}{#editor-GET-includes__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 7. パスパラメーター]

{#editor-GET-includes__entry__6}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 8. クエリパラメーター]

{#editor-GET-includes__entry__10}{#editor-GET-includes__cdm_apps-returnFields-entry}

| 名前 | 説明 |
|-|-|
| changesetNumber | 関連する変更セットの一意の識別子 (「Chset-10」など)。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| returnFields | 応答の一部として返されるフィールドのリスト。sys_id、sys_updated_by、ステータスなどのレコード列名を渡します。 データタイプ：アレイ デフォルト:エンドポイントによって決定されたすべてのフィールド |
| sourceFullNamePath | 必須です。含まれているノードを返すソースノードのパス名。 次のいずれかの形式で名前パスを渡すことができます。たとえば、testApp/collections ディレクトリにある `collectionA` ノードのインクルードを返すには、次のようにします。 * バックスラッシュ形式: testApp/collections/collectionA 注: ノード名にバックスラッシュ (「/」) が含まれている場合、この形式は使用できません。 * 置換文字を含むバックエンド名のパス: testApp collections collectionA * アレイ: \['testApp','collections','collectionA'\] データタイプ：文字列 |
[表 : 9. 要求本文のパラメーター]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#editor-GET-includes__entry__18}{#editor-GET-includes__accept-JSON-only-entry-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
[表 : 10. 要求ヘッダー]

{#editor-GET-includes__entry__22}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 11. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#editor-GET-includes__entry__26}{#editor-GET-includes__entry-200-status-code}{#editor-GET-includes__entry-400-status-code}{#editor-GET-includes__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 12. ステータスコード]

### 応答本文のパラメーター

{#editor-GET-includes__id_jpm_rxl_c5b__entry__2}{#editor-GET-includes__conflict-node-editor-entry}{#editor-GET-includes__conflict_type-node-editor-entry}{#editor-GET-includes__description-node-editor-entry}{#editor-GET-includes__effective_from-node-editor-entry}{#editor-GET-includes__effective_to-node-editor-entry}{#editor-GET-includes__level-node-editor-entry}{#editor-GET-includes__linked_to-node-editor-entry}{#editor-GET-includes__main_id-node-editor-entry}{#editor-GET-includes__main_id_encoded-node-editor-entry}{#editor-GET-includes__node_classifier-node-editor-entry}{#editor-GET-includes__previous_version-node-editor-entry}{#editor-GET-includes__restricted_to-node-editor-entry}{#editor-GET-includes__system_folder-node-editor-entry}

| 名前 | 説明 |
|-|-|
| changeset_id | 関連する変更セットの一意の識別子 (「Chset-10」など)。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| 競合 | ノードの処理時に競合があったかどうかを示すフラグ。 可能な値： * true:競合が検出されました。 * false:競合は検出されませんでした。 データタイプ：ブーリアン |
| conflict_type | conflictパラメーターが true の場合、検出された競合のタイプ。競合が検出されない場合は null。 可能な値： * corrupted_node * deleted_node * duplicated_node * incomplete_deleted_parent * incomplete_deleted_ref * incomplete_renamed_ref * invalid_include * orphaned_descendant * related_conflict * unlinked_include * unrenamed_include * updated_node データタイプ：文字列 |
| description | ノードの目的の簡単な説明。 データタイプ：文字列 |
| effective_from | ノードが変更セットの一部としてコミットされたときのタイムスタンプ (長整数に変換されます)。ノードがコミットされていない場合、この値は「null」です。 データタイプ:数値 (整数) |
| effective_to | 削除されたか、別のノードに置き換えられたときのノードのタイムスタンプ (長整数に変換されます)。それ以外の場合は「null」。 データタイプ:数値 (整数) |
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } |
| error.detail | エラーに関する追加情報。 データタイプ：文字列 |
| error.message | 要求の処理中に生成されたエラーメッセージ。 データタイプ：文字列 |
| level | ルートノードから始まるノードのレベル (常に 0)。たとえば、 ノード /AppA/components/compA には 2 つのレベルがあります。 データタイプ：文字列 |
| linked_to | このノードがリンクされている参照先ノードの main_id パラメーター。 このノードが参照ノードにリンクされていない場合、値は「null」です。 データタイプ：文字列 |
| main_id | ノードのプライマリ識別子。この値を CdmQuery() スクリプトインクルードで使用すると、JSON ツリーを取得できます。例: `CdmQuery().mainId('123')/query().getTree();` データタイプ：文字列 |
| main_id_encoded | ノードの main_id パラメータの RADIX 57 文字列表現。 データタイプ：文字列 |
| name | ターゲットパスの下に含まれていたノードの名前。 データタイプ：文字列 |
| node_classifier | ノードの分類子階層。この情報を使用して、フォルダー階層内のノードを見つけます。 たとえば、展開可能項目の階層は /application/deployables/env:Development です コレクションの階層は /applications/collections ですが データタイプ：文字列 |
| node_path | ターゲットパスに含まれていたノードの完全パス名 ( /Production/deployables/Development1/cdi1 など)。 データタイプ：文字列 |
| position | ノード位置。 たとえば、次のアレイをアップロードするとします。 arrayNode1: [ "literal1", {"cdi1": 1}, "literal3" ] 位置の値は次のように設定されます。 * arrayNode1.literal1 = 1000 * arrayNode1.2000 = 2000 * arrayNode1.literal3 = 3000 {#editor-GET-includes__ul_ybk_wg2_25b}複合オブジェクトがアレイ (この場合は `{"cdi1": 1}`) の下にアップロードされた場合、エンドポイントはその位置と同じ名前で新しい仮想ノードを作成します。上記の例では、これは 2000 です。インクルードの場合、位置は常に空です。 データタイプ：文字列 |
| previous_version | ノードレコードの以前のバージョンの詳細。 注: 新しいノードが作成された場合、エンドポイントはこのパラメーターに対して `「previous_version」= null` を返します。 データタイプ: オブジェクト "previous_version": { "link": "String", "value": "String" } |
| restricted_to | 関連付けられたノードにアクセスできるグループの詳細。 データタイプ: オブジェクト "restricted_to": { "link": "String", "value": "String" } |
| secure_value | この値にセキュリティ保護のフラグが付けられている場合は、暗号化フィールド (マスクされた状態で返されます)。 この情報を復号化するには、ユーザーに sn_cdm.cdm_secrets ロールが必要です。returnFieldsクエリパラメーターフィールドを設定することで、これらのフィールドを返さないようにエンドポイントに指示できます。 データタイプ：文字列 |
| status | ノードステータス。 可能な値： * 削除済み * 新規 * 優先 * 更新日時 * 有効 データタイプ：文字列 |
| sys_id | ノードのSys_id。 データタイプ：文字列 テーブル:CDM ノード \[sn_cdm_node\] |
| system_folder | 関連付けられたノードがシステムフォルダーであるかどうかを示すフラグ。 可能な値： * true:ノードはシステムフォルダーです。 * false:ノードはシステムフォルダーではありません。 データタイプ：ブーリアン |
| type | ノードタイプ。 可能な値： * sn_cdm_node_cdi * sn_cdm_node_collection * sn_cdm_node_component * sn_cdm_node_folder * sn_cdm_node_variable データタイプ：文字列 |
| value | ノード値。 データタイプ：文字列 |
[ ]

{#editor-GET-includes__id_jpm_rxl_c5b}  

### cURL 要求

このコード例は、ソースパス /testApp/collections/collA のインクルードを取得する方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/editor/includes?changesetNumber=Chset5&sourceFullNamePath=%2FtestApp%2Fcollections%2FcollA" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

結果を返します:

    { 
      "result": [ 
        { 
          "sys_id": "a1c517a953b70110a1d3ddeeff7b129b", 
          "type": "sn_cdm_node_deployable", 
          "main_id": "6", 
          "main_id_encoded": ",", 
          "node_path": "!$!+!,", 
          "level": 2, 
          "status": "valid", 
          "node_classifier": "/application/deployables/env:Development", 
          "position": null, 
          "restricted_to": null, 
          "changeset_id": "e9c517a953b70110a1d3ddeeff7b1299", 
          "previous_version": null, 
          "effective_from": "1654002206866", 
          "effective_to": null, 
          "name": "Development_1", 
          "description": null, 
          "value": null, 
          "secure_value": null, 
          "system_folder": "0", 
          "linked_to": null, 
          "conflict": "0", 
          "conflict_type": null 
        } 
      ] 
    }

## CdmEditorApi - GET /sn_cdm/editor/nodes {#ariaid-title4}

指定されたノードの詳細、または指定された親ノードの子 構成データ管理 (CDM) ノードのリストを返します。
このエンドポイントの呼び出し元には、CDM ビューアーロールが必要です。

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/editor/nodes

デフォルト URL: /api/sn_cdm/editor/nodes  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#editor-GET-nodes__entry__2}{#editor-GET-nodes__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 13. パスパラメーター]

{#editor-GET-nodes__entry__6}{#editor-GET-nodes__cdm_apps-returnFields-entry}{#editor-GET-nodes__type-node-editor-entry}

| 名前 | 説明 |
|-|-|
| changesetNumber | 関連する変更セットの一意の識別子 (「Chset-10」など)。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| パスワードを解読 | リーフノードの値を暗号化するかどうかを示すフラグ。 有効な値： * true:暗号化 * false:暗号化されていません データタイプ：ブーリアン デフォルト値：false |
| name | ノード名。このパラメーターを渡すと、指定したノードの結果のみが返されます。 データタイプ：文字列 デフォルト:親ノード内のすべてのノード |
| parentFullNamePath | 必須です。子ノードを返す親ノード、または name パラメーターで指定されたノードが存在する親ノードのパス名。 次のいずれかの形式で名前パスを渡すことができます。たとえば、testApp/collections ディレクトリにある `collectionA` ノードのノードを返すには、次のようにします。 * バックスラッシュ形式: testApp/collections/collectionA 注: ノード名にバックスラッシュ (「/」) が含まれている場合、この形式は使用できません。 * 置換文字を含むバックエンド名のパス: testApp collections collectionA * アレイ: \['testApp','collections','collectionA'\] データタイプ：文字列 |
| returnFields | 応答の一部として返されるフィールドのリスト。sys_id、sys_updated_by、ステータスなどのレコード列名を渡します。 データタイプ：アレイ デフォルト:エンドポイントによって決定されたすべてのフィールド |
| type | ノードタイプ。 可能な値： * sn_cdm_node_cdi OR CDI * sn_cdm_node_collection OR コレクション * sn_cdm_node_component OR コンポーネント * sn_cdm_node_folder OR フォルダー * sn_cdm_node_variable OR 変数 データタイプ：文字列 デフォルト:すべて |
[表 : 14. クエリパラメーター]

{#editor-GET-nodes__entry__20}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 15. 要求本文のパラメーター]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#editor-GET-nodes__entry__24}{#editor-GET-nodes__accept-JSON-only-entry-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
[表 : 16. 要求ヘッダー]

{#editor-GET-nodes__entry__28}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 17. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#editor-GET-nodes__entry__32}{#editor-GET-nodes__entry-200-status-code}{#editor-GET-nodes__entry-400-status-code}{#editor-GET-nodes__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 18. ステータスコード]

### 応答本文のパラメーター

{#editor-GET-nodes__id_nwg_5jl_c5b__entry__2}{#editor-GET-nodes__changeset-node-editor-entry}{#editor-GET-nodes__changeset_link-node-editor-entry}{#editor-GET-nodes__changeset_value-node-editor-entry}{#editor-GET-nodes__conflict-node-editor-entry}{#editor-GET-nodes__conflict_type-node-editor-entry}{#editor-GET-nodes__description-node-editor-entry}{#editor-GET-nodes__effective_from-node-editor-entry}{#editor-GET-nodes__effective_to-node-editor-entry}{#editor-GET-nodes__level-node-editor-entry}{#editor-GET-nodes__linked_to-node-editor-entry}{#editor-GET-nodes__main_id-node-editor-entry}{#editor-GET-nodes__main_id_encoded-node-editor-entry}{#editor-GET-nodes__name-node-editor-entry}{#editor-GET-nodes__node_classifier-node-editor-entry}{#editor-GET-nodes__name_path-node-editor-entry}{#editor-GET-nodes__position-node-editor-entry}{#editor-GET-nodes__previous_version-node-editor-entry}{#editor-GET-nodes__previous_version_link-node-editor-entry}{#editor-GET-nodes__previous_version_value-node-editor-entry}{#editor-GET-nodes__restricted_to-node-editor-entry}{#editor-GET-nodes__restricted_to_link-node-editor-entry}{#editor-GET-nodes__restricted_to_value-node-editor-entry}{#editor-GET-nodes__secure_value-node-editor-entry}{#editor-GET-nodes__status-node-editor-entry}{#editor-GET-nodes__system_folder-node-editor-entry}{#editor-GET-nodes__sys_class_name-node-editor-entry}{#editor-GET-nodes__sys_created_by-node-editor-entry}{#editor-GET-nodes__sys_created_on-node-editor-entry}{#editor-GET-nodes__sys_id-node-editor-entry}{#editor-GET-nodes__sys_updated_by-node-editor-entry}{#editor-GET-nodes__sys_updated_on-node-editor-entry}{#editor-GET-nodes__d3018e3608}{#editor-GET-nodes__value-node-editor-entry}

| 名前 | 説明 |
|-|-|
| changeset_id | ノードに関連付けられた変更セットレコードの詳細。 データタイプ: オブジェクト "changeset_id": { "link": "String", "value": "String" } |
| changeset_id.link | Table REST API を使用してこの変更セットレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| changeset_id.value | 変更セットレコードの一意の識別子。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| 競合 | ノードの処理時に競合があったかどうかを示すフラグ。 可能な値： * true:競合が検出されました。 * false:競合は検出されませんでした。 データタイプ：ブーリアン |
| conflict_type | conflictパラメーターが true の場合、検出された競合のタイプ。競合が検出されない場合は null。 可能な値： * corrupted_node * deleted_node * duplicated_node * incomplete_deleted_parent * incomplete_deleted_ref * incomplete_renamed_ref * invalid_include * orphaned_descendant * related_conflict * unlinked_include * unrenamed_include * updated_node データタイプ：文字列 |
| description | ノードの目的の簡単な説明。 データタイプ：文字列 |
| effective_from | ノードが変更セットの一部としてコミットされたときのタイムスタンプ (長整数に変換されます)。ノードがコミットされていない場合、この値は「null」です。 データタイプ:数値 (整数) |
| effective_to | 削除されたか、別のノードに置き換えられたときのノードのタイムスタンプ (長整数に変換されます)。それ以外の場合は「null」。 データタイプ:数値 (整数) |
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } |
| error.detail | エラーに関する追加情報。 データタイプ：文字列 |
| error.message | 要求の処理中に生成されたエラーメッセージ。 データタイプ：文字列 |
| level | ルートノードから始まるノードのレベル (常に 0)。たとえば、 ノード /AppA/components/compA には 2 つのレベルがあります。 データタイプ：文字列 |
| linked_to | このノードがリンクされている参照先ノードの main_id パラメーター。 このノードが参照ノードにリンクされていない場合、値は「null」です。 データタイプ：文字列 |
| main_id | ノードのプライマリ識別子。この値を CdmQuery() スクリプトインクルードで使用すると、JSON ツリーを取得できます。例: `CdmQuery().mainId('123')/query().getTree();` データタイプ：文字列 |
| main_id_encoded | ノードの main_id パラメータの RADIX 57 文字列表現。 データタイプ：文字列 |
| name | ノードの名前。 データタイプ：文字列 |
| node_classifier | ノードの分類子階層。この情報を使用して、フォルダー階層内のノードを見つけます。 たとえば、展開可能項目の階層は /application/deployables/env:Development です コレクションの階層は /applications/collections ですが データタイプ：文字列 |
| node_path | 完全なノードパス名。 データタイプ：文字列 |
| position | ノード位置。 たとえば、次のアレイをアップロードするとします。 arrayNode1: [ "literal1", {"cdi1": 1}, "literal3" ] 位置の値は次のように設定されます。 * arrayNode1.literal1 = 1000 * arrayNode1.2000 = 2000 * arrayNode1.literal3 = 3000 {#editor-GET-nodes__ul_ybk_wg2_25b}複合オブジェクトがアレイ (この場合は `{"cdi1": 1}`) の下にアップロードされた場合、エンドポイントはその位置と同じ名前で新しい仮想ノードを作成します。上記の例では、これは 2000 です。インクルードの場合、位置は常に空です。 データタイプ：文字列 |
| previous_version | ノードレコードの以前のバージョンの詳細。 注: 新しいノードが作成された場合、エンドポイントはこのパラメーターに対して `「previous_version」= null` を返します。 データタイプ: オブジェクト "previous_version": { "link": "String", "value": "String" } |
| previous_version.link | テーブル REST API を使用してこのノードレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| previous_version.value | ノードレコードのSys_id。 データタイプ：文字列 テーブル:CDM ノード \[sn_cdm_node\] |
| reason_for_conflict | 競合の詳細な説明。 データタイプ：文字列 |
| restricted_to | 関連付けられたノードにアクセスできるグループの詳細。 データタイプ: オブジェクト "restricted_to": { "link": "String", "value": "String" } |
| restricted_to.link | Table REST API を使用してこのグループレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| restricted_to.value | グループレコードのSys_id。 データタイプ：文字列 テーブル:CDM グループ \[sys_user_group\] |
| secure_value | この値にセキュリティ保護のフラグが付けられている場合は、暗号化フィールド (マスクされた状態で返されます)。 この情報を復号化するには、ユーザーに sn_cdm.cdm_secrets ロールが必要です。returnFieldsクエリパラメーターフィールドを設定することで、これらのフィールドを返さないようにエンドポイントに指示できます。 データタイプ：文字列 |
| status | ノードステータス。 可能な値： * 削除済み * 新規 * 優先 * 更新日時 * 有効 データタイプ：文字列 |
| system_folder | 関連付けられたノードがシステムフォルダーであるかどうかを示すフラグ。 可能な値： * true:ノードはシステムフォルダーです。 * false:ノードはシステムフォルダーではありません。 データタイプ：ブーリアン |
| sys_class_name | ノードが存在するテーブル。 データタイプ：文字列 |
| sys_created_by | ノードを作成したユーザーの名前。 データタイプ：文字列 |
| sys_created_on | ノードが作成された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| sys_id | ノードのSys_id。 データタイプ：文字列 テーブル:CDM ノード \[sn_cdm_node\] |
| sys_updated_by | ノードを更新したユーザーの名前。 データタイプ：文字列 |
| sys_updated_on | ノードが最後に更新された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| type | ノードタイプ。 可能な値： * sn_cdm_node_cdi * sn_cdm_node_collection * sn_cdm_node_component * sn_cdm_node_folder * sn_cdm_node_variable データタイプ：文字列 デフォルト:すべて |
| value | ノード値。 データタイプ：文字列 |
[ ]

{#editor-GET-nodes__id_nwg_5jl_c5b}  

### cURL 要求

このコード例は、 /testApp/Fdeployables/Development_1 親ノードの下にあるタイプ sn_cdm_node_cdi の子ノードを取得する方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/editor/nodes?decryptPassword=true&name=cdi45&changesetNumber=Chset3&parentFullNamePath=%2FtestApp%2Fdeployables%2FDevelopment_1&type=sn_cdm_node_cdi" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

結果を返します:

    { 
      "result": [ 
        { 
          "changeset_id": { 
            "value": "d403648653b70110a1d3ddeeff7b12c5", 
            "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/d403648653b70110a1d3ddeeff7b12c5" 
          }, 
          "node_path": "!$!+!,![:", 
          "description": null, 
          "sys_updated_on": "2022-06-30 09:24:07", 
          "type": "sn_cdm_node_cdi", 
          "sys_class_name": "sn_cdm_node", 
          "sys_id": "c93c7c1753981110a1d3ddeeff7b12c7", 
          "sys_updated_by": "admin", 
          "previous_version": null, 
          "sys_created_on": "2022-06-30 08:53:13", 
          "value": "cdcdc", 
          "effective_from": null, 
          "linked_to": null, 
          "sys_created_by": "admin", 
          "restricted_to": null, 
          "level": "3", 
          "conflict_type": null, 
          "main_id": "2869", 
          "effective_to": null, 
          "secure_value": null, 
          "node_classifier": "/application/deployables/env:Development", 
          "main_id_encoded": "[:", 
          "name": "cdi45", 
          "position": null, 
          "reason_for_conflict": null, 
          "system_folder": false, 
          "status": "new", 
          "conflict": false 
        } 
      ] 
    }

## CdmEditorApi - POST /sn_cdm/editor/includes {#ariaid-title5}

既存のノードを別のノードに含めます。たとえば、コンポーネントノードをコレクションノードに含めたり、コレクションノードを展開可能ノードに含めたりします。ノードを含めると、新しいノードには独自のsys_idとmain_Idが含まれます。
このエンドポイントの呼び出し元には、CDM エディターロールが必要です。

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/editor/includes

デフォルト URL: /api/sn_cdm/editor/includes  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#editor-POST-includes__entry__2}{#editor-POST-includes__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 19. パスパラメーター]

{#editor-POST-includes__entry__6}{#editor-POST-includes__cdm_apps-returnFields-entry}

| 名前 | 説明 |
|-|-|
| changesetNumber | 必須です。ターゲットノードに含めるオープン変更セットの一意の番号。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| returnFields | 応答の一部として返されるフィールドのリスト。sys_id、sys_updated_by、ステータスなどのレコード列名を渡します。 データタイプ：アレイ デフォルト:エンドポイントによって決定されたすべてのフィールド |
| sourceFullNamePath | 必須です。ターゲットノードに含めるノードのパス名。 次のいずれかの形式で名前パスを渡すことができます。たとえば、 `Staging/deployables/Development1/cdi1` というノードを含めるには、次のようにします。 * バックスラッシュ形式: Staging/deployables/Development1/cdi1 注: ノード名にバックスラッシュ (「/」) が含まれている場合、この形式は使用できません。 * 置換文字を含むバックエンド名のパス: ステージング展開可能項目 Development1 cdi1 * アレイ: \['Staging','deployables','Development1','cdi1'\] データタイプ：文字列 |
| ターゲットフルネームパス | 必須です。ソースノードを含めるノードのパス名。 次のいずれかの形式で名前パスを渡すことができます。たとえば、 `Production/deployables/Development1` というノードを含めるには、次のようにします。 * バックスラッシュ形式: Production/deployables/Development1/cdi1 注: ノード名にバックスラッシュ (「/」) が含まれている場合、この形式は使用できません。 * 置換文字を含むバックエンド名パス: 本番展開可能項目 Development1 cdi1 * アレイ: \['Production','deployables','Development1','cdi1'\] {#editor-POST-includes__ul_wk2_k21_cyb} データタイプ：文字列 |
[表 : 20. クエリパラメーター]

{#editor-POST-includes__entry__16}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 21. 要求本文のパラメーター]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#editor-POST-includes__entry__20}{#editor-POST-includes__accept-JSON-only-entry-RESTAPI}{#editor-POST-includes__content_type-JSON-only-entry-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 22. 要求ヘッダー]

{#editor-POST-includes__entry__26}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 23. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#editor-POST-includes__entry__30}{#editor-POST-includes__entry-200-status-code}{#editor-POST-includes__entry-400-status-code}{#editor-POST-includes__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 24. ステータスコード]

### 応答本文のパラメーター

{#editor-POST-includes__id_cvv_pxl_c5b__entry__2}{#editor-POST-includes__conflict-node-editor-entry}{#editor-POST-includes__conflict_type-node-editor-entry}{#editor-POST-includes__description-node-editor-entry}{#editor-POST-includes__effective_from-node-editor-entry}{#editor-POST-includes__effective_to-node-editor-entry}{#editor-POST-includes__level-node-editor-entry}{#editor-POST-includes__linked_to-node-editor-entry}{#editor-POST-includes__main_id-node-editor-entry}{#editor-POST-includes__main_id_encoded-node-editor-entry}{#editor-POST-includes__node_classifier-node-editor-entry}{#editor-POST-includes__previous_version-node-editor-entry}{#editor-POST-includes__restricted_to-node-editor-entry}{#editor-POST-includes__system_folder-node-editor-entry}

| 名前 | 説明 |
|-|-|
| changeset_id | 関連する変更セットの一意の識別子 (「Chset-10」など)。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| 競合 | ノードの処理時に競合があったかどうかを示すフラグ。 可能な値： * true:競合が検出されました。 * false:競合は検出されませんでした。 データタイプ：ブーリアン |
| conflict_type | conflictパラメーターが true の場合、検出された競合のタイプ。競合が検出されない場合は null。 可能な値： * corrupted_node * deleted_node * duplicated_node * incomplete_deleted_parent * incomplete_deleted_ref * incomplete_renamed_ref * invalid_include * orphaned_descendant * related_conflict * unlinked_include * unrenamed_include * updated_node データタイプ：文字列 |
| description | ノードの目的の簡単な説明。 データタイプ：文字列 |
| effective_from | ノードが変更セットの一部としてコミットされたときのタイムスタンプ (長整数に変換されます)。ノードがコミットされていない場合、この値は「null」です。 データタイプ:数値 (整数) |
| effective_to | 削除されたか、別のノードに置き換えられたときのノードのタイムスタンプ (長整数に変換されます)。それ以外の場合は「null」。 データタイプ:数値 (整数) |
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } |
| error.detail | エラーに関する追加情報。 データタイプ：文字列 |
| error.message | 要求の処理中に生成されたエラーメッセージ。 データタイプ：文字列 |
| level | ルートノードから始まるノードのレベル (常に 0)。たとえば、 ノード /AppA/components/compA には 2 つのレベルがあります。 データタイプ：文字列 |
| linked_to | このノードがリンクされている参照先ノードの main_id パラメーター。 このノードが参照ノードにリンクされていない場合、値は「null」です。 データタイプ：文字列 |
| main_id | ノードのプライマリ識別子。この値を CdmQuery() スクリプトインクルードで使用すると、JSON ツリーを取得できます。例: `CdmQuery().mainId('123')/query().getTree();` データタイプ：文字列 |
| main_id_encoded | ノードの main_id パラメータの RADIX 57 文字列表現。 データタイプ：文字列 |
| name | ターゲットパスの下に含まれていたノードの名前。 データタイプ：文字列 |
| node_classifier | ノードの分類子階層。この情報を使用して、フォルダー階層内のノードを見つけます。 たとえば、展開可能項目の階層は /application/deployables/env:Development です コレクションの階層は /applications/collections ですが データタイプ：文字列 |
| node_path | ターゲットパスに含まれていたノードの完全パス名 ( /Production/deployables/Development1/cdi1 など)。 データタイプ：文字列 |
| position | ノード位置。 たとえば、次のアレイをアップロードするとします。 arrayNode1: [ "literal1", {"cdi1": 1}, "literal3" ] 位置の値は次のように設定されます。 * arrayNode1.literal1 = 1000 * arrayNode1.2000 = 2000 * arrayNode1.literal3 = 3000 {#editor-POST-includes__ul_ybk_wg2_25b}複合オブジェクトがアレイ (この場合は `{"cdi1": 1}`) の下にアップロードされた場合、エンドポイントはその位置と同じ名前で新しい仮想ノードを作成します。上記の例では、これは 2000 です。インクルードの場合、位置は常に空です。 データタイプ：文字列 |
| previous_version | ノードレコードの以前のバージョンの詳細。 注: 新しいノードが作成された場合、エンドポイントはこのパラメーターに対して `「previous_version」= null` を返します。 データタイプ: オブジェクト "previous_version": { "link": "String", "value": "String" } |
| restricted_to | 関連付けられたノードにアクセスできるグループの詳細。 データタイプ: オブジェクト "restricted_to": { "link": "String", "value": "String" } |
| secure_value | この値にセキュリティ保護のフラグが付けられている場合は、暗号化フィールド (マスクされた状態で返されます)。 この情報を復号化するには、ユーザーに sn_cdm.cdm_secrets ロールが必要です。returnFieldsクエリパラメーターフィールドを設定することで、これらのフィールドを返さないようにエンドポイントに指示できます。 データタイプ：文字列 |
| status | ノードステータス。 可能な値： * 削除済み * 新規 * 優先 * 更新日時 * 有効 データタイプ：文字列 |
| sys_id | ノードのSys_id。 データタイプ：文字列 テーブル:CDM ノード \[sn_cdm_node\] |
| system_folder | 関連付けられたノードがシステムフォルダーであるかどうかを示すフラグ。 可能な値： * true:ノードはシステムフォルダーです。 * false:ノードはシステムフォルダーではありません。 データタイプ：ブーリアン |
| type | ノードタイプ。 可能な値： * sn_cdm_node_cdi * sn_cdm_node_collection * sn_cdm_node_component * sn_cdm_node_folder * sn_cdm_node_variable データタイプ：文字列 |
| value | ノード値。 データタイプ：文字列 |
[ ]

{#editor-POST-includes__id_cvv_pxl_c5b}  

### cURL 要求

次のコード例は、/testApp/deploymentables/Development_1 の下にノード /testApp/collections/collA を含める方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/editor/includes?changesetNumber=Chset5&targetFullNamePath=%2FtestApp%2Fdeployables%2FDevelopment_1&sourceFullNamePath=%2FtestApp%2Fcollecti
    ons%2FcollA" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'

結果を返します:

    { 
      "result": { 
        "changeset_id": { 
          "value": "d403648653b70110a1d3ddeeff7b12c5", 
          "link": "http://192.168.0.233:8080/api/now/table/sn_cdm_changeset/d403648653b70110a1d3ddeeff7b12c5" 
        }, 
        "node_path": "!$!+!,![?", 
        "description": null, 
        "sys_updated_on": "2022-06-30 09:19:47", 
        "type": "sn_cdm_node_linked", 
        "sys_class_name": "sn_cdm_node", 
        "sys_id": "1642015b53981110a1d3ddeeff7b1232", 
        "sys_updated_by": "admin", 
        "previous_version": null, 
        "sys_created_on": "2022-06-30 09:19:47", 
        "value": null, 
        "effective_from": null, 
        "linked_to": "2870", 
        "sys_created_by": "admin", 
        "restricted_to": null, 
        "level": "3", 
        "conflict_type": null, 
        "main_id": "2872", 
        "effective_to": null, 
        "secure_value": null, 
        "node_classifier": "/application/deployables/env:Development", 
        "main_id_encoded": "[?", 
        "name": "collA", 
        "position": null, 
        "reason_for_conflict": null, 
        "system_folder": false, 
        "status": "new", 
        "conflict": false 
      } 
    }

## CdmEditorApi - POST /sn_cdm/editor/nodes {#ariaid-title6}

コンポーネント、コレクション、フォルダー、構成データアイテム (CDI)、変数など、特定のタイプのノードを作成します。
現在定義されていない親ノードを自動的に生成するかどうかを指定することもできます。

このエンドポイントの呼び出し元には、CDM エディターロールまたは CDM シークレットロールのいずれかが必要です。

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/editor/nodes

デフォルト URL: /api/sn_cdm/editor/nodes  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#editor-POST-nodes__entry__2}{#editor-POST-nodes__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 25. パスパラメーター]

{#editor-POST-nodes__entry__6}{#editor-POST-nodes__changesetNumber-changeset-entry}{#editor-POST-nodes__fullNamePath-node-editor-entry}{#editor-POST-nodes__cdm_apps-returnFields-entry}{#editor-POST-nodes__secure-node-editor-entry}

| 名前 | 説明 |
|-|-|
| autoCreateParents | 名前パスに存在しない親をコンポーネントとして自動的に作成するかどうかを示すフラグ。例外は、アプリ、展開可能項目、コレクションです。このフラグを設定せず、親がまだ存在しない場合、エンドポイントは失敗します。 有効な値： * true:存在しない親を自動的に作成します。 * false:存在しない親を自動的に作成しません。 データタイプ：ブーリアン デフォルト値：false |
| changesetNumber | 必須です。 関連する変更セットの一意の識別子 (「Chset-10」など)。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| fullNamePath | 必須です。ノードのパス名。 次のいずれかの形式で名前パスを渡すことができます。たとえば、 `ノード testApp/deployables/Development1/cdi1` の名前パスを定義するには、次のようにします。 * バックスラッシュ形式: testApp/deployables/Development1/cdi1 注: ノード名にバックスラッシュ ("/") が含まれている場合、この形式は使用できません。 * 置換文字を含むバックエンド名のパス: testApp deployables Development1 cdi1 * アレイ: \['testApp','deployables','Development1','cdi1'\] {#editor-POST-nodes__cdm_apps-namePath-ul} データタイプ：文字列 |
| returnFields | 応答の一部として返されるフィールドのリスト。sys_id、sys_updated_by、ステータスなどのレコード列名を渡します。 データタイプ：アレイ デフォルト:エンドポイントによって決定されたすべてのフィールド |
| セキュア | リーフノードの値を暗号化するかどうかを示すフラグ。 有効な値： * true:暗号化 * false:暗号化されていません データタイプ：ブーリアン デフォルト値：false |
| type | 必須です。新しいノードのタイプ。 有効な値： * sn_cdm_node_collection OR コレクション * sn_cdm_node_component OR コンポーネント * sn_cdm_node_folder OR フォルダー * sn_cdm_node_cdi OR CDI * sn_cdm_node_variableまたは変数 データタイプ：文字列 |
| value | 新しいノードの値。 データタイプ：文字列 デフォルト:「null」に相当 |
[表 : 26. クエリパラメーター]

{#editor-POST-nodes__entry__22}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 27. 要求本文のパラメーター]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#editor-POST-nodes__entry__26}{#editor-POST-nodes__accept-JSON-only-entry-RESTAPI}{#editor-POST-nodes__content_type-JSON-only-entry-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 28. 要求ヘッダー]

{#editor-POST-nodes__entry__32}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 29. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#editor-POST-nodes__entry__36}{#editor-POST-nodes__entry-200-status-code}{#editor-POST-nodes__entry-400-status-code}{#editor-POST-nodes__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 30. ステータスコード]

### 応答本文のパラメーター

{#editor-POST-nodes__id_nwg_5jl_c5b__entry__2}{#editor-POST-nodes__changeset-node-editor-entry}{#editor-POST-nodes__changeset_link-node-editor-entry}{#editor-POST-nodes__changeset_value-node-editor-entry}{#editor-POST-nodes__conflict-node-editor-entry}{#editor-POST-nodes__conflict_type-node-editor-entry}{#editor-POST-nodes__description-node-editor-entry}{#editor-POST-nodes__effective_from-node-editor-entry}{#editor-POST-nodes__effective_to-node-editor-entry}{#editor-POST-nodes__level-node-editor-entry}{#editor-POST-nodes__linked_to-node-editor-entry}{#editor-POST-nodes__main_id-node-editor-entry}{#editor-POST-nodes__main_id_encoded-node-editor-entry}{#editor-POST-nodes__name-node-editor-entry}{#editor-POST-nodes__node_classifier-node-editor-entry}{#editor-POST-nodes__name_path-node-editor-entry}{#editor-POST-nodes__position-node-editor-entry}{#editor-POST-nodes__previous_version-node-editor-entry}{#editor-POST-nodes__previous_version_link-node-editor-entry}{#editor-POST-nodes__previous_version_value-node-editor-entry}{#editor-POST-nodes__restricted_to-node-editor-entry}{#editor-POST-nodes__restricted_to_link-node-editor-entry}{#editor-POST-nodes__restricted_to_value-node-editor-entry}{#editor-POST-nodes__secure_value-node-editor-entry}{#editor-POST-nodes__status-node-editor-entry}{#editor-POST-nodes__system_folder-node-editor-entry}{#editor-POST-nodes__sys_class_name-node-editor-entry}{#editor-POST-nodes__sys_created_by-node-editor-entry}{#editor-POST-nodes__sys_created_on-node-editor-entry}{#editor-POST-nodes__sys_id-node-editor-entry}{#editor-POST-nodes__sys_updated_by-node-editor-entry}{#editor-POST-nodes__sys_updated_on-node-editor-entry}{#editor-POST-nodes__type-node-editor-entry}{#editor-POST-nodes__value-node-editor-entry}

| 名前 | 説明 |
|-|-|
| changeset_id | ノードに関連付けられた変更セットレコードの詳細。 データタイプ: オブジェクト "changeset_id": { "link": "String", "value": "String" } |
| changeset_id.link | Table REST API を使用してこの変更セットレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| changeset_id.value | 変更セットレコードの一意の識別子。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| 競合 | ノードの処理時に競合があったかどうかを示すフラグ。 可能な値： * true:競合が検出されました。 * false:競合は検出されませんでした。 データタイプ：ブーリアン |
| conflict_type | conflictパラメーターが true の場合、検出された競合のタイプ。競合が検出されない場合は null。 可能な値： * corrupted_node * deleted_node * duplicated_node * incomplete_deleted_parent * incomplete_deleted_ref * incomplete_renamed_ref * invalid_include * orphaned_descendant * related_conflict * unlinked_include * unrenamed_include * updated_node データタイプ：文字列 |
| description | ノードの目的の簡単な説明。 データタイプ：文字列 |
| effective_from | ノードが変更セットの一部としてコミットされたときのタイムスタンプ (長整数に変換されます)。ノードがコミットされていない場合、この値は「null」です。 データタイプ:数値 (整数) |
| effective_to | 削除されたか、別のノードに置き換えられたときのノードのタイムスタンプ (長整数に変換されます)。それ以外の場合は「null」。 データタイプ:数値 (整数) |
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } |
| error.detail | エラーに関する追加情報。 データタイプ：文字列 |
| error.message | 要求の処理中に生成されたエラーメッセージ。 データタイプ：文字列 |
| level | ルートノードから始まるノードのレベル (常に 0)。たとえば、 ノード /AppA/components/compA には 2 つのレベルがあります。 データタイプ：文字列 |
| linked_to | このノードがリンクされている参照先ノードの main_id パラメーター。 このノードが参照ノードにリンクされていない場合、値は「null」です。 データタイプ：文字列 |
| main_id | ノードのプライマリ識別子。この値を CdmQuery() スクリプトインクルードで使用すると、JSON ツリーを取得できます。例: `CdmQuery().mainId('123')/query().getTree();` データタイプ：文字列 |
| main_id_encoded | ノードの main_id パラメータの RADIX 57 文字列表現。 データタイプ：文字列 |
| name | ノードの名前。 データタイプ：文字列 |
| node_classifier | ノードの分類子階層。この情報を使用して、フォルダー階層内のノードを見つけます。 たとえば、展開可能項目の階層は /application/deployables/env:Development です コレクションの階層は /applications/collections ですが データタイプ：文字列 |
| node_path | 完全なノードパス名。 データタイプ：文字列 |
| position | ノード位置。 たとえば、次のアレイをアップロードするとします。 arrayNode1: [ "literal1", {"cdi1": 1}, "literal3" ] 位置の値は次のように設定されます。 * arrayNode1.literal1 = 1000 * arrayNode1.2000 = 2000 * arrayNode1.literal3 = 3000 {#editor-POST-nodes__ul_ybk_wg2_25b}複合オブジェクトがアレイ (この場合は `{"cdi1": 1}`) の下にアップロードされた場合、エンドポイントはその位置と同じ名前で新しい仮想ノードを作成します。上記の例では、これは 2000 です。インクルードの場合、位置は常に空です。 データタイプ：文字列 |
| previous_version | ノードレコードの以前のバージョンの詳細。 注: 新しいノードが作成された場合、エンドポイントはこのパラメーターに対して `「previous_version」= null` を返します。 データタイプ: オブジェクト "previous_version": { "link": "String", "value": "String" } |
| previous_version.link | テーブル REST API を使用してこのノードレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| previous_version.value | ノードレコードのSys_id。 データタイプ：文字列 テーブル:CDM ノード \[sn_cdm_node\] |
| reason_for_conflict | 競合の詳細な説明。 データタイプ：文字列 |
| restricted_to | 関連付けられたノードにアクセスできるグループの詳細。 データタイプ: オブジェクト "restricted_to": { "link": "String", "value": "String" } |
| restricted_to.link | Table REST API を使用してこのグループレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| restricted_to.value | グループレコードのSys_id。 データタイプ：文字列 テーブル:CDM グループ \[sys_user_group\] |
| secure_value | この値にセキュリティ保護のフラグが付けられている場合は、暗号化フィールド (マスクされた状態で返されます)。 この情報を復号化するには、ユーザーに sn_cdm.cdm_secrets ロールが必要です。returnFieldsクエリパラメーターフィールドを設定することで、これらのフィールドを返さないようにエンドポイントに指示できます。 データタイプ：文字列 |
| status | ノードステータス。 可能な値： * 削除済み * 新規 * 優先 * 更新日時 * 有効 データタイプ：文字列 |
| system_folder | 関連付けられたノードがシステムフォルダーであるかどうかを示すフラグ。 可能な値： * true:ノードはシステムフォルダーです。 * false:ノードはシステムフォルダーではありません。 データタイプ：ブーリアン |
| sys_class_name | ノードが存在するテーブル。 データタイプ：文字列 |
| sys_created_by | ノードを作成したユーザーの名前。 データタイプ：文字列 |
| sys_created_on | ノードが作成された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| sys_id | ノードのSys_id。 データタイプ：文字列 テーブル:CDM ノード \[sn_cdm_node\] |
| sys_updated_by | ノードを更新したユーザーの名前。 データタイプ：文字列 |
| sys_updated_on | ノードが最後に更新された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| type | ノードタイプ。 可能な値： * sn_cdm_node_cdi * sn_cdm_node_collection * sn_cdm_node_component * sn_cdm_node_folder * sn_cdm_node_variable データタイプ：文字列 デフォルト:すべて |
| value | ノード値。 データタイプ：文字列 |
[ ]

{#editor-POST-nodes__id_nwg_5jl_c5b}  

### cURL 要求

次のコード例は、このエンドポイントを使用してノードを作成する方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/editor/nodes?fullNamePath=%2FtestApp%2Fdeployables%2FDevelopment1%2Fcdi1&secure=true&value=someVal&type=cdi&changesetNumber=Chset-760" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'

結果を返します:

    { 
      "result": { 
        "changeset_id": { 
          "value": "d403648653b70110a1d3ddeeff7b12c5", 
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/d403648653b70110a1d3ddeeff7b12c5" 
        }, 
        "node_path": "!$!+!,![:", 
        "description": null, 
        "sys_updated_on": "2022-06-30 08:53:13", 
        "type": "sn_cdm_node_cdi", 
        "sys_class_name": "sn_cdm_node", 
        "sys_id": "c93c7c1753981110a1d3ddeeff7b12c7", 
        "sys_updated_by": "admin", 
        "previous_version": null, 
        "sys_created_on": "2022-06-30 08:53:13", 
        "value": null, 
        "effective_from": null, 
        "linked_to": null, 
        "sys_created_by": "admin", 
        "restricted_to": null, 
        "level": "3", 
        "conflict_type": null, 
        "main_id": "2869", 
        "effective_to": null, 
        "secure_value": "﷞﷟﷒113a0c6e53001110a1d3ddeeff7b121d﷬﷔1﷬﷭bAUA1wj-fxofbSrMyF-BAg==6qiho5f_9DhnuHT2Km5SLf0Ck4XNX_w=﷮﷯", 
        "node_classifier": "/application/deployables/env:Development", 
        "main_id_encoded": "[:", 
        "name": "cdi45", 
        "position": null, 
        "reason_for_conflict": null, 
        "system_folder": false, 
        "status": "new", 
        "conflict": false 
      } 
    }

## CdmEditorApi - PUT /sn_cdm/editor/nodes {#ariaid-title7}

指定されたノードの名前や値を更新します。
このエンドポイントの呼び出し元には、CDM エディターロールまたは CDM シークレットロールのいずれかが必要です。

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/editor/nodes

デフォルト URL: /api/sn_cdm/editor/nodes  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#editor-PUT-nodes__entry__2}{#editor-PUT-nodes__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 31. パスパラメーター]

{#editor-PUT-nodes__entry__6}{#editor-PUT-nodes__changesetNumber-changeset-entry}{#editor-PUT-nodes__fullNamePath-node-editor-entry}{#editor-PUT-nodes__secure-node-editor-entry}{#editor-PUT-nodes__cdm_apps-returnFields-entry}

| 名前 | 説明 |
|-|-|
| changesetNumber | 必須です。 関連する変更セットの一意の識別子 (「Chset-10」など)。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| fullNamePath | 必須です。ノードのパス名。 次のいずれかの形式で名前パスを渡すことができます。たとえば、 `ノード testApp/deployables/Development1/cdi1` の名前パスを定義するには、次のようにします。 * バックスラッシュ形式: testApp/deployables/Development1/cdi1 注: ノード名にバックスラッシュ ("/") が含まれている場合、この形式は使用できません。 * 置換文字を含むバックエンド名のパス: testApp deployables Development1 cdi1 * アレイ: \['testApp','deployables','Development1','cdi1'\] {#editor-PUT-nodes__cdm_apps-namePath-ul} データタイプ：文字列 |
| newName | 関連付けられたノードの新しい名前。 データタイプ：文字列 |
| newValue | 関連付けられたノードの新しい値。 データタイプ：文字列 |
| セキュア | リーフノードの値を暗号化するかどうかを示すフラグ。 有効な値： * true:暗号化 * false:暗号化されていません データタイプ：ブーリアン デフォルト値：false |
| returnFields | 応答の一部として返されるフィールドのリスト。sys_id、sys_updated_by、ステータスなどのレコード列名を渡します。 データタイプ：アレイ デフォルト:エンドポイントによって決定されたすべてのフィールド |
[表 : 32. クエリパラメーター]

{#editor-PUT-nodes__entry__20}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 33. 要求本文のパラメーター]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#editor-PUT-nodes__entry__24}{#editor-PUT-nodes__accept-JSON-only-entry-RESTAPI}{#editor-PUT-nodes__content_type-JSON-only-entry-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 34. 要求ヘッダー]

{#editor-PUT-nodes__entry__30}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 35. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#editor-PUT-nodes__entry__34}{#editor-PUT-nodes__entry-200-status-code}{#editor-PUT-nodes__entry-400-status-code}{#editor-PUT-nodes__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 36. ステータスコード]

### 応答本文のパラメーター

{#editor-PUT-nodes__id_nwg_5jl_c5b__entry__2}{#editor-PUT-nodes__changeset-node-editor-entry}{#editor-PUT-nodes__changeset_link-node-editor-entry}{#editor-PUT-nodes__changeset_value-node-editor-entry}{#editor-PUT-nodes__conflict-node-editor-entry}{#editor-PUT-nodes__conflict_type-node-editor-entry}{#editor-PUT-nodes__description-node-editor-entry}{#editor-PUT-nodes__effective_from-node-editor-entry}{#editor-PUT-nodes__effective_to-node-editor-entry}{#editor-PUT-nodes__level-node-editor-entry}{#editor-PUT-nodes__linked_to-node-editor-entry}{#editor-PUT-nodes__main_id-node-editor-entry}{#editor-PUT-nodes__main_id_encoded-node-editor-entry}{#editor-PUT-nodes__name-node-editor-entry}{#editor-PUT-nodes__node_classifier-node-editor-entry}{#editor-PUT-nodes__name_path-node-editor-entry}{#editor-PUT-nodes__position-node-editor-entry}{#editor-PUT-nodes__previous_version-node-editor-entry}{#editor-PUT-nodes__previous_version_link-node-editor-entry}{#editor-PUT-nodes__previous_version_value-node-editor-entry}{#editor-PUT-nodes__restricted_to-node-editor-entry}{#editor-PUT-nodes__restricted_to_link-node-editor-entry}{#editor-PUT-nodes__restricted_to_value-node-editor-entry}{#editor-PUT-nodes__secure_value-node-editor-entry}{#editor-PUT-nodes__status-node-editor-entry}{#editor-PUT-nodes__system_folder-node-editor-entry}{#editor-PUT-nodes__sys_class_name-node-editor-entry}{#editor-PUT-nodes__sys_created_by-node-editor-entry}{#editor-PUT-nodes__sys_created_on-node-editor-entry}{#editor-PUT-nodes__sys_id-node-editor-entry}{#editor-PUT-nodes__sys_updated_by-node-editor-entry}{#editor-PUT-nodes__sys_updated_on-node-editor-entry}{#editor-PUT-nodes__type-node-editor-entry}{#editor-PUT-nodes__value-node-editor-entry}

| 名前 | 説明 |
|-|-|
| changeset_id | ノードに関連付けられた変更セットレコードの詳細。 データタイプ: オブジェクト "changeset_id": { "link": "String", "value": "String" } |
| changeset_id.link | Table REST API を使用してこの変更セットレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| changeset_id.value | 変更セットレコードの一意の識別子。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| 競合 | ノードの処理時に競合があったかどうかを示すフラグ。 可能な値： * true:競合が検出されました。 * false:競合は検出されませんでした。 データタイプ：ブーリアン |
| conflict_type | conflictパラメーターが true の場合、検出された競合のタイプ。競合が検出されない場合は null。 可能な値： * corrupted_node * deleted_node * duplicated_node * incomplete_deleted_parent * incomplete_deleted_ref * incomplete_renamed_ref * invalid_include * orphaned_descendant * related_conflict * unlinked_include * unrenamed_include * updated_node データタイプ：文字列 |
| description | ノードの目的の簡単な説明。 データタイプ：文字列 |
| effective_from | ノードが変更セットの一部としてコミットされたときのタイムスタンプ (長整数に変換されます)。ノードがコミットされていない場合、この値は「null」です。 データタイプ:数値 (整数) |
| effective_to | 削除されたか、別のノードに置き換えられたときのノードのタイムスタンプ (長整数に変換されます)。それ以外の場合は「null」。 データタイプ:数値 (整数) |
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } |
| error.detail | エラーに関する追加情報。 データタイプ：文字列 |
| error.message | 要求の処理中に生成されたエラーメッセージ。 データタイプ：文字列 |
| level | ルートノードから始まるノードのレベル (常に 0)。たとえば、 ノード /AppA/components/compA には 2 つのレベルがあります。 データタイプ：文字列 |
| linked_to | このノードがリンクされている参照先ノードの main_id パラメーター。 このノードが参照ノードにリンクされていない場合、値は「null」です。 データタイプ：文字列 |
| main_id | ノードのプライマリ識別子。この値を CdmQuery() スクリプトインクルードで使用すると、JSON ツリーを取得できます。例: `CdmQuery().mainId('123')/query().getTree();` データタイプ：文字列 |
| main_id_encoded | ノードの main_id パラメータの RADIX 57 文字列表現。 データタイプ：文字列 |
| name | ノードの名前。 データタイプ：文字列 |
| node_classifier | ノードの分類子階層。この情報を使用して、フォルダー階層内のノードを見つけます。 たとえば、展開可能項目の階層は /application/deployables/env:Development です コレクションの階層は /applications/collections ですが データタイプ：文字列 |
| node_path | 完全なノードパス名。 データタイプ：文字列 |
| position | ノード位置。 たとえば、次のアレイをアップロードするとします。 arrayNode1: [ "literal1", {"cdi1": 1}, "literal3" ] 位置の値は次のように設定されます。 * arrayNode1.literal1 = 1000 * arrayNode1.2000 = 2000 * arrayNode1.literal3 = 3000 {#editor-PUT-nodes__ul_ybk_wg2_25b}複合オブジェクトがアレイ (この場合は `{"cdi1": 1}`) の下にアップロードされた場合、エンドポイントはその位置と同じ名前で新しい仮想ノードを作成します。上記の例では、これは 2000 です。インクルードの場合、位置は常に空です。 データタイプ：文字列 |
| previous_version | ノードレコードの以前のバージョンの詳細。 注: 新しいノードが作成された場合、エンドポイントはこのパラメーターに対して `「previous_version」= null` を返します。 データタイプ: オブジェクト "previous_version": { "link": "String", "value": "String" } |
| previous_version.link | テーブル REST API を使用してこのノードレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| previous_version.value | ノードレコードのSys_id。 データタイプ：文字列 テーブル:CDM ノード \[sn_cdm_node\] |
| reason_for_conflict | 競合の詳細な説明。 データタイプ：文字列 |
| restricted_to | 関連付けられたノードにアクセスできるグループの詳細。 データタイプ: オブジェクト "restricted_to": { "link": "String", "value": "String" } |
| restricted_to.link | Table REST API を使用してこのグループレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| restricted_to.value | グループレコードのSys_id。 データタイプ：文字列 テーブル:CDM グループ \[sys_user_group\] |
| secure_value | この値にセキュリティ保護のフラグが付けられている場合は、暗号化フィールド (マスクされた状態で返されます)。 この情報を復号化するには、ユーザーに sn_cdm.cdm_secrets ロールが必要です。returnFieldsクエリパラメーターフィールドを設定することで、これらのフィールドを返さないようにエンドポイントに指示できます。 データタイプ：文字列 |
| status | ノードステータス。 可能な値： * 削除済み * 新規 * 優先 * 更新日時 * 有効 データタイプ：文字列 |
| system_folder | 関連付けられたノードがシステムフォルダーであるかどうかを示すフラグ。 可能な値： * true:ノードはシステムフォルダーです。 * false:ノードはシステムフォルダーではありません。 データタイプ：ブーリアン |
| sys_class_name | ノードが存在するテーブル。 データタイプ：文字列 |
| sys_created_by | ノードを作成したユーザーの名前。 データタイプ：文字列 |
| sys_created_on | ノードが作成された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| sys_id | ノードのSys_id。 データタイプ：文字列 テーブル:CDM ノード \[sn_cdm_node\] |
| sys_updated_by | ノードを更新したユーザーの名前。 データタイプ：文字列 |
| sys_updated_on | ノードが最後に更新された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| type | ノードタイプ。 可能な値： * sn_cdm_node_cdi * sn_cdm_node_collection * sn_cdm_node_component * sn_cdm_node_folder * sn_cdm_node_variable データタイプ：文字列 デフォルト:すべて |
| value | ノード値。 データタイプ：文字列 |
[ ]

{#editor-PUT-nodes__id_nwg_5jl_c5b}  

### cURL 要求

次のコード例は、ノードの値を更新する方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/editor/nodes?newValue=cdcdc&fullNamePath=%2FtestApp%2Fdeployables%2FDe
    velopment-1%2Fcdi45&changesetNumber=Chset-5" \
    --request PUT \
    --header "Accept:application/json" \
    --user 'username':'password'

結果を返します:

    { 
      "result": { 
        "changeset_id": { 
          "value": "d403648653b70110a1d3ddeeff7b12c5", 
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/d403648653b70110a1d3ddeeff7b12c5" 
        }, 
        "node_path": "!$!+!,![:", 
        "description": null, 
        "sys_updated_on": "2022-06-30 08:53:13", 
        "type": "sn_cdm_node_cdi", 
        "sys_class_name": "sn_cdm_node", 
        "sys_id": "c93c7c1753981110a1d3ddeeff7b12c7", 
        "sys_updated_by": "admin", 
        "previous_version": null, 
        "sys_created_on": "2022-06-30 08:53:13", 
        "value": null, 
        "effective_from": null, 
        "linked_to": null, 
        "sys_created_by": "admin", 
        "restricted_to": null, 
        "level": "3", 
        "conflict_type": null, 
        "main_id": "2869", 
        "effective_to": null, 
        "secure_value": "﷞﷟﷒113a0c6e53001110a1d3ddeeff7b121d﷬﷔1﷬﷭bAUA1wj-fxofbSrMyF-BAg==6qiho5f_9DhnuHT2Km5SLf0Ck4XNX_w=﷮﷯", 
        "node_classifier": "/application/deployables/env:Development", 
        "main_id_encoded": "[:", 
        "name": "cdi45", 
        "position": null, 
        "reason_for_conflict": null, 
        "system_folder": false, 
        "status": "new", 
        "conflict": false 
      } 
    }


