XML-Konfiguration für Export und Import zwischen Umgebungen übertragen

Dieser Vorgang definiert, wie XML-Konfigurationen zwischen Umgebungen oder Firmen übertragen werden. Dazu wird eine Konfigurationsdatendatei (ZIP-Datei, die eine XML-Datei enthält) erstellt und anschließend in die Empfängerumgebung und -firma importiert. Beachten Sie, dass beim Ausführen des Importschritts in der Zielumgebung in "Listen- und Druckerprogr. Konfigurieren" (CMS005) die Option 25 = Standard wiederherstellen ausgeführt wird. Mit dieser Aktion wird sichergestellt, dass die konfigurierbaren Ausgabekonfigurationen für das Programm aktuell sind und dass die neueste XML-Struktur abgerufen wird, bevor Anpassungen vorgenommen werden.

Konfigurationsdatendatei exportieren

Diese Aktivität wird ausgeführt, um die Konfiguration in der Quellumgebung oder der Quellfirma zu extrahieren, und wird in der Empfängerumgebung oder der Empfängerfirma als Konfiguration verwendet. Die Exportkonfiguration kann auf zwei Arten abgeschlossen werden:
  • Über Option 27 = Exportkonfiguration in "Listen- und Druckerprogr. Konfigurieren" (CMS005)
  • Über Option 21 = Exportkonfiguration in "XML-Struktur. Öffnen" (CMS006)

Bevor Sie beginnen

  1. Aktivieren Sie die globale Sequenznummer in (CMS005/E) der Druckerdatei. Mit der globalen Sequenznummer kann validiert werden, welche Tabelle zuerst gelesen werden muss.
  2. Führen Sie die Exportkonfiguration entweder in (CMS005) oder in (CMS006) aus.

Konfigurationsdatendatei auf Druckerdateistufe erstellen

  1. Starten Sie "Listen- und Druckerprogr. Konfigurieren" (CMS005).
  2. Wählen Sie im Feld "Auswählen" die Option "Druckerdateien" aus.
  3. Wählen Sie die Druckerdatei aus, und verwenden Sie Option 27 = Exportkonfiguration.
  4. Geben Sie im Popup-Fenster Dateiname und -version an, und klicken Sie auf "OK".
  5. Um die XML-Exportdatei zu überprüfen, starten Sie "Konfigurationsdaten-Jobs. Öffnen" (MNS200). Wählen Sie das Startdatum und die Jobnummer aus, und verwenden Sie Option 20 = XML-Datei anzeigen.

Der tatsächliche Name der ZIP-Datei ist "ConfigData_<Dateiname>.xml.xip".

Konfigurationsdatendatei auf XML-Strukturstufe erstellen

  1. Starten Sie "XML-Struktur. Öffnen" (CMS006).
  2. Wählen Sie die XML-Struktur aus, und verwenden Sie Option 21 = Exportkonfiguration.
  3. Geben Sie im Popup-Fenster Dateiname und -version an, und klicken Sie auf "OK".
  4. Um die XML-Exportdatei zu überprüfen, starten Sie "Konfigurationsdaten-Jobs. Öffnen" (MNS200). Wählen Sie das Startdatum und die Jobnummer aus, und verwenden Sie Option 20 = XML-Datei anzeigen.

Der tatsächliche Name der ZIP-Datei ist "ConfigData_<Dateiname>.xml.xip".

Konfigurationsdatendatei importieren

Diese Aktivität wird verwendet, um Informationen von einer Umgebung oder einer Firma in eine andere Umgebung oder eine andere Firma zu migrieren.

Bevor Sie beginnen

  1. Führen Sie in (CMS005/B) die Option 25 = Standard wiederherstellen aus, um sicherzustellen, dass die XML-Struktur für die Druckerdatei aktuell ist.
  2. Aktivieren Sie bei Bedarf die globale Sequenznummer.
  3. Stellen Sie sicher, dass alle Informationen der Ursprungsumgebung oder Ursprungsfirma in der Empfängerumgebung oder Empfängerfirma gefunden werden wie z. B. Sortierfolgen und benutzerdefinierte Tabellen.
  4. Führen Sie den Import aus.

Der Import erfolgt in M3 BE-Administrations-Tools.

  1. Wählen Sie in H5 das Anwendungsmenü aus. Navigieren Sie im erweiterten Menü zu "Administrations-Tools".
  2. Wählen Sie "Business Engine Configuration Data" aus.
  3. Wählen Sie "Exported" aus, um eine Liste aller XML-Exportdateien anzuzeigen. Die Liste ist der Liste in (MNS200) ähnlich.
  4. Wählen Sie die XML-Datei aus, und klicken Sie auf "Import". 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. Beim Import entscheiden Sie, ob die vorhandenen Daten ersetzt werden sollen oder nicht. Wenn Daten ersetzt werden sollen, wird vor der Hinzufügetransaktion eine Löschtransaktion ausgeführt.

Importprotokolle prüfen

Ein Importprotokoll wird erstellt, wenn im Fenster "Import Configuration Data" die Option "Log to file" ausgewählt wird. Nach der erfolgreichen Ausführung des Imports werden die Download-Protokolle angezeigt. Das Importprotokoll zeigt die Konfigurationen an, z. B. Transaktionsname, Tabellenname, Feldnamen und Informationen, die eine bestimmte Transaktion beschreiben, die nicht importiert werden.
Hinweis

Das Importprotokoll muss dahingehende geprüft werden, ob eine Abweichung zwischen Quellumgebung oder Quellfirma und Zielumgebung oder Zielfirma vorliegt. Das Protokoll gibt Aufschluss darüber, ob Konfigurationseinstellungen fehlen oder falsch sind, die den Abschluss des Imports verhindern.

Details zur XML-Konfigurationsdatendatei

Der Inhaltsteil der Konfigurationsdatendatei besteht immer aus folgenden Abschnitte: Überprüfen, Löschen und Hinzufügen. Er wird von Anfang bis Ende verarbeitet.

  • Scheck

    Optionaler Abschnitt.

    Gibt an, ob API-Transaktionen vor dem Start von Lösch- und Hinzufügetransaktionen auf verknüpfte Daten überprüft werden müssen. Wenn die API-Transaktionen eine Fehlermeldung auslösen, wird der Prozess beendet und die Hinzufüge- und Löschabschnitte werden nicht verarbeitet.

  • Löschen

    Erforderlicher Abschnitt.

    Spezifikation von API-Transaktionen, die das Löschen vorhandener Daten erfordern. Der Löschabschnitt wird nur verarbeitet, wenn im Tool-Assistenten das Kontrollfeld "Vorhandene Daten ersetzen" aktiviert ist. Normalerweise wird mindestens eine API-Transaktion angegeben, aber bei Bedarf werden auch mehrere API-Transaktionen aufgelistet. Fehler- oder Warnmeldungen von API-Transaktionen werden protokolliert, aber XML setzt die Verarbeitung mit der nächsten API-Transaktion fort.

  • Hinzufügen

    Erforderlicher Abschnitt

    Spezifikation von API-Transaktionen, die zusätzliche Daten erfordern. Der Hinzufügeabschnitt wird immer verarbeitet, es sei denn, im Prüfabschnitt wurde ein Fehler gefunden. Normalerweise wird mindestens eine API-Transaktion angegeben, aber bei Bedarf werden auch mehrere API-Transaktionen aufgelistet. Fehler- oder Warnmeldungen von API-Transaktionen werden protokolliert, aber XML setzt die Verarbeitung mit der nächsten API-Transaktion fort.

Verwandte Themen