Zum Hauptinhalt springen

Eine Konfiguration ins Produktivsystem bringen

Was auf einem System gebaut wurde, lässt sich auf ein anderes übertragen, ohne es noch einmal einzutippen. Xchange schreibt dafür eine Datei und liest sie auf dem anderen System wieder ein.

Vorweg:

  • Zugangsdaten tragen Sie im Zielsystem von Hand nach. Passwörter, Token und Client-Secrets bleiben auf dem Ausgangssystem; erst mit ihnen lässt sich der Stand aktivieren.
  • Das Einspielen legt einen Entwurf an und lässt Bestehendes stehen. Was es im Zielsystem gibt und in der Datei fehlt, bleibt erhalten.

Im Beispiel: Cambira betreibt neben dem Produktivsystem ein Testsystem. Dort ist eine zehnte Route entstanden, „Retouren Webshop“, und die soll nun produktiv laufen. A. Vogt exportiert den Stand dort; M. Brandt spielt die Datei hier ein, weil dafür die Aktivierung nötig ist.

Was Sie brauchen​

  • Für das Ausgeben genügt Lesen. Die beiden Schaltflächen Exportieren und Entwurf exportieren stehen allen offen, die die Konfigurationsstände sehen dürfen.
  • Für das Einspielen brauchen Sie die Berechtigung Aktivierung in der Stufe Voll. Mit ihr erscheint die Schaltfläche Importieren im Kopf des Bildschirms.
  • Das Zielsystem darf nicht älter sein als das Ausgangssystem. Eine Datei aus einer neueren Installation lässt sich in einer älteren nicht einspielen – dazu unten mehr.
  • Sie brauchen die Zugangsdaten, die im Zielsystem nachzutragen sind. Suchen Sie sie heraus, bevor Sie anfangen.

Ausgeben: immer ein ganzer Stand​

Auf dem Bildschirm Konfigurationsstände gibt es zwei Schaltflächen zum Ausgeben:

  • Exportieren im Fach Aktive Konfiguration gibt den aktiven Stand aus – das, was gerade läuft.
  • Entwurf exportieren im Fach Entwurf gibt den Entwurf aus – das, was auf die Aktivierung wartet. Die Schaltfläche erscheint nur, solange es einen Entwurf gibt.

Ausgegeben wird immer alles. Jede Datei enthält den ganzen Stand – alle Anbindungen, alle Routen, alle Wertetabellen und alles, was daran hängt: Auslöser, Filter, Zuordnungen, Schritte. Das ist der Grund, warum das Einspielen später eine Entscheidungsliste zeigt.

Xchange schlägt einen Dateinamen vor, der Stand und Zeitpunkt trägt, z. B. xchange-config-v12-20261008084500.json; ein Entwurf bekommt zusätzlich draft in den Namen. Behalten Sie ihn – er ist das Einzige an der Datei, was von außen verrät, woher sie kommt.

Die Zugangsdaten tragen Sie nach​

An den Zugangsdaten bleibt eine Übertragung am häufigsten stecken. Eine Anbindung besteht aus zwei Teilen: der Beschreibung – Adresse, Verfahren, Zeitgrenzen – und dem Geheimnis, mit dem sie sich anmeldet. Nur der erste Teil steht in der Datei.

Xchange sagt das auch: Gleich beim Öffnen des Import-Dialogs steht oben ein Warnhinweis, dass Zugangsdaten fehlen und nach dem Import neu einzugeben sind.

Was passiert, wenn Sie es überlesen: Der Import geht durch, der Entwurf ist da – und die Prüfung meldet für jede betroffene Anbindung einen Fehler. Aktivieren lässt sich nur ein Stand ohne Fehler. Tragen Sie die Zugangsdaten also vor dem Aktivieren nach – am schnellsten geht es, wenn Sie sie schon beim Import zur Hand haben.

Der Grund: Eine Konfigurationsdatei wandert per Mail, über eine Dateiablage oder einen Stick; ein Passwort, das darin stünde, wäre damit unterwegs.

Einspielen: die Datei auswählen​

Importieren steht im Kopf des Bildschirms Konfigurationsstände. Der Dialog hat zwei Schritte; dies ist der erste.

Sobald Sie die Datei gewählt haben, liest Xchange den Umschlag und zeigt ihn an, bevor irgendetwas passiert: Exportiert mit, Quellsystem, Exportiert am und drei Zahlen – Anbindungen, Routen, Wertetabellen. Exportiert mit nennt die Version von Xchange, die die Datei geschrieben hat, z. B. „Xchange 1.1.0“; bei einer Datei, die diese Angabe nicht trägt, steht dort „–“.

Import-Dialog mit dem Hinweis zu den Zugangsdaten und den Angaben der gewählten Datei.

Lesen Sie Quellsystem und Exportiert am, bevor Sie weitergehen. Es ist die einzige Stelle, an der Sie prüfen können, ob Sie die Datei erwischt haben, die Sie meinten – und die einzige Gelegenheit, bevor Sie Entscheidungen treffen.

Die drei Zahlen nennen genau die drei Objektarten, über die Sie gleich einzeln entscheiden. Was an einer Route hängt – ihr Auslöser, ihre Filter, ihre Zuordnung –, reist mit der Route, ohne eigene Zahl.

Ersetzen oder Zusammenführen: die eine Entscheidung​

Die Frage stellt sich, wenn im Zielsystem bereits ein Entwurf offen ist. Dann erscheint über dem Dateifeld eine Auswahl mit zwei Möglichkeiten.

Beide Wörter beziehen sich allein auf Ihren Entwurf.

Was damit geschieht
ErsetzenDer vorhandene Entwurf wird weggeworfen. Xchange legt einen neuen an – eine Kopie des aktiven Standes – und legt die Datei darauf.
ZusammenführenDer vorhandene Entwurf bleibt, so wie er ist. Die Datei wird darauf gelegt.

Beide lassen die Konfiguration stehen. Auch Ersetzen beginnt beim aktiven Stand statt bei einem leeren Blatt – eine Route, die es hier gibt und in der Datei fehlt, überlebt beides.

Vorausgewählt ist Zusammenführen; damit bleibt der offene Entwurf erhalten. Ersetzen wirft ihn sofort weg, sobald Sie importieren, ohne weitere Rückfrage. Steht dort ein Entwurf, der Ihnen fremd ist, schauen Sie erst nach, was darin liegt – die Schaltfläche Vergleichen zeigt es Zeile für Zeile: Eine laufende Konfiguration ändern.

Im Beispiel: Offen ist Vogts Entwurf, Version 8, bereits geprüft. Brandt lässt Zusammenführen stehen, und Vogts Arbeit bleibt im Entwurf.

Die Entscheidung wirkt sofort auf die Vorschau. Xchange vergleicht die Datei mit dem Stand, auf dem sie am Ende landet: bei Ersetzen mit dem aktiven Stand, bei Zusammenführen mit Ihrem Entwurf. Stellen Sie deshalb hier um, damit die Liste im zweiten Schritt zeigt, was das Ergebnis wird.

Einspielen: die Vorschau​

Weiter führt in den zweiten Schritt. Xchange vergleicht nun jede Anbindung, jede Route und jede Wertetabelle aus der Datei mit dem, was hier steht, und ordnet sie in drei Gruppen ein:

ÄnderungstypWas er heißtWas Sie wählen können
NeuGibt es hier noch nicht.Importieren oder Überspringen
KonfliktGibt es hier auch, mit anderem Inhalt.Überschreiben oder Überspringen
GleichGibt es hier, mit demselben Inhalt.entfällt – der Inhalt stimmt schon

Die Zeilen mit Gleich sind eingeklappt; Gleiche Objekte anzeigen blendet sie ein. Enthält die Datei nur solche, sagt Xchange das und sperrt Importieren.

Vorschau des Imports: drei Anbindungen übersprungen, die neue Route wird importiert.

Rechnen Sie mit einer langen Liste, und mit Überspringen als Normalfall. Weil jede Datei einen ganzen Stand enthält, bringt sie alles mit, was auf dem anderen System steht – auch Objekte, die hier bleiben sollen, wie sie sind.

Im Beispiel: Brandt sieht vierzehn Objekte. Eines ist Neu – die Route „Retouren Webshop“, das eigentliche Ziel, vorausgewählt auf Importieren. Die drei Anbindungen stehen auf Konflikt, weil das Testsystem eigene Adressen und eigene Zugänge hat; vorausgewählt ist dort Überschreiben, und Brandt stellt alle drei auf Überspringen. Die übrigen zehn – neun Routen und die Wertetabelle – sind Gleich und bleiben eingeklappt.

Bei den Anbindungen ist Überspringen richtig. Mit Überschreiben stünde danach bei „Webshop Cambira“ die Testadresse in der produktiven Konfiguration.

Was mit der übersprungenen Anbindung passiert​

Die neue Route zeigt auf eine Anbindung – geht sie ins Leere, wenn diese übersprungen wird?

Solange die Anbindung hier existiert, bleibt der Verweis gültig. Xchange biegt den Verweis auf die vorhandene um. Die importierte Route hängt danach an Ihrer Anbindung, mit Ihrer Adresse und Ihren Zugangsdaten.

Eine Ausnahme gibt es. War die Anbindung Neu – also hier bisher unbekannt – und Sie überspringen sie, während Sie ihre Route importieren, dann fehlt der Bezugspunkt. Die Route landet im Entwurf, aber die Prüfung meldet für sie „Anbindung ist kein gültiger Verweis“. Wenn Sie diese Meldung nach einem Import sehen, ist das hier die Ursache: Entweder Sie spielen die Anbindung nach oder Sie tragen an der Route die richtige ein.

Kommt ein Objekt aus einem anderen System und trägt nur denselben Namen, erkennt Xchange das und setzt ein Informationssymbol neben den Änderungstyp. Ein Überschreiben übernimmt dann den Inhalt, behält aber die hiesige Identität – Ihre Läufe und Ihr Verlauf bleiben also an dem Objekt hängen, das sie schon kennen. Benennt das Überschreiben dabei ein Objekt um, sagt das Symbol auch das; was es alles meldet, steht unter Konfigurationsstände.

Importieren schließt den Dialog. Das Ergebnis ist ein Entwurf; laufen wird er erst nach der Aktivierung.

Wenn die Datei nicht durchgeht​

Xchange prüft an drei Stellen.

Beim Auswählen der Datei – hier geht es nur um die Datei selbst:

  • Sie ist keine Xchange-Exportdatei oder beschädigt.
  • Sie ist zu groß; die Grenze liegt bei 10 MB.

Beim Weiter – hier vergleicht Xchange den Inhalt mit dieser Installation. Die meisten Meldungen sagen im Kern dasselbe: Die Datei stammt aus einer neueren Installation. Entweder wurde sie mit einer neueren Version von Xchange exportiert – trägt die Datei ihre Version, nennt die Meldung beide, z. B. „Diese Konfigurationsdatei wurde mit Xchange 1.1.0 exportiert und ist neuer als diese Installation (Xchange 1.0.0).“ –, oder sie enthält Felder, die es hier noch nicht gibt.

Der Ausweg ist in beiden Fällen derselbe, und die Meldung nennt ihn: diese Installation aktualisieren und die Datei danach erneut einspielen. Die Datei selbst bleibt, wie sie ist. Eine Datei aus einer älteren Installation spielt Xchange dagegen ein.

„Die Konfigurationsdatei ist unvollständig oder beschädigt und kann nicht importiert werden.“ heißt, dass in der Datei ein Teil fehlt, den jede Exportdatei enthält – meist, weil sie von Hand bearbeitet oder beim Übertragen abgeschnitten wurde. Exportieren Sie die Konfiguration erneut.

Ein unbekanntes Feld führt dabei nur dann zum Abbruch, wenn es tatsächlich etwas enthält; ein leeres lässt Xchange stillschweigend weg. Deshalb kann zwischen denselben beiden Systemen eine Datei durchgehen und die nächste abgewiesen werden – je nachdem, ob das neue Feld darin gefüllt ist.

Eine doppelte Zeile hat einen anderen Grund. Enthält eine Wertetabelle oder die Zuordnung oder Quittierung einer Route dieselbe Zeile zweimal, nennt die Meldung die betroffene Wertetabelle oder Route. Das entsteht, wenn die Datei nach dem Export von Hand bearbeitet wurde. Exportieren Sie die Konfiguration erneut und spielen Sie die neue Datei ein.

Vergleicht eine Bedingung der Zusatzdaten ein Feld mit einem anderen Feld, weist Xchange die Datei ebenfalls ab; die Meldung nennt die betroffene Route. In den Zusatzdaten vergleicht eine Bedingung ein Feld nur mit einem Wert oder Platzhalter. Ändern Sie die Bedingung im exportierenden System, exportieren Sie erneut und spielen Sie die neue Datei ein.

In der Vorschau – steht an einer Route Zuordnung in der Datei nicht lesbar oder an einer Wertetabelle Einträge in der Datei nicht lesbar, lässt sich die Datei als Ganzes nicht einspielen. Importieren bleibt gesperrt, auch wenn Sie den Eintrag auf Überspringen stellen. Korrigieren Sie die Route oder Wertetabelle im Quellsystem und exportieren Sie die Konfiguration dort erneut.

Wie es weitergeht​

  1. Zugangsdaten nachtragen – an jeder Anbindung, die neu hineingekommen ist.
  2. Prüfen, und zwar bevor Sie jemandem sagen, es sei übertragen. Fehlende Zugangsdaten stehen dort als Fehler.
  3. Aktivieren. Bis dahin läuft weiter der alte Stand: Prüfen und aktivieren.

Ist dabei versehentlich etwas aktiviert worden: Auf einen früheren Stand zurückgehen.

Siehe auch​