Funzione di inserimento con aggiornamento
Crea e aggiorna i record per gli oggetti specificati e restituisce i risultati al metodo di richiamata specificato.
Versioni (Edition) richieste
| Disponibile nelle versioni: Lightning Experience |
| Disponibile in: Enterprise Edition e Unlimited Edition con licenza aggiuntiva Life Sciences Cloud per Customer Engagement e pacchetto gestito Life Sciences Customer Engagement. |
Questa funzione è supportata solo nell'app mobile Life Sciences Cloud.
È possibile creare o aggiornare oggetti personalizzati e oggetti Customer Engagement di Scienze della vita supportati. Per creare o aggiornare i record:
- L'utente deve disporre delle autorizzazioni Lettura per gli oggetti e i campi specificati.
- Le configurazioni attive della cache dei metadati degli oggetti devono essere create per ogni oggetto e sincronizzate con l'app mobile Life Sciences Cloud.
Sintassi
PresentationPlayer.upsert(objects, callbackMethod)Argomenti
| Argomento | Descrizione |
|---|---|
objects |
Una matrice di oggetti per cui creare o aggiornare i record.
|
callbackMethod |
Nome del metodo JavaScript che riceve il risultato dell'operazione. |
Restituisce
Questa funzione restituisce una matrice di ID dei record nuovi o aggiornati.
Limiti
Questa funzione non può creare o aggiornare record Utente, Tipo di record, Territorio, Territorio2 e AssociazioneUtenteTerritorio2.
Non è possibile utilizzare questa funzione per creare o aggiornare i record correlati. Per aggiornare i record correlati, ad esempio i record in una relazione controllante-controllato, utilizzare due chiamate di funzione.
Esempio
Questo esempio crea record utilizzando il nome dell'oggetto.
<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>Questo esempio aggiorna i record utilizzando gli ID record.
<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>Errori
Questa funzione elabora fino a 15 record alla volta. Se si inviano più di 15 record, si verifica un errore.
Questa funzione può anche restituire errori in caso di errori durante la creazione o l'aggiornamento dei record. Ad esempio, si possono verificare errori quando:
- Le regole di convalida non riescono.
- L'utente non dispone dell'accesso Lettura o Modifica all'oggetto o al campo.
- L'oggetto o il campo non è supportato.
- Si verificano errori di query nel database SQLite.
