v_record : incluse dans le périmètre, globale

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • L’API v_record vous permet de définir une exception ou un message d’erreur sur un enregistrement de table distante. Les tables distantes vous permettent de récupérer des données à partir de sources externes ou d’une autre instance avec des services REST ou SOAP.

    Cette API s’exécute partout où des méthodes de création, de mise à jour et de suppression GlideRecord sont utilisées dans un script sans aucune modification apportée aux espaces de travail ou aux listes et formulaires.

    Cette API nécessite l’activation du module d’extension Tables distantes (com.glide.script.vtable). Pour en savoir plus, consultez Create script definitions for a remote table.

    Utilisez v_record avec l’objet scriptable pour interroger les v_query : incluse dans le périmètre, globale tables distantes et l’API v_table : incluse dans le périmètre, globale pour créer des tables distantes.

    v_record : setLastErrorMessage(Chaîne lastErrorMessage)

    Définit une exception ou un message d’erreur à afficher pendant les opérations modifiables sur un enregistrement de table distante dans la vue de formulaire ou de liste, et dans les journaux système.

    Remarque :
    v_record représente l’enregistrement distant sur lequel l’opération d’insertion, de mise à jour ou de suppression est exécutée. Par conséquent, aucune table n’est mise à jour à la suite de l’utilisation de cette méthode.
    Tableau 1. Paramètres
    Nom Type Description
    lastErrorMessage Chaîne Message d’exception ou d’erreur à afficher en tant que dernière erreur ou exception dans l’enregistrement de table distante. S’affiche dans la vue de formulaire ou de liste et est écrit dans le journal système.
    Tableau 2. Renvoie
    Type Description
    Néant

    L’exemple suivant définit le message d’exception « Exception rencontrée lors de l’exécution de l’insertion » à afficher pendant les opérations modifiables sur un enregistrement de table distante :

    (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);

    Sortie :

    "Exception encountered executing the insert"

    La sortie est le message d’exception défini à l’aide de setLastErrorMessage() lorsqu’il existe une exception dans l’opération exécutée sur le système distant (telle que l’insertion, la mise à jour, la suppression). Si aucune exception n’est renvoyée, l’opération est considérée comme réussie.