Mapa com scripts de evento de transformação

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 9 min. de leitura

    • Os eventos de transformação ocorrem durante o processo de transformação de uma tabela de conjunto de importação em uma tabela.

    Esses eventos modificam o comportamento de transformação de qualquer tipo de especificação de mapeamento. Os scripts de evento de transformação modificam o processamento dos eventos em várias fases da transformação.

    Por exemplo, o processamento de uma operação de mapeamento definida usando Utilitário de Assistência de Mapeamento pode ser manipulado usando os scripts de evento. Há vários objetos JavaScript de conjunto de importação que podem ser acessados durante esses eventos. Esses objetos representam tabelas ou partes de tabelas. É importante observar que o que esses objetos se referem varia dependendo do contexto do evento no qual eles são referenciados.

    A tabela a seguir contém todos os eventos de transformação e suas variáveis contextuais.
    Nota:
    Para exibir os logs de importação, defina glide.importlog.log_to_tablepropriedade como verdadeira. Para obter mais informações, consulte Propriedades dos conjuntos de importação.
    Tabela 1. Eventos de transformação e suas variáveis contextuais
    Nome do evento Parâmetros de eventos
    onStart

    Quando: O script de evento onStart é processado no início de uma execução de importação, antes que todas as linhas de dados sejam lidas.

    Tabela 2. Objetos JS do conjunto de importação disponíveis para serem referenciados e seu contexto no evento onStart
    Objeto JS do conjunto de importação Tipo Contexto no evento do conjunto de importação onStart
    origem GlideRecord A primeira linha da tabela de origem, ainda não há dados porque a linha não foi lida.
    import_set GlideRecord O conjunto de importação que está sendo transformado no momento.
    mapa GlideTransformMap Informações somente leitura sobre o registro do mapa de transformação atual.
    log Função O objeto de log da execução de importação atual. Por exemplo, log.info(...), log.warn(...), log.error(...).
    Nota:
    Para exibir os logs de importação, defina glide.importlog.log_to_tablepropriedade como verdadeira. Para obter mais informações, consulte Propriedades dos conjuntos de importação.
    ignorar Booliano Quando definido como verdadeiro, toda a transformação será interrompida e nenhum processamento adicional ocorrerá.
    erro Booliano Quando definido como verdadeiro, tem o mesmo efeito que o sinalizador Ignorar de parar toda a transformação, com uma mensagem de erro.

    Exemplo:

    var info = "Starting Import Set Transformation Mapping operation using Data source, " 
+ map.table_source + " and Transform Map " + map.name + " on import set " + import_set.number;
log.info( info );
    onComplete

    Quando: O script de evento onComplete é processado no final de uma execução de importação, depois que todas as linhas de dados são lidas e transformadas.

    Tabela 3. Objetos JS do conjunto de importação disponíveis para serem referenciados e seu contexto no evento onComplete
    Objeto JS do conjunto de importação Tipo Contexto no evento do conjunto de importação onComplete
    origem GlideRecord A última linha da tabela do conjunto de importação de origem.
    target GlideRecord A última linha da tabela de destino.
    import_set GlideRecord O conjunto de importação que está sendo transformado no momento.
    mapa GlideTransformMap Informações somente leitura sobre o registro do mapa de transformação atual.
    log Função O objeto de log da execução de importação atual. Por exemplo, log.info(...), log.warn(...), log.error(...).
    Nota:
    Para exibir os logs de importação, defina glide.importlog.log_to_tablepropriedade como verdadeira. Para obter mais informações, consulte Propriedades dos conjuntos de importação.
    erro Booliano Quando definido como verdadeiro, marcará o status atual do conjunto de importação como erro após a conclusão.

    Exemplo:

    // Create a myimport_completed event that can be reacted by an email notification or script action
// (there is already an import.finished event that the system will create at the end of an import)
var e = new GlideEvent("myimport_completed", import_set.sys_id, map.sys_id, "");
e.insert();
    onBefore

    Quando: O script de evento onBefore é processado no início de uma transformação de linha, antes que a linha de origem seja transformada na linha de destino.

    Tabela 4. Objetos JS do conjunto de importação disponíveis para serem referenciados e seu contexto no evento onBefore
    Objeto JS do conjunto de importação Tipo Contexto no evento do conjunto de importação onBefore
    origem GlideRecord A linha da tabela de origem que está sendo processada no momento.
    target GlideRecord A linha da tabela de destino que está sendo processada no momento.
    import_set GlideRecord O conjunto de importação que está sendo transformado no momento.
    mapa GlideTransformMap Informações somente leitura sobre o registro do mapa de transformação atual.
    log Função O objeto de log da execução de importação atual. Por exemplo, log.info(...), log.warn(...), log.error(...).
    Nota:
    Para exibir os logs de importação, defina glide.importlog.log_to_tablepropriedade como verdadeira. Para obter mais informações, consulte Propriedades dos conjuntos de importação.
    ação Cadeia de caracteres A ação retorna um valor de "inserir" ou "atualizar", indicando se a linha de destino atual está prestes a ser criada ou atualizada.
    ignorar Booliano Quando definido como verdadeiro, a transformação de linha atual será ignorada e as linhas restantes serão processadas.

    Se você definiu um script onAfter, o script onAfter será executado para a linha atual, mesmo que o sinalizador ignorar esteja definido como verdadeiro.
    status_message Cadeia de caracteres Define uma mensagem personalizada a ser enviada na resposta XML do <status_message>.
    erro Booliano Quando definido como verdadeiro, interromperá toda a transformação do conjunto de importação atual, com uma mensagem de erro.
    error_message Cadeia de caracteres Define uma mensagem personalizada a ser enviada na resposta XML do <error_message>.

    Exemplo:

    var name = source.u_name.toString();
var info = "Before the row is transformed, " + name;
log.info( info ); 
 
// Make sure a company name has been provided
var company = source.u_company.toString();
if(company.length == 0 ){
	ignore = true;
	info ="No company name, row ignored! " + name;
	log.info( info );
}
    onAfter

    Quando: O script de evento onAfter é processado no final de uma transformação de linha, depois que a linha de origem é transformada na linha de destino e salva.

    Tabela 5. Objetos JS do conjunto de importação disponíveis para serem referenciados e seu contexto no evento onAfter
    Objeto JS do conjunto de importação Tipo Contexto no evento do conjunto de importação onAfter
    origem GlideRecord A linha da tabela de origem que está sendo processada no momento.
    target GlideRecord A linha da tabela de destino que está sendo processada no momento.
    import_set GlideRecord O conjunto de importação que está sendo transformado no momento.
    mapa GlideTransformMap Informações somente leitura sobre o registro do mapa de transformação atual.
    log Função O objeto de log da execução de importação atual. Por exemplo, log.info(...), log.warn(...), log.error(...).
    Nota:
    Para exibir os logs de importação, defina glide.importlog.log_to_tablepropriedade como verdadeira. Para obter mais informações, consulte Propriedades dos conjuntos de importação.
    ação Cadeia de caracteres A ação retorna um valor de "inserir" ou "atualizar", indicando se a linha de destino atual foi criada ou atualizada.
    status_message Cadeia de caracteres Define uma mensagem personalizada a ser enviada na resposta XML do <status_message>.
    erro Booliano Quando definido como verdadeiro, interromperá toda a transformação do conjunto de importação atual, com uma mensagem de erro.
    error_message Cadeia de caracteres Define uma mensagem personalizada a ser enviada na resposta XML do <error_message>.

    Exemplo:

    if(source.new=="true"){
  gs.include('Cart');var bundle =new GlideRecord('sc_cat_item');
  bundle.addQuery('name','CONTAINS','comp');
  bundle.query();
  if(bundle.next()){
     var new_comp_cart = new Cart();
     var cart = new Cart();
     var item = cart.addItem(bundle);
     var rc = cart.placeOrder();
     log.info(rc.number);}}
    onForeignInsert

    Quando: O script de evento onForeignInsert é processado no início da criação de um registro relacionado e referenciado, antes que o registro seja criado.

    Tabela 6. Objetos JS do conjunto de importação disponíveis para serem referenciados e seu contexto no evento onForeignInsert
    Objeto JS do conjunto de importação Tipo Contexto no evento do conjunto de importação onForeignInsert
    origem GlideRecord A linha da tabela de origem que está sendo processada no momento.
    target GlideRecord A linha da tabela de destino que está sendo processada no momento.
    mapa GlideTransformMap Informações somente leitura sobre o registro do mapa de transformação atual.
    log Função O objeto de log da execução de importação atual. Por exemplo, log.info(...), log.warn(...), log.error(...).
    Nota:
    Para exibir os logs de importação, defina glide.importlog.log_to_tablepropriedade como verdadeira. Para obter mais informações, consulte Propriedades dos conjuntos de importação.
    ação Cadeia de caracteres A ação retorna um valor de "inserir" ou "atualizar", indicando se a linha de destino atual está prestes a ser criada ou atualizada.
    nome Cadeia de caracteres Avalia o nome do campo do registro de destino para o qual um registro externo que está prestes a ser criado.
    valor Cadeia de caracteres Avalia o valor de exibição do registro de origem para o qual um registro externo está prestes a ser criado.
    ignorar Booliano Quando definido como verdadeiro, ignora a criação de um novo registro externo ou relacionado.
    erro Booliano Quando definido como verdadeiro, rejeita toda a linha de transformação, nenhum dado é salvo para esta linha.

    Exemplo:

    //Create an event.
var e = new GlideEvent("myimport_ForeignInsert", action, name, "");
e.insert();
    onChoiceCreate

    Quando: O script de evento onChoiceCreate é processado no início de uma criação de valor de escolha, antes que o novo valor de escolha seja criado.

    Tabela 7. Objetos JS do conjunto de importação disponíveis para serem referenciados e seu contexto no evento onChoiceCreate
    Objeto JS do conjunto de importação Tipo Contexto no evento onChoiceCreate do conjunto de importação
    origem GlideRecord A linha da tabela de origem que está sendo processada no momento.
    target GlideRecord A linha da tabela de destino que está sendo processada no momento.
    mapa GlideTransformMap Informações somente leitura sobre o registro do mapa de transformação atual.
    log Função O objeto de log da execução de importação atual. Por exemplo, log.info(...), log.warn(...), log.error(...).
    Nota:
    Para exibir os logs de importação, defina glide.importlog.log_to_tablepropriedade como verdadeira. Para obter mais informações, consulte Propriedades dos conjuntos de importação.
    ação Cadeia de caracteres A ação retorna um valor de "inserir" ou "atualizar", indicando se a linha de destino atual está prestes a ser criada ou atualizada.
    nome Cadeia de caracteres Avalia o nome do campo do registro de destino para o qual um valor de opção está prestes a ser criado.
    valor Cadeia de caracteres Avalia o valor de exibição do registro de origem para o qual uma opção está prestes a ser criada.
    ignorar Booliano Quando definido como verdadeiro, ignora a criação de um valor de opção.
    erro Booliano Quando definido como verdadeiro, rejeita toda a linha de transformação, nenhum dado é salvo para esta linha.

    Exemplo:

    //Create an event
var e = new GlideEvent("myimport_ChoiceCreate", action, value, "");
e.insert();
    onReject

    Quando: O script de evento onReject é processado durante a ocorrência de um registro externo ou criação de opção e o registro externo ou opção é rejeitado , toda a linha de transformação não é salva.

    Tabela 8. Objetos JS do conjunto de importação disponíveis para serem referenciados e seu contexto no evento OnError
    Objeto JS do conjunto de importação Tipo Contexto no evento do conjunto de importação OnError
    origem GlideRecord A linha da tabela de origem que está sendo processada no momento.
    target GlideRecord A linha da tabela de destino que está sendo processada no momento.
    mapa GlideTransformMap Informações somente leitura sobre o registro do mapa de transformação atual.
    ação Cadeia de caracteres A ação retorna um valor de "inserir" ou "atualizar", indicando se a linha de destino atual está prestes a ser criada ou atualizada.
    log Função O objeto de log da execução de importação atual. Por exemplo, log.info(...), log.warn(...), log.error(...).
    Nota:
    Para exibir os logs de importação, defina glide.importlog.log_to_tablepropriedade como verdadeira. Para obter mais informações, consulte Propriedades dos conjuntos de importação.
    Exemplo:
    //Create an event
var e = new GlideEvent("myimport_onReject", action, "", "");
e.insert();