Datei-Upload

Mit dieser Web-Dynpro-Anwendung (USMD_FILE_UPLOAD) können Sie Stammdaten aus einer Datei in die Datenbanktabellen kopieren, die im Datenmodell für die Stammdaten-Governance definiert wurden.

Hinweis Hinweis

Umgekehrt können Sie Stammdaten aus den Datenbanktabellen im CSV-Format auch über einen Datei-Download in eine lokale Datei kopieren.

Ende des Hinweises.

Voraussetzungen

Sie sind der aktuelle Bearbeiter eines Änderungsantrags, der für die Genehmigung und Nachverfolgung von Änderungen verwendet wird.
Ihnen ist ein Standarddatenmodell zugeordnet. Wenn Ihnen über den Benutzerstammsatz kein Datenmodell zugeordnet ist, müssen Sie sich in dieser Web-Dynpro-Anwendung über Modell ändern ein Datenmodell zuordnen.
Die hochzuladende Datei liegt als Textdatei (z.B. CSV-Datei) vor.
Binärdateien werden nicht unterstützt.

Als Trennzeichen zwischen den Feldwerten ist das Semikolon, der Tabulator, das Komma oder ein anderes druckbares Zeichen möglich. Außer dem Tabulator unterstützt das System keine unsichtbaren Zeichen.
Sie haben die hochzuladende Datei entweder auf dem Präsentationsserver (d.h. auf Ihrem lokalen PC) oder auf dem Anwendungsserver abgelegt.

Funktionsumfang

Die Anwendung ermöglicht die Eingabe aller für den Datei-Upload relevanten Parameter und startet den Upload-Vorgang.

Sie führen den Datei-Upload für einen bestimmten Entitätstyp durch (und für eine bestimmte Edition, falls für den Editionstyp eine Edition erforderlich ist). Hierbei können Sie nur Stammdaten für Entitätstypen mit der Ablage- und Verwendungsart (AV-Art) 1 (Änderbar durch Änderungsantrag; generierte Datenbanktabellen) oder 4 (Änderbar über anderen Entitätstyp; generierte Datenbanktabellen) hochladen.

Zusätzlich können Sie festlegen, was mit den vorhandenen Stammdaten während des Upload-Vorgangs geschehen soll:

Das System löscht alle vorhandenen Stammdaten. Anschließend legt es die in der Upload-Datei enthaltenen Datensätze neu an.
Das System löscht nur die vorhandenen Stammdaten, zu denen die Upload-Datei Datensätze enthält. Anschließend legt es die in der Upload-Datei enthaltenen Datensätze neu an.
Das System überschreibt bei den vorhandenen Stammdaten nur die Attribute, die in der Upload-Datei vorhanden sind. Alle anderen Attribute bleiben erhalten.

Falls die in der Upload-Datei enthaltenen Datensätze im externen Format (dem Format, das Sie auf der Benutzungsoberfläche sehen) vorliegen, können Sie sie automatisch in das interne Format (das Format, in dem die Daten in der Datenbanktabelle angelegt werden) konvertieren lassen.

Sie können die aktuellen Einstellungen als Variante sichern. In diesem Fall müssen Sie die Parameter nicht bei jedem Datei-Upload neu einstellen.

Das System protokolliert jeden Datei-Upload automatisch in einem Anwendungsprotokoll. Sie können das Protokoll mit der Transaktion SLG1 (Objekt FMDM, Unterobjekt UPLOAD) aufrufen.

Aktivitäten

Wenn Sie im SAP NetWeaver Portal das Business Package for Financial MDM 1.51 installiert haben, können Sie diese Web-Dynpro-Anwendung im Work Center Finanzstammdaten-Governance über den Service Datei-Upload im Workset Verteilungsmonitor aufrufen.

Die Anwendung umfasst folgende Schritte:

Entitätstyp festlegen
Dateistruktur definieren
Upload-Einstellungen festlegen
Prüfen und ausführen
Bestätigen

Entitätstyp festlegen

In diesem Schritt wählen Sie entweder eine zuvor gesicherte Variante oder stellen die allgemeinen Parameter für den Datei-Upload wie folgt ein:

Unter Entitätstyp wählen Sie den betreffenden Entitätstyp für den Datei-Upload aus.
Über die Transferart bestimmen Sie, welche Stammdaten des Entitätstyps hochgeladen werden (Attribute, sprachabhängige Texte oder Hierarchien).

Hinweis
Die Transferart Sprachabhängige Texte ist nur für Entitätstypen der AV-Art 1 auswählbar, die sprachabhängige Texte enthalten.

Sie können Texte direkt mit der Transferart Attribute in der jeweiligen Anmeldesprache hochladen.

Beim Hochladen sprachabhängiger Texte müssen Sie immer das Feld Sprachenschlüssel ausfüllen.

Ende des Hinweises.

Dateistruktur definieren

In diesem Schritt wählen Sie die Entitätstypen oder Attribute, die Sie in die hochzuladenden Daten aufnehmen möchten.

Upload-Einstellungen festlegen

In diesem Schritt nehmen Sie die folgenden Einstellungen vor:

Upload-Modus
- Wenn Sie den Upload-Modus Alle löschen und die Transferart Attribute wählen, löscht das System alle vorhandenen Stammdaten. Anschließend legt es die in der Upload-Datei enthaltenen Datensätze neu an. Dies ist jedoch nur zulässig, wenn Folgendes zutrifft:
  - Die zu löschenden Stammdaten werden noch nicht als Knoten in einer Hierarchie verwendet.
    
    Hinweis
    Das System löscht automatisch alle Stammdaten, die als Blätter in einer Hierarchie verwendet werden.
    
    Ende des Hinweises.
  - Die zu löschenden Stammdaten werden in keinem anderen Entitätstyp verwendet.
    
    Hinweis
    Beispiele aus dem Bereich Financials, die zeigen, warum Stammdaten nicht in anderen Entitätstypen verwendet werden dürfen:
    
    Jedes Konto ist genau einem Kontenplan zugeordnet. Wenn dieser Kontenplan gelöscht wird, sind die zu diesem Kontenplan gehörigen Konten ungültig.
    Ein Konto hat das Attribut Aufrissart. Wenn die Aufrissart gelöscht wird, werden die Stammdaten zu diesem Konto ungültig.
    
    Ende des Hinweises.
- Wenn Sie den Upload-Modus Hochgeladene löschen wählen, löscht das System die Stammdaten, für die in der Upload-Datei Datensätze vorhanden sind. Anschließend legt es die in der Upload-Datei enthaltenen Datensätze neu an.
  Wenn der Upload nicht alle Attribute umfasst, setzt das System die fehlenden Attribute auf initial. Wenn Attribute, die als Mussfelder gekennzeichnet sind, nicht hochgeladen werden, gibt das System eine Fehlermeldung aus.
- Wenn Sie den Upload-Modus Überschreiben bzw. hinzufügen wählen, ändert das System bei den vorhandenen Datensätzen nur die Attribute, die sich in der Upload-Datei befinden.
Konvertierung
Aufgrund der Einstellungen im Benutzerstammsatz (Transaktion SU01 – Registerkarte Festwerte) kann für Datensätze (Datumswerte und Zahlen) eine Konvertierung vom externen in das interne Format notwendig sein. Um festzulegen, dass das System eine Konvertierung durchführen soll, wählen Sie die Einstellung Konvertierung durchführen.
Dateiablage
- Die hochzuladende Datei kann sich entweder auf dem Präsentationsserver (dem lokalen PC) oder auf dem Anwendungsserver befinden.
  Wenn sich die Datei auf dem Anwendungsserver befindet, müssen Sie als Dateinamen den absoluten (vollständigen) Dateipfad angeben.
  
  Hinweis
  Das Dateisystem des Anwendungsservers können Sie mit der Transaktion AL11 anzeigen.
  
  Ende des Hinweises.
Dateiformat
- Grundsätzlich akzeptiert das System nur Textdateien für den Datei-Upload.
  Sie können einstellen, ob als Trennzeichen zwischen den Feldwerten das Semikolon, der Tabulator, das Komma oder ein anderes druckbares Zeichen verwendet werden soll.
  
  Hinweis
  Außer dem Tabulator unterstützt das System keine unsichtbaren Zeichen.
  
  Ende des Hinweises.
- Sie können angeben, welches Zeichen eine Kommentarzeile in der Upload-Datei einleitet. Dieses Zeichen muss in der ersten Spalte jeder Kommentarzeile stehen.

Prüfen und ausführen

In diesem Schritt lädt das System die Daten hoch und prüft sie auf Konsistenz.

Wenn Sie den Upload-Modus Hochgeladene löschen gewählt haben, ermittelt das System zusätzlich die zu löschenden Stammdaten.

Bevor das System in diesem Schritt die vorhandenen Stammdaten löschen und die hochgeladenen Stammdaten sichern kann, müssen die Stammdatenänderungen über einen Änderungsantrag (oder über mehrere Änderungsanträge) beantragt, genehmigt und protokolliert werden. Daher ist in diesem Schritt des Datei-Uploads zusätzlich Folgendes zu berücksichtigen:

Wenn die hochgeladenen und die zu löschenden Stammdaten noch nicht in einen Änderungsantrag aufgenommen wurden, fordert das System den Benutzer auf, einen Änderungsantrag anzugeben.
Hierfür muss dem Benutzer mindestens ein Änderungsantrag zugeordnet sein, dessen Status die Bearbeitung von Objekten erlaubt. Dieser Änderungsantrag darf keine feste (vordefinierte) Objektliste besitzen.

Hinweis
Um dem Benutzer die Nummer des Änderungsantrags bewusst zu machen, über den die Stammdatenänderung beantragt wird, wird die Nummer beim Datei-Upload auch dann abgefragt, wenn dem Benutzer nur ein Änderungsantrag zugeordnet ist.

Ende des Hinweises.
Wenn sich noch nicht alle hochgeladenen und zu löschenden Stammdaten in einem Änderungsantrag mit einer festen Objektliste befinden, muss der Benutzer beim Datei-Upload einen Änderungsantrag angeben.

Hinweis
Der Änderungsantragstyp bestimmt, ob ein Änderungsantrag eine feste Objektliste besitzt. Den Änderungsantragstyp legen Sie im Customizing für Stammdaten-Governance unter Allgemeine Einstellungen Prozessmodellierung Änderungsanträge Typ des Änderungsantrags anlegen an.

Ende des Hinweises.
Wenn sich die hochgeladenen und die zu löschenden Stammdaten bereits in einem noch nicht freigegeben Änderungsantrag befinden, sind folgende Fälle zu unterscheiden:
- Der Änderungsantrag ist dem Benutzer zugeordnet, der den Datei-Upload durchführt.
  In diesem Fall sind keine weiteren Schritte erforderlich.
- Der Änderungsantrag ist einem anderen Benutzer zugeordnet.
  Dies führt zu einem Abbruch.
Wenn sich ein Teil der hochgeladenen und der zu löschenden Stammdaten in verschiedenen Änderungsanträgen befindet (die dem Benutzer zugeordnet und noch nicht freigegeben sind) und ein anderer Teil noch nicht, werden nur die noch nicht in einem Änderungsantrag enthaltenen Stammdaten in dem Änderungsantrag beantragt und protokolliert, den der Benutzer beim Datei-Upload angegeben hat.
Wenn beim Datei-Upload Stammdaten zu löschen sind und diese Löschung automatisch auch eine Löschung von Hierarchieeinträgen bewirkt, werden diese Hierarchieänderungen ebenfalls in den Änderungsantrag aufgenommen. Voraussetzung hierfür ist jedoch, dass sich die Hierarchieeinträge noch nicht in einem anderen, noch nicht freigegebenen Änderungsantrag des Benutzers befinden.

Beispiel

Erstbefüllung der Stammdatentabellen beim Produktivstart