Appel de la fonctionnalité Report Builder depuis les fonctions Microsoft Excel

Cette fonctionnalité intègre un peu plus l’utilisation du Report Builder dans le processus Excel naturel, sans nécessiter d’accéder à l’interface utilisateur du Report Builder.

Par exemple, vous souhaitez peut-être actualiser automatiquement les requêtes du Report Builder dont le filtre d’entrée est basé sur des données extraites d’Excel provenant d’autres sources. Vous pouvez effectuer cette opération à l’aide de la fonction string RefreshRequestsInCellsRange(…) . Tous les appels sont asynchrones. Ils renvoient immédiatement et n’attendent pas un appel pour s’exécuter entièrement.

REMARQUE

La version 5.0 (ou supérieure) du Report Builder doit être installée pour que cette fonctionnalité fonctionne.

Vous trouverez ci-dessous un tableau comportant la liste des fonctions présentées :

Nom de la fonction	Description
string AsyncRefreshAll()	Actualise toutes les requêtes du Report Builder présentes dans un classeur.
string AsyncRefreshRange(string rangeAddressInA1Format)	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 »).
string AsyncRefreshRangeAltTextParam()	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.
string AsyncRefreshActiveWorksheet()	Actualise toutes les requêtes du Report Builder présentes dans la feuille de calcul active.
string AsyncRefreshWorksheet(string worksheetName)	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).
string AsyncRefreshWorksheetAltTextParam();	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.
string GetLastRunStatus()	Renvoie une chaîne qui décrit l’état de l’exécution la plus récente.

Pour accéder à ces fonctions dans le Créateur de rapports, accédez à Formules > Insérer fonction. Dans la partie inférieure de la liste de catégories, vous trouverez Adobe.ReportBuilder.Bridge :

Utilisation de ces fonctions dans une formule

Par exemple, la formule

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

indique « Si la cellule P5 contient du texte ou est vierge, actualisez la plage se trouvant dans la cellule P9. »

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

Vous pouvez à présent affecter une macro à un contrôle que vous avez créé et ce dernier 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. Parfois, néanmoins, vous souhaitez n’actualiser que certaines requêtes, pas toutes.

Définissez le paramètre de macro.
Cliquez avec le bouton droit et sélectionnez Affecter une macro.
Saisissez le nom de la fonction du Créateur de rapports (sans paramètre ou parenthèse).

Transfert de paramètres aux fonctions du Report Builder par l’intermédiaire du format de contrôle

Les deux fonctions qui utilisent un paramètre peuvent être utilisées avec le format de contrôle mais uniquement par l’intermédiaire du champ Texte de remplacement :

AsyncRefreshRange(string rangeAddressInA1Format)
AsyncRefreshWorksheet(string worksheetName)

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 du Créateur de rapports sous Formules > Insérer fonction > Adobe.ReportBuilder.Bridge.
Sélectionnez une des deux fonctions qui se terminent par AltTextParam et cliquez sur OK.