---
sourceDocument: Yokohama データと自動化
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama データと自動化

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# 変換イベントスクリプトを使用したマップ

# 変換イベントスクリプトを使用したマップ {#ariaid-title1}

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

変換イベントは、インポートセットテーブルをテーブルに変換するプロセス中に発生します。
これらのイベントは、任意のタイプのマッピング仕様からの変換動作を変更します。変換イベントスクリプトは、変換のさまざまなステージでイベントの処理を変更します。

たとえば、[マッピング支援ユーティリティ](https://servicenow-prod.fluidtopics.net/Sz0adtznErpKjheraHw4ow "インポートの状況や、本番テーブルにロードする前にデータを変換する必要があるかどうかに応じて、さまざまな方法でフィールドをマッピングできます。")を使用して定義されたマッピング操作の処理は、イベントスクリプトを使用して操作できます。これらのイベント中にアクセスできるインポートセット JavaScript オブジェクトは多数あります。これらのオブジェクトは、テーブルまたはテーブルの一部を表します。これらのオブジェクトの参照先は、参照先のイベントのコンテキストによって異なることに注意してください。  
すべての変換イベントとそのコンテキスト変数のテーブルを次に示します。  
注:  
インポートログを表示するには、glide.importlog.log_to_table プロパティを true に設定します。詳細については、「[インポートセットのプロパティ](https://servicenow-prod.fluidtopics.net/5cWxdkQJTadLgaDSJugD_A "複数のプロパティがインポートセットの動作をコントロールします。")」を参照してください。  
{#r_MapWithTransformationEventScripts__table_r1y_4rs_sq__entry__2}

| イベント名 | イベントパラメーター |
|-|-|
| onStart | タイミング：onStart イベントスクリプトは、データ行が読み取られる前に、インポート実行の開始時に処理されます。 {#r_MapWithTransformationEventScripts__table_vjh_wrs_sq__entry__3} | インポートセット JS オブジェクト | タイプ | onStart インポートセットイベントのコンテキスト | |-|-|-| | ソース | GlideRecord | ソーステーブルの最初の行は読み取られていないため、まだデータがありません。 | | import_set | GlideRecord | 現在変換中のインポートセット。 | | マップ | GlideTransformMap | 現在の変換マップレコードに関する読み取り専用の情報。 | | ログ | 関数 | 現在のインポート実行のログオブジェクト。例：log.info(...)、log.warn(...)、log.error(...)。 注: インポートログを表示するには、glide.importlog.log_to_table プロパティを true に設定します。詳細については、「[インポートセットのプロパティ](https://servicenow-prod.fluidtopics.net/5cWxdkQJTadLgaDSJugD_A "複数のプロパティがインポートセットの動作をコントロールします。")」を参照してください。 | | 無視 | ブール | true に設定すると、変換全体が停止し、それ以上の処理は行われません。 | | エラー | ブール | true に設定すると、変換全体を停止する ignore フラグと同じ効果があり、エラーメッセージが表示されます。 | [表 : 2. 参照可能なインポートセット JS オブジェクトと onStart イベントでのそれらのコンテキスト] {#r_MapWithTransformationEventScripts__table_vjh_wrs_sq} 例： var info = "Starting Import Set Transformation Mapping operation using Data source, " + map.table_source + " and Transform Map " + map.name + " on import set " + import_set.number; log.info( info ); |
| onComplete | タイミング：onComplete イベントスクリプトは、すべてのデータ行が読み取られて変換された後、インポート実行の最後に処理されます。 {#r_MapWithTransformationEventScripts__table_hln_4ss_sq__entry__3} | インポートセット JS オブジェクト | タイプ | onComplete インポートセットイベントのコンテキスト | |-|-|-| | ソース | GlideRecord | ソースインポートセットテーブルの最後の行。 | | ターゲット | GlideRecord | ターゲットテーブルの最後の行。 | | import_set | GlideRecord | 現在変換中のインポートセット。 | | マップ | GlideTransformMap | 現在の変換マップレコードに関する読み取り専用の情報。 | | ログ | 関数 | 現在のインポート実行のログオブジェクト。例：log.info(...)、log.warn(...)、log.error(...)。 注: インポートログを表示するには、glide.importlog.log_to_table プロパティを true に設定します。詳細については、「[インポートセットのプロパティ](https://servicenow-prod.fluidtopics.net/5cWxdkQJTadLgaDSJugD_A "複数のプロパティがインポートセットの動作をコントロールします。")」を参照してください。 | | エラー | ブール | true に設定すると、完了後に現在のインポートセットステータスがエラーにマークされます。 | [表 : 3. 参照可能なインポートセット JS オブジェクトと onComplete イベントでのそれらのコンテキスト] {#r_MapWithTransformationEventScripts__table_hln_4ss_sq} 例： // Create a myimport_completed event that can be reacted by an email notification or script action // (there is already an import.finished event that the system will create at the end of an import) var e = new GlideEvent("myimport_completed", import_set.sys_id, map.sys_id, ""); e.insert(); |
| onBefore | タイミング：onBefore イベントスクリプトは、ソース行がターゲット行に変換される前に、行変換の開始時に処理されます。 {#r_MapWithTransformationEventScripts__table_myd_kts_sq__entry__3} | インポートセット JS オブジェクト | タイプ | onBefore インポートセットイベントのコンテキスト | |-|-|-| | ソース | GlideRecord | 現在処理中のソーステーブルの行。 | | ターゲット | GlideRecord | 現在処理中のターゲットテーブルの行。 | | import_set | GlideRecord | 現在変換中のインポートセット。 | | マップ | GlideTransformMap | 現在の変換マップレコードに関する読み取り専用の情報。 | | ログ | 関数 | 現在のインポート実行のログオブジェクト。例：log.info(...)、log.warn(...)、log.error(...)。 注: インポートログを表示するには、glide.importlog.log_to_table プロパティを true に設定します。詳細については、「[インポートセットのプロパティ](https://servicenow-prod.fluidtopics.net/5cWxdkQJTadLgaDSJugD_A "複数のプロパティがインポートセットの動作をコントロールします。")」を参照してください。 | | アクション | 文字列 | アクションは、現在のターゲット行が作成または更新されようとしているかを示す「insert」または「update」のいずれかの値を返します。 | | 無視 | ブール | true に設定すると、現在の行の変換はスキップされ、残りの行が処理されます。 onAfter スクリプトを定義した場合、ignore フラグが true に設定されていても、現在の行に対して onAfter スクリプトが実行されます。 | | status_message | 文字列 | \<status_message\> XML 応答で送信されるカスタムメッセージを定義します。 | | エラー | ブール | true に設定すると、現在のインポートセットの変換全体が停止し、エラーメッセージが表示されます。 | | error_message | 文字列 | \<error_message\> XML 応答で送信されるカスタムメッセージを定義します。 | [表 : 4. 参照可能なインポートセット JS オブジェクトと onBefore イベントでのそれらのコンテキスト] {#r_MapWithTransformationEventScripts__table_myd_kts_sq} 例： var name = source.u_name.toString(); var info = "Before the row is transformed, " + name; log.info( info ); // Make sure a company name has been provided var company = source.u_company.toString(); if(company.length == 0 ){ ignore = true; info ="No company name, row ignored! " + name; log.info( info ); } |
| onAfter | タイミング：onAfter イベントスクリプトは、ソース行がターゲット行に変換されて保存された後、行変換の最後に処理されます。 {#r_MapWithTransformationEventScripts__table_us2_m5s_sq__entry__3} | インポートセット JS オブジェクト | タイプ | onAfter インポートセットイベントのコンテキスト | |-|-|-| | ソース | GlideRecord | 現在処理中のソーステーブルの行。 | | ターゲット | GlideRecord | 現在処理中のターゲットテーブルの行。 | | import_set | GlideRecord | 現在変換中のインポートセット。 | | マップ | GlideTransformMap | 現在の変換マップレコードに関する読み取り専用の情報。 | | ログ | 関数 | 現在のインポート実行のログオブジェクト。例：log.info(...)、log.warn(...)、log.error(...)。 注: インポートログを表示するには、glide.importlog.log_to_table プロパティを true に設定します。詳細については、「[インポートセットのプロパティ](https://servicenow-prod.fluidtopics.net/5cWxdkQJTadLgaDSJugD_A "複数のプロパティがインポートセットの動作をコントロールします。")」を参照してください。 | | アクション | 文字列 | アクションは、現在のターゲット行が作成されたか更新されたかを示す「insert」または「update」のいずれかの値を返します。 | | status_message | 文字列 | \<status_message\> XML 応答で送信されるカスタムメッセージを定義します。 | | エラー | ブール | true に設定すると、現在のインポートセットの変換全体が停止し、エラーメッセージが表示されます。 | | error_message | 文字列 | \<error_message\> XML 応答で送信されるカスタムメッセージを定義します。 | [表 : 5. 参照可能なインポートセット JS オブジェクトと onAfter イベントでのそれらのコンテキスト] {#r_MapWithTransformationEventScripts__table_us2_m5s_sq} 例： if(source.new=="true"){ gs.include('Cart');var bundle =new GlideRecord('sc_cat_item'); bundle.addQuery('name','CONTAINS','comp'); bundle.query(); if(bundle.next()){ var new_comp_cart = new Cart(); var cart = new Cart(); var item = cart.addItem(bundle); var rc = cart.placeOrder(); log.info(rc.number);}} |
| onForeignInsert | タイミング：onForeignInsert イベントスクリプトは、レコードが作成される前に、関連する参照レコードの作成開始時に処理されます。 {#r_MapWithTransformationEventScripts__table_o4c_svs_sq__entry__3} | インポートセット JS オブジェクト | タイプ | onForeignInsert インポートセットイベントのコンテキスト | |-|-|-| | ソース | GlideRecord | 現在処理中のソーステーブルの行。 | | ターゲット | GlideRecord | 現在処理中のターゲットテーブルの行。 | | マップ | GlideTransformMap | 現在の変換マップレコードに関する読み取り専用の情報。 | | ログ | 関数 | 現在のインポート実行のログオブジェクト。例：log.info(...)、log.warn(...)、log.error(...)。 注: インポートログを表示するには、glide.importlog.log_to_table プロパティを true に設定します。詳細については、「[インポートセットのプロパティ](https://servicenow-prod.fluidtopics.net/5cWxdkQJTadLgaDSJugD_A "複数のプロパティがインポートセットの動作をコントロールします。")」を参照してください。 | | アクション | 文字列 | アクションは、現在のターゲット行が作成または更新されようとしているかを示す「insert」または「update」のいずれかの値を返します。 | | 名前 | 文字列 | 作成されようとしている外部レコードのターゲットレコードのフィールド名になります。 | | 値 | 文字列 | 外部レコードが作成されようとしているソースレコードからの表示値になります。 | | 無視 | ブール | true に設定すると、新しい外部レコードまたは関連レコードの作成が無視されます。 | | エラー | ブール | true に設定すると、変換行全体が却下され、この行のデータは保存されません。 | [表 : 6. 参照可能なインポートセット JS オブジェクトと onForeignInsert イベントでのそれらのコンテキスト] {#r_MapWithTransformationEventScripts__table_o4c_svs_sq} 例： //Create an event. var e = new GlideEvent("myimport_ForeignInsert", action, name, ""); e.insert(); |
| onChoiceCreate | タイミング：onChoiceCreate イベントスクリプトは、新しい選択値が作成される前に、選択値の作成の開始時に処理されます。 {#r_MapWithTransformationEventScripts__table_t4k_pws_sq__entry__3} | インポートセット JS オブジェクト | タイプ | onChoiceCreate インポートセットイベントのコンテキスト | |-|-|-| | ソース | GlideRecord | 現在処理中のソーステーブルの行。 | | ターゲット | GlideRecord | 現在処理中のターゲットテーブルの行。 | | マップ | GlideTransformMap | 現在の変換マップレコードに関する読み取り専用の情報。 | | ログ | 関数 | 現在のインポート実行のログオブジェクト。例：log.info(...)、log.warn(...)、log.error(...)。 注: インポートログを表示するには、glide.importlog.log_to_table プロパティを true に設定します。詳細については、「[インポートセットのプロパティ](https://servicenow-prod.fluidtopics.net/5cWxdkQJTadLgaDSJugD_A "複数のプロパティがインポートセットの動作をコントロールします。")」を参照してください。 | | アクション | 文字列 | アクションは、現在のターゲット行が作成または更新されようとしているかを示す「insert」または「update」のいずれかの値を返します。 | | 名前 | 文字列 | 選択値が作成されようとしているターゲットレコードのフィールド名になります。 | | 値 | 文字列 | 選択肢が作成されようとしているソースレコードの表示値になります。 | | 無視 | ブール | true に設定すると、選択値の作成が無視されます。 | | エラー | ブール | true に設定すると、変換行全体が却下され、この行のデータは保存されません。 | [表 : 7. 参照可能なインポートセット JS オブジェクトと onChoiceCreate イベントでのそれらのコンテキスト] {#r_MapWithTransformationEventScripts__table_t4k_pws_sq} 例： //Create an event var e = new GlideEvent("myimport_ChoiceCreate", action, value, ""); e.insert(); |
| onReject | 外部レコードまたは選択肢の作成中に onReject イベントスクリプトが処理され、外部レコードまたは選択肢が却下された場合、変換行全体は保存されません。 {#r_MapWithTransformationEventScripts__table_q5k_4xs_sq__entry__3} | インポートセット JS オブジェクト | タイプ | onError インポートセットイベントのコンテキスト | |-|-|-| | ソース | GlideRecord | 現在処理中のソーステーブルの行。 | | ターゲット | GlideRecord | 現在処理中のターゲットテーブルの行。 | | マップ | GlideTransformMap | 現在の変換マップレコードに関する読み取り専用の情報。 | | アクション | 文字列 | アクションは、現在のターゲット行が作成または更新されようとしているかを示す「insert」または「update」のいずれかの値を返します。 | | ログ | 関数 | 現在のインポート実行のログオブジェクト。例：log.info(...)、log.warn(...)、log.error(...)。 注: インポートログを表示するには、glide.importlog.log_to_table プロパティを true に設定します。詳細については、「[インポートセットのプロパティ](https://servicenow-prod.fluidtopics.net/5cWxdkQJTadLgaDSJugD_A "複数のプロパティがインポートセットの動作をコントロールします。")」を参照してください。 | [表 : 8. 参照可能なインポートセット JS オブジェクトと onError イベントでのそれらのコンテキスト] {#r_MapWithTransformationEventScripts__table_q5k_4xs_sq} 例： //Create an event var e = new GlideEvent("myimport_onReject", action, "", ""); e.insert(); |
[表 : 1. 変換イベントとそのコンテキスト変数]

{#r_MapWithTransformationEventScripts__table_r1y_4rs_sq}