v_Record – Umfang, Global

Die v_Record Mit der API können Sie eine Ausnahme oder Fehlermeldung für einen Remote-Tabellendatensatz festlegen. Mit Remote-Tabellen können Sie Daten aus externen Quellen oder aus einer anderen Instanz mit REST- oder SOAP-Services abrufen.

Diese API wird überall ausgeführt, wo GlideRecord-Methoden zum Erstellen, Aktualisieren und Löschen in einem Skript ohne Änderungen an Arbeitsbereichen oder Listen und Formularen verwendet werden.

Diese API erfordert die Aktivierung des Plugins „Remote-Tabellen“ (com.Glide.script.vtable). Weitere Informationen finden Sie unter Create script definitions for a remote table.

Verwenden v_Record Mit v_query: Bereichsbezogen, Global Skriptfähiges Objekt zum Abfragen von Remote-Tabellen und v_table: Bereichsbezogen, Global API zum Erstellen von Remotetabellen.

v_RECORD – setLastErrorMessage(Zeichenfolge lastErrorMessage)

Legt eine Ausnahme oder Fehlermeldung fest, die während bearbeitbarer Vorgänge in einem Remote-Tabellendatensatz in der Formular- oder Listenansicht und in Systemprotokollen angezeigt wird.

Hinweis:

v_RECORD stellt den Remote-Datensatz dar, für den der Einfüge-, Update- oder Löschvorgang ausgeführt wird. Daher werden aufgrund der Verwendung dieser Methode keine Tabellen aktualisiert.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
LastErrorMessage	Zeichenfolge	Ausnahme oder Fehlermeldung, die als letzter Fehler oder letzte Ausnahme im Datensatz der Remote-Tabelle angezeigt werden soll. Wird im Formular oder in der Listenansicht angezeigt und wird in das Systemprotokoll geschrieben.

Tabelle : 2. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel legt fest, dass die Ausnahmemeldung „Ausnahme beim Ausführen des Einfügens aufgetreten“ während bearbeitbarer Vorgänge in einem Remote-Tabellendatensatz angezeigt wird:

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

Ausgabe:

"Exception encountered executing the insert"

Die Ausgabe ist die Ausnahmemeldung, die mit festgelegt wurde SetLastErrorMessage() Wenn beim auf dem Remote-System ausgeführten Vorgang eine Ausnahme auftritt (z. B. Einfügen, Aktualisieren, Löschen). Wenn keine Ausnahme zurückgegeben wird, wird der Vorgang als Erfolg betrachtet.