Crystal Reports und Jitterbit App Builder

Übersicht

Der 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 sie erstellen und ändern möchten.

Voraussetzungen

• Der App Builder benötigt die Crystal Reports-Laufzeit, die auf dem Anwendungsserver installiert ist.
• Crystal Reports SP21 ist das Minimum für den App Builder, und SP21-SP32 werden unterstützt.

Crystal Reports aktivieren

Der App Builder wird mit vorinstallierten Crystal Reports auf Windows-Systemen geliefert. Crystal Reports wird in einem COM-Server außerhalb des Prozesses gehostet. Befolgen Sie diese Schritte, um den Crystal Reports COM-Server zu registrieren.

1. Starten Sie Windows PowerShell als Administrator.
2. Wechseln Sie in das Verzeichnis Scripts im Installationsverzeichnis des App Builders.
3. Führen Sie das RegisterCrystalReports.ps1 Skript aus.

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

Crystal Reports für das Bearbeiten und Erstellen von Berichten konfigurieren

Wenn Sie einen Crystal Report bearbeiten und/oder erstellen möchten, der vom App Builder verwendet werden soll, 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, Fehlersuche und Verwendung von Crystal Reports sind auf der SAP Crystal Reports Website verfügbar.

Um mehr über Crystal Reports zu erfahren oder eine lizenzierte Version zu erhalten, besuchen Sie bitte https://www.sap.com/products/technology-platform/crystal-reports.html

Konfigurieren des Crystal Reports-Laufzeittreibers zum Anzeigen von Berichten

Um die Anzeige von Crystal Report-Seiten im App Builder zu nutzen, müssen Sie sicherstellen, dass die Crystal Report-Laufzeitumgebung auf Ihrem Anwendungsserver installiert ist. Derzeit erfordert der App Builder, dass Sie Crystal Reports Version 13.0.21 runtime installiert haben.

Download-Link für den Treiber:

64-Bit-Treiber herunterladen

Sobald Sie ihn heruntergeladen haben, führen Sie den Installer aus, indem Sie auf die ausführbare Datei CRRuntime_xx_13_0_21.msi klicken.

Befolgen Sie die Anweisungen im Installer, bis Sie die Seite mit der abgeschlossenen Installation erreichen:

1. Sobald der Installer abgeschlossen ist, klicken Sie auf Fertigstellen.
2. Navigieren Sie dann zu IIS und erweitern Sie Ihren Server. Sobald der Server erweitert ist, navigieren Sie zu den Anwendungs-Pools.
3. Wählen Sie den Anwendungs-Pool aus, der den App Builder ausführt, und drücken Sie im Aktionsbereich auf der rechten Seite des Bildschirms auf Stop.
4. Sobald der Anwendungs-Pool vollständig gestoppt ist, drücken Sie Start und warten Sie, bis der Anwendungs-Pool vollständig neu gestartet ist.
5. Sobald der App Builder wieder zugänglich ist, versuchen Sie, zu einer Ihrer Seiten zu navigieren, die als Crystal Report-Seite konfiguriert ist. Wenn die Vorlage und die Laufzeit korrekt eingerichtet sind, sollten Sie einen eingebetteten Crystal Report sehen:

Fehlerbehebung bei Problemen

• Ein Benutzer kann die Fehlermeldung "Eine nicht behandelte Ausnahme wurde am Ende der Pipeline erfasst" erhalten, während er versucht, einen Crystal Report in einer App Builder-App auszuführen. Als Workaround versuchen Sie, IIS neu zu starten, um zu sehen, ob dies das Problem behebt. In einigen Fällen müssen Sie möglicherweise den neuesten Crystal Reports-Laufzeittreiber installieren, bevor Sie IIS neu starten.
• Wenn Sie den Fehler "CrystalDecisions.CrystalReports.Engine.LogOnException: Datenbankanmeldung fehlgeschlagen. ---> System.Runtime.InteropServices.COMException: Datenbankanmeldung fehlgeschlagen" sehen, überprüfen Sie den Dateipfad von "Datenbank überprüfen" in der Crystal Reports-Installation auf Richtigkeit.
• Wenn Sie einen leeren Bereich in Ihrem Crystal Report im Vergleich zu einem Bild sehen, das Sie erwarten, überprüfen Sie, ob Sie das Bild so stark wie möglich komprimiert haben (wobei die Qualität erhalten bleibt). Besuchen Sie tinypng.com, um Hilfe bei der Bildkomprimierung zu erhalten.