Ändert einen Foren-Beitrag - hierzu benötigt die identifizierte Person das Zugriffsrecht „512“ („bearbeiten aller Postings des Forums“) bzw. das Recht „8“ („bearbeiten eigener Postings“), wenn sie ihren EIGENEN Beitrag ändern möchte.
Anmerkung : Falls die Identifizierung fehlschlägt, werden die Rechte für die anonyme Person (mit der speziellen „PersonID = 0“) gecheckt.

Wie bei fo_InsertPosting_Pu wird der „Body“, also der Beitrag selbst, in „tempdb.dbo.TextData“ erwartet. Sollen evtl. zugehörige „Binaries“ geändert werden, sind die Prozeduren fo_DeletePostingBinary_Pu und fo_InsertBinaryForPosting_Pu zu verwenden.

Anmerkung zum Parameter „MaintainSearchPostings“ :
Um ein Suchen in den „Postings“ zu ermöglichen, gibt es die Tabelle „SearchPostings“, die für einen Beitrag beliebig viele Suchwörter speichern kann - im Regelfall alle Wörter des „Subjects“ und des „Bodies“ (siehe auch fo_SearchPostings_Pu).
Leider gibt es in der ASE-Version 11.0.3 derzeit keine Möglichkeit, in T-SQL einen String vom Typ „text“ zu parsen, so daß die Ermittlung der Suchwörter in der Client-Anwendung erfolgen MUSS. Solche Suchwörter kann man aber dieser Prozedur via „tempdb.dbo.AnyValues“ (die Spalte „ID“ spielt keine Rolle) übergeben, und diese werden dann auch transaktionssicher in „SearchPostings“ eingetragen. (Ist dies gewünscht, muß „MaintainSearchPostings“ auf „1“ gesetzt werden.)
Hinweis : Ein Wort darf derzeit nicht mehr als 100 Byte belegen. Da in der „Value“-Spalte von „tempdb.dbo.AnyValues“ aber bis zu 1000 Bytes übergeben werden können, prüfen wir dies und werden ggf. einen Fehler !

Anmerkungen zum Parameter „SavePostingProperties“ :

1. Es gibt die Möglichkeit, zu dem zu ändernden Beitrag zusätzliche „Eigenschaften“ (sprich Informationen) zu verwalten (hinzufügen, ändern, löschen). Diese Eigenschaften können via „tempdb.dbo.CharacteristicValues“ übergeben werden :

• „CharacteristicID“ enthält die ID eines Merkmals, zu der die Eigenschaft gehört
• „Value“ enthält die Eigenschaft selbst

Hierzu ist „SavePostingProperties“ auf „1“ zu setzen. Sollte es bzgl. der Eigenschaften irgendwelche Fehler geben (falsches Format, das zugehörige Merkmal ist nicht für das Forum konfiguriert etc.), schlägt das Anlegen
des Beitrags fehl !
Setzt man „SavePostingProperties“ jedoch auf „2“, werden evtl. fehlerhafte Eigenschaften ignoriert, d.h. der Beitrag plus die Eigenschaften, die alle Überprüfungen bestanden haben, werden angelegt.

2. Um eine bestehende Eigenschaft zu ändern oder zu löschen, ist die NEGATIVE „PostingCharacteristicID“ zu übergeben, und als „Value“ muß die „ValueID“ übergeben werden ! Hintergrund sind Datums-Werte, die u.U. anders ausgegeben werden, als sie intern gespeichert sind. Fehlt ein „korrespondierender“ Datensatz (zur POSITIVEN „CharacteristicID“), dann wird die vorhandene Eigenschaft gelöscht.
Bsp.: Der folgende Aufruf von mi_InsertTempdb_CharacValues vor dem Aufruf dieser Prozedur (z.B. mit „SavePostingProperties = 1“) führt dazu, daß die Eigenschaft mit der „ValueID = 42“ zum Merkmal mit der ID „17“ auf den Wert „Warum“ gesetzt wird :
exec mi_InsertTempdb_CharacValues '-17¶17', '42¶Warum', Delete = 1
Hingegen würde der Aufruf…
exec mi_InsertTempdb_CharacValues '-17', '42', Delete = 1
… bewirken, daß die Eigenschaft (mit der „ValueID = 42“) zum Merkmal mit der ID „17“ gelöscht würde.

3. Eigenschaften eines Beitrags sind immer an eine „PersonID“ gebunden. Dies bedeutet, daß eine Eigenschaft entweder „allgemein“ gültigt ist - nämlich wenn „PersonID = 0“ ist - oder die Eigenschaft hat nur Gültigkeit für die durch „PersonID“ angegebene Person. Pro Merkmal ist durch das sogenannte „CommonCharacteristic“-Flag (s. Rückgabemenge von fo_GetPostingCharacs_Ad) konfiguriert, ob

• nur
• auch
• keine

allgemeine(n) Eigenschaften hinterlegt werden können.
Die durch „tempdb.dbo.CharacteristicValues“ angegebenen Eigenschaften sind immer „allgemein“, d.h. werden zur „PersonID = 0“ versucht, zu speichern. Insbesondere könnte es daher z.B. zu einem Fehler kommen, wenn eine Eigenschaft zu einem Merkmal angegeben wurde, für das „CommonCharacteristic = 2“ konfiguriert ist

4. Genau wie im „Item-“ und „Person-Management“ gehören Eigenschaften immer zu einem Merkmal - Merkmale charakterisieren sozusagen die Eigenschaften.
Wenn für das zugehörige Forum eines Beitrags mindestens ein Merkmal zugeordnet ist (→ fo_ModifyCharacsForForums_Ad), können diesem Beitrag ausschließlich Eigenschaften zu Merkmalen hinzugefügt werden, die dem Forum zugeordnet sind.

5. Sind dem Forum eines Beitrags direkt KEINE Merkmale zugeordnet (→ fo_ModifyCharacsForForums_Ad), können diesem Beitrag ausschließlich Eigenschaften zu Merkmalen hinzugefügt werden, die wenigestens einer Kategorie, in die das Forum DIREKT eingeordnet ist, zugeordnet sind (→ fo_ModifyCharacForForumCats_Ad).

6. Der Wert im Parameter „Country“ (Groß-/Kleinbuchstaben sind egal) gibt in diesem Zusammenhang an, in welchem Format die „Value“-Werte sind, falls es sich um Datums-Angaben handelt :

• 'german' : Tag-Monat-Jahr (Standardwert) - es wird auch „Germany“ akzeptiert
• 'english' : Monat-Tag-Jahr - es wird auch „England“ akzeptiert

7. Möchte man eine Ergebnismenge der fehlerhaften Eigenschaften bekommen, ist für „SavePostingProperties“ der Wert „3“ (dann schlägt das Anlegen des Beitrags fehl) bzw. „4“ (dann wird der Beitrag plus die Eigenschaften, die in Ordnung sind, angelegt) anzugeben.
Falls die Prozedur „0“ oder „-874“ („Die Posting-Eigenschaften können nicht gesetzt/geändert/gelöscht werden, da Fehler auftraten“) zurückgibt, erhält man dann eine entsprechende Rückgabemenge (s. Anmerkung zur Rückgabespalte „ErrorCode“).

Anmerkung zur Rückgabespalte „ErrorCode“ (falls „3“ oder „4“ für den Parameter „SavePostingProperties“ übergeben wurde) :

Für „ErrorCode“ sind derzeit folgende Werte möglich :

• „1“ : Das Merkmal ist dem zugehörigen Forum des Postings nicht zugeordnet
• „2“ : Die Eigenschaft ist ungültig, d.h. entspricht nicht dem Feldtyp des zugehörigen Merkmals
• „3“ : Es handelt sich um ein Merkmal mit vordefinierten Werten, aber die übergebene Eigenschaft ist nicht vordefiniert
• „4“ : Aufgrund des „CommonCharacteristic“-Flags kann die Eigenschaft zu diesem Merkmal zur angegebenen „PersonID“ nicht gesetzt werden
• „5“ : Allgemeine Eigenschaften zu diesem Merkmal dürfen nicht mehr hinzugefügt werden
• „6“ : Allgemeine Eigenschaften zu diesem Merkmal dürfen nicht mehr geändert werden
• „7“ : Allgemeine Eigenschaften zu diesem Merkmal dürfen nicht mehr gelöscht werden
• „8“ : Der Beitrag besitzt (zur gleichen „PersonID“) die Eigenschaft bereits
• „9“ : Die maximale Anzahl von Eigenschaften zu diesem Merkmal ist überschritten

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

Unformatierte Ausgabe:

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

Mit xmllint ³⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/fo_ModifyPosting_Pu?PersonIdentificationValues=<value>&PersonTypeID=<value>&UniqueID=<value>&PostingID=<value>&NewAuthor=<value>&NewEMailOfAuthor=<value>&NewSubject=<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_ModifyPosting_Pu',
		array(
			'PersonIdentificationValues' => '<value>',
			'PersonTypeID' => <value>,
			'UniqueID' => '<value>',
			'PostingID' => <value>,
			'NewAuthor' => '<value>',
			'NewEMailOfAuthor' => '<value>',
			'NewSubject' => '<value>',
			// 'MaintainSearchPostings' => 0,
			// 'KeepOldAuthor' => 0,
			// 'SavePostingProperties' => 0,
			// 'Country' => 'german',
			// '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_ModifyPosting_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="NewAuthor"><!-- varchar value --></Parameter>
				<Parameter Name="NewEMailOfAuthor"><!-- varchar value --></Parameter>
				<Parameter Name="NewSubject"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="MaintainSearchPostings">0</Parameter> -->
				<!-- <Parameter Name="KeepOldAuthor">0</Parameter> -->
				<!-- <Parameter Name="SavePostingProperties">0</Parameter> -->
				<!-- <Parameter Name="Country">'german'</Parameter> -->
				<!-- <Parameter Name="SeparatorInIdentVals">'¶'</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>