Sie befinden sich hier:
upsert-Funktion
Erstellt und aktualisiert Datensätze für die angegebenen Objekte und gibt Ergebnisse an die angegebene Rückmeldungsmethode zurück.
Erforderliche Editionen
| Verfügbarkeit: Lightning Experience |
| Verfügbarkeit: Enterprise und Unlimited Edition mit Life Sciences Cloud, der Add-On-Lizenz "Life Sciences Cloud für Kundenengagement" und dem verwalteten Paket "Life Sciences Customer Engagement". |
Diese Funktion wird nur in der mobilen Life Sciences Cloud-Anwendung unterstützt.
Sie können benutzerdefinierte Objekte und unterstützte Life Sciences-Objekte vom Typ "Kundenengagement" erstellen oder aktualisieren. Erstellen oder Aktualisieren von Datensätzen:
- Der Benutzer muss über Leseberechtigungen für die angegebenen Objekte und Felder verfügen.
- Für jedes Objekt müssen Konfigurationen für den aktiven Objekt-Metadaten-Cache erstellt und mit der mobilen Life Sciences Cloud-Anwendung synchronisiert werden.
Syntax
PresentationPlayer.upsert(objects, callbackMethod)Argumente
| Argument | Beschreibung |
|---|---|
objects |
Ein Array von Objekten, für die Datensätze erstellt oder aktualisiert werden sollen.
|
callbackMethod |
Der Name der JavaScript-Methode, die das Ergebnis des Vorgangs empfängt. |
Rückgaben
Diese Funktion gibt ein Array von IDs der neuen oder aktualisierten Datensätze zurück.
Einschränkungen
Diese Funktion kann keine Benutzer-, Datensatztyp-, Regions-, Region2- und UserTerritory2Association-Datensätze erstellen oder aktualisieren.
Sie können diese Funktion nicht zum Erstellen oder Aktualisieren verwandter Datensätze verwenden. Verwenden Sie zwei Funktionsaufrufe, um verwandte Datensätze zu aktualisieren, beispielsweise Datensätze in einer Über-/Unterordnungsbeziehung.
Beispiel
In diesem Beispiel werden Datensätze mithilfe des Objektnamens erstellt.
<body>
<input id="name" style="color: black;">
<input id="customField" style="color: black;">
<a href="javascript:save();">Save Record</a>
</body>
<script type="text/javascript">
function save() {
let name = document.getElementById("name").value;
let customField= document.getElementById("customField").value;
PresentationPlayer.upsert([{
'sobject': 'Account',
'name': name,
'customField__c': customField
}], 'upsertCallbackMethod');
}
function upsertCallbackMethod(data) {
console.log(data);
PresentationPlayer.alert(JSON.stringify(data));
}
</script>In diesem Beispiel werden Datensätze mithilfe von Datensatz-IDs aktualisiert.
<script type="text/javascript">
function save() {
let name = document.getElementById("name").value;
let customField= document.getElementById("customField").value;
let accountId = allData.customers[0].Id;
PresentationPlayer.upsert([{
'sobject': 'Account',
'id': accountId,
'name': name,
'customField__c': customField
}], 'upsertCallbackMethod');
}
function upsertCallbackMethod(data) {
if (data.state === 'success') {
console.log(data);
PresentationPlayer.alert(JSON.stringify(data));
} else {
PresentationPlayer.alert(data.message + '\n' + data.code);
}
}
</script>Fehler
Diese Funktion verarbeitet bis zu 15 Datensätze gleichzeitig. Wenn Sie mehr als 15 Datensätze senden, tritt ein Fehler auf.
Diese Funktion kann auch Fehler zurückgeben, wenn beim Erstellen oder Aktualisieren von Datensätzen Fehler auftreten. Fehler können beispielsweise in folgenden Fällen auftreten:
- Validierungsregeln schlagen fehl.
- Der Benutzer hat keinen Lese- oder Bearbeitungszugriff auf das Objekt oder Feld.
- Das Objekt oder Feld wird nicht unterstützt.
- SQLite-Datenbankabfragefehler treten auf.
