Utilizzare le funzioni di Report Builder con Microsoft Excel

È possibile utilizzare le funzioni di Report Builder per accedere alle funzionalità senza accedere all'interfaccia utente del Report Builder.

Ad esempio, per aggiornare automaticamente le richieste di Report Builder con filtri di input basati sui dati estratti in Excel da altre origini, utilizzare la stringa RefreshRequestsInCellsRange(…) . Tutte le chiamate sono asincrone e vengono restituite immediatamente senza attendere la completa esecuzione.

Requisiti

È necessario specificare Report Builder 5.0 (o versione successiva).

Nella tabella seguente sono elencate le funzioni esposte.

Nome funzione	Tipo	Descrizione
AsyncRefreshAll()	string	Aggiorna tutte le richieste di Report Builder presenti in una cartella di lavoro.
AsyncRefreshRange(string rangeAddressInA1Format)	string	Aggiorna tutte le richieste di Report Builder presenti nell'indirizzo di intervallo di celle specificato (un'espressione stringa che rappresenta un intervallo di celle in formato A1, ad esempio "Foglio1!A2:A10").
AsyncRefreshRangeAltTextParam()	string	Aggiorna tutte le richieste di Report Builder presenti nell'intervallo di celle specificato passato tramite il testo alternativo del controllo Form Ms.
AsyncRefreshActiveWorksheet()	string	Aggiorna tutte le richieste di Report Builder presenti nel foglio di lavoro attivo.
AsyncRefreshWorksheet(string sheetName)	string	Aggiorna tutte le richieste di Report Builder presenti nel foglio di lavoro specificato (il nome del foglio di lavoro visualizzato nella scheda).
AsyncRefreshWorksheetAltTextParam();	string	Aggiorna tutte le richieste di Report Builder presenti nel nome specifico del foglio di lavoro passato tramite il testo alternativo del controllo Ms Form
stringa GetLastRunStatus()	string	Restituisce una stringa che descrive lo stato dell'ultima esecuzione.

Per accedere alle funzioni del Report Builder, vai a Formulas > Insert Function. Utilizzare il campo di ricerca per cercare una funzione o selezionare una categoria per elencare le funzioni in tale categoria.

Schermata che mostra la finestra Inserisci funzione con l'elenco delle categorie espanso.

Esempio

L’esempio seguente mostra Se il valore nella cella P5 è un testo o è vuoto, aggiornare l'intervallo nella cella P9.

=IF(OR(ISTEXT(P5),ISBLANK(P5)),AsyncRefreshRange("P9"),"")

Utilizzare le funzioni di Report Builder con il controllo del formato

È possibile assegnare una macro a un controllo creato e tale controllo può essere una funzione che aggiorna una richiesta di cartella di lavoro. Ad esempio, la funzione AsyncRefreshActiveWorksheet aggiornerà tutte le richieste in un foglio di lavoro. Talvolta, tuttavia, potrebbe essere utile aggiornare solo alcune richieste.

Impostare il parametro della macro.
Fare clic con il pulsante destro del mouse sul controllo e selezionare Assign Macro.
Immettere il nome della funzione di Report Builder (nessun parametro o parentesi).

Schermata che mostra la finestra Assegna macro.

Trasmettere i parametri alle funzioni di Report Builder mediante il controllo del formato

Due funzioni che accettano un parametro possono essere utilizzate con Controllo formato. È necessario utilizzare il Testo alternativo: campo:

AsyncRefreshRange(string rangeAddressInA1Format)
AsyncRefreshWorksheet(string sheetName)

Per passare parametri alle funzioni di Report Builder mediante il controllo del formato

Fare clic con il pulsante destro del mouse sul controllo e selezionare Format Control.
Fai clic sulla scheda Alt Text.
Sotto Alternative text, immettere l'intervallo di celle da aggiornare.
Apre l'elenco dei parametri di Report Builder in Formulas > Insert Function> Adobe.ReportBuilder.Bridge.
Selezionate una delle due funzioni che terminano con AltTextParam e fate clic su OK.