retrieveMultipleRecords

Recupera una raccolta di record di tabella.

Disponibile per

App e portali basati su modello.

Sintassi

context.webAPI.retrieveMultipleRecords(entityLogicalName, options, maxPageSize).then(successCallback, errorCallback);

Parametri

Nome	TIPO	Obbligatorio	Description
entityLogicalName	String	Yes	Nome logico della tabella dei record da recuperare. Ad esempio: "account".
options	String	NO	Opzioni di query di sistema OData o query FetchXML per recuperare i dati. Sono supportate le opzioni di query di sistema seguenti: $select, $top, $filter, $expand e $orderby. Per specificare una query FetchXML, usare la fetchXml colonna per specificare la query. NOTA: è necessario usare sempre l'opzione di query di sistema $select per limitare le proprietà restituite per un record di tabella includendo un elenco delimitato da virgole di nomi di proprietà. La limitazione delle colonne recuperate è una procedura consigliata importante per le prestazioni. Se le proprietà non vengono specificate utilizzando $select, verranno restituite tutte le proprietà. È possibile specificare le opzioni di query a partire da ?. È anche possibile specificare più opzioni di query di sistema usando & per separare le opzioni di query.
maxPageSize	Number	NO	Specificare un numero positivo che indica il numero di record di tabella da restituire per pagina. Se non si specifica questo parametro, il valore predefinito viene passato come 5.000. Se il numero di record recuperati è maggiore del valore specificato maxPageSize , nextLink la colonna nell'oggetto promise restituito conterrà un collegamento per recuperare il set successivo di tabelle.
successCallback	Funzione	NO	Funzione da chiamare quando vengono recuperati i record di tabella. Alla funzione viene passato un oggetto con le colonne seguenti: entità: matrice di oggetti JSON, in cui ogni oggetto rappresenta il record di tabella recuperato contenente colonne e i relativi valori come key: value coppie. L'ID del record di tabella viene recuperato per impostazione predefinita. nextLink: String. Se il numero di record recuperati è maggiore del valore specificato nel maxPageSize parametro nella richiesta, questa colonna restituisce l'URL per restituire il set di record successivo.
errorCallback	Funzione	NO	Funzione da chiamare quando l'operazione ha esito negativo.

Valore restituito

Tipo: Promise<RetrieveMultipleResponse>

Descrizione: RetrieveMultipleResponse restituisce una promessa che contiene una matrice di oggetti JSON che contengono i record di tabella recuperati e il parametro nextLink con l'URL che punta al set successivo di record nel caso di paging (maxPageSize) viene specificato nella richiesta e il conteggio dei record restituito supera il valore di paging. Include i parametri seguenti:

parametro	Valore restituito	Description
Entità	Entity[]	Matrice di oggetti JSON, in cui ogni oggetto rappresenta il record di tabella recuperato contenente colonne e i relativi valori.
nextLink	string	Se il numero di record recuperati è maggiore del valore specificato nel parametro 'maxPageSize' nella richiesta, questo parametro restituisce l'URL per restituire il set di record successivo.

Articoli correlati

Web API
Informazioni di riferimento sulle API del framework dei componenti di Power Apps
Panoramica del framework dei componenti di Power Apps