Função fetchWithParams
Consulta dados que ainda não foram retornados nas variáveis Mustache e retorna resultados para o método de retorno de chamada especificado.
Edições obrigatórias
| Disponível em: Lightning Experience |
| Disponível em: Edições Enterprise e Unlimited com a licença Life Sciences Cloud, o complemento Life Sciences Cloud para Engajamento do cliente e o pacote gerenciado Engajamento do cliente Life Sciences. |
Você pode consultar os objetos Usuário, Conta, Tipo de registro, Território2, UserTerritory2Association, Ciências biológicas e objetos personalizados. Para consultar registros:
- O usuário deve ter a permissão Ler nos objetos e campos consultados.
- Configurações de cache de metadados de objeto ativo devem existir para cada objeto e devem ser sincronizadas com o aplicativo móvel Life Sciences Cloud.
Sintaxe
PresentationPlayer.fetchWithParams(query, params, callbackMethod)Argumentos
| Argumento | Descrição |
|---|---|
query |
A consulta SOQL como uma string ou o valor do localizador de consulta para busca subsequente. Você pode incluir variáveis Mustache nas consultas. No parâmetro
A cláusula WHERE oferece suporte a:
|
params |
Opcional. A capacidade de especificar o tamanho do lote. No argumento Cada chamada pode retornar no máximo 100 registros. |
callbackMethod |
O nome do método JavaScript que recebe os resultados da consulta. |
Retorna
Essa função retorna um resultado JSON.
| Nome do campo | Tipo | Descrição |
|---|---|---|
records |
Array<Object> | Os dados do resultado. |
done |
Booleano | Indica se todos os dados foram consultados (true) ou não (false). |
totalSize |
Inteiro | O número total de registros processados na consulta. |
queryLocator |
String | Um identificador SQL exclusivo que pode ser usado em solicitações futuras. |
state |
String | O status da solicitação, como sucesso ou erro. |
Uso
Independentemente do tamanho do lote, as consultas podem retornar no máximo 100 registros. Este exemplo define o tamanho do lote como 75 registros.
PresentationPlayer.fetchWithParams('SELECT FirstName, LastName, Name, Email, Phone, Username FROM User WHERE Id = ' + userId', {'batchSize': 75}, getCurrentUserRecordCallback');Se você não especificar o tamanho do lote, a função fetchWithParams consultará 15 registros por padrão. Para consultar registros adicionais ao usar tamanhos de lote menores, use a variável queryLocator.
Este exemplo usa a variável 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');
}Exemplo
<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>Erros
Essa função retorna um erro quando:
- A consulta não pode acessar nem localizar um registro.
- Ocorre um erro de SQL.
