Report Builder-Funktionen über Microsoft Excel-Funktionen aufrufen

Dank dieser Funktion wird die Report Builder-Verwendung in den normalen Excel-Workflow integriert, ohne dass Sie auf die Report Builder-Benutzeroberfläche zugreifen müssen.

Sie können beispielsweise Report Builder-Anforderungen automatisch aktualisieren, deren Eingabefilter auf Daten basieren, die in Excel aus anderen Quellen abgerufen wurden. Genau dies können Sie mithilfe der Zeichenfolgenfunktion RefreshRequestsInCellsRange(…) durchführen. Alle Aufrufe sind asynchron. Sie werden sofort zurückgegeben und warten nicht, bis ein Aufruf vollständig ausgeführt wird.

HINWEIS

Damit dies funktioniert, muss Report Builder 5.0 (oder höher) installiert sein.

In der nachfolgenden Tabelle sind alle exponierten Funktionen aufgelistet.

Name der Funktion	Beschreibung
string AsyncRefreshAll()	Aktualisiert alle in einer Arbeitsmappe vorhandenen Report Builder-Anforderungen.
string AsyncRefreshRange(string rangeAddressInA1Format)	Aktualisiert alle Report Builder-Anforderungen in der angegebenen Zellenbereichsadresse (ein Zeichenfolgenausdruck, der einen Zellenbereich im A1-Format darstellt, z. B. „Sheet1!A2:A10“).
string AsyncRefreshRangeAltTextParam()	Aktualisiert alle Report Builder-Anforderungen, die im angegebenen, über den Alternativtext des MS-Formularsteuerelements weitergeleiteten Zellenbereich vorhanden sind.
string AsyncRefreshActiveWorksheet()	Aktualisiert alle im aktiven Arbeitsblatt vorhandenen Report Builder-Anforderungen.
string AsyncRefreshWorksheet(string worksheetName)	Aktualisiert alle im angegebenen Arbeitsblatt vorhandenen Report Builder-Anforderungen (der Arbeitsblattname, wie er auf der Registerkarte angezeigt wird.)
string AsyncRefreshWorksheetAltTextParam();	Aktualisiert alle Report Builder-Anforderungen, die im angegebenen, über den Alternativtext des MS-Formularsteuerelements weitergeleiteten Arbeitsblattnamen vorhanden sind.
string GetLastRunStatus()	Gibt eine Zeichenfolge zurück, die den Status der letzten Ausführung beschreibt.

Um auf diese Funktionen innerhalb von ReportBuilder zuzugreifen, wechseln Sie zu Formeln > Funktion einfügen. Am Ende der Kategorienliste finden Sie Adobe.ReportBuilder.Bridge:

Verwenden dieser Funktionen in einer Formel

Beispiel: Die Formel

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

bedeutet: „Wenn die Zelle P5 Text enthält oder leer ist, aktualisieren Sie den Bereich der Zelle P9.“

Verwenden von Report Builder-Funktionen mit „Steuerelement formatieren“

Ab sofort können Sie einem Steuerelement, das Sie erstellt haben, ein Makro zuweisen. Dieses Steuerelement kann eine Funktion sein, die eine Arbeitsmappenanforderung aktualisiert. Beispielsweise werden mit der Funktion AsyncRefreshActiveWorksheet alle Anforderungen in einem Arbeitsblatt aktualisiert. Manchmal möchten Sie jedoch vielleicht nur bestimmte Anforderungen und nicht alle aktualisieren.

Legen Sie den Makro-Parameter fest.
Klicken Sie mit der rechten Maustaste auf das Steuerelement und wählen Sie Makro zuweisen aus.
Geben Sie den ReportBuilder-Funktionsnamen ein (ohne Parameter und Klammern).

Weiterleiten von Parametern zu Report Builder-Funktionen über „Steuerelement formatieren“

Die beiden Funktionen, die einen Parameter annehmen, können mit „Steuerelement formatieren“ verwendet werden, jedoch nur über das Feld für Alternativtext:

AsyncRefreshRange(string rangeAddressInA1Format)
AsyncRefreshWorksheet(string worksheetName)

Klicken Sie mit der rechten Maustaste auf das Steuerelement und wählen Sie Steuerelement formatieren aus.
Klicken Sie auf die Registerkarte Alt-Text.
Geben Sie unter Alternativtext den Zellenbereich ein, der aktualisiert werden soll.
Öffnen Sie unter Formeln > Funktion einfügen > Adobe.ReportBuilder.Bridge die Liste der Report Builder-Parameter.
Wählen Sie eine der beiden Funktionen aus, die auf AltTextParam enden, und klicken Sie auf OK.