Prozedur zum Anlegen einer Person.

Wichtiger Hinweis :
Das Merkmal „Kundennummer“ (ID „1“) darf als „MaxLength“ (in „FieldTypes“) keinen Wert größer als 19 haben, da derzeit nicht mehr als 16 Zahlen (plus 3 Zeichen für das „GEN“-Präfix) generiert werden !

Anmerkung zur Rückgabespalte „ResultCode“ :
Folgende Codes können derzeit zurückgegeben werden :
„2“ : Die Eigenschaft existiert bereits, aber das zugehörige Merkmal ist eindeutig („IsUnique = 1“) !
„3“ : Es handelt sich um ein Merkmal mit vordefinierten Werten, aber die übergebene Eigenschaft existiert nicht
„4“ : Die Eigenschaft gehört zu einem Merkmal, das nicht dem Informationstyp („PersonCharacCategoryID“) zugeordnet ist.
„5“ : Das Merkmal darf aufgrund von Zugriffsbeschränkungen nicht editiert werden
„6“ : Der Wert ist ungültig, d.h. entspricht nicht dem Feldtyp des zugehörigen Merkmals
„7“ : Pflichtmerkmal („Required = 1“ in „PersonCharacteristics“), zu dem keine Eigenschaft angegeben wurde bzw. dessen Eigenschaft fehlerhaft ist (im letzteren Fall taucht das Merkmal ein zweites Mal in der Ergebnismenge auf, und zwar mit dem Code „2“, „3“ oder „6“)
„8“ : Wie „7“, mit dem Unterschied, daß es sich um ein Kategorie-Pflichtmerkmal („Required = 1“ in „PersoncCharacsInCategories“) handelt
„9“ : Pflichtmerkmale („Required“ in „PersonCharacteristics“ oder „PersonCharacsInCategories“ enthält den Wert „1“) können nicht gelöscht werden
„10“ : Der vordefinierte Wert ist zwar angelegt, aber entweder nicht mehr oder noch nicht gültig

Hinweis zum Dubletten-Check :

1. Beim Ändern von Personendaten, also auch insbesondere beim Anlegen neuer Personen, kann ein Dubletten-Check durchgeführt werden. Vorraussetzung dafür ist zum einen, daß der „PersonTypeSettings“-Eintrag „CharacteristicsForDuplicateSearch“ für den entsprechenden Personen-Typ konfiguriert ist oder „_ac_ExecuteDuplicateCheck“ (individuell) implementiert ist. Standardmäßig ist die Prozedur „_ac_ExecuteDuplicateCheck“ so codiert, daß eine „Action“ angelegt wird, die als Parameter die betroffene „PersonID“ (zur „KeyVariable = AffectedPersonID“) sowie zur „KeyVariable = ActionInsertedByProcedure“ den Prozedurnamen „_ac_ExecuteDuplicateCheck“ besitzt.
Es ist dann noch ein entsprechendes Skript/Programm einzurichten, das diese Actions abarbeitet, d.h. letztlich die Prozedur pm_UpdatePossibleDuplicates_Ad aufruft. Die Prozedur „_ac_ExecuteDuplicateCheck“ legt diese Action aber nur an, wenn der besagte „PersonTypeSettings“-Eintrag vorhanden ist. Diese Prozedur kann natürlich (wie alle „ac“-Prozeduren) individuell angepaßt werden.

2. Soll ein Dubletten-Check ohne Verzögerung durchgeführt werden, d.h. transaktionssicher zusammen mit dem Anlegen der Personendaten, ist der „PersonTypeSettings“-Eintrag „ExecDuplicateCheckImmediately“ für den entsprechenden Personen-Typ auf „1“ zu setzen. In diesem Fall wird eine interne Prozedur aufgerufen, die den Dubletten-Check durchführt und dazu den bereits erwähnten Eintrag aus „PersonTypeSettings“ zum Schlüssel „CharacteristicsForDuplicateSearch“ ZWINGEND benötigt (ansonsten gibt es zwar keinen Fehler, es wird aber auch nichts weiter ausgeführt) !

Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.

Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:

• pm_InsertNewPerson_Pu im Engine Playground öffnen

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/pm_InsertNewPerson_Pu?UniqueID=<value>&CharacteristicIDList1=<value>&ValueList1=<value>'

Mit xmllint ⁶⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/pm_InsertNewPerson_Pu?UniqueID=<value>&CharacteristicIDList1=<value>&ValueList1=<value>' | xmllint --format -

use dStore_php\WebService;
 
$service = new WebService\Service( WebService\Scheme::HTTP,'<partner>-<project>.dstore.de', 80);
 
$request = new WebService\Requests\Engine\Procedure\Request(
			new WebService\Requests\AccessData('default'),
	'pm_InsertNewPerson_Pu',
		array(
			'UniqueID' => '<value>',
			'CharacteristicIDList1' => '<value>',
			'ValueList1' => '<value>',
			// 'CharacteristicIDList2' => NULL,
			// 'ValueList2' => NULL,
			// 'PersonCharacCategoryID' => 1,
			// 'ResultInErrorIDList' => 1,
			// 'ValueIDsForPredefinedCharacs' => 1,
			// 'GeneratePassword' => 0,
			// 'GenerateCustomerNo' => 0,
			// 'CancelOnError' => 0,
			// 'SeparatorInLists' => '¶',
			// 'UpdateVisitorPersons' => 1,
			// 'PersonTypeID' => NULL,
			// 'Country' => 'german'
		)
);
 
$service->execute($request);
 
			$xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument();
			$ResultSet = $xml_result->getRowsAsArray();
 
$OutputParams = $xml_result->getOutputParametersAsArray();

XML zur Ausführung mit der Methode engine/execute, z.B. per

curl --header 'Content-Type: application/xml' -X POST 'http://<partner>-<kunde>.dstore.de/default/engine/execute' -d '<xml-daten>'

<?xml version="1.0" encoding="UTF-8"?>
<ListOfBatches>
	<Batch No="0">
		<Procedure Name="pm_InsertNewPerson_Pu">
			<Parameters>
				<Parameter Name="UniqueID"><!-- varchar value --></Parameter>
				<Parameter Name="CharacteristicIDList1"><!-- varchar value --></Parameter>
				<Parameter Name="ValueList1"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="CharacteristicIDList2">NULL</Parameter> -->
				<!-- <Parameter Name="ValueList2">NULL</Parameter> -->
				<!-- <Parameter Name="PersonCharacCategoryID">1</Parameter> -->
				<!-- <Parameter Name="ResultInErrorIDList">1</Parameter> -->
				<!-- <Parameter Name="ValueIDsForPredefinedCharacs">1</Parameter> -->
				<!-- <Parameter Name="GeneratePassword">0</Parameter> -->
				<!-- <Parameter Name="GenerateCustomerNo">0</Parameter> -->
				<!-- <Parameter Name="CancelOnError">0</Parameter> -->
				<!-- <Parameter Name="SeparatorInLists">'¶'</Parameter> -->
				<!-- <Parameter Name="UpdateVisitorPersons">1</Parameter> -->
				<!-- <Parameter Name="PersonTypeID">NULL</Parameter> -->
				<!-- <Parameter Name="Country">'german'</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>