Kopiert einen Forum-Beitrag - inklusive aller Antworten des Beitrags (sofern gewünscht).
Im folgenden sprechen wir daher der Einfachheit halber von „zu kopierenden Beiträgen“.

Hinweise :

1. Selbstverständlich werden immer die Rechte, die die durch „PersonIdentificationValues“, „PersonTypeID“ und „UniqueID“ identifizierte Person hat, für das Forum der zu kopierenden Beiträge sowie für das Forum, in das die Beiträge kopiert werden sollen, überprüft. Falls die Identifizierung fehlschlägt, werden die Rechte für die anonyme Person (mit der speziellen „PersonID = 0“) gecheckt.

Es werden folgende Rechte benötigt :

(i) Im „Quellforum“ genügt lesender Zugriff, sofern die zu kopierenden Beiträge im Status „4“ oder „8“ sind.
Gibt es jedoch einen Beitrag, der „unbestätigt“ ist („Visible = 1“), muß die identifizierte Person das Recht zum Bestätigen von Postings („AccessLevelID = 64“) besitzen - sonst gibt es den Fehler „-802“. Alternativ kann man solche Beiträge auch auslassen (um den Fehler zu vermeiden), indem man für „IncludeReplies“ den Wert „2“ angibt. Ist allerdings schon der durch „PostingID“ angegeben Beitrag selbst „unbestätigt“ und besitzt die identifizierte Person nicht das entsprechende Recht, ist ein Fehler in jedem Fall unvermeidbar.

(ii) Im „Zielforum“ (also entweder in „TargetForumID“ oder im Forum von „TargetPostingID“) wird je nach „KeepAuthor“ und je nachdem ob ein „MainPosting“ oder eine oder mehrere Antwort(en) entsteht/entstehen, eines der folgenden Rechte benötigt :

• „anlegen eines Beitrags unter anderem Autor“ („AccessLevelID = 8192“)
• „eröffnen eines neuen Threads“ („AccessLevelID = 4“)
• „antworten auf bestehendes Posting“ („AccessLevelID = 2“)

2. In der Kopie sind sowohl „Binaries“ als auch „PostingProperties“ eingeschlossen - bei letzteren allerdings nur solche zur
„PersonID = 0“ ! Ist anderes gewünscht, kann man „IncludeBinaries“ bzw. „IncludeProperties“ auf „0“ setzen. Natürlich kann es vorkommen, daß für das Zielforum (in dem die Kopie erstellt werden soll) andere Beschränkungen hinsichtlich „Binaries“ konfiguriert sind (Anzahl „Binaries“, Maximale Größe eines Binaries, etc.). Verletzt ein „Binary“, das zu kopieren ist, diese Beschränkung, gibt es einen entsprechenden Fehler. Möchte man solche „Binaries“ hingegen einfach auslassen, setzt man „IncludeBinaries“ auf „2“.
Analog kann es sein, daß bestimmte Merkmale für „PostingProperties“ im Zielforum nicht erlaubt sind - dann gibt es ebenfalls einen Fehler. Um solche Eigenschaften auszulassen (und damit einen Fehler zu vermeiden), setzt man „IncludeProperties“ auf „2“.

3. Ist „PostingID“ bereits im Visible-Status „gelöscht“, kann der Beitrag NICHT mehr kopiert werden ! ( ⇒ „-803“)

4. Antworten, die „gelöscht“ sind („Visible = 0“) werden grundsätzlich NICHT KOPIERT !

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:

• fo_CopyPosting_Pu im Engine Playground öffnen

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/fo_CopyPosting_Pu?PersonIdentificationValues=<value>&PersonTypeID=<value>&UniqueID=<value>&PostingID=<value>&TargetForumID=<value>'

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/fo_CopyPosting_Pu?PersonIdentificationValues=<value>&PersonTypeID=<value>&UniqueID=<value>&PostingID=<value>&TargetForumID=<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'),
	'fo_CopyPosting_Pu',
		array(
			'PersonIdentificationValues' => '<value>',
			'PersonTypeID' => <value>,
			'UniqueID' => '<value>',
			'PostingID' => <value>,
			'TargetForumID' => <value>,
			// 'TargetPostingID' => NULL,
			// 'KeepAuthor' => 0,
			// 'IncludeReplies' => 1,
			// 'IncludeBinaries' => 1,
			// 'IncludeProperties' => 1,
			// 'Author' => NULL,
			// 'EMailOfAuthor' => NULL,
			// 'SeparatorInIdentVals' => '¶'
		)
);
 
$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="fo_CopyPosting_Pu">
			<Parameters>
				<Parameter Name="PersonIdentificationValues"><!-- varchar value --></Parameter>
				<Parameter Name="PersonTypeID"><!-- tinyint value --></Parameter>
				<Parameter Name="UniqueID"><!-- varchar value --></Parameter>
				<Parameter Name="PostingID"><!-- integer value --></Parameter>
				<Parameter Name="TargetForumID"><!-- smallint value --></Parameter>
				<!-- <Parameter Name="TargetPostingID">NULL</Parameter> -->
				<!-- <Parameter Name="KeepAuthor">0</Parameter> -->
				<!-- <Parameter Name="IncludeReplies">1</Parameter> -->
				<!-- <Parameter Name="IncludeBinaries">1</Parameter> -->
				<!-- <Parameter Name="IncludeProperties">1</Parameter> -->
				<!-- <Parameter Name="Author">NULL</Parameter> -->
				<!-- <Parameter Name="EMailOfAuthor">NULL</Parameter> -->
				<!-- <Parameter Name="SeparatorInIdentVals">'¶'</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>