---
sourceDocument: Xanadu API Reference
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideImportSetTransformer - Scoped, Global

# GlideImportSetTransformer - Scoped, Global {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read

The GlideImportSetTransformer API provides methods to create an
Import Set Transformer object used to execute an Import Set Transform.  
To execute an Import Set transform:

1. Create an Import Set table using the GlideImportSetTable API.
2. Create a Transform Map using the GlideImportSetTransformMap API.
3. Create or use an existing Import Set using the GlideRecord API.
4. Execute an Import Set Transform using the GlideImportSetTransformer API.

{#GlideImportSetTransformerAPI__ol_wnr_brf_ckb}Once you have created the Import Set record it must be consumed by the GlideImportSetTransformer API in order to trigger the transform.

    var transformer = new GlideImportSetTransformer();
    transformer.transformAllMaps(importSetGr); 

**Related concepts**   

* [GlideImportLog](https://servicenow-prod.fluidtopics.net/qNWk7yJGC8yDqUP2uVapVg#GlideImportLogAPI "The GlideImportLog API provides methods to write log entries directly to the Import Log [import_log] table.")
* [GlideImportSetRun](https://servicenow-prod.fluidtopics.net/DuUdB5QjbqzVKw9vNXpdgQ#GlideImportSetRunAPI "The GlideImportSetRun API provides methods to creates an Import Set Run record which the GlideImportSetTransformer API can consume.")
* [GlideImportSetTable](https://servicenow-prod.fluidtopics.net/hcK8zq2yc77uOy_947gQmw#GlideImportSetTableAPI "The GlideImportSetTable API provides methods to create temporary Import Set tables.")
* [GlideImportSetTransformMap](https://servicenow-prod.fluidtopics.net/FN6~ahvPtG3B7g~0D95WzQ#GlideImportSetTransformMapAPI "The GlideImportSetTransformMap API provides methods to create transform maps and transform entries.")
* [GlideRecord](https://servicenow-prod.fluidtopics.net/Z64TK~kWnpWTEG5bCPvZuQ#c_GlideRecordScopedAPI "The scoped GlideRecord API is used for database operations.")
* [GlideTransformLog](https://servicenow-prod.fluidtopics.net/40hOpIutNqObDYC_~w8L~w#GlideTransformLogAPI "The GlideTransformLog API provides methods to create a GlideTransformLog object to log messages to localhost logs.")

## GlideImportSetTransformer - GlideImportSetTransformer() {#ariaid-title2}

Instantiates a GlideImportSetTransformer object.
{#GImpSetTrans-GlideImportSetTrans__table_xc4_sln_yjb__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 1. Parameters]

{#GImpSetTrans-GlideImportSetTrans__table_xc4_sln_yjb}  

    var transformer = new GlideImportSetTransformer();

## GlideImportSetTransformer - getImportSetRun() {#ariaid-title3}

Gets the Import Set Run object associated with a GlideImportSetTransformer
object.
{#GImpSetTrans-getImportSetRun__table_inr_wvq_xjb__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 2. Parameters]

{#GImpSetTrans-getImportSetRun__table_inr_wvq_xjb} {#GImpSetTrans-getImportSetRun__table_jnr_wvq_xjb__entry__2}

| Type | Description |
|-|-|
| GlideImportSetRun | GlideImportSetRun object created by running a transformation or the argument supplied to the setImportSetRun() method. |
[Table 3. Returns]

{#GImpSetTrans-getImportSetRun__table_jnr_wvq_xjb}  

    var importSet = new GlideRecord('sys_import_set');
    importSet.short_description = 'Import set from scripted rest api';
    importSet.table_name = importSetTableName;
    var importSetID = importSet.insert();
    var transformer = new GlideImportSetTransformer();
    transformer.transformAllMaps(importSet);
    var importSetRun = transformer.getImportSetRun();

## GlideImportSetTransformer - isError() {#ariaid-title4}

Returns a Boolean value specifying whether or not there was an error during a
transformation.
{#GImpSetTrans-isError__table_inr_wvq_xjb__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 4. Parameters]

{#GImpSetTrans-isError__table_inr_wvq_xjb} {#GImpSetTrans-isError__table_jnr_wvq_xjb__entry__2}

| Type | Description |
|-|-|
| Boolean | Flag that indicates whether there is an error. * true: Error. * false: Success. {#GImpSetTrans-isError__ul_ec3_j1y_bkb} |
[Table 5. Returns]

{#GImpSetTrans-isError__table_jnr_wvq_xjb}  

    var importSet = new GlideRecord('sys_import_set');
    importSet.short_description = 'Import set from scripted rest api';
    importSet.table_name = importSetTableName;
    var importSetID = importSet.insert();
    var transformer = new GlideImportSetTransformer();
    transformer.transformAllMaps(importSet);
    if(transformer.isError()) {
    	gs.error('Error executing the transform');
    }

## GlideImportSetTransformer - setImportSetID(String id) {#ariaid-title5}

Associates an Import Set record with a specific GlideImportSetTransformer
object.
{#GImpSetTrans-setImportSetID_S__table_inr_wvq_xjb__entry__3}

| Name | Type | Description |
|-|-|-|
| id | String | The sys_id of an Import Set record from the Import Sets \[sys_import_set\] table. |
[Table 6. Parameters]

{#GImpSetTrans-setImportSetID_S__table_inr_wvq_xjb} {#GImpSetTrans-setImportSetID_S__table_jnr_wvq_xjb__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 7. Returns]

{#GImpSetTrans-setImportSetID_S__table_jnr_wvq_xjb}  

    var importSet = new GlideRecord('sys_import_set');
    importSet.short_description = 'Import set from scripted rest api';
    importSet.table_name = importSetTableName;
    var importSetID = importSet.insert();
    var transformer = new GlideImportSetTransformer();
    transformer.setImportSetID(importSetID);
    transformer.transformAllMaps(importSet);

## GlideImportSetTransformer - setImportSetRun(GlideImportSetRun importSetRun) {#ariaid-title6}

Associates an Import Set Run object with a specific GlideImportSetTransformer
object.
{#GImpSetTrans-setImportSetRun_O__table_inr_wvq_xjb__entry__3}

| Name | Type | Description |
|-|-|-|
| importSetRun | GlideImportSetRun | GlideImportSetRun object representing the ImportSetRun record to track the transformation history. |
[Table 8. Parameters]

{#GImpSetTrans-setImportSetRun_O__table_inr_wvq_xjb} {#GImpSetTrans-setImportSetRun_O__table_jnr_wvq_xjb__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 9. Returns]

{#GImpSetTrans-setImportSetRun_O__table_jnr_wvq_xjb}  

    var importSet = new GlideRecord('sys_import_set');
    importSet.short_description = 'Import set from scripted rest api';
    importSet.table_name = importSetTableName;
    var importSetID = importSet.insert();
    var importSetRun = new GlideImportSetRun(importSetID);
    var transformer = new GlideImportSetTransformer();
    transformer.setImportSetRun(importSetRun);
    transformer.transformAllMaps(importSet);

## GlideImportSetTransformer - setLogger(GlideImportLog log) {#ariaid-title7}

Associates a GlideImportLog object with a specific GlideImportSetTransformer
object.
If this method is not called prior to calling the transformAllMaps()
method, a GlideImportLog object is created internally on the server side.
{#GImpSetTrans-setLogger_O__table_inr_wvq_xjb__entry__3}

| Name | Type | Description |
|-|-|-|
| log | GlideImportLog | GlideImportLog object to link to the Import Set history. Once set, any call from the GlideImportLog object is associated with the Import Set run history for that specific transform. |
[Table 10. Parameters]

{#GImpSetTrans-setLogger_O__table_inr_wvq_xjb} {#GImpSetTrans-setLogger_O__table_jnr_wvq_xjb__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 11. Returns]

{#GImpSetTrans-setLogger_O__table_jnr_wvq_xjb}  

    var importSet = new GlideRecord('sys_import_set');
    importSet.short_description = 'Import set from scripted rest api';
    importSet.table_name = importSetTableName;
    var importSetID = importSet.insert();
    var importLog = new GlideImportLog();
    var transformer = new GlideImportSetTransformer();
    transformer.setLogger(importLog);
    transformer.transformAllMaps(importSet);

## GlideImportSetTransformer - setMapID(String mapID) {#ariaid-title8}

Associates a Transform Map with a specific GlideImportSetTransformer
object.
{#GImpSetTrans-setMapID_S__table_inr_wvq_xjb__entry__3}

| Name | Type | Description |
|-|-|-|
| mapID | String | A sys_id from the Table Transform Maps \[sys_transform_map\] table. |
[Table 12. Parameters]

{#GImpSetTrans-setMapID_S__table_inr_wvq_xjb} {#GImpSetTrans-setMapID_S__table_jnr_wvq_xjb__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 13. Returns]

{#GImpSetTrans-setMapID_S__table_jnr_wvq_xjb}  

    var importSet = new GlideRecord('sys_import_set');
    importSet.short_description = 'Import set from scripted rest api';
    importSet.table_name = importSetTableName;
    var importSetID = importSet.insert();
    var transformMapId = '<sys id of transform map>';
    var transformer = new GlideImportSetTransformer();
    transformer.setMapID(transformMapId);
    transformer.transformAllMaps(importSet);

## GlideImportSetTransformer - setSyncImport(Boolean synchronous) {#ariaid-title9}

Enables running synchronous transformations.
{#GImpSetTrans-setSyncImport_B__table_inr_wvq_xjb__entry__3}

| Name | Type | Description |
|-|-|-|
| synchronous | Boolean | Sets transformation mode. Valid values: * true: Run transformation synchronously * false: Run transformation asynchronously {#GImpSetTrans-setSyncImport_B__ul_elk_qq4_bkb} Default: false |
[Table 14. Parameters]

{#GImpSetTrans-setSyncImport_B__table_inr_wvq_xjb} {#GImpSetTrans-setSyncImport_B__table_jnr_wvq_xjb__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 15. Returns]

{#GImpSetTrans-setSyncImport_B__table_jnr_wvq_xjb}  


    var importSet = new GlideRecord('sys_import_set');
    importSet.short_description = 'Import set from scripted rest api';
    importSet.table_name = importSetTableName;
    var importSetID = importSet.insert();
    var transformer = new GlideImportSetTransformer();
    transformer.setSyncImport(true);
    transformer.transformAllMaps(importSet);

## GlideImportSetTransformer - transformAllMaps(GlideRecord importSet, String
rowSysId) {#ariaid-title10}

Executes the Import Set transformation.
{#GImpSetTrans-transformAllMaps_G_S__table_inr_wvq_xjb__entry__3}

| Name | Type | Description |
|-|-|-|
| importSet | GlideRecord | GlideRecord of the import set to execute. |
| rowSysId | String | Optional. Restricts transformation to a single record by passing the sys_id of a record from the Import Sets \[sys_import_set\] table. Default: Transform all rows |
[Table 16. Parameters]

{#GImpSetTrans-transformAllMaps_G_S__table_inr_wvq_xjb} {#GImpSetTrans-transformAllMaps_G_S__table_jnr_wvq_xjb__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 17. Returns]

{#GImpSetTrans-transformAllMaps_G_S__table_jnr_wvq_xjb}  

    var importSet = new GlideRecord('sys_import_set');
    importSet.short_description = 'Import set from scripted rest api';
    importSet.table_name = importSetTableName;
    var importSetID = importSet.insert();
    var transformer = new GlideImportSetTransformer();
    transformer.transformAllMaps(importSet);