GlideImportSetTransformer - com escopo, global

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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.
    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); 

    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 de execução do 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 ao executar uma transformação ou o argumento fornecido para o método setImportSetRun().
    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 da 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 para importação da tabela Conjuntos para importação [sys_import_set].
    Tabela 7. Retorna
    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 de execução do conjunto de importação a um objeto GlideImportSetTransformer específico.

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

    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.

    Tabela 10. Parâmetros
    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 11. Retorna
    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. Retorna
    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: executa a transformação de forma síncrona
    • falso: executa a transformação de forma assíncrona

    Padrão: falso

    Tabela 15. Retorna
    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, String 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. Retorna
    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);