Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Nächste Überarbeitung | Vorhergehende Überarbeitung Letzte Überarbeitung Beide Seiten der Revision | ||
xml:persons_in_configuration [21.08.2012 ] dstore angelegt |
xml:persons_in_configuration [21.04.2015 ] dstore [Relevante Parameter] |
||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
+ | ====== persons_in Konfiguration ====== | ||
+ | Die Konfiguration der Schnittstelle geschieht über ApplicationSettings. Eine Beispielkonfiguration zum Einlesen per Import-Funktion des admin_SmartGate findet sich hier: | ||
+ | |||
+ | {{:xml:applicationsettings-persons-in.xml|}} | ||
+ | |||
+ | :!: Sofern es sich nicht um eine Sandbox-Umgebung handelt ist absolute Sorgfalt wichtig, da bestehende Einstellungen unter Umständen überschrieben werden. | ||
+ | |||
+ | Alle im folgenden beschriebenen Einstellungen können während der Laufzeit erfolgen und werden mit der Abarbeitung des nächsten Jobs nach der Konfigurationsänderung wirksam. | ||
+ | |||
+ | ===== Merkmal-Mapping ===== | ||
+ | |||
+ | Die am häufigsten verwendete Konfiguration ist die Einstellung der Zuordnung von XML-Elementen zu dStore-Merkmalen. Diese wird über den ApplicationPart "PersonMapping_<PersonTypeID>" der Application "xml_SmartGate" gesteuert. | ||
+ | |||
+ | Als Keys werden dort die Werte des Attributes "Characteristic" der "Property" eingetragen und als Values die CharacteristicIDs des dStore-Merkmals, auf das zugeordnet werden soll. | ||
+ | |||
+ | Tipp: Es müssen nicht alle Properties der XML-Datei eine Zuordung erhalten. Properties ohne Zuordnung werden ignoriert und nicht in die Schnittstellentabellen eingefügt. | ||
+ | |||
+ | ===== Parameter ===== | ||
+ | |||
+ | Alle in der folgenden Tabelle aufgeführten Einstellungen werden als Einstellung direkt zur Application "xml_SmartGate" als Key/Value Paar hinterlegt. | ||
+ | |||
+ | ==== Relevante Parameter ==== | ||
+ | |||
+ | ^KeyVariable ^Pflicht? ^Default ^Erklärung ^ | ||
+ | |PERSONS_IN_IDENTIFYINGCHARACTERISTICID_<PersonTypeID>|nein| |Über welches Merkmal werden standardmäßig die Personen referenziert (Attribut "IdentifyingValue"). Dabei muss es sich um ein "Unique-Merkmal" handeln. Kann pro XML-Datei über das entsprechende Attribut überschrieben werden. Wird hier als Merkmal "0" angegeben wird der "IdentifyingValue" als PersonID interpretiert| | ||
+ | |PERSONS_IN_EXECUTE_AFTER_IMPORT_<PersonTypeID>|nein| | Hier kann der Name einer Prozedur konfiguriert werden, die direkt nach der Ausführung des Imports von Personendaten des Typs <PersonTypeID> ausgeführt wird. Alle Werte im Attribut "IdentifyingValue" der "Person"-Elemente werden zuvor in "tempdb.dbo.AnyValues" (Spalte "Value" - Spalte ID ist mit fortlaufender Nummer belegt) eingefügt, so daß der Prozedur genau die verarbeiteten Personen zur Verfügung stehen. Sofern die Prozedur einen Parameter "IdentifyingCharacID" und/oder "PersonTypeID" besitzt, werden ihr darin die Attribut-Werte "IdentifyingCharacteristicID" bzw. "PersonType" des "ListOfPersons"-Elementes übergeben | | ||
+ | |||
+ | ==== Ressourcen-Limits ==== | ||
+ | |||
+ | Damit die Schnittstelle nicht den Datenbankserver blockiert und zu unerwünschten Performanceproblemen in den Anwendungen führt, kann hier festgelegt werden, bis zu welcher prozentualen CPU-Belastung (0,25,50,75) welche Dateigrößen (Angabe in Kilobyte) importiert werden. Die Einstellungen und jeweilige Standardwerte (Angabe in Kilobyte)sind: | ||
+ | |||
+ | * PERSONS_IN_RESOURCE_LIMIT_75 : 1 | ||
+ | * PERSONS_IN_RESOURCE_LIMIT_50 : 500 | ||
+ | * PERSONS_IN_RESOURCE_LIMIT_25 : 1000 | ||
+ | * PERSONS_IN_RESOURCE_LIMIT_0 : 10000 | ||
+ | |||
+ | ==== Überholte Parameter ==== | ||
+ | |||
+ | Folgende Parameter sind bereits weggefallen oder fallen in naher Zukunft weg und werden hier nicht mehr erläutert: | ||
+ | |||
+ | * PERSONS_IN_EXECUTE_AFTER_IMPORT_<PersonTypeID> |