Verwalten der Datenintegration

Daten mit dem Express-Datenlader übertragen

Objective

After completing this lesson, you will be able to erläutern Sie, wie Sie Daten mit dem Express Data Loader übertragen.

Express-Datenlader-Datenübertragung

Eine weitere Methode zum Laden und Extrahieren von Daten in und aus SAP Territory and Quota ist der Express Data Loader (XDL). XDL ist ein cloudbasiertes Tool, mit dem Sie Massendaten sicher in und aus dem System importieren und exportieren können, ohne dass Code erforderlich ist.

XDL kann zum Importieren von Daten aus Quellsystemen und zum Extrahieren von Quoten in SAP Incentive Management verwendet werden. Hier können die Quoten zur Berechnung von Provisionen und anderen Leistungsanreizen aus Verkaufsvorgängen verwendet werden.

Download der Importdateivorlage

XDL-Daten werden mithilfe von Importdateien mit sehr spezifischen Namens- und Formatierungsanforderungen geladen. Daher ist es am einfachsten, die Importdateien zu formatieren, indem Sie die Sammlung von Vorlagen herunterladen. Die vollständige Sammlung der Importdateivorlagen wird als einzelne ZIP-Datei von der XDL-Onlinehilfeseite heruntergeladen. Diese Seite enthält auch eine Tabelle mit dem Vorlagennamen, dem Dateitypcode und der Beschreibung für jede Vorlage. Die Abbildung unten zeigt den Download-Link in der Online-Hilfe.

Auf der Online-Hilfeseite wird der Link zum Herunterladen der Importvorlage angezeigt.

Nachdem Sie die ZIP-Datei in Ihr lokales System heruntergeladen haben, können Sie die Dateien in einen Ordner extrahieren.

Während wir dieses Thema durchgehen, betrachten wir ein Szenario, in dem Bikes In Motion jeden Monat XDL zum Importieren neuer Kundenkonten verwenden möchte.

Die Tabelle auf der Seite Express-Datenlader-Vorlagen zeigt, dass Konten mit der Datei TQAC_Template importiert werden, die den Dateitypcode TQAC hat.

Namens- und Formatanforderungen für XDL-Dateien

Die Anforderungen an die Dateibenennung für XDL sind sehr präzise. Jede Vorlage verfügt über eine Registerkarte, die die spezifischen Anforderungen für diesen Dateityp beschreibt. In der Regel sollte die Datei jedoch in folgendem Format benannt werden:

Code Snippet
1
[Tenant ID]_[File Type Code]_<DEV or TST or PRD>_<yyyymmdd>_<hhmiss>_<Content Tag>.<file-suffix>

  • Die Tenant-ID ist die vierstellige Ziffer am Anfang der URL. Dies ist ein von SAP benannter Code zur eindeutigen Identifizierung des Eigentümers des Tenants. Die Tenant-ID für Fahrräder in Bewegung kann beispielsweise 1104 sein.
  • Der Dateitypcode identifiziert die Art der Daten, die importiert werden. Die Liste der Importdateivorlagen enthält den Dateitypcode. Der Dateitypcode für Konten ist beispielsweise TQAC.
  • DEV, TST oder PRD identifiziert den Typ des Tenants: Entwicklungs-, Test- oder Produktivmandant.
  • JJJJMMTT ist das Datum, z.B. 20220101.
  • HHMMSS ist die genaue Uhrzeit, z.B. wäre 13:00 Uhr 130000.
  • Das Content-Tag ist ein kurzer Textstring, der einen beliebigen Wert zur eindeutigen Identifizierung der Charge enthalten kann. In diesem Fall verwenden wir das Content-Tag JanAccounts.

Wenn wir diese alle zusammenfassen, könnte der Dateiname wie folgt lauten:

BIKE_TQAC_PRD_20220101_130000_JanAccounts.xlsx

Neben dem Namen hat die Datei auch folgende Formatierungsanforderungen:

  • Sichern Sie die Datei als Textdatei mit Trennzeichen und dem Suffix .txt.
  • Das Trennzeichen muss mit dem in den Einstellungen für Eingangsdateityp in XDL ausgewählten Trennzeichen übereinstimmen. In diesem Fall wird ein Tabulatortrennzeichen verwendet.
  • Ebenso muss die Kodierung mit der Kodierung übereinstimmen, die in den Einstellungen für den Eingangsdateityp in XDL ausgewählt wurde. In diesem Fall verwendet die Datei die UTF-8-Kodierung.
  • Die Datei kann eine optionale Kopfzeile haben. Stellen Sie jedoch sicher, dass Sie angeben, ob eine Kopfzeile in den Einstellungen für Eingangsdateityp verwendet wird.

Express-Datenlader-Konfiguration

Der nächste Schritt besteht darin, die Dateianforderungen zu konfigurieren. Dazu gehören drei Schritte: globale Einstellungen, Eingangsdateitypeinstellungen und Ausgangsdateitypeinstellungen.

Globale Einstellungen sind Standardeinstellungen, die sowohl für eingehende als auch für ausgehende Dateiübertragungen gelten. Zu den globalen Einstellungen gehören Optionen wie die Standardzeitzone, die Zeichenkodierung, der Komprimierungstyp und der E-Mail-Empfänger für Erfolgs- und Fehlerbenachrichtigungen.

Die Einstellungen für den Eingangsdateityp umfassen die Standardeinstellungen und Metadaten jeder Datei, die importiert wird. Für jede Vorlagendatei muss ein Dateityp konfiguriert werden. Das bedeutet, dass jeder Vorlage ein Dateityp zugeordnet sein muss. Zu den Einstellungen gehören der Dateityp, Importoptionen und die Ziel-Staging-Tabelle. Sie können den Standardzeichensatz und das Trennzeichen auch überschreiben, indem Sie diese in den Dateitypeinstellungen festlegen.

Die Einstellungen für den Ausgangsdateityp umfassen die Standardeinstellungen und Metadaten jeder Datei, die exportiert wird, z.B. Konten oder Quoten. Zu den Einstellungen gehören der Ausgangsdateityp, die gespeicherte Quellprozedur und der Komprimierungsmodus. Wie bei den Einstellungen für den Eingangsdateityp können Sie den Standardzeichensatz und das Trennzeichen überschreiben, indem Sie diese in den Dateitypeinstellungen festlegen.

Sehen wir uns an, wie wir sowohl globale als auch eingehende Einstellungen so konfigurieren können, dass sie mit der Importdatei übereinstimmen, die wir im vorherigen Thema angelegt haben.

Globale Einstellungen konfigurieren

Schritte

  1. Wählen Sie in der Anwendungsauswahl Express Data Loader.

  2. Wählen Sie Konfiguration→Globale Einstellungen.

  3. Legen Sie den Komprimierungsmodus fest. Der Standardwert ist Gzip, aber in unserem Beispiel wird kein Komprimierungsmodus verwendet.

  4. Legen Sie die Zeitzone fest.

    Dies wird für den Zeitstempel für den Job verwendet.

  5. Wählen Sie ein Zeichenkodierungsattribut (Zeichensatz) aus. Der Standardwert ist UTF-8.

  6. Wählen Sie ein Trennzeichen aus. Der Standardwert ist durch Tabulatorengetrennt.

  7. Wählen Sie einen Aufbewahrungszeitraum für Fehlerprotokolle und Jobs aus. Die Standardwerte sind 30 Tage bzw. 90 Tage.

  8. Geben Sie eine E-Mail für Erfolgs- und Fehlerbenachrichtigungs-E-Mails ein.

  9. Aktivieren Sie den Schalter Autorun. Geben Sie an, ob der Import automatisch ausgeführt werden soll, sobald der Datei-Upload ausgeführt wird.

  10. Wählen Sie ein Escape-Trennzeichen aus.

    Diese Einstellung gibt an, ob kommagetrennte Dateien, die ein Trennzeichen als Teil ihrer Daten haben, geladen werden können. Wenn diese Option aktiviert ist, können Sie doppelte Anführungszeichen für den Import von Werten verwenden, die ein Trennzeichen als Teil des Felds ("") haben.

  11. Wählen Sie Sichern.

Ergebnis

Die Seite Globale Einstellungen zum Konfigurieren von XDL wird angezeigt.

Einstellungen für Eingangsdateityp konfigurieren

Schritte

  1. Wählen Sie Einrichtung des→Konfigurationsdateityps aus.

  2. Blättern oder suchen Sie nach dem Dateityp. Das folgende Beispiel zeigt die Einrichtung für SAP-Gebiets- und Quotenkonten: TQAC.

  3. Wählen Sie den zu konfigurierenden Dateityp aus. In diesem Fall wählen wir TQAC aus.

  4. Wählen Sie das Bleistiftsymbol, um die Einrichtung des Dateityps zu bearbeiten.

    5. Die beiden Dateitypen für Gebiets- und Quotenkonten werden angezeigt.

  5. Lassen Sie den Zeichensatz (Zeichenkodierungsattribut) auf Standard gesetzt. Dies entspricht standardmäßig der UTF-8-Einstellung, die wir im globalen Setup ausgewählt haben.

  6. Behalten Sie das Trennzeichen bei der Standardeinstellung bei.

    Dabei wird standardmäßig das Tabulatortrennzeichen verwendet, das wir in der globalen Konfiguration ausgewählt haben.

  7. Setzen Sie den Importtyp auf Validieren und übertragen. Dadurch werden die Datensätze nach Abschluss des Imports automatisch aus der Staging-Tabelle in die Produktion übertragen.

  8. Wählen Sie den Schalter, um mit einem Import fortzufahren, wenn bei der Validierung Fehler gefunden werden.

  9. Wählen Sie den Schalter Kopf.

  10. Wählen Sie Sichern.

Ergebnis

Die Standardfelder zum Bearbeiten eines Dateityps werden angezeigt.

Ausführung der Übertragung eingehender Dateien

Jetzt können wir den Express Data Loader verwenden, um die neuen Konten in SAP Territory and Quota zu laden.

Datei im Express-Datenlader importieren

Schritte

  1. Wählen Sie im linken Navigator das Menü Jobs.

  2. Wählen Sie in der Symbolleiste das Symbol Hochladen ().

  3. Navigieren Sie zum Speicherort der tabulatorgetrennten Textdatei, und wählen Sie Öffnen.

  4. Warten Sie, bis der Job abgeschlossen ist.

Ergebnis

Laden Sie die Textdatei „Aufträge“ über die Schaltfläche „Hochladen“ auf der Seite „Aufträge“ hoch.

Sobald der Job abgeschlossen ist, können Sie zurück zu Gebiet und Quote navigieren, um zu überprüfen, ob die Datensätze in den Arbeitsbereich geladen wurden.

Kontodaten mit dem Express-Datenlader importieren

Unternehmensszenario

In dieser Übung führen Sie die Schritte zum Importieren von Kundendaten in die SAP-Gebiets- und Quotenanwendung mit dem Express-Datenlader aus.

ExerciseStart Exercise

Ausführung der Ausgangsdateiübertragung

Beim Extrahieren von Daten aus SAP Territory and Quota wird ein anderer Vorlagentyp verwendet. Die Ausgangsvorlage ist eine UTF-8-kodierte Textdatei, die eine SQL-SELECT-Anweisung enthält. Eine Reihe von Beispieldateien kann über diesen Link heruntergeladen werden (beachten Sie, dass es sich hierbei um einen direkten Download handelt). Dadurch wird eine ZIP-Datei angelegt, die eine Sammlung von Textdateien (.txt) enthält.

Extrahieren Sie die ZIP-Datei in einen Ordner. Die folgende Tabelle enthält eine Liste der verfügbaren Extraktdateien.

DatentypExtraktdateiname
TerritoryAccountTERRITORYACCEXT
TerritoryGeographyTERRITORYGEOEXT
TerritoryProductTERRITORYPRODEXT
GebietsquoteTERRITORYQUOTAEXT
KontoACCOUNTEXT
GeografieGEOGRAPHYEXT
ProduktePRODUCTEXT

Ausgangsdateiformat und Namensanforderungen

Die SELECT -Anweisung listet jede zu extrahierende Spalte getrennt durch ein @-Zeichen auf, gefolgt von einer WHERE -Klausel, die durch ein Komma gekennzeichnet ist.

Sehen wir uns zwei Beispiele für Extraktdateien und die Syntax an, die zum Auswählen von Spalten und Filtern verwendet wird:

Um Konten zu extrahieren, verwenden wir die ACCOUNTEXT-Datei. Der folgende Inhalt würde Konto-ID, Umsatz, Adresse, Ort, Bundesland/-staat, Postleitzahl und Gültigkeitsstartdatum aus allen Konten extrahieren, in denen der Bundesstaat gleich Kalifornien (CA) ist:

Code Snippet
1
accountId@Revenue@ADDRESS1@CITY@STATE@POSTALCODE@EFFECTIVESTARTDATE,@STATE = "CA"

Es ist auch möglich, bei Bedarf benutzerdefinierte Felder einzuschließen.

Um Quoten in einem Gebietsprogramm zu extrahieren, verwenden wir die Datei TERRITORYQUOTAEXT. Der folgende Inhalt würde Quoten aus einem Gebiet extrahieren, einschließlich des Gebietsprogrammnamens, des Gebiets, des Quotenwerts und des endgültigen Quotenwerts, wenn das Gültigkeitsstartdatum am oder nach dem 1. Januar 2010 liegt, wenn das Gebietsprogramm „NPR TP" ist und der Zieltyp „Umsatz" ist:

Code Snippet
1
Territory Program@Territory@QuotaValue@finalQuotaValue,@EFFECTIVESTARTDATE >= "20100101" and @TERRITORY PROGRAM = "NPR TP" and @Target Type = "revenue"

Die Extraktdatei wird mit der Namenskonvention gesichert.

Code Snippet
1
<tenantid>_<outboundname>_<optionalstring>.txt.

  • Die Tenant-ID ist die vierstellige Ziffer am Anfang der URL. Dies ist ein von SAP benannter Code zur eindeutigen Identifizierung des Eigentümers des Tenants. Dies entspricht der Tenant-ID, die für Eingangsdateien verwendet wird.
  • Der Ausgangsname ist der Name des Dateityps. In den beiden oben verwendeten Beispielen wäre dies ACCOUNTEXT oder TERRITORYQUOTAEXT.
  • Die optionale Zeichenfolge ist eine Kurztextzeichenfolge, die einen beliebigen Wert zur eindeutigen Identifizierung der Charge enthalten kann.

Anhand der beiden Beispiele würde die Konto-Extraktdatei BIKE_ACCOUNTEXT_2022Accounts.txt und die Kontingentextraktdatei BIKE_TERRITORYQUOTAEXT_2022Quotas.txt heißen.

Notiz

Der letzte Teil dieser Dateinamen kann eine beliebige Zeichenfolge sein.

Extraktdatei im Express-Datenlader hochladen

Schritte

  1. Melden Sie sich am Express Data Loader (XDL) an.

  2. Wählen Sie das Menü Jobs im Navigator im linken Bereich.

  3. Wählen Sie in der Symbolleiste das Symbol Hochladen ().

Ergebnis

Laden Sie die XDL-Extraktionsdatei über die Schaltfläche „Hochladen“ auf der Seite Jobs hoch.

Zusammenfassung

  • Express-Datenlader-Funktionen bieten sichere No-Code-Massenimporte und -exporte zwischen Quellsystemen und der Anwendung.
  • Vorlagenanforderungen stellen korrekt benannte, formatierte Dateien bereit, die als ZIP-Datei mit Textvorlagen heruntergeladen wurden.
  • Globale und dateiartige Konfigurationen legen Trennzeichen, Validierungsmodi, Kopfzeilenoptionen, Aufbewahrungszeiträume und Benachrichtigungseinstellungen fest.
Learning

SAP FacebookSAP YoutubeSAP LinkedIn