persons_in XML-Schema

Schema

Das vollständige Schema finden Sie unter persons_in_v1_0.xsd

Im folgenden gehen wir auf die wichtigsten Elemente des Schemas ein. Beim Lesen hilft es, sich die untenstehende Beispieldatei vor Augen zu halten.

ListOfPersons

Eine Liste von Personen, die imortiert werden sollen. Jede Person darf in der Liste nur ein Mal auftauchen (referenziert über den IdentifyingValue).

Attribute

Attribut	Pflicht?	Erklärung
CreationDate	ja	Zeitpunkt, an dem die Liste auf dem Fremdsystem erstellt wurde (z.B. UNIX-Timestamp)
PersonType	ja	Zu welcher PersonTypeID sollen die Daten importiert werden. Für jeden Personentyp müssen vor dem Import die entsprechenden Konfiguration (z.B. Mappings) vorgenommen werden.
IdentifyingCharacteristicID	nein	Über welches Merkmal werden die Personen dieser Liste referenziert. Dabei muss es sich um ein „Unique-Merkmal“ handeln. Diese Einstellung überschreibt die entsprechende globale Einstellung für diese eine Liste.
IdentValuesAreCaseSensitive	nein	Soll die Groß- und Kleinschreibung bei den übergebenen IdentifyingValues (Attribut zur Person) beachtet werden?
ExecutionLevel	nein	Nur zu Debugging-Zwecken notwendig. Eine Bitmap, mit der festgelegt werden kann, welche Teile ausgeführt bzw. übersprungen werden sollen. Default-Wert: 3, siehe unten

Werte der ExecutionLevel Bitmask

0 : Führen eines detaillierten Debug-Logs. Wird derzeit imm er gemacht und kann nicht abgeschaltet werden.
1 : Daten in die Schnittstellentabellen einfügen
2 : Aufruf der Importprozedur (im_ImportPersonData_Ad)
4 : Aufruf einer individuellen Prozedur nach der Importprozedur¹⁾

Person

Eine Person mit den entsprechenden Properties. Jedes Merkmal darf zu einer Person nur ein Mal auftauchen.

Attribute

Attribut	Pflicht?	Erklärung
IdentifyingValue	ja	Über diesen Wert wird die Person referenziert. Kann auch die PersonID sein.
PersonStatus	nein	Über dieses Attribut kann gesteuert werden, ob die Daten zur Person lediglich geändert werden sollen. Mögliche Werte siehe unten

Mögliche Werte für den PersonStatus:

„NewOrModified“ : Das Standardverhalten: Personen die nicht existieren werden neu angelegt.
„Modified“ : Es werden Eigenschaften importiert, jedoch keine neuen Personen imporiert.

Property

Eine Eigenschaft zur Person.

Attribute

Attribut	Pflicht?	Erklärung
Characteristic	ja	Characteristic zu der der Wert importiert werden soll.Ist kein Mapping der Characteristic auf eine entsprechende ID konfiguriert wird der Wert nicht importiert.
Increment	nein	Ist der übergebene Wert als Inkrementeller Wert anzusehen? Siehe hierzu die Dokumentation der Prozedur pm_ImportPersonData_Ad

Beispieldatei

persons_in_sample1.xml

<?xml version="1.0" encoding="UTF-8" ?>
<ListOfPersons xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://resources.dstore.de/xsd/xml_SmartGate/persons_in_v1_0.xsd"
    PersonType="1"
    CreationDate="1237378667">
    <!-- Anlegen einer neuen Person des Typs "Accounts" -->
    <Person IdentifyingValue="klaus@dbap.de">
        <!-- Zuerst die Pflicht-Merkmale für dem Personentyp -->
        <Property Characteristic="E-Mail">klaus@dbap.de</Property>
        <Property Characteristic="Passwort">default</Property>
        <!-- Dann noch das Geburtsdatum -->
        <Property Characteristic="Geburtsdatum">23.02.1976</Property>
    </Person>
    <!-- Inkrementelles Update der Hausnummer: Ralf zieht zwei Häuser weiter -->
    <Person IdentifyingValue="ralf@dbap.de">
        <Property Characteristic="Hausnr" Increment="true">2</Property> 
    </Person>
</ListOfPersons>

¹⁾

wird in absehbarer Zukunft nicht mehr unterstützt