GlideImportSetTransformer - escopo, global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • . GlideImportSetTransformer A API fornece métodos para criar um objeto 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 GlideImportSetTable API.
    2. Crie um mapa de transformação usando GlideImportSetTransformMap API.
    3. Crie ou use um Conjunto de importação existente usando GlideRecord API.
    4. Execute uma transformação de conjunto de importação usando GlideImportSetTransformer API.
    Depois de criar o registro do Conjunto de importação, ele deve ser consumido pelo GlideImportSetTransformer API para acionar a transformação.
    var transformer = new GlideImportSetTransformer();
    transformer.transformAllMaps(importSetGr); 

    GlideImportSetTransformer - GlideImportSetTransformer()

    Instancia um objeto GlideImportSetTransformer.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum
    var transformer = new GlideImportSetTransformer();

    GlideImportSetTransformer - getImportSetRun()

    Obtém o objeto Executar conjunto de importação associado a um objeto GlideImportSetTransformer.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 3. Retorna
    Tipo Descrição
    GlideImportSetRun Objeto GlideImportSetRun criado executando uma transformação ou o argumento fornecido ao SetImportSetRun() método.
    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()

    Retorna um valor booliano que especifica se houve ou não um erro durante uma transformação.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 5. Retorna
    Tipo Descrição
    Booliano Sinalizador que indica se há um erro.
    • Verdadeiro: Erro.
    • Falso: Sucesso.
    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 de cadeia de caracteres)

    Associa um registro de Conjunto de importação a um objeto GlideImportSetTransformer específico.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    id Cadeia de caracteres O sys_id de um registro de Conjunto de importação da tabela Conjuntos de importação [sys_import_set].
    Tabela 7. Retornos
    Tipo Descrição
    vazio
    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)

    Associa um objeto Executar conjunto de importação a um objeto GlideImportSetTransformer específico.

    Tabela 8. Parâmetros
    Nome Tipo Descrição
    ImportSetExecutar GlideImportSetRun Objeto GlideImportSetRun que representa o registro ImportSetRun para rastrear o histórico de transformação.
    Tabela 9. Retornos
    Tipo Descrição
    vazio
    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)

    Associa um objeto GlideImportLog a um objeto GlideImportSetTransformer específico.

    Se este método não for chamado antes de chamar o. TransformAllMaps() Um objeto GlideImportLog é criado internamente no lado do servidor.

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    log GlideImportLog Objeto GlideImportLog a ser vinculado ao histórico do conjunto de importação. Uma vez definida, qualquer chamada do objeto GlideImportLog é associada ao histórico de execução do conjunto de importação para essa transformação específica.
    Tabela 11. Retornos
    Tipo Descrição
    vazio
    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)

    Associa um mapa de transformação a um objeto GlideImportSetTransformer específico.

    Tabela 12. Parâmetros
    Nome Tipo Descrição
    MapID Cadeia de caracteres Um sys_id da tabela Mapas de transformação de tabela [sys_transform_map].
    Tabela 13. Retornos
    Tipo Descrição
    vazio
    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)

    Habilita a execução de transformações síncronas.

    Tabela 14. Parâmetros
    Nome Tipo Descrição
    síncrono Booliano Define o modo de transformação.

    Valores válidos:

    • Verdadeiro: Executar transformação de forma síncrona
    • Falso: Execute transformação assíncrona

    Padrão: falso

    Tabela 15. Retornos
    Tipo Descrição
    vazio
    
    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, cadeia de caracteres rowSysId)

    Executa a transformação do conjunto de importação.

    Tabela 16. Parâmetros
    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 17. Retornos
    Tipo Descrição
    vazio
    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);