Benutzer-Werkzeuge

Webseiten-Werkzeuge

xml:persons_in_schema

Inhaltsverzeichnis

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.
IdentValuesAreCaseSensitiveneinSoll die Groß- und Kleinschreibung bei den übergebenen IdentifyingValues (Attribut zur Person) beachtet werden?
ExecutionLevelneinNur 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 Importprozedur1)

Person

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

Attribute

Attribut Pflicht? Erklärung
IdentifyingValuejaÜber diesen Wert wird die Person referenziert. Kann auch die PersonID sein.
PersonStatusneinÜ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
CharacteristicjaCharacteristic zu der der Wert importiert werden soll.Ist kein Mapping der Characteristic auf eine entsprechende ID konfiguriert wird der Wert nicht importiert.
IncrementneinIst 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>
1)
wird in absehbarer Zukunft nicht mehr unterstützt
xml/persons_in_schema.txt · Zuletzt geändert: 13.11.2014 (Externe Bearbeitung)

Seiten-Werkzeuge