v_record - com escopo, global

A API v_record 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 de GlideRecord são usados em um script sem mudanças nos espaços ou nas 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.

Use v_record com o objeto programável v_query - com escopo, global para consultar tabelas remotas e a API v_table – Scoped, Global 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 no formulário ou exibição de lista e em 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	Exceção ou mensagem de 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" a ser exibida durante as 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 setLastErrorMessage() quando há uma exceção na operação executada no sistema remoto (como inserir, atualizar, excluir). Se nenhuma exceção for retornada, a operação será considerada um sucesso.