Exportiert eine Liste von Personendaten und gibt diese (via „print“) an die Standardausgabe.

Hinweise :

1. Es kann natürlich vorkommen, daß nicht alle Eigenschaften in einen „string“ von maximal 1000 Bytes passen (da wir mit dem „print“-Kommando arbeiten, welches derzeit eine Beschränkung von ca. 1000 Bytes hat). Bei betroffenen Personen wird dann versucht, soviel Eigenschaften wie möglich zu speichern. Die Zeile enthält aber auf jeden Fall genauso viele Vorkommen von „Separator“-Zeichen ! Anstelle der Eigenschaften (die nicht ausgegeben werden können) steht dann ein „-“, und die letzte Eigenschaft ist immer „ERROR, 1000 BYTES EXCEEDED !“, um das Problem (und die Ursache) erkennen zu können.

2. Pro Merkmal kann festgestellt werden, wieviele Bytes maximal für eine Eigenschaft belegt sein könnten. Bildet man eine Summe für alle (in „CharacteristicIDList“) angegebenen Merkmale, kann leicht errechnet werden, wieviele Zeichen eine Ausgabezeile maximal haben kann. Übersteigt der (theoretische) Wert die Zahl 1000, wird eine entsprechende „WARNING“-Meldung zu Beginn ausgegeben.

Anmerkung zu den Parametern „CharStringsInPropsToReplace“ und „ReplaceCharStringsInPropsBy“ :

Sind bestimmte Zeichen, die in Personen-Eigenschaften vorkommen können, unerwünscht, kann man durch „CharStringsInPropsToReplace“ und „ReplaceCharStringsInPropsBy“ eine Ersetzung vornehmen lassen. In beiden Parametern können Zeichenketten (durch „¶“ getrennt) übergeben werden. Alle Vorkommen der ersten in „CharStringsInPropsToReplace“ angegebenen Zeichenkette werden durch die erste in „ReplaceCharStringsInPropsBy“ angegebene Zeichenkette ersetzt, alle Vorkommen der zweiten (…) Zeichenkette werden durch die zweite (…) ersetzt usw.
Hierzu ein Beispiel :
Übergibt man „ CharStringsInPropsToReplace = 'ܶü¶,¶ß' “ und „ ReplaceCharStringsInPropsBy = 'Ue¶ue¶¶ss' “ führt dies dazu, daß in allen Eigenschaften das Zeichen „Ü“ bzw. „ü“ durch die Zeichenkette „Ue“ bzw. „ue“ ersetzt wird, daß alle Vorkommen von „,“ ENTFERNT (!) werden und daß an Stelle von „ß“ ein „ss“ ausgegeben wird.
Hinweis : Ist für das „Separator“-Zeichen keine Ersetzung angegeben, führt dies automatisch dazu, daß dieses Zeichen durch „?“ ersetzt wird; im „default“-Fall bedeutet dies quasi die implizite Angabe von „ CharStringsInPropsToReplace = ',' “ und „ ReplaceCharStringsInPropsBy = '?' “.

Anmerkung zum Parameter „LastEditedInfoForCharacIDs“ :

Hier kann man eine Liste (wie immer durch „¶“ getrennt) von „PersonCharacteristicID“s angeben, zu denen man die Information, wann die entsprechende Eigenschaft der Person zuletzt geändert wurde, bekommen möchte.
Diese Information ist NICHT verfügbar, wenn die Person aktuell KEINE Eigenschaft zum entsprechenden Merkmal besitzt UND keine Historie vorhanden ist - in diesem Fall wird die durch „StringForNoProperty“ angegebene Zeichenkette ausgegeben.
Die entsprechende „Zeilenüberschrift“ (erste Zeile in der Ausgabe) setzt sich aus der „CharacteristicDescription“ des Merkmals plus der Zeichenkette „_LE“ (für „LastEdited“) zusammen.

Die Prozedur hat keine Rückgaben.

Die Prozedur hat keine Output-Parameter.

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_ExportPersonData_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/pm_ExportPersonData_Ad?PersonTypeID=<value>&CharacteristicIDList=<value>'

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/pm_ExportPersonData_Ad?PersonTypeID=<value>&CharacteristicIDList=<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_ExportPersonData_Ad',
		array(
			'PersonTypeID' => <value>,
			'CharacteristicIDList' => '<value>',
			// 'Separator' => ',',
			// 'CharStringsInPropsToReplace' => NULL,
			// 'ReplaceCharStringsInPropsBy' => NULL,
			// 'RowCount' => 0,
			// 'IncludePersonID' => 0,
			// 'StringForNoProperty' => 'NULL',
			// 'DateFormat' => 'german',
			// 'IncludeCreationDate' => 0,
			// 'IncludeLastEditedDate' => 0,
			// 'LastEditedInfoForCharacIDs' => NULL
		)
);
 
$service->execute($request);
 
			$xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument();
			$ResultSet = $xml_result->getRowsAsArray();

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_ExportPersonData_Ad">
			<Parameters>
				<Parameter Name="PersonTypeID"><!-- tinyint value --></Parameter>
				<Parameter Name="CharacteristicIDList"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="Separator">','</Parameter> -->
				<!-- <Parameter Name="CharStringsInPropsToReplace">NULL</Parameter> -->
				<!-- <Parameter Name="ReplaceCharStringsInPropsBy">NULL</Parameter> -->
				<!-- <Parameter Name="RowCount">0</Parameter> -->
				<!-- <Parameter Name="IncludePersonID">0</Parameter> -->
				<!-- <Parameter Name="StringForNoProperty">'NULL'</Parameter> -->
				<!-- <Parameter Name="DateFormat">'german'</Parameter> -->
				<!-- <Parameter Name="IncludeCreationDate">0</Parameter> -->
				<!-- <Parameter Name="IncludeLastEditedDate">0</Parameter> -->
				<!-- <Parameter Name="LastEditedInfoForCharacIDs">NULL</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>