v_record - Escopo, Global

. v_record A API permite que você defina uma exceção ou mensagem de erro em um registro de tabela remota. As tabelas remotas permitem recuperar dados de fontes externas ou de outra instância com serviços REST ou SOAP.

Esta API é executada sempre que os métodos de criação, atualização e exclusão do GlideRecord são usados em um script sem mudanças em espaços de trabalho, listas e formulários.

Esta API requer que o plug-in Tabelas remotas (com.glide.script.vtable) seja ativado. Para obter mais informações, consulte Create script definitions for a remote table.

Usar v_record com v_query - com escopo, global objeto programável para consultar tabelas remotas e v_table – Scoped, Global API para criar tabelas remotas.

v_record - setLastErrorMessage(cadeia de caracteres lastErrorMessage)

Define uma exceção ou mensagem de erro a ser exibida durante operações editáveis em um registro de tabela remota na exibição de formulário ou de lista e nos logs do sistema.

Nota:

v_record representa o registro remoto no qual a operação de inserção, atualização ou exclusão é executada, portanto, nenhuma tabela é atualizada como resultado do uso deste método.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
LastErrorMessage	Cadeia de caracteres	Mensagem de exceção ou erro a ser exibida como o último erro ou exceção no registro da tabela remota. Exibido no formulário ou na exibição de lista e é gravado no log do sistema.

Tabela 2. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir define a mensagem de exceção "Exceção encontrada ao executar a inserção" para exibir durante operações editáveis em um registro de tabela remota:

(function executeInsert(v_record) { 
   try{ 
//add logic to insert the record in the remote table 
   } catch(ex) { 
      v_record.setLastErrorMessage("Exception encountered executing the insert");
   } 
})(v_record); 
(function executeUpdate(v_record, v_changed_fields) { 
   try{
//add logic to update the record in the remote table from the changed fields in 	
// v_changed_fields 
   }catch(ex) { 
      v_record.setLastErrorMessage("Exception encountered executing the update"); 
   } 
})
(v_record, v_changed_fields); 
(function executeDelete(v_record) { 
   try{ 
//add logic to delete the record in the remote table 
   }catch(ex) { 
      v_record.setLastErrorMessage("Exception encountered executing the delete"); 
   } 
})(v_record);

Saída:

"Exception encountered executing the insert"

A saída é a mensagem de exceção que foi definida usando NomeDeLastErrorMessage() quando há uma exceção na operação realizada no sistema remoto (como inserir, atualizar, excluir). Se não houver nenhuma exceção retornada, a operação será considerada um sucesso.