GlideImportLog - com escopo, global

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura
  • A API GlideImportLog fornece métodos para gravar entradas de log diretamente na tabela Log de importação [import_log].

    Um objeto GlideImportLog é consumível pela API GlideImportSetTransformer. Este objeto não é necessário para a API GlideImportSetTransformer. Ele permite que você associe logs de importação a uma transformação de Conjunto para importação específica.

    GlideImportLog - GlideImportLog(GlideImportSetRun importSetRun, origem da cadeia de caracteres)

    Instancia um objeto GlideImportLog.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    importSetRun GlideImportSetRun Opcional. Registro de execução do conjunto de importação ao qual todos os logs serão associados.
    origem Cadeia de caracteres Opcional. Valor do campo de origem anexado ao registro de log de importação que define em que lugar no processo do conjunto de importação esta mensagem foi registrada. Por exemplo, Carregamento pode representar a etapa de carregamento, Limpeza pode representar durante a limpeza após a transformação e assim por diante.

    Exemplo sem parâmetro de origem opcional.

    var importSetRun = new GlideImportSetRun();
    var importLog = new GlideImportLog(importSetRun);
    

    Exemplo usando o parâmetro de origem opcional.

    var importSetRun = new GlideImportSetRun();
    var importLog = new GlideImportLog(importSetRun, 'Scripted ImportSetTransformer');
    

    GlideImportLog - erro (mensagem de cadeia de caracteres, origem de cadeia de caracteres)

    Registra em log uma mensagem do tipo Erro na tabela Log de importação [import_log].

    GlideImportLog

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres Mensagem de log. Tamanho máximo de 4000 caracteres.
    origem Cadeia de caracteres Opcional. Valor do campo de origem anexado ao registro de log de importação que define em que lugar no processo do conjunto de importação esta mensagem foi registrada. Por exemplo, Carregamento pode representar a etapa de carregamento, Limpeza pode representar durante a limpeza após a transformação e assim por diante.
    Tabela 3. Retorna
    Tipo Descrição
    Nenhum(a)
    var importLog = new GlideImportLog();
    importLog.error('Error executing transform');
    

    GlideImportLog – getImportRunHistory()

    Retorna um sys_id do registro de execução de importação associado a este log de importação.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 5. Retorna
    Tipo Descrição
    Cadeia de caracteres Sys_id de um registro de execução de conjunto de importação da tabela Histórico de transformações [sys_import_set_run].
    var importSet = new GlideRecord('sys_import_set');
    importSet.name = 'Scripted 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);
    var importRunSysId = importLog.getImportRunHistory();
    

    GlideImportLog - info (cadeia de caracteres de mensagem, cadeia de caracteres de origem)

    Registra em log uma mensagem do tipo Informações na tabela Log de importação [import_log].

    GlideImportLog

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres Mensagem de log. Tamanho máximo de 4000 caracteres.
    origem Cadeia de caracteres Opcional. Valor do campo de origem anexado ao registro de log de importação que define em que lugar no processo do conjunto de importação esta mensagem foi registrada. Por exemplo, Carregamento pode representar a etapa de carregamento, Limpeza pode representar durante a limpeza após a transformação e assim por diante.
    Tabela 7. Retorna
    Tipo Descrição
    Nenhum(a)
    var importLog = new GlideImportLog();
    importLog.info('Successfully executed transform');
    

    GlideImportLog – setImportRunHistory(cadeia de caracteres importRunHistory)

    Associa o objeto GlideImportLog a um registro de execução de conjunto de importação específico.

    Tabela 8. Parâmetros
    Nome Tipo Descrição
    importRunHistory Cadeia de caracteres O sys_id de um registro da tabela Histórico de transformações [sys_import_set_run].
    Tabela 9. Retorna
    Tipo Descrição
    vazio
    var importRunSysId = '4aa3a8d55ba10010953330ad5981c79f';
    var importLog = new GlideImportLog();
    importLog.setImportRunHistory(importRunSysId);
    

    GlideImportLog - aviso (mensagem de cadeia de caracteres, origem de cadeia de caracteres)

    Registra em log uma mensagem do tipo Aviso na tabela Log de importação [import_log].

    GlideImportLog

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    message Cadeia de caracteres Mensagem de log. Tamanho máximo de 4000 caracteres.
    origem Cadeia de caracteres Opcional. Valor do campo de origem anexado ao registro de log de importação que define em que lugar no processo do conjunto de importação esta mensagem foi registrada. Por exemplo, Carregamento pode representar a etapa de carregamento, Limpeza pode representar durante a limpeza após a transformação e assim por diante.
    Tabela 11. Retorna
    Tipo Descrição
    Nenhum(a)
    var importLog = new GlideImportLog();
    importLog.warn('Transform taking longer than expected.');