Report

Der folgende Abschnitt zeigt, wie der Integrationstyp Report verwendet wird.
Integrationstyp Report extrahiert Daten aus den am häufigsten verwendeten und benutzerdefinierten ABAP-Reports und SAP-Transaktionen. Eine Report-Extraktion ist möglich, wenn der Report in SAP eine tabellenartige Struktur zurückgibt.

Hinweis: Die Report Komponente setzt die Installation des benutzerdefinierten Funktionsbausteins in Ihrem SAP-System voraus. Z_XTRACT_IS_REMOTE_REPORT Nähere Informationen finden Sie unter Report Funktionsbaustein installieren .

Warnung! Fehlende Berechtigungen Um den Integrationstyp in yunIO zu verwenden, muss der Zugriff auf die entsprechenden Berechtigungsobjekte (RFC) in SAP verfügbar sein. Weitere Informationen finden Sie im Knowledge-Base-Artikel SAP Zugriffsrechte: Report.

Allgemeiner Workflow #

Die folgende Grafik zeigt den allgemeinen Workflow der Einrichtung von Report Services mit yunIO:
Report-Workflow

Einen Report finden #

Legen Sie einen Service vom Typ Report an.
Klicken Sie auf [Save and edit]. Das Search SAP Reports Menü öffnet sich.
Geben Sie den Namen eines Reports oder den TCODE eines Reports in das Feld Search by a report name or an exact TCODE (1). Die Verwendung von Wildcards ( * ) wird nur für Reportnamen unterstützt.
Um nach Reportnamen zu suchen, klicken Sie auf [Search]. (2) Um nach TCODES zu suchen, klicken Sie auf [By TCODE].
Wählen Sie eine Quelldatei aus der Liste der Suchergebnisse aus (3). Die Extraktionseinstellungen von Report werden automatisch geöffnet.

Einstellungen #

Das Report Menü ist in folgende Unterabschnitte unterteilt:

Report (4) zeigt den Namen und die Beschreibung des ausgewählten Reports.
Advanced Settings (Erweiterte Einstellungen) (5) bestimmen, wie die Daten aus SAP extrahiert werden.
Selection Parameters (Auswahlparameter) (6) bestimmen die Auswahlparameter für den yunIO-Service.
Output Columns (Ausgabe-Spalten) (7) bestimmen die Ausgabe des yunIO-Services.

yunIO-table

Report #

Im Abschnitt Report werden der Name und die Beschreibung des ausgewählten Reports angezeigt.
Um eine andere Quelldatei auszuwählen, klicken Sie auf Select in der oberen rechten Ecke des Abschnitts.

Advanced Settings (Erweiterte Einstellungen) #

Run in background

Wenn die Checkbox Run in background aktiviert ist, wird die Reportextraktion als Hintergrundjob in SAP ausgeführt. Das Extrahieren großer Datenmengen im Vordergrundmodus kann zu Timeout-Fehlern (“Time limit exceeded”) führen.Um Timeout-Fehler zu vermeiden, aktivieren Sie die Einstellung Run in background.

Dynamic column width and offset

Wenn die Checkbox “Dynamic column width and offset” aktiviert ist, werden die Spaltenbreite und der Spaltenabstand zur Laufzeit des Reports dynamisch angepasst. Alternative Anforderung für Reports, die je nach den Selektionskriterien des Reports unterschiedliche Spaltenbreiten haben.

Skip rows from top

Metainformationen können im Kopfbereich des Reports vor dem eigentlichen Reportkörper angezeigt werden. Die Einstellung Skip rows from top ermöglicht das Überspringen von Metainformationen.
Geben Sie die Anzahl der Zeilen ein, die am Anfang des Reports übersprungen werden sollen.

Skip rows from bottom

Ähnlich wie die Einstellung Skip rows from top, ermöglicht die Einstellung Skip rows from bottom das Überspringen der Reihen im Fussbereich des Reports.
Geben Sie die Anzahl der Zeilen ein, die am Ende des Reports übersprungen werden sollen.

Variant

Eine Variante besteht aus einer Reihe der Auswahlparameter die die Ergebnismenge des Reports auf Datensätze beschränken, die der Auswahl entsprechen. Eine Variante mit Selektionen kann in SAP im Eingabebildschirm eines ABAP-Reports erstellt werden. Der Zweck einer Variante ist es, Selektionen zu speichern. Das minimiert die Eingabe von Selektionen, wenn Sie Reports ausführen. Falls vorhanden, können Varianten aus der Dropdown-Liste ausgewählt werden..

Hinweis: Manuelle Selektionen und Varianten können kombiniert werden. Manuelle Selektionen überschreiben Selektionen in Varianten.

Detect Columns

Die Erkennung von Spalten (Detect Columns) ist für die Nutzung des Dienstes obligatorisch. Klicken Sie auf [Detect columns], um den Report auf der Grundlage der gewählten Variante oder Selektionen auszuführen und Spalten automatisch zu erkennen.

Hinweis: Wenn ein Report Varianten hat, muss die Variante ausgewählt werden, bevor Sie die Einstellung [Automatically detect columns] verwenden.

Selection Parameters #

Der folgende Abschnitt entspricht dem Eingabebildschirm des Reports in SAP.
Einige Selektionsfelder haben nur einen technischen Namen und keine Beschreibung. Um zu verstehen, welches Feld einem Feld in SAP entspricht, vergleichen Sie die Ergebnisse mit dem Eingabebildschirm des Reports in SAP.
Klicken Sie auf ein Selektionsfeld und drücken Sie die Funktionstaste [F1], um den technischen Namen des Selektionsfeldes anzuzeigen.

Hinweis: Wenn ein Selektionsparameter leer gelassen wird, verwendet der Report den im Report definierten Wert.

Output Columns #

Im folgenden Abschnitt werden die Länge und die Namen der erkannten Spalten des Reports angezeigt.

Tipp: Um die Länge und die Namen der Spalten manuell anzupassen, laden Sie die Dienst-Definition des Report-Dienstes herunter und bearbeiten Sie diese Definition.

Beispiel eines Dienstes #

Das folgende Beispiel zeigt, wie man einen yunIO-Service einrichtet, der den SAP ABAP-Report RLT10010 (Evaluation of Movements per Storage Type - “Bewegungen pro Lagertyp”) extrahiert:

[Getting Started: Creating a Service]Legen Sie einen Service (./getting-started#creating-a-service) des Integrationstyps Report an.
Suchen Sie nach dem Report RLT10010, siehe Einen Report finden.
Wählen Sie eine Variante oder geben Sie Selektionsparameter ein. Das angeführte Beispiel verwendet eine Variante VAR01.
Führen Sie den Report in SAP aus, um die Anzahl der zu überspringenden Zeilen zu ermitteln. Setzen Sie die Einstellung Skip rows from top auf 8, um die Kopfzeile des Reports zu überspringen.
Klicken Sie auf [Detect Columns], um die Spalten des Reports automatisch zu ermitteln. Die ermittelten Spalten werden im Abschnitt Output Columns angezeigt.
Klicken Sie auf [Save], um den Service zu speichern.
Testen Sie den Service, siehe Service testen.

SAP Customizing #

Die Extraktion von Reports setzt die Installation eines Z-Funktionsbausteins auf Ihrem SAP-System voraus.
Falls es Ihnen nicht möglich ist, den Z-Funktionsbaustein selbst zu installieren, wenden Sie sich an Ihre SAP-Basis-Abteilung.

Hinweis: Ab Version 1.2 des benutzerdefinierten Funktionsbausteins Z_XTRACT_IS_REMOTE_REPORT muss der Zugriff auf Reports explizit erteilt werden, siehe Berechtigungsobjekte für Z_XTRACT_IS_REMOTE_REPORT.

Installation von Z_XTRACT_IS_REMOTE_REPORT #

Installieren Sie den Funktionsbaustein über den mitgelieferten Transportauftrag Z_XTRACT_IS_REMOTE_REPORT-transport.zip.
Der Transportauftrag befindet sich in folgendem Installationsverzeichnis: C:\Program Files\Theobald Software\yunIO\ABAP\Report\Z_XTRACT_IS_REMOTE_REPORT-transport.zip.

Der Transportauftrag muss von Ihrem SAP-Basis-Team in SAP importiert werden.

Berechtigungsobjekte für Z_XTRACT_IS_REMOTE_REPORT #

Ab Z_XTRACT_IS_REMOTE_REPORT Version 1.2 muss der Zugriff auf Reports explizit erteilt werden
Es gibt 2 Möglichkeiten, um zu verifizieren, ob ein SAP Benutzer einen Report extrahieren darf:

Verwenden Sie Berechtigungsgruppen, siehe Authorizing Access to Reports via Authorization Groups.
Verwenden Sie das benutzerdefinierte Berechtigungsobjekt Z_TS_PROG.