Vous êtes ici :
Fonction fetchWithParams
Interroge les données qui ne sont pas déjà renvoyées dans les variables Mustache et renvoie les résultats à la méthode de rappel spécifiée.
Éditions requises
| Disponible avec : Lightning Experience |
| Disponible avec : les éditions Enterprise et Unlimited avec Life Sciences Cloud, la licence complémentaire Life Sciences Cloud pour Customer Engagement et le package géré Life Sciences Customer Engagement. |
Vous pouvez interroger les objets Utilisateur, Compte, Type d'enregistrement, Territoire2, UserTerritory2Association, Sciences de la vie et objets personnalisés. Pour interroger des enregistrements :
- Attribuez à l'utilisateur les autorisations Lire sur les objets et les champs interrogés.
- Créez des configurations de cache de métadonnées d'objet actif existent pour chaque objet et synchronisez-les avec l'application mobile Life Sciences Cloud.
Syntaxe
PresentationPlayer.fetchWithParams(query, params, callbackMethod)Arguments
| Argument | Description |
|---|---|
query |
La requête SOQL en tant que chaîne ou la valeur du localisateur de requête pour les récupérations suivantes. Vous pouvez inclure des variables Mustache dans des requêtes. Dans le paramètre
La clause WHERE prend en charge :
|
params |
Facultatif. La possibilité de spécifier la taille du lot. Dans l'argument Chaque appel peut renvoyer jusqu'à 100 enregistrements. |
callbackMethod |
Le nom de la méthode JavaScript qui reçoit les résultats de la requête. |
Retours
Cette fonction renvoie un résultat JSON.
| Nom du champ | Type | Description |
|---|---|---|
records |
Array<Object> | Les données du résultat. |
done |
Booléen | Indique si toutes les données ont été interrogées (true) ou non (false). |
totalSize |
Nombre entier | Le nombre total d'enregistrements traités dans la requête. |
queryLocator |
Chaîne | Un identifiant SQL unique qui peut être utilisé dans de futures requêtes. |
state |
Chaîne | Le statut de la requête, par exemple réussite ou erreur. |
Utilisation
Quelle que soit la taille du lot, les requêtes peuvent renvoyer jusqu'à 100 enregistrements. Cet exemple définit la taille du lot sur 75 enregistrements.
PresentationPlayer.fetchWithParams('SELECT FirstName, LastName, Name, Email, Phone, Username FROM User WHERE Id = ' + userId', {'batchSize': 75}, getCurrentUserRecordCallback');Si vous ne spécifiez pas la taille du lot, la fonction de fetchWithParams interroge 15 enregistrements par défaut. Pour interroger des enregistrements supplémentaires en utilisant des tailles de lot plus petites, utilisez la variable queryLocator.
Cet exemple utilise la variable queryLocator.
function getAccounts() {
PresentationPlayer.fetchWithParams('SELECT Id FROM Account', {'batchSize': 15}, 'getAccountsCallback');
// Return 15 records
}
function getAccountsCallback(data) {
// Process records
PresentationPlayer.fetchWithParams(data.queryLocator, 'getAccountsCallback');
}Exemple
<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>Erreurs
Cette fonction renvoie une erreur lorsque :
- La requête ne peut pas accéder à ni trouver un enregistrement.
- Une erreur SQL se produit.
