v_record : Inclus dans le champ d’application, global

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 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 distant. Les tables distantes vous permettent de récupérer des données à partir de sources externes ou d’une autre instance avec les 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 – Inclus dans le champ d’application, global tables distantes et l’API v_table : Inclus dans le champ d’application, global pour créer des tables distantes.

    v_record : setLastErrorMessage(String lastErrorMessage)

    Définit un message d’exception ou 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
    Aucun

    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 qui a été défini à l’aide de setLastErrorMessage() lorsqu’il y a une exception dans l’opération exécutée sur le système distant (telle que insérer, mettre à jour, supprimer). Si aucune exception n’est renvoyée, l’opération est considérée comme réussie.