upsert-funktio
Luo ja päivittää tietueita määritetyille objekteille ja palauttaa tuloksia määritetylle callback-metodille.
Vaaditut versiot
| Käytettävissä: Lightning Experiencessa |
| Käytettävissä: Enterprise Edition- ja Unlimited Edition -versioissa Life Sciences Cloudilla, Life Sciences Cloud for Customer Engagement -lisäosalisenssillä ja Life Sciences Customer Engagement -hallitulla paketilla. |
Tätä toimintoa tuetaan vain Life Sciences Cloud -mobiilisovelluksessa.
Voit luoda tai päivittää mukautettuja objekteja ja tuettuja Life Sciences Customer Engagement -objekteja. Tietueiden luominen tai päivittäminen:
- Käyttäjällä täytyy olla määritettyjen objektien ja kenttien lukuoikeudet.
- Aktiiviset objektin metadatan välimuistikokoonpanot täytyy luoda kullekin objektille ja synkronoida Life Sciences Cloud -mobiilisovellukseen.
Syntaksi
PresentationPlayer.upsert(objects, callbackMethod)Argumentit
| Argumentti | Kuvaus |
|---|---|
objects |
Taulukko objekteista, joille tietueita luodaan tai päivitetään.
|
callbackMethod |
Toiminnon tuloksen vastaanottavan JavaScript-metodin nimi. |
Palautukset
Funktio palauttaa uusien tai päivitettyjen tietueiden tunnusten taulukon.
Rajoitukset
Tämä funktio ei voi luoda tai päivittää User-, Tietuetyyppi-, Alue-, Territory2- ja UserTerritory2Association -tietueita.
Et voi käyttää tätä funktiota liittyvien tietueiden luomiseen tai päivittämiseen. Käytä kahta funktiokutsua päivittääksesi asiaan liittyviä tietueita, kuten ylätaso–alataso-suhteen tietueita.
Esimerkki
Tämä esimerkki luo tietueita käyttämällä objektin nimeä.
<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>Tämä esimerkki päivittää tietueita käyttämällä tietueiden tunnuksia.
<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>Virheet
Tämä funktio käsittelee enintään 15 tietuetta kerralla. Jos lähetät yli 15 tietuetta, tapahtuu virhe.
Tämä funktio voi palauttaa virheitä myös, jos tietueiden luomisessa tai päivittämisessä ilmenee virheitä. Virheitä voi ilmetä esimerkiksi, kun:
- Vahvistussäännöt epäonnistuvat.
- Käyttäjällä ei ole objektin tai kentän luku- tai muokkausoikeutta.
- Objektia tai kenttää ei tueta.
- SQLite-tietokannan kyselyiden virheitä tapahtuu.
