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.
Warnung: Beta-Version - Grundlegende Änderungen möglich Der Integrationstyp im Preview-Modus. Grundlegende Änderungen können jederzeit veröffentlicht werden. Erstellen Sie regelmäßige Backups der Konfigurationsdateien, um bei Bedarf auf die vorige Version zu wechseln.
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:
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.
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 #
The extraction of reports requires the installation of a custom function module in your SAP system.
If you cannot install the function module, turn to your SAP Basis team for help.
Note: As of version 1.2 of the custom function module Z_XTRACT_IS_REMOTE_REPORT
access to reports must be explicitly granted, see Authority Objects for Z_XTRACT_IS_REMOTE_REPORT.
Installation of Z_XTRACT_IS_REMOTE_REPORT #
Install the function module using the transport request Z_XTRACT_IS_REMOTE_REPORT-transport.zip.
The transport request is located in the following installation directory:
C:\Program Files\Theobald Software\yunIO\ABAP\Report\Z_XTRACT_IS_REMOTE_REPORT-transport.zip
.
The transport request needs to be imported into SAP by your SAP Basis team.
Authority Objects for Z_XTRACT_IS_REMOTE_REPORT #
As of Z_XTRACT_IS_REMOTE_REPORT version 1.2 access to reports must be explicitly granted.
There are 2 ways to verify that the SAP user is allowed to extract a report:
- Use authentication groups, see Authorizing Access to Reports via Authorization Groups.
- Use the custom authorization object Z_TS_PROG.