--- 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 --- # SegmentHandle API :スコープ対象 # SegmentHandle API :スコープ対象 {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：7分 ヘッダーやアイテムなどのセグメントの単一インスタンスを処理するためのメソッド。このクラスは、SegmentHandler スクリプトインクルードで定義されています。 [SegmentHandler](https://servicenow-prod.fluidtopics.net/WazVzw85yEF~32TE_e4mkQ#SegmentHandlerAPIScoped "特定の操作の IDoc ペイロードをビルドするためのチェーン可能な API を提供するスクリプトインクルード。") スクリプトインクルードには ERP 向けゼロコピーコネクタ (com.sn_erp_integration) ストアアプリケーションが必要であり、sn_erp_integration 名前空間内で提供されます。詳細については、「[Zero Copy Connector for ERP](https://www.servicenow.com/docs/access?context=erp-integration-overview&version=australia&pubname=australia-integrate-applications&ft:locale=en-US)」を参照してください。 必要なロール：sn_erp_integration.erp_user このクラスのメソッドは、次のタスクに使用します。 * その特定のセグメントインスタンスにフィールドを追加します。 * インスタンスの下にネストされたセグメント/子セグメントを追加します。 * `endSegment()` または `root()` メソッドを使用して親またはルートにチェーンバックします。 {#SegmentHandleAPIScoped__ul_plx_wjk_c3c} ## SegmentHandle - addField(String fieldName, String value) {#ariaid-title2} 現在のセグメントインスタンスの事前定義されたフィールドをペイロードに追加します。 {#SegmentHandle-addField_S_S__table_qkt_53x_3hc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | セグメントに追加するフィールドの名前。 | | value | 文字列 | セグメントに追加するフィールドの値。 | [表 : 1. パラメーター] {#SegmentHandle-addField_S_S__table_qkt_53x_3hc} {#SegmentHandle-addField_S_S__table_rkt_53x_3hc__entry__2} | タイプ | 説明 | |-|-| | オブジェクト | チェーン用の現在の SegmentHandle オブジェクト。 | [表 : 2. 返される内容] {#SegmentHandle-addField_S_S__table_rkt_53x_3hc} 次の例は、セグメントペイロードを作成する方法を示しています。特定のセグメントへの参照を保持する場合は、明示的な変数を使用します。 * 複数の obj.addSegment("E1EDK01") 呼び出しは、複数のヘッダーセグメントを生成します。 * ネストされたセグメントは、正しい親ハンドル (p01、p20 など) から作成されます。 * k01_1、k01_2、p01 などのハンドルは、後で再利用してフィールドや子を追加できます。 {#SegmentHandle-addField_S_S__ul_y5z_y4m_c3c} var obj = new SegmentHandler('460d3ff2ff5de210d3a2fffffffffff8'); // Create first E1EDK01 let k01_1 = obj.addSegment("E1EDK01") .addField("BELNR", "1000") .addField("CURCY", "USD"); // Create another E1EDK01 let k01_2 = obj.addSegment("E1EDK01") .addField("BELNR", "2000") .addField("CURCY", "EUR"); // Create E1EDP01 with nested segments let p01 = obj.addSegment("E1EDP01") .addField("MENGE", "50") .addField("POSEX", "0010"); let p20 = p01.addSegment("E1EDP20") .addField("AMENG", "10") .addField("WMENG", "5"); p20.addSegment("E1EDP19") .addField("IDTNR", "MAT01"); gs.info(JSON.stringify(obj.getData(), null, 2)); 出力： { "data": { "E1EDK01": [{ "BELNR": "1000", "CURCY": "USD" }], "E1EDP01": [{ "MENGE": "50", "POSEX": "0010", "E1EDP20": [{ "AMENG": "10", "WMENG": "5", "E1EDP19": [{ "IDTNR": "MAT01" }] }] }] } } ## SegmentHandle:addSegment(文字列 segmentName, オブジェクト値) {#ariaid-title3} 事前定義されたネストされた子セグメントをペイロードに追加します。 {#SegmentHandle-addSegment_S_O__table_qkt_53x_3hc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | セグメント名 | 文字列 | 現在のセグメント内にネストされたセグメントの名前。 | | 値 | オブジェクト | addField() メソッドの代わりに使用するオプションの実装。 | [表 : 3. パラメーター] {#SegmentHandle-addSegment_S_O__table_qkt_53x_3hc} {#SegmentHandle-addSegment_S_O__table_dbp_4y2_c3c__entry__2} | タイプ | 説明 | |-|-| | オブジェクト | 子セグメントの新しい SegmentHandle を返します。 | [表 : 4. 返される内容] {#SegmentHandle-addSegment_S_O__table_dbp_4y2_c3c} 次の例は、セグメントペイロードを作成する方法を示しています。特定のセグメントへの参照を保持する場合は、明示的な変数を使用します。 * 複数の obj.addSegment("E1EDK01") 呼び出しは、複数のヘッダーセグメントを生成します。 * ネストされたセグメントは、正しい親ハンドル (p01、p20 など) から作成されます。 * k01_1、k01_2、p01 などのハンドルは、後で再利用してフィールドや子を追加できます。 {#SegmentHandle-addSegment_S_O__ul_y5z_y4m_c3c} var obj = new SegmentHandler('460d3ff2ff5de210d3a2fffffffffff8'); // Create first E1EDK01 let k01_1 = obj.addSegment("E1EDK01") .addField("BELNR", "1000") .addField("CURCY", "USD"); // Create another E1EDK01 let k01_2 = obj.addSegment("E1EDK01") .addField("BELNR", "2000") .addField("CURCY", "EUR"); // Create E1EDP01 with nested segments let p01 = obj.addSegment("E1EDP01") .addField("MENGE", "50") .addField("POSEX", "0010"); let p20 = p01.addSegment("E1EDP20") .addField("AMENG", "10") .addField("WMENG", "5"); p20.addSegment("E1EDP19") .addField("IDTNR", "MAT01"); gs.info(JSON.stringify(obj.getData(), null, 2)); 出力： { "data": { "E1EDK01": [{ "BELNR": "1000", "CURCY": "USD" }], "E1EDP01": [{ "MENGE": "50", "POSEX": "0010", "E1EDP20": [{ "AMENG": "10", "WMENG": "5", "E1EDP19": [{ "IDTNR": "MAT01" }] }] }] } } ## SegmentHandle:endSegment() {#ariaid-title4} スキーマ内の 1 つ上のレベルに移動します。 {#SegmentHandle-endSegment__table_qkt_53x_3hc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 5. パラメーター] {#SegmentHandle-endSegment__table_qkt_53x_3hc} {#SegmentHandle-endSegment__table_rkt_53x_3hc__entry__2} | タイプ | 説明 | |-|-| | オブジェクト | 親ハンドルまたはルートハンドラー。 * 子セグメントから、親 SegmentHandle オブジェクトを返します。 * 最上位セグメントから、親 SegmentHandler オブジェクトを返します。 {#SegmentHandle-endSegment__ul_jgb_2qm_c3c}root() メソッドを使用して、ルート SegmentHandler オブジェクトを返します。 | [表 : 6. 返される内容] {#SegmentHandle-endSegment__table_rkt_53x_3hc} 次の例は、ネストされたセグメントを持つヘッダーとアイテムを 1 つの Fluent チェーンでビルドする方法を示しています。構造は、構成されたスキーマによって異なります。スキーマパターンは、ネストされたアレイを持つセグメントのアレイです。 let obj = new sn_erp_integration.SegmentHandler('460d3ff2ff5de210d3a2fffffffffff8'); obj.addSegment("E1EDK01") .addField("BELNR", "1000") .addField("CURCY", "USD") .endSegment() .addSegment("E1EDP01") .addField("MENGE", "50") .addField("POSEX", "0010") .addSegment("E1EDP20") .addField("AMENG", "10") .addField("WMENG", "5") .addSegment("E1EDP19") .addField("IDTNR", "MAT01") .endSegment() .endSegment() .endSegment(); gs.info(JSON.stringify(obj.getData(), null, 2)); 出力： { "data": { "E1EDK01": [{ "BELNR": "1000", "CURCY": "USD" }], "E1EDP01": [{ "MENGE": "50", "POSEX": "0010", "E1EDP20": [{ "AMENG": "10", "WMENG": "5", "E1EDP19": [{ "IDTNR": "MAT01" }] }] }] } } ## SegmentHandle - root() {#ariaid-title5} ネストの深さに関係なく、ルート SegmentHandler オブジェクトを取得します。 {#SegmentHandle-root__table_qkt_53x_3hc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 7. パラメーター] {#SegmentHandle-root__table_qkt_53x_3hc} {#SegmentHandle-root__table_rkt_53x_3hc__entry__2} | タイプ | 説明 | |-|-| | オブジェクト | ルートレベルの SegmentHandler。 | [表 : 8. 返される内容] {#SegmentHandle-root__table_rkt_53x_3hc} 次の例は、スキーマ内のレベル間を移動する方法を示しています。 let p19 = p20.addSegment("E1EDP19").addField("IDTNR", "MAT01"); p19.endSegment() // back to E1EDP20 .endSegment() // back to E1EDP01 .root() // back to SegmentHandler .addSegment("E1EDK01").addField("BELNR", "3000");