Import und Export von M3-Datensetdefinitionen

In diesem Dokument wird der Import und Export von Datensetdefinitionen in M3 beschrieben.

Mit dem Import und Export der M3-Datensetdefinitionen können Sie M3-Datensetdefinitionen von einer Firma oder einem Tenant nach einer anderen Firma oder einem anderen Tenant importieren und exportieren. Sie können Datensetdefinitionen im XML-Format aus folgenden Programmen exportieren und sie über APIs und Funktionsprogramme in die M3-Datenbank importieren.

  • "Datenset. Öffnen" (OSS401)
  • "Datenset. Kumulatorfelder verbinden" (OSS402)
  • "Datenset. Auswahlfelder verbinden" (OSS403)
  • "Datenset. Feldwerte verbinden" (OSS404)
  • "Datenset. Transaktionstypen verbinden" (OSS406)
  • "Verkaufsbudget. Öffnen" (OSS420)

Die Konfigurationsartikeldatei unterstützt die Importstrategien "Replace existing records" und "Keep existing records" im Business Engine Configuration Data-Tool. In (OSS401) können bis zu 200 Datensätze in einem Schritt exportiert werden.

Einschränkungen

  • Die Aktivierung eines Datensets in (OSS401) und des Verkaufsbudgets in (OSS420) und die Aktualisierung einer Budgetversion in (OSS401) werden nur während "Vorhandene Datensätze ersetzen" unterstützt.
  • Wenn die XML-Datei beim Import Datensätze in (OSS402), (OSS403), (OSS404), (OSS406) oder (OSS420) enthält, die nicht in der Zielfirma vorhanden sind, werden diese Datensätze unabhängig von der ausgewählten Option hinzugefügt ("Keep existing records" oder "Replace existing records"). Beispiel: Sie importieren ein Datenset in Firma B mit diesen Datensätzen, und diese Datensätze werden nach dem Import in Firma B aus dem Datenset gelöscht. Wenn aus irgendeinem Grund das Datensets erneut mit diesen Datensätzen importiert wird, die in Firma B gelöscht wurden, werden die Datensätze hinzugefügt, unabhängig davon, ob "Keep existing records" oder "Replace existing records" ausgewählt wurde.
  • Die Datensätze in der Datensettabelle sind nicht Bestandteil des Exports und des Imports.

Bevor Sie beginnen

Sie müssen ein Datenset erstellen. (Siehe unterstützende Funktion in Daten aus Datenset in eine Datei exportieren.)

Führen Sie folgende Schritte aus

  1. Datenset exportieren.

    Dafür haben Sie zwei Möglichkeiten.

    Auswahl des Datensets

    • Öffnen Sie (OSS401), und wählen Sie ein Datenset aus.
    • Wählen Sie für das zu exportierende Datenset die verknüpfte Option 21 = Exportkonfiguration aus. Das Fenster "Exportkonfiguration" wird angezeigt.
    • Geben Sie in das Feld "Dateiname" einen Dateinamen ein, oder übernehmen Sie den im Feld angegebenen Standardnamen. Die Eingabe in diesem Feld ist obligatorisch.
    • Geben Sie in das Feld "Version" die Dateiversionsnummer ein. Die Eingabe in diesem Feld ist obligatorisch.
    • Geben Sie in das Feld "Beschreibung" die Dateibeschreibung ein. Dieses Feld ist optional.
    • Geben Sie in das Feld "AbhängBeschreib" eine Beschreibung der Dateiabhängigkeit ein. Dieses Feld ist optional.
    • Klicken Sie auf "OK", um die Datei zu exportieren.

    Datensetbereich

    • Öffnen Sie (OSS401), und wählen Sie ein Datenset aus.
    • Geben Sie einen Datensetbereich an, indem Sie F17 = Export auswählen. Bild S wird angezeigt.
    • Geben Sie in den Feldern "Von" und "Bis" den zu exportierenden Bereich des Datensets ein.
    • Geben Sie in das Feld "Dateiname" einen Dateinamen ein, oder übernehmen Sie den im Feld angegebenen Standardnamen. Die Eingabe in diesem Feld ist obligatorisch.
    • Geben Sie in das Feld "Version" die Dateiversionsnummer ein. Die Eingabe in diesem Feld ist obligatorisch.
    • Geben Sie in das Feld "Beschreibung" die Dateibeschreibung ein. Dieses Feld ist optional.
    • Geben Sie in das Feld "AbhängBeschreib" eine Beschreibung der Dateiabhängigkeit ein. Dieses Feld ist optional.
    • Klicken Sie auf "OK", um die Datei zu exportieren.

    Die Datei wird in ein XML-Format exportiert. Die Datei wird nach dem Export auf dem M3-Dateiübertragungslaufwerk im Verzeichnis "FileImport" gespeichert. Um die Datei anzuzeigen, verwenden Sie in M3 Business Engine-Dateien das Menü "Administrations-Tools".

  2. Datenset importieren.

    Sie können den Import in M3 BE-Administrations-Tools ausführen.

    Zur Ausführung des Imports müssen die Quelldateien auf dem M3-Dateiübertragungslaufwerk im Verzeichnis "FileImport" gespeichert werden. Verwenden Sie zur Anzeige der Datei die M3 Business Engine-Dateien-App im Menü "Administrations-Tools".

    • Wählen Sie in H5 das Anwendungsmenü aus. Navigieren Sie im erweiterten Menü zu "Administrations-Tools".
    • Wählen Sie "Business Engine Configuration Data" aus.
    • Wählen Sie "Exported" aus, um eine Liste aller exportierten XML-Dateien anzuzeigen.
    • Suchen Sie nach der exportierten XML-Datei, indem Sie nach dem Namen einer Datei suchen.
    • Wählen Sie die XML-Datei aus, und klicken Sie auf "Import".

    • Das Fenster "Konfigurationsdatendatei importieren" wird angezeigt. Geben Sie die Firma und die Division ein, in die der Import erfolgen soll. Wählen Sie "Keep existing records" aus, wenn Sie das vorhandene Datenset erhalten möchten, oder "Replace existing records", wenn Sie das vorhandene Datenset ersetzen möchten. Wählen Sie "Log to file" aus, um die Protokolle nach dem Import anzuzeigen. Dies ist wichtig, falls ein Import fehlschlägt. Die Protokolle zeigen an, warum der Import nicht erfolgreich war.

      In einer Meldung wird angezeigt, ob der Import erfolgreich war oder nicht.

    Das Import-Tool liest die XML-Datei und führt die erforderlichen API-Programme aus, um die Daten in die M3 BE-Datenbank zu schreiben. Das auszuführende API-Programm und die auszuführende Transaktion werden in der XML-Datei angegeben. Wenn Daten ersetzt werden sollen, wird vor der Hinzufügetransaktion eine Löschtransaktion ausgeführt.

Verwandte Themen