Crystal Reports und Jitterbit App Builder

Übersicht

App Builder unterstützt die Möglichkeit, von SAP Crystal Reports erstellte Berichte zu Seiten in Anwendungen hinzuzufügen. Um diese Crystal Reports zu nutzen, beschreibt dieser Artikel, was Sie benötigen, je nachdem, ob Sie die Berichte einfach nur anzeigen oder erstellen und ändern möchten.

Voraussetzungen

• App Builder erfordert eine Installation der Crystal Reports Laufzeit auf dem App-Server
• Crystal Reports SP21 ist das Minimum für App Builder, und SP21-SP32 werden unterstützt

Aktivieren von Crystal Reports

Auf Windows-Systemen App Builder unterstützt Crystal Reports. Crystal Reports wird prozessextern auf einem COM-Server gehostet. Führen Sie die folgenden Schritte aus, um den Crystal Reports COM-Server zu registrieren.

1. Starten Sie Windows PowerShell als Administrator.
2. Wechseln Sie in das Verzeichnis Scripts unter dem App Builder Installationsverzeichnis.
3. Führen Sie die Datei RegisterCrystalReports.ps1 aus Script.

> cd C:\inetpub\wwwroot\App Builder\Scripts
> .\RegisterCrystalReports.ps1

Konfigurieren Sie Crystal Reports zum Bearbeiten und Erstellen von Berichten

Wenn Sie einen Crystal Report bearbeiten und/oder erstellen möchten, der von App Builder, benötigen Sie eine lizenzierte Version von SAP Crystal Reports oder Zugriff auf eine kostenlose Testversion. Crystal Reports ist eine Business-Intelligence-Anwendung und wird verwendet, um pixelgenaue, leistungsstarke, formatierte und dynamische Berichte aus nahezu jeder Datenquelle zu erstellen.

Informationen zu Anforderungen, Installation, Fehlerbehebung und Verwendung von Crystal Reports finden Sie unter SAP Crystal Reports-Website.

Weitere Informationen zu Crystal Reports oder eine lizenzierte Version finden Sie unter https://www.sap.com/products/technology-platform/crystal-reports.html

Konfigurieren des Crystal Reports Treiber zum Anzeigen von Berichten

Um die Vorteile der Anzeige von Crystal Report-Seiten in App Builder Sie müssen sicherstellen, dass die Crystal Report Laufzeit Engine auf Ihrem App-Server installiert ist. Derzeit App Builder erfordert, dass Sie Crystal Reports Version 13.0.21 Laufzeit installiert haben.

Download-Link für den Treiber:

64-Bit-Treiberdownload

Nachdem Sie es heruntergeladen haben, führen Sie das Installationsprogramm aus, indem Sie auf die ausführbare Datei CRRuntime_xx_13_0_21.msi klicken.

Folgen Sie den Anweisungen im Installationsprogramm, bis Sie auf die Seite mit der abgeschlossenen Installation gelangen:

1. Sobald das Installationsprogramm abgeschlossen ist, klicken Sie auf Fertigstellen.
2. Navigieren Sie dann zu IIS und erweitern Sie Ihren Server. Sobald der Server erweitert wurde, navigieren Sie zu den Anwendungspools.
3. Wählen Sie den Anwendungspool aus, der ausgeführt wird App Builder und drücken Sie im Aktionsmenü auf der rechten Seite des Bildschirms Stopp.
4. Sobald der App-Pool vollständig gestoppt wurde, drücken Sie Start und warten Sie, bis der App-Pool vollständig neu gestartet wurde.
5. Sobald App Builder wieder zugänglich ist, navigieren Sie zu einer Ihrer Seiten, die als Crystal Report-Seite konfiguriert sind. Wenn die Vorlage und die Laufzeit richtig eingerichtet sind, sollte ein eingebetteter Crystal Report angezeigt werden:

Beheben von Problemen

• Ein Benutzer erhält möglicherweise die Fehlermeldung "Eine unbehandelte Ausnahme wurde am Ende der Pipeline abgefangen" beim Versuch, einen Crystal Report in auszuführen an App Builder App. Versuchen Sie als Workaround, IIS neu zu starten, um zu sehen, ob das Problem dadurch behoben wird. In einigen Fällen müssen Sie möglicherweise den neuesten Crystal Reports-Laufzeit Treiber installieren, bevor Sie IIS neu starten.
• Wenn der Fehler „CrystalDecisions.CrystalReports.Engine.LogOnException: Datenbankanmeldung fehlgeschlagen. ---> System.Runtime.InteropServices.COMException: Datenbankanmeldung fehlgeschlagen“ angezeigt wird, überprüfen Sie den Dateipfad unter „Datenbank überprüfen“ bei der Crystal Reports-Installation auf Richtigkeit.
• Wenn Sie in Ihrem Crystal Report anstelle des erwarteten Bildes einen leeren Bereich sehen, überprüfen Sie, ob Sie das Bild so weit wie möglich komprimiert haben (unter Beibehaltung der Qualität). Hilfe zum Komprimieren von Bildern finden Sie unter tinypng.com.