Utilisation de fonctions de Report Builder avec Microsoft Excel

Vous pouvez utiliser des fonctions de Report Builder pour accéder à la fonctionnalité sans accéder à l’interface utilisateur de Report Builder.

Par exemple, pour actualiser automatiquement les requêtes de Report Builder avec des filtres d’entrée basés sur des données extraites d’Excel à partir d’autres sources, utilisez la chaîne RefreshRequestsInCellsRange(…) . Tous les appels sont asynchrones et renvoient immédiatement et n’attendent pas de s’exécuter complètement.

Configuration requise

Report Builder 5.0 (ou version ultérieure) est requis.

Le tableau suivant répertorie les fonctions exposées.

Nom de la fonction	Type	Description
AsyncRefreshAll()	string	Actualise toutes les requêtes du Report Builder présentes dans un classeur.
AsyncRefreshRange(string rangeAddressInA1Format)	string	Actualise toutes les requêtes du Report Builder présentes dans l’adresse de plage de cellules spécifiée (une expression string représentant une plage de cellules au format A1, par exemple « Sheet1!A2:A10 »).
AsyncRefreshRangeAltTextParam()	string	Actualise toutes les requêtes du Report Builder présentes dans la plage de cellules spécifiée qui est transférée par l’intermédiaire du Texte de remplacement du Contrôle de formulaire MS.
AsyncRefreshActiveWorksheet()	string	Actualise toutes les requêtes du Report Builder présentes dans la feuille de calcul active.
AsyncRefreshWorksheet(string worksheetName)	string	Actualise toutes les requêtes du Report Builder présentes dans la feuille de calcul indiquée (le nom de la feuille de calcul tel qu’il s’affiche dans l’onglet).
AsyncRefreshWorksheetAltTextParam();	string	Actualise toutes les requêtes du Report Builder présentes dans le nom de feuille de calcul spécifique qui a été transféré par l’intermédiaire du Texte de remplacement du Contrôle de formulaire MS.
tring GetLastRunStatus()	string	Renvoie une chaîne qui décrit l’état de l’exécution la plus récente.

Pour accéder aux fonctions de Report Builder, accédez à Formules > Insérer une fonction. Utilisez le champ de recherche pour rechercher une fonction ou sélectionnez une catégorie afin de répertorier les fonctions de cette catégorie.

Capture d’écran montrant la fenêtre Insérer une fonction avec la liste de catégories développée.

Exemple

L’exemple suivant illustre Si la valeur de la cellule P5 est textuelle ou est vide, actualisez la plage qui se trouve dans la cellule P9..

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

Utilisation des fonctions du Report Builder avec le format de contrôle

Vous pouvez affecter une macro à un contrôle que vous avez créé et ce contrôle peut être une fonction qui actualise une requête de classeur. Par exemple, la fonction AsyncRefreshActiveWorksheet actualise toutes les requêtes d’une feuille de calcul. Cependant, il peut arriver que vous souhaitiez actualiser uniquement certaines requêtes.

Définissez le paramètre de macro.
Cliquez avec le bouton droit et sélectionnez Affecter une macro.
Saisissez le nom de la fonction de Report Builder (pas de paramètres ni de parenthèses).

Capture d’écran de la fenêtre Attribuer une macro .

Transfert de paramètres à des fonctions de Report Builder à l’aide de la commande de format

Deux fonctions qui utilisent un paramètre peuvent être utilisées avec la commande Format. Vous devez utiliser la variable Texte de remplacement : field :

AsyncRefreshRange(string rangeAddressInA1Format)
AsyncRefreshWorksheet(string worksheetName)

Transfert de paramètres à des fonctions de Report Builder à l’aide de la commande de format

Cliquez avec le bouton droit et sélectionnez Format de contrôle.
Cliquez sur l’onglet Texte de remplacement.
Sous Texte de remplacement, saisissez la plage de cellules que vous souhaitez actualiser.
Ouvrez la liste des paramètres de Report Builder sous Formules > Insérer une fonction> Adobe.ReportBuilder.Bridge.
Sélectionnez une des deux fonctions qui se terminent par AltTextParam et cliquez sur OK.