---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideImportSetTransformer - com escopo, global

# GlideImportSetTransformer - com escopo, global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

A API GlideImportSetTransformer fornece métodos para criar um objeto de transformador de conjunto de importação usado para executar uma transformação de conjunto de importação.  
Para executar uma transformação de conjunto de importação:

1. Crie uma tabela de conjunto de importação usando a API GlideImportSetTable.
2. Crie um mapa de transformação usando a API GlideImportSetTransformMap.
3. Crie ou use um conjunto para importação existente usando a API GlideRecord.
4. Execute uma transformação de conjunto de importação usando a API GlideImportSetTransformer.

{#GlideImportSetTransformerAPI__ol_wnr_brf_ckb}Depois de criar o registro do conjunto de importação, ele deve ser consumido pela API GlideImportSetTransformer para acionar a transformação.

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

**Conceitos relacionados**   

* [GlideImportLog](https://servicenow-prod.fluidtopics.net/MDal48_cSU~nuox27x1o3Q#GlideImportLogAPI "A API GlideImportLog fornece métodos para gravar entradas de log diretamente na tabela Log de importação [import_log].")
* [GlideImportSetRun](https://servicenow-prod.fluidtopics.net/J7WHS9tQaE6NDtlZIQtS3A#GlideImportSetRunAPI "A API GlideImportSetRun fornece métodos para criar um registro de execução de conjunto de importação que a API GlideImportSetTransformer pode consumir.")
* [GlideImportSetTable](https://servicenow-prod.fluidtopics.net/kj5QyJZrrFBSoQcHXs5Otg#GlideImportSetTableAPI "A API GlideImportSetTable fornece métodos para criar tabelas temporárias de conjunto para importação.")
* [GlideImportSetTransformMap](https://servicenow-prod.fluidtopics.net/5ZvM9G8yOeTWm67DpxUtUQ#GlideImportSetTransformMapAPI "A API GlideImportSetTransformMap fornece métodos para criar mapas de transformação e entradas de transformação.")
* [GlideRecord](https://servicenow-prod.fluidtopics.net/FBR_zQLvGAsgQtw7~4MAGA#c_GlideRecordScopedAPI "A API GlideRecord com escopo é usada para operações de banco de dados.")
* [GlideTransformLog](https://servicenow-prod.fluidtopics.net/IBTFVGEHnS8fkrWZ219szQ#GlideTransformLogAPI "A API GlideTransformLog fornece métodos para criar um objeto GlideTransformLog para registrar mensagens em logs de host local.")

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

Instancia um objeto GlideImportSetTransformer.
{#GImpSetTrans-GlideImportSetTrans__table_xc4_sln_yjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

{#GImpSetTrans-GlideImportSetTrans__table_xc4_sln_yjb}  

    var transformer = new GlideImportSetTransformer();

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

Obtém o objeto de execução do conjunto de importação associado a um objeto GlideImportSetTransformer.
{#GImpSetTrans-getImportSetRun__table_inr_wvq_xjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 2. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| GlideImportSetRun | Objeto GlideImportSetRun criado ao executar uma transformação ou o argumento fornecido para o método setImportSetRun(). |
[Tabela 3. Retorna]

{#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}

Retorna um valor booliano que especifica se houve ou não um erro durante uma transformação.
{#GImpSetTrans-isError__table_inr_wvq_xjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 4. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se há um erro. * verdadeiro: erro. * falso: sucesso. {#GImpSetTrans-isError__ul_ec3_j1y_bkb} |
[Tabela 5. Retorna]

{#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(ID da cadeia de caracteres) {#ariaid-title5}

Associa um registro de conjunto de importação a um objeto GlideImportSetTransformer específico.
{#GImpSetTrans-setImportSetID_S__table_inr_wvq_xjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ID | Cadeia de caracteres | O sys_id de um registro de Conjunto para importação da tabela Conjuntos para importação \[sys_import_set\]. |
[Tabela 6. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 7. Retorna]

{#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}

Associa um objeto de execução do conjunto de importação a um objeto GlideImportSetTransformer específico.
{#GImpSetTrans-setImportSetRun_O__table_inr_wvq_xjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| importSetRun | GlideImportSetRun | Objeto GlideImportSetRun que representa o registro ImportSetRun para rastrear o histórico de transformação. |
[Tabela 8. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 9. Retorna]

{#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(log de GlideImportLog) {#ariaid-title7}

Associa um objeto GlideImportLog a um objeto GlideImportSetTransformer específico.
Se este método não for chamado antes de chamar o método transformAllMaps(), um objeto GlideImportLog será criado internamente no lado do servidor.
{#GImpSetTrans-setLogger_O__table_inr_wvq_xjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| log | GlideImportLog | Objeto GlideImportLog a ser vinculado ao histórico do Conjunto para importação. Depois de definido, qualquer chamada do objeto GlideImportLog é associada ao histórico de execução do conjunto de importação para essa transformação específica. |
[Tabela 10. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 11. Retorna]

{#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(cadeia de caracteres mapID) {#ariaid-title8}

Associa um mapa de transformação a um objeto GlideImportSetTransformer específico.
{#GImpSetTrans-setMapID_S__table_inr_wvq_xjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| mapID | Cadeia de caracteres | Um sys_id da tabela Mapas de transformação de tabela \[sys_transform_map\]. |
[Tabela 12. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 13. Retorna]

{#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 (booliano síncrono) {#ariaid-title9}

Habilita a execução de transformações síncronas.
{#GImpSetTrans-setSyncImport_B__table_inr_wvq_xjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| síncrono | Booliano | Define o modo de transformação. Valores válidos: * verdadeiro: executa a transformação de forma síncrona * falso: executa a transformação de forma assíncrona {#GImpSetTrans-setSyncImport_B__ul_elk_qq4_bkb} Padrão: falso |
[Tabela 14. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 15. Retorna]

{#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}

Executa a transformação do conjunto de importação.
{#GImpSetTrans-transformAllMaps_G_S__table_inr_wvq_xjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| importSet | GlideRecord | GlideRecord do conjunto de importação a ser executado. |
| rowSysId | Cadeia de caracteres | Opcional. Restringe a transformação a um único registro, passando o sys_id de um registro da tabela Conjuntos para importação \[sys_import_set\]. Padrão: transformar todas as linhas |
[Tabela 16. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 17. Retorna]

{#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);