Functie fetchWithParams
Voert een query uit op gegevens die nog niet zijn geretourneerd in Mustache variabelen en retourneert resultaten naar de opgegeven callback-methode.
Vereiste editions
| Beschikbaar in: Lightning Experience |
| Beschikbaar in: Enterprise en Unlimited Edition met Life Sciences Cloud, Life Sciences Cloud voor Customer Engagement Add-on-licentie en het beheerde pakket Life Sciences Customer Engagement. |
U kunt een query uitvoeren op de objecten Gebruiker, Account, Recordtype, Territorium2, UserTerritory2Association, Life Sciences en aangepaste objecten. Een query uitvoeren op records:
- De gebruiker moet de machtiging Lezen hebben voor de objecten en velden waarop de query betrekking heeft.
- Cacheconfiguraties van actieve metagegevens voor objecten moeten bestaan voor elk object en moeten worden gesynchroniseerd met de mobiele app Life Sciences Cloud.
Syntaxis
PresentationPlayer.fetchWithParams(query, params, callbackMethod)Argumenten
| Argument | Beschrijving |
|---|---|
query |
De SOQL-query als een tekenreeks of de querylocatorwaarde voor daaropvolgende ophaalacties. U kunt Mustache variabelen opnemen in query's. Geef in de parameter
De WHERE-clausule ondersteunt:
|
params |
Optioneel. De mogelijkheid om de batchgrootte op te geven. Gebruik in het argument Elk gesprek kan maximaal 100 records retourneren. |
callbackMethod |
De naam van de JavaScript-methode die de queryresultaten ontvangt. |
Geeft als resultaat
Deze functie retourneert een JSON-resultaat.
| Veldnaam | Type | Beschrijving |
|---|---|---|
records |
Array<Object> | De resultaatgegevens. |
done |
Booleaans | Geeft aan of op alle gegevens een query is uitgevoerd (true) of niet (false). |
totalSize |
Geheel getal | Het totale aantal records dat in de query is verwerkt. |
queryLocator |
Tekenreeks | Een unieke SQL-identifier die kan worden gebruikt in toekomstige verzoeken. |
state |
Tekenreeks | De status van het verzoek, zoals geslaagd of fout. |
Gebruik
Ongeacht de batchgrootte kunnen query's maximaal 100 records retourneren. In dit voorbeeld wordt de batchgrootte ingesteld op 75 records.
PresentationPlayer.fetchWithParams('SELECT FirstName, LastName, Name, Email, Phone, Username FROM User WHERE Id = ' + userId', {'batchSize': 75}, getCurrentUserRecordCallback');Als u de batchgrootte niet opgeeft, voert de fetchWithParams standaard een query uit op 15 records. Gebruik voor het uitvoeren van query's op extra records bij gebruik van kleinere batchgrootten de variabele queryLocator.
In dit voorbeeld wordt de variabele queryLocator gebruikt.
function getAccounts() {
PresentationPlayer.fetchWithParams('SELECT Id FROM Account', {'batchSize': 15}, 'getAccountsCallback');
// Return 15 records
}
function getAccountsCallback(data) {
// Process records
PresentationPlayer.fetchWithParams(data.queryLocator, 'getAccountsCallback');
}Voorbeeld
<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>Fouten
Deze functie retourneert een fout wanneer:
- De query kan geen record openen of vinden.
- Er treedt een SQL-fout op.
