Überprüfen der Adapterkonfiguration
Beim Hinzufügen des Empfangsspeicherorts und des Sendeports werden Sie aufgefordert, Ihre benutzerdefinierten Eigenschaften im Dialogfeld Transporteigenschaften des <Adapternamens> zu konfigurieren. Diese Eigenschaften werden in den XSD-Schemadateien des Projekts AdapterHarness definiert.
Die Überprüfung des Konfigurationsschemas erfolgt in drei Schritten:
Beim Anzeigen einer gespeicherten Konfiguration wird das gespeicherte XML-Dokument vom Adapterframework vor dem Laden des Dokuments in die Eigenschaftenseite anhand des Schemas überprüft. Dabei wird vom Framework davon ausgegangen, dass ein ungültiges Dokument auf eine Änderung in der Definition des Konfigurationsschemas hinweist. Nur gültige Dokumente werden in die Eigenschaftenseite geladen.
Wenn der Adapter beim Speichern einer Konfiguration die IAdapterConfigValidation-Schnittstelle implementiert, übergibt das Framework an den Adapter das XML-Dokument, das aus der Serialisierung der Eigenschaftenseitendaten erstellt wurde. Anschließend wird das Dokument vom Adapter verarbeitet. Jegliche Fehler sollten Ausnahmen auslösen, die vom Framework abgefangen und dem Benutzer angezeigt werden. Fehlende oder zu erzeugende Werte sollten bei der Überprüfung generiert werden. Die Verwendung der <durchsuchbaren show="false">-Dekoration unterdrückt die Anzeige eines Eintrags im Eigenschaftenraster, obwohl der Wert im XML-instance angezeigt wird.
Beim Speichern einer Konfiguration wird das XML-Dokument vom Framework vor dem Speichern des Werts in der Datenbank erneut anhand des Schemas überprüft. Dadurch wird sichergestellt, dass nur gültige Daten persistent gespeichert werden.