v_record : Bereichsbezogen, global

Mit der API v_record können Sie eine Ausnahme- oder Fehlermeldung für einen Remotetabellendatensatz festlegen. Mit Remotetabellen können Sie Daten aus externen Quellen oder aus einer anderen Instanz mit REST- oder SOAP-Services abrufen.

Diese API wird überall dort ausgeführt, wo GlideRecord-Erstellungs-, Aktualisierungs- und Löschmethoden in einem Skript ohne Änderungen an Arbeitsbereichen oder Listen und Formularen verwendet werden.

Für diese API muss das Plugin „Remotetabellen“ (com.glide.script.vtable) aktiviert sein. Weitere Informationen finden Sie unter Create script definitions for a remote table.

Verwenden Sie v_record mit dem skriptfähigen Objekt v_query: Bereichsbezogen, global, um Remotetabellen abzufragen, und der API v_table: Bereichsbezogen, global, um Remotetabellen zu erstellen.

v_record – setLastErrorMessage(String lastErrorMessage)

Legt eine Ausnahme- oder Fehlermeldung fest, die während bearbeitbarer Vorgänge für einen Remotetabellendatensatz im Formular oder in der Listenansicht und in Systemprotokollen angezeigt wird.

Hinweis:

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

Tabelle : 1. Parameter

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

Tabelle : 2. Rückgaben

Typ	Beschreibung
Keine

Im folgenden Beispiel wird die Ausnahmemeldung „Ausnahme beim Ausführen der Einfügung gefunden“ während bearbeitbarer Vorgänge für einen Remote-Tabellendatensatz angezeigt:

(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 „setLastErrorMessage()“ festgelegt wurde, wenn bei dem 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 erfolgreich betrachtet.