Der folgende Abschnitt behandelt die Verwendung von Xtract Universal für eine SAP Integration in SSRS.
Voraussetzung #
Um die SSRS-Destination zu nutzen, benötigen Sie folgende Komponenten:
- Visual Studio 2017 oder höher
- das Microsoft Reporting Services Projects Plugin (Version 2.6.11 oder höher) für Visual Studio.
- Power BI Report Server (Januar 2020 oder später)
- Xtract Universal (Version 4.29 oder höher)
- Bearbeiten Sie die Registry des Rechners, auf dem der SSRS Server läuft, entsprechend der Microsoft Hilfe (Konfigurieren für starke Kryptografie), um Transport Layer Security nutzen zu können.
Hinweis: Der Power BI Report Builder wird nicht unterstützt.
Installation #
Um die SSRS-Destination zu nutzen, installieren Sie das Microsoft Reporting Services Projects Plugin in Visual Studio. Nach der Installation, schließen Sie Visual Studio.
Microsoft SQL Server Reporting Services unterstützt eine große Auswahl von Datenquellen out-of-the-box. Um Xtract Universal als Datenquelle hinzuzufügen, installieren Sie die Xtract Universal Data Extension für Visual Studio und den Report Server. Die Erweiterung muss auf beiden Umgebungen installiert sein, um die von Xtract Universal extrahierten Daten zu konsumieren, siehe folgende Grafik:
Die Erweiterung wird bei der Installation des Xtract Universal Setup automatisch installiert. Um die Installation zu beenden, schließen Sie Visual Studio.
Hinweis: Achten Sie darauf, dass Sie immer die aktuelle Version des Microsoft Reporting Services Projects Plugins und von Xtract Universal installieren.
Nach der Installation der C:\Program Files\XtractUniversal\ssrs\SSRSDataExtensionSetup.exe
erstellt das Setup die folgenden Einträge und Erweiterungen im Installationsverzeichnis von Visual Studio:
C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRS\XUDataExtension2020.05.dll
C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRS\Theobald.Common.dll
C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRS\Theobald.Distillery.Common.dll
C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRS\Theobald.Net.dll
C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRS\RSReportDesigner.config
Installation der Xtract Universal Data Extension #
Um die Xtract Universal Erweiterung auf mehreren Umgebungen zu installieren, ohne den kompletten Xtract Universal Designer zu installieren, führen Sie folgende Schritte aus:
- Stellen Sie sicher, dass das Microsoft Reporting Services Projects Plugin für Visual Studio bereits installiert und aktiviert ist.
- Schließen Sie Visual Studio.
- Installieren Sie Xtract Universal auf der Umgebung, auf der die Lizenz läuft.
- Nach der Installation, öffnen Sie das Verzeichnis von Xtract Universal, z.B.
C:\Program files\Xtract Universal\
und kopieren Sie den Ordner\ssrs
auf jede Umgebung, auf der Visual Studio verwendet wird um Reports zu erstellen oder auf denen der Report Server läuft. - Führen Sie die SSRSDataExtensionSetup.exe als Administrator aus, um die Xtract Universal Erweiterung auf allen kompatiblen Versionen von Visual Studio und/oder dem Report Server zu installieren.
- Nach der Installation auf dem Report Server starten Sie den Report Server neu, damit die Änderungen in Kraft treten. Sie können den Server im Configuration Manager neu starten. Klicken Sie auf [stop] und anschließend auf [start].
Um die Erweiterung zu deinstallieren, verwenden Sie die uninstall.bat Datei aus dem \ssrs
-Ordner des Xtract Universal Verzeichnisses.
Hinweis: Wenn das Reporting Services Projects Plugin in Visual Studio upgedatet wird, ist die Xtract Universal Data Extension nicht mehr verfügbar. Die Xtract Universal Data Extension muss dann neu installiert werden.
Sollten bei der Installation der Xtract Universal Data Extension Schwierigkeiten auftreten, Senden Sie die Log-Datei aus dem Verzeichnis C:\Program Files\XtractUniversal\ssrs\log.txt
an Theobald Support.
Verbindung #
Eine Destination hinzufügen #
- Navigieren Sie im Hauptfenster des Designers zu Server > Manage Destinations. Das Fenster “Manage Destination” wird geöffnet.
- Klicken Sie auf [Add], um eine neue Destination hinzufügen. Das Fenster “Destination Details” wird geöffnet.
- Geben Sie einen Namen für die Destination ein.
- Wählen Sie den Destinationstyp aus dem Dropdown-Menü aus.
Destination Details #
Für das Anlegen einer SSRS Zielumgebung müssen keine weiteren Einstellungen vorgenommen werden.
Einstellungen #
Destination Settings öffnen #
- Eine bestehende Extraktion anlegen oder auswählen, siehe Erste Schritte mit Xtract Universal.
- Klicken Sie auf [Destination]. Das Fenster “Destination Settings” wird geöffnet.
Die folgenden Einstellungen können für die Destination definiert werden.
Destination Settings - Destinationseinstellungen #
Column Name Style #
Definiert den Spaltennamen. Folgende Optionen sind verfügbar:
- Code: Der technische Spaltenname aus SAP wird als Spaltenname verwendet, z.B. MAKTX
- PrefixedCode: Der technische Name der Tabelle wird mit dem Tilde-Zeichen und dem entsprechenden Spaltennamen verbunden, z. B. MAKT~MAKTX.
- CodeAndText: Der technische Name und die Beschreibung der Spalte aus SAP mit einem Unterstrich verbunden werden als Spaltennamen verwendet, z.B. MAKTX_Material Description (Short Text).
- TextAndCode: Die Beschreibung und der technische Name der Spalte SAP mit einem Unterstrich verbunden werden als Spaltennamen verwendet, z.B. Material Description (Short Text)_MAKTX.
- Text: Die Beschreibung aus SAP wird als Spaltenname verwendet, z.B. Material Description (Short Text).
Date conversion #
Convert date strings
Konvertiert die Zeichenabfolge des SAP-Datums (YYYYMMDD, z.B. 19900101) zu einem formatierten Datum (YYYY-MM-DD, z.B. 1990-01-01). Im Datenziel hat das SAP-Datum keinen String-Datentyp sondern einen echten Datumstyp.
Convert invalid dates to
Falls ein SAP-Datum nicht in ein gültiges Datumsformat konvertiert werden kann, wird das ungültige Datum zu dem eingegebenen Wert konvertiert. NULL wird als Wert unterstützt.
Bei der Konvertierung eines ungültigen SAP-Datums werden zuerst die beiden Sonderfälle 00000000 und 9999XXXX überprüft.
Convert 00000000 to
Konvertiert das SAP-Datum 00000000 zu dem eingegebenen Wert.
Convert 9999XXXX to
Konvertiert das SAP-Datum 9999XXXX zu dem eingegebenen Wert.
SSRS in Visual Studio #
Der folgende Abschnitt zeigt, wie man in der SQL Server Reporting Services (SSRS) Umgebung über Xtract Universal auf SAP-Daten zugreift.
SAP-Daten im Xtract Universal Designer extrahieren #
Um SAP-Daten in der SQL Server Report Server (SSRS) Umgebung zur Verfügung zu stellen, wird im ersten Schritt eine entsprechende Extraktion im Xtract Universal Designer erstellt.
Informationen bzgl. der Erstellung von Extraktionen finden Sie unter Erste Schritte.
Verwenden Sie für die Extraktion die SQL Server Reporting Service Destination.
Eine Extraktion als Datenquelle in Visual Studio hinzufügen #
Die folgenden Schritte beschreiben, wie man eine Xtract Universal Datenquelle in Visual Studio hinzufügt:
- Erstellen Sie ein neues “Report Server Project” in Visual Studio.
- Rechtsklicken Sie auf den Ordner Shared Data Sources im Solution Explorer und wählen Sie Add New Data Source. Das Fenster “Shared Data Source Properties” öffnet sich.
- Weisen Sie im Tab General der neuen Datenquelle einen Namen zu oder verwenden Sie den Standardnamen (1).
- Wählen Sie den Typ Xtract Universal aus der Drop-Down-Liste aus (2).
Falls Xtract Universal nicht verfügbar oder in Großbuchstaben ist, prüfen Sie ob die aktuelle Xtract Universal Version und das aktuelle Microsoft Reporting Services Projects Plugin installiert sind. - Geben Sie einen connection string (3) zum Xtract Universal Web-Server im Format
Url=http://[host]:[port]/
ein, z.B.Url=http://localhost:8065/
. Beachten Sie die Groß-Kleinschreibung. - Optional (nur nötig, wenn die XU-Serversicherheit konfiguriert wurde oder an das SAP-Quellsystem entsprechende Credentials übergeben werden müssen): Wechseln Sie in den Credentials Tab (4) und geben Sie Ihren Benutzernamen und Passwort für Xtract Universal ein.
- Bestätigen Sie Ihre Eingabe mit [OK].
Wenn Xtract Universal trotz aktuellem Microsoft Reporting Services Projects Plugin und aktuellem Xtract Universal nicht in der Drop-Down-Liste (2) verfügbar ist, schicken Sie die Log-Datei aus C:\Program Files\XtractUniversal\ssrs\log.txt
an den Theobald Support.
Tipp: Der connection string ist im URL string aus dem “Run Extraction”-Fenster des Designers enthalten. Kopieren Sie den String bis zum ‘?’ und fügen Sie ihn als connection string in Visual Studio ein.
Hinweis: Wenn in den XU Webserer Einstellungen https Restricted… oder https Unrestricted aktiviert ist, muss auf dem Rechner, auf dem der SSRS Server läuft, die Registry entsprechend der Microsoft Hilfe (Konfigurieren für starke Kryptografie) angepasst werden.
Einen Report mit einer Xtract Universal Datenquelle erstellen #
Die folgenden Schritte beschreiben, wie man in Visual Studio einen Report mit einer Xtract Universal Datenquelle erstellt:
- Fügen Sie eine Extraktion als Datenquelle in Visual Studio hinzu.
- Rechtsklicken Sie auf den Ordner Reports im Solution Explorer und wählen Sie Add New Report. Das Fenster “Report Wizard” öffnet sich.
- Wählen Sie im Assistenten eine Datenquelle und klicken Sie auf [Next].
- Klicken Sie auf [Query Builder…]. Das Fenster “Query Designer” öffnet sich.
- Wählen Sie eine Xtract Universal Extraktion aus dem Drop-Down-Menü aus (5).
Wenn keine Extraktionen angezeigt werden, prüfen Sie den connection string (3) in der Datenquelle und prüfen Sie, ob in Xtract Universal eine Extraktion mit einer SQL Server Reporting Services Destination existiert. Wenn Ihnen der unten abgebildete Editor nicht angezeigt wird, klicken Sie auf Edit as Text. - Optional: Bearbeiten Sie die Laufzeitparameter der Extraktion (6). Parameteränderungen werden im Query string angezeigt (7). Ungültige Eingaben werden rot markiert. Eine Fehlermeldung erhalten Sie, wenn Sie den Mauszeiger auf die Markierung bewegen.
- Klicken Sie auf [Preview] (8) um die Extraktion im Preview Mode auszuführen.
- Bestätigen Sie Ihre Eingabe mit [OK]. Der Query Builder schließt sich.
- Prüfen Sie, dass der Query string aus dem Query Builder im Report-Assistenten angezeigt wird, bevor Sie auf [Next] klicken.
- Richten Sie den Report entsprechend Ihrer Anwendung ein und beenden Sie den Report-Assistenten.
Nachdem der Report erstellt wurde, können Sie auf den Query Builder zugreifen, indem Sie unter Report Data über Rechtsklick auf Dataset Query… auswählen.
Tipp: Das Durchreichen des (Windows) Users, der den Bericht auf dem Report Server oder bei der Entwicklung in Visual Studio ausführt, wird unterstützt. Single Sign On in SAP ist über diesen Weg ebenfalls möglich. Voraussetzung hierfür ist die Einrichtung der Web Server Authentifizierung in Xtract Universal bzw. die Einrichtung des Single Sign On.
Parametrisierung #
Der Xtract Universal Designer verwendet für die Parametrisierung Laufzeitparameter.
Die Laufzeitparameter sind im Query Builder verfügbar. Sie können eine der folgenden Eigenschaften (Behaviours) annehmen:
- Default: Verwendet den Wert, der im Xtract Universal Designer definiert wurde.
- Constant: Geben Sie hier einen konstanten Wert ein für den Parameter ein.
- Parameterized: Geben Sie hier den Namen eines dynamischen Abfrageparameters ein, der zu Laufzeit übergeben wird. Der Parameter unterstützt die Verwendung von Formeln.
Hinweis: Laufzeitparameter erlauben die Eingabe eines einzelnen Parameters.
Wenn man mehrere Abfrageparameter verwenden möchte, kann man mit den Bordmitteln des VS Report Designers einen berechneten Abfrageparameter zusammenbauen und diesen als Laufzeitparameter übergeben, siehe Using Computed Query Parameters for SSRS with Xtract Universal.
Dynamische Laufzeitparameter definieren
Verwenden Sie VS Abfrageparameter als Eingabe für Xtract Laufzeitparameter.
- Um einen neuen Abfrageparameter zu erstellen, rechtklicken Sie auf das Dataset im Fenster Report Data und wählen Sie Dataset Properties Das Fenster “Dataset Properties” öffnet sich.
- Wechseln Sie in den Tab Parameters und klicken Sie auf [Add].
- Geben Sie einen Parameter Name(1) und einen Parameter Value ein oder verwenden Sie [f(x)], um Formeln hinzuzufügen oder mehrere Eingaben zu kombinieren.
- Wechseln Sie in den Tab Query und klicken Sie auf [Query Designer…]. Das Fenster “Query Designer” öffnet sich.
- Wählen Sie Parameterized als Behaviour des Laufzeitparameters aus, den Sie dynamisieren möchten.
- Geben Sie den Namen des Abfrageparameters (1) unter Value ein.
- Bestätigen Sie Ihre Eingabe mit [OK].
Optionale Parameter
Wenn ein Abfrageparameter NULL ist, wird der Parameter zu Laufzeit nicht übergeben und der Parameter wird ignoriert.
Hinweis: Abhängig vom Extraktionstyp können einige Laufzeitparameter nicht ignoriert werden. Insbesondere Custom Parameters sind i.d.R. verpflichtend.
- Rechtsklicken Sie auf das Eingabefeld, das optional sein soll und wählen Sie Parameter Properties. Das Fenster “Report Parameter Properties” öffnet sich.
- Aktivieren Sie die Checkbox Allow null value im Tab General.
- Bestätigen Sie Ihre Eingabe mit [OK]. Eine Checkbox NULL wird neben Ihrem Eingabefeld angezeigt.
- Wenn die Checkbox NULL aktiv ist, wird der Parameter zur Laufzeit ignoriert.
Tipp: Sie können auch einen berechneten Abfrageparameter verwenden, um den Wert NULL zu erhalten. Erstellen Sie eine Formel, die Nothing als Wert zurückgibt.