Der folgende Abschnitt behandelt die Verwendung von Xtract Universal für eine SAP Integration in Power BI Report Server (SSRS).

Voraussetzung #

Um die Power BI Report Server Destination zu nutzen, benötigen Sie folgende Komponenten:

Hinweis: Der Power BI Report Builder wird nicht unterstützt.

Installation #

Um die Power BI Report Server Destination zu nutzen, installieren Sie das Microsoft Reporting Services Projects Plugin in Visual Studio. Nach der Installation, schließen Sie Visual Studio.

Microsoft Power BI Report Server (SQL Server Reporting Services) unterstützt standardmäßig eine Vielzahl von Datenquellen “Out-of-the-box”. Um Xtract Universal zur Liste der Datenquellen hinzuzufügen, installieren Sie Xtract Universal Report Server Plugin für Visual Studio und den Report Server. Das Plugin muss in beiden Umgebungen installiert sein, um die von Xtract Universal extrahierten Daten zu nutzen, siehe Grafik unten:

XU-Setup

Um die Installation abzuschließen, schließen Sie alle Visual Studio-Fenster.

Warnung! Alte Versionen nicht unterstützt Stellen Sie sicher, dass Sie die neueste Version des Plugins Microsoft Reporting Services Projects und Xtract Universal installieren.

###Installation mit dem Xtract Universal Report Server Plugin

Das Xtract Universal Report Server Plugin kann als Teil des Xtract Universal Setup installiert werden.
Um das Xtract Universal Report Server Plugin in mehreren Umgebungen zu installieren, ohne den Xtract Universal Designer zu installieren, führen Sie die folgenden Schritte aus:

  1. Stellen Sie sicher, dass das Microsoft Reporting Services Projects-Plugin für Visual Studio installiert und aktiv ist.
  2. Schließen Sie Visual Studio.
  3. Installieren Sie Xtract Universal auf der Umgebung, auf der die Lizenz läuft..
  4. Laden Sie [XtractUniversalReportServerPluginSetup.exe] herunter (/docs/xu/XtractUniversalReportServerPluginSetup.exe).
  5. Führen Sie XtractUniversalReportServerPluginSetup.exe in jeder Umgebung aus, die Visual Studio zum Designen von Reports verwendet oder in der der Reportserver ausgeführt wird. Dadurch wird das Xtract Universal Report Server Plugin auf allen kompatiblen Versionen von Visual Studio und/oder Report Server in der Umgebung installiert.
    XU-Setup
  6. Nachdem die Installation auf dem Resportserver abgeschlossen ist, starten Sie den Reportserver neu, damit die Änderungen wirksam werden. Sie können den Server im Report Server Configuration Manager neu starten, indem Sie auf [stop] und dann auf [start] klicken.

Hinweis: Wenn das Reporting Services Projects-Plugin für Visual Studio aktualisiert wird, ist das Xtract Universal Report Server Plugin nicht mehr verfügbar. Das Report Server Plugin muss neu installiert werden.

Nach der Installation des Xtract Universal Report Server Plugins stehen im Visual Studio-Installationsverzeichnis folgende Einträge und Erweiterungen zur Verfügung:

  • 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

Verbindung #

Eine Destination hinzufügen #

  1. Navigieren Sie im Hauptfenster des Designers zu Server > Manage Destinations. Das Fenster “Manage Destination” wird geöffnet.
  2. Klicken Sie auf [Add], um eine neue Destination hinzufügen. Das Fenster “Destination Details” wird geöffnet.
  3. Geben Sie einen Namen für die Destination ein.
  4. 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.

ssrs-create-destination

Einstellungen #

Destination Settings öffnen #

  1. Eine bestehende Extraktion anlegen oder auswählen, siehe Erste Schritte mit Xtract Universal.
  2. Klicken Sie auf [Destination]. Das Fenster “Destination Settings” wird geöffnet. Destination-settings

Die folgenden Einstellungen können für die Destination definiert werden.

Destination Settings - Destinationseinstellungen #

ssrs-configuration

Column Name Style #

Definiert den Spaltennamen. Folgende Optionen sind verfügbar:

column_name_style_options

  • 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 Power BI Report Server (SSRS) Umgebung über Xtract Universal auf SAP-Daten zugreift.

SAP-Daten im Xtract Universal Designer extrahieren #

Um SAP-Daten in der 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 Power BI Report Server 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:

  1. Erstellen Sie ein neues “Report Server Project” in Visual Studio.
    New-Project
  2. 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.
  3. Weisen Sie im Tab General der neuen Datenquelle einen Namen zu oder verwenden Sie den Standardnamen (1).
  4. 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.
  5. 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. Shared-Data-Source-Properties
  6. 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.
  7. 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:

  1. Fügen Sie eine Extraktion als Datenquelle in Visual Studio hinzu.
  2. Rechtsklicken Sie auf den Ordner Reports im Solution Explorer und wählen Sie Add New Report. Das Fenster “Report Wizard” öffnet sich.
  3. Wählen Sie im Assistenten eine Datenquelle und klicken Sie auf [Next].
  4. Klicken Sie auf [Query Builder…]. Das Fenster “Query Designer” öffnet sich.
  5. 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 Power BI Report Server (SQL Server Reporting Services) Destination existiert. Wenn Ihnen der unten abgebildete Editor nicht angezeigt wird, klicken Sie auf Edit as Text. Query-Designer
  6. 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.
  7. Klicken Sie auf [Preview] (8) um die Extraktion im Preview Mode auszuführen.
  8. Bestätigen Sie Ihre Eingabe mit [OK]. Der Query Builder schließt sich.
  9. Prüfen Sie, dass der Query string aus dem Query Builder im Report-Assistenten angezeigt wird, bevor Sie auf [Next] klicken. Report-Wizard
  10. 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 Report 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.

  1. 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.
  2. Wechseln Sie in den Tab Parameters und klicken Sie auf [Add]. Query-Parameter
  3. 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.
  4. Wechseln Sie in den Tab Query und klicken Sie auf [Query Designer…]. Das Fenster “Query Designer” öffnet sich. Query-Designer
  5. Wählen Sie Parameterized als Behaviour des Laufzeitparameters aus, den Sie dynamisieren möchten.
  6. Geben Sie den Namen des Abfrageparameters (1) unter Value ein.
  7. 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.

  1. Rechtsklicken Sie auf das Eingabefeld, das optional sein soll und wählen Sie Parameter Properties. Das Fenster “Report Parameter Properties” öffnet sich. Input-Field
  2. Aktivieren Sie die Checkbox Allow null value im Tab General.
  3. Bestätigen Sie Ihre Eingabe mit [OK]. Eine Checkbox NULL wird neben Ihrem Eingabefeld angezeigt.
  4. 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.