Sie befinden sich hier:
Funktion fetchWithParams
Fragt Daten ab, die nicht bereits in Mustache Variablen zurückgegeben wurden, 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". |
Sie können die Objekte "Benutzer", "Account", "Datensatztyp", "Region2", "UserTerritory2Association", "Biowissenschaften" und "Benutzerdefinierte Objekte" abfragen. Abfragen von Datensätzen:
- Der Benutzer muss über die Berechtigung "Lesen" für die abgefragten Objekte und Felder verfügen.
- Für jedes Objekt müssen Konfigurationen für den aktiven Objekt-Metadaten-Cache vorhanden sein und mit der mobilen Life Sciences Cloud-Anwendung synchronisiert werden.
Syntax
PresentationPlayer.fetchWithParams(query, params, callbackMethod)Argumente
| Argument | Beschreibung |
|---|---|
query |
Die SOQL-Abfrage als Zeichenfolge oder der Abfrage-Locator-Wert für nachfolgende Abrufe. Sie können Mustache-Variablen in Abfragen einschließen. Geben Sie im Parameter
Die WHERE-Klausel unterstützt Folgendes:
|
params |
Optional. Die Möglichkeit, die Batchgröße anzugeben. Verwenden Sie im Argument Jeder Anruf kann maximal 100 Datensätze zurückgeben. |
callbackMethod |
Der Name der JavaScript-Methode, die die Abfrageergebnisse empfängt. |
Rückgaben
Diese Funktion gibt ein JSON-Ergebnis zurück.
| Feldname | Typ | Beschreibung |
|---|---|---|
records |
Array<Object> | Die Ergebnisdaten. |
done |
Boolean (Boolesch) | Gibt an, ob alle Daten abgefragt wurden (true) oder nicht (false). |
totalSize |
Ganzzahl | Die Gesamtanzahl der in der Abfrage verarbeiteten Datensätze. |
queryLocator |
Zeichenfolge | Eine eindeutige SQL-Kennung, die bei künftigen Anforderungen verwendet werden kann. |
state |
Zeichenfolge | Der Anforderungsstatus, beispielsweise Erfolg oder Fehler. |
Verwendung
Unabhängig von der Batchgröße können Abfragen maximal 100 Datensätze zurückgeben. In diesem Beispiel wird die Batchgröße auf 75 Datensätze festgelegt.
PresentationPlayer.fetchWithParams('SELECT FirstName, LastName, Name, Email, Phone, Username FROM User WHERE Id = ' + userId', {'batchSize': 75}, getCurrentUserRecordCallback');Wenn Sie die Batchgröße nicht angeben, fragt die fetchWithParams standardmäßig 15 Datensätze ab. Verwenden Sie die Variable queryLocator, um bei Verwendung kleinerer Batches zusätzliche Datensätze abzufragen.
In diesem Beispiel wird die Variable queryLocator verwendet.
function getAccounts() {
PresentationPlayer.fetchWithParams('SELECT Id FROM Account', {'batchSize': 15}, 'getAccountsCallback');
// Return 15 records
}
function getAccountsCallback(data) {
// Process records
PresentationPlayer.fetchWithParams(data.queryLocator, 'getAccountsCallback');
}Beispiel
<script type="text/javascript">
var configData;
document.addEventListener('PresentationDOMContentLoaded', function(event) => {
configData = event.data;
function getCurrentUserRecord() {
let userId = ' \' ' + configData.parameters.id + ' \' ';
PresentationPlayer.fetchWithParams('SELECT FirstName, LastName, Name, Email, Phone, Username FROM User WHERE Id = ' + userId, {'batchSize': 75},
'getCurrentUserRecordCallback');
}
function getCurrentUserRecordCallback(data) {
if (data.state === 'success') {
const html = data.records.map((el)=>{
console.log('User Name: ', el.Name);
console.log('User Email: ', el.Email);
});
} else {
PresentationPlayer.alert(data.message + '\n' + data.code);
}
}
</script>Fehler
Diese Funktion gibt in folgenden Fällen einen Fehler zurück:
- Die Abfrage kann nicht auf einen Datensatz zugreifen oder ihn finden.
- Es tritt ein SQL-Fehler auf.
