Geändertes XML-Schema aktualisieren

Wenn Sie ein Projekt erstellt haben, das ein XML-Schema verwendet, und das XML-Schema geändert wird, können Sie versuchen, das vorhandene XML-Schema mit dem neuen XML-Schema zu aktualisieren.

Informationen zu diesem Vorgang

Eine Aktualisierung auf ein neues XML-Schema bedeutet, dass alle Projektentitäten, die mit dem XML-Schema arbeiten, von der Änderung betroffen sein können. Die folgenden Projektentitäten können von einer Änderung des XML-Schemas betroffen sein:
  • Zuordnungen, die sich auf das XML-Schema beziehen, sowohl eigenständige Zuordnungen als auch die in Aktivitäten integrierten Zuordnungen
  • Variablen, die sich auf das XML-Schema beziehen
  • XPath-Ausdrücke in Orchestrierungen
  • XPath-Ausdrücke, die in Jobschlüsseln verwendet werden
  • Einige Endpunktkonfigurationen
  • Bedingungen, die in Orchestrierungen definiert sind
Während des Aktualisierungsprozesses meldet Studio zurück, welche Projektentitäten von der Änderung betroffen sind, bevor die Änderung festgeschrieben wird.

Ein XML-Schema definiert zum Beispiel einen Eingabeparameter für die Aktivität zum Zuordnen von Variablen (Map Variables). Im Fenster 'Von Orchestrierung' der Aktivität Map Variables werden Verknüpfungen zwischen den Knoten des Eingabeparameters und den Knoten der Ausgabeparameter angezeigt. Wenn das XML-Schema, das den Eingabeparameter definiert, auf ein neues XML-Schema aktualisiert wird, sind dessen Verknüpfungen vielleicht nicht mehr gültig, weil die Eingabeknoten im neuen XML-Schema umbenannt oder entfernt wurden. Sie müssen die Verknüpfungen erneut erstellen, um die Orchestrierung wieder gültig zu machen.

In einigen Fällen verhindert Studio das Hochladen eines neuen XML-Schemas aus den folgenden Gründen ganz:
  • Das neue XML-Schema ist ungültig.
  • Durch Hochladen des neuen XML-Schemas zum Ersetzen des vorhandenen ergäbe sich ein ungültiges Projekt.
Anmerkung: Die Aktualisierung eines vorhandenen XML-Schemas (wie in den nachfolgenden Schritten beschrieben) unterscheidet sich vom Laden mehrerer XML-Schemata in ein Projekt, bei dem entweder eine Datei auf die Registerkarte Projekt gezogen wird oder mit der rechten Maustaste auf den Ordner für XML-Schemata auf der Registerkarte Projekt geklickt und die Option Dokument hinzufügen ausgewählt wird. Die Aktualisierung eines vorhandenen XML-Schemas ersetzt das vorhandene XML-Schema im Projekt, während beim Hochladen derselben Datei auf die Registerkarte Projekt zwei Instanzen des XML-Schemas im Projekt erstellt werden.

Vorgehensweise

  1. Öffnen Sie das XML-Schema, das bereits im Projekt verwendet wird und das durch das neue XML-Schema ersetzt werden soll. Öffnen Sie die grafische Darstellung oder die Quellensicht des XML-Schemas:
    • Grafische Darstellung: Öffnen Sie die Registerkarte Projekt und klicken Sie doppelt auf das XML-Schema im Verzeichnis XML-Schemata. Die Knoten des XML-Schemas werden auf der Registerkarte XML-Schema angezeigt. Klicken Sie auf der Registerkarte 'XML-Schema' auf einen beliebigen Knoten des Schemas.
    • Quellensicht: Öffnen Sie die Registerkarte Projekt und klicken Sie doppelt auf das XML-Schema im Verzeichnis XML-Schemata. Die Knoten des XML-Schemas werden auf der Registerkarte XML-Schema angezeigt. Klicken Sie mit der rechten Maustaste auf die Registerkarte und wählen Sie die Option Quelle des XML-Schemas anzeigen im Menü aus. Klicken Sie auf der Registerkarte XML-Schema auf eine beliebige Zeile des XML-Schemas.
  2. Wählen Sie ein neues XML-Schema zum Ersetzen des vorhandenen XML-Schemas mit einer der folgenden Optionen aus:
    • Wenn die grafische Darstellung des XML-Schemas geöffnet ist, können Sie eine XML-Schemadatei aus dem lokalen Dateisystem in das XML-Schema ziehen, das auf der Registerkarte XML-Schema geöffnet ist.
    • Wählen Sie die Optionen Datei > Aktualisieren im Studio-Symbolleistenmenü aus. Das Dialogfenster Aktuelles Schemadokument aktualisieren wird angezeigt. Geben Sie im Feld Position die Position des neuen XML-Schemas an einer externen Webadresse oder im Dateisystem an.
  3. Klicken Sie auf OK. Das Dialogfenster 'Die Aktualisierung des XML-Schemas wirkt sich auf die aufgelisteten abhängigen Projektentitäten aus' wird angezeigt und listet alle Projektentitäten auf, die potenziell von der Ersetzung des ursprünglichen XML-Schemas durch das neue XML-Schema betroffen sind.
  4. Optional: Klicken Sie im Dialogfenster auf eine beliebige der aufgelisteten abhängigen Entitäten, um die betroffene Entität in Studio anzuzeigen.
  5. Klicken Sie auf Aktualisieren. Studio versucht, das Projekt mit dem neuen XML-Schema zu aktualisieren. Das Ergebnis der versuchten Aktualisierung hängt von den folgenden Bedingungen ab:
    • Wenn Änderungen im XML-Schema nach der Aktualisierung ein beschädigtes Projekt zur Folge hätten oder das neue XML-Schema ungültig ist, wird das Dialogfenster Fehler mit einer Beschreibung des Problems im XML-Schema angezeigt. Klicken Sie auf OK. Die Aktualisierung wird abgebrochen, das XML-Schema wird auf das ursprüngliche XML-Schema zurückgesetzt und das Projekt wird nicht geändert.
    • Wenn die Änderungen am XML-Schema kein beschädigtes Projekt zur Folge haben und das XML-Schema gültig ist, wird die Aktualisierung ausgeführt und das ursprüngliche XML-Schema wird durch das neue XML-Schema ersetzt. Einige der Projektentitäten sind nach der Aktualisierung möglicherweise ungültig und erfordern eine Bereinigung. Es zum Beispiel möglich, dass Verknüpfungen in den Fenstern 'Eingaben zuordnen' und 'Ausgaben zuordnen' nach der Aktualisierung neu erstellt werden müssen. Zur Ermittlung der Gültigkeitsfehler öffnen Sie eine Orchestrierung und wählen Orchestrierung > Validieren im Studio-Symbolleistenmenü aus.
  6. Klicken Sie auf Schließen.