---
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


---

# GlideImportSetTransformMap - com escopo, global

# GlideImportSetTransformMap - 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) 2 min. de leitura

A API GlideImportSetTransformMap fornece métodos para criar mapas de transformação e entradas de transformação.

Você pode usar os métodos GlideImportSetTransformMap em scripts globais e com escopo. Use o identificador de namespace `sn_impex` para criar um objeto GlideImportSetTransformMap.
**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.")
* [GlideImportSetTransformer](https://servicenow-prod.fluidtopics.net/1WfJBV2o7v4idoYAVl557w#GlideImportSetTransformerAPI "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.")
* [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.")

## GlideImportSetTransformMap - GlideImportSetTransformMap(cadeia de caracteres transformMapName, cadeia de caracteres importSetTableName, cadeia de caracteres targetTableName) {#ariaid-title2}

Instancia um objeto GlideImportSetTransformMap.
{#GImpSetTMp-GlImportSetTransformMap__table_nnl_z1f_vjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| transformMapName | Cadeia de caracteres | Nome do mapa. |
| importSetTableName | Cadeia de caracteres | Nome da tabela Conjunto para importação. |
| targetTableName | Cadeia de caracteres | Nome da tabela de destino. |
[Tabela 1. Parâmetros]

{#GImpSetTMp-GlImportSetTransformMap__table_nnl_z1f_vjb}  

    var transformMap = new sn_impex.GlideImportSetTransformMap("temp user map name", importSetTableName, targetTableName);

## GlideImportSetTransformMap - addDateTimeTransformEntry(cadeia de caracteres sourceColumn, cadeia de caracteres targetColumn, aglutinação booliana, cadeia de caracteres dateTimeFormat) {#ariaid-title3}

Adicione uma entrada de transformação GlideDateTime a um mapa de transformação.
{#GImpSetTMp-addGDTTrnsEntry_S_S_B_S__table_mrr_n1f_vjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| targetColumn | Cadeia de caracteres | Coluna de destino da tabela de destino para a qual transformar. |
| aglutinar | Booliano | Opcional. Sinalizador que indica se o registro deve ser inserido na tabela de destino * verdadeiro: se verdadeiro e a tabela de destino contiver um registro com o mesmo valor neste campo, o registro será atualizado, ou seja, não será inserido. * falso: padrão. O registro foi inserido na tabela de destino. {#GImpSetTMp-addGDTTrnsEntry_S_S_B_S__ul_jq3_byx_bkb} |
| sourceColumn | Cadeia de caracteres | Coluna de origem da tabela Conjunto de importação da qual transformar. |
| dateTimeFormat | Cadeia de caracteres | Opcional. Formato GlideDateTime da transformação, por exemplo, aaaa-MM-dd HH:mm:ss. Se estiver vazio, o valor padrão será o formato de data e hora do sistema. |
[Tabela 2. Parâmetros]

{#GImpSetTMp-addGDTTrnsEntry_S_S_B_S__table_mrr_n1f_vjb} {#GImpSetTMp-addGDTTrnsEntry_S_S_B_S__table_nrr_n1f_vjb__entry__2}

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

{#GImpSetTMp-addGDTTrnsEntry_S_S_B_S__table_nrr_n1f_vjb}  

    var transformMap = new sn_impex.GlideImportSetTransformMap("temp user map name", importSetTableName, targetTableName,);
    transformMap.addDateTimeTransformEntry("u_start date", "first day", true, "yyyy-MM-dd HH:mm:ss");
    var transformMapId = transformMap.create();

## GlideImportSetTransformMap - addTransformEntry(cadeia de caracteres sourceColumn, cadeia de caracteres targetColumn, aglutinação booliana) {#ariaid-title4}

Adiciona uma entrada de transformação de cadeia de caracteres a um mapa de transformação.
{#GImpSetTMp-addTransformEntry_S_S_B__table_mrr_n1f_vjb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| targetColumn | Cadeia de caracteres | Coluna de origem da tabela Conjunto de importação da qual transformar. |
| aglutinar | Cadeia de caracteres | Coluna de destino da tabela de destino para a qual transformar. |
| sourceColumn | Booliano | Opcional. Sinalizador que indica se o registro deve ser inserido na tabela de destino * verdadeiro: se verdadeiro e a tabela de destino contiver um registro com o mesmo valor neste campo, o registro será atualizado, ou seja, não será inserido. * falso: padrão. O registro foi inserido na tabela de destino. {#GImpSetTMp-addTransformEntry_S_S_B__ul_jq3_byx_bkb} |
[Tabela 4. Parâmetros]

{#GImpSetTMp-addTransformEntry_S_S_B__table_mrr_n1f_vjb} {#GImpSetTMp-addTransformEntry_S_S_B__table_nrr_n1f_vjb__entry__2}

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

{#GImpSetTMp-addTransformEntry_S_S_B__table_nrr_n1f_vjb}  

    var transformMap = new sn_impex.GlideImportSetTransformMap("temp user map name", importSetTableName, targetTableName); 
    transformMap.addTransformEntry("first_name", "first_name", true);
    transformMap.addTransformEntry("last_name", "last_name", false);
    transformMap.addTransformEntry("age", "age", false); 
    var transformMapId = transformMap.create();

## GlideImportSetTransformMap - criar () {#ariaid-title5}

Cria um novo mapa de transformação.
Nota:  
Para criar um mapa de transformação, você deve ter definido pelo menos uma entrada de transformação usando addDateTimeTransformEntry() ou addTransformEntry().
{#GImpSetTMp-create__table_k5g_xs2_vjb__entry__3}

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

{#GImpSetTMp-create__table_k5g_xs2_vjb} {#GImpSetTMp-create__table_l5g_xs2_vjb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O sys_id do mapa de transformação criado. |
[Tabela 7. Retorna]

{#GImpSetTMp-create__table_l5g_xs2_vjb}  

    var transformMap = new sn_impex.GlideImportSetTransformMap("temp user map name", importSetTableName, targetTableName);
    transformMap.addTransformEntry("u_first_name", "first_name");
    var transformMapId = transformMap.create();