Protokolliert „Log-Einträge“ zu einer angegebenen „Action“. Die Information (der Eintrag selbst also) wird in der Tabelle „tempdb.dbo.TextData“ erwartet.
Hintergrund ist die Möglichkeit, die Abarbeitung einer „Action“ (also letztlich die Ausführung eines Programms) verfolgen bzw. „debug“en zu können.

Hinweise :

1. Im Fall „ReplaceLastLogPart“ muß immer der KOMPLETTE „Log“-Eintrag„ übergeben werden, da es in T-SQL keine Möglichkeit gibt, beim Datentyp „text“ den “+„-Operator (für „string-Konkatenation“) anzuwenden (daher auch “…Replace…„ im Namen des Parameters) !

2. Es können nicht beliebig viele „Log-Parts“ angelegt werden, sondern nur so viele, wie zur „CommandID“ der „ActionID“ in „CommandSettings“ zum Schlüssel „MaxNumberOfLogPartsPerAction“ konfiguriert wurden !

3. Intern wird je nach „ReplaceLastLogPart“ entweder die Prozedur fo_InsertPosting_Pu oder fo_ModifyPosting_Pu zur Speicherung des „Log-Eintrags“ verwendet. Daher sind u.a. Identifizierungsdaten nötig. Diese und evtl. andere Informationen, die als Parameter an besagte Prozeduren weitergereicht werden, müssen hier aber nicht übergeben werden, sondern sind via ac_ModifyCommandSettings_Ad zu konfigurieren.
Anders ausgedrückt :
Die Identifizierungsdaten und sämtliche andere Informationen, die benötigt werden, aber hier nicht übergeben werden, ermitteln wir uns aus „CommandSettings“ (zur „CommandID“ der „ActionID“) !

4. Um ein Suchen in den „Log-Einträgen“ zu ermöglichen, sollte der Parameter „MaintainSearchPostings“ auf „1“ gesetzt und die Suchwörter (im Regelfall alle Wörter des Eintrags) via „tempdb.dbo.AnyValues“ (die Spalte „ID“ spielt keine Rolle) übergeben werden.
Hintergrund : s. gleichnamiger Parameter von fo_InsertPosting_Pu bzw. fo_ModifyPosting_Pu !

5. Es gibt die Möglichkeit, zusätzliche „Eigenschaften“ (sprich Informationen) zum „Log-Eintrag“ zu speichern. Dazu ist „SavePostingProperties“ auf „1“ zu setzen, und die Eigenschaften müssen 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

s.a. gleichnamiger Parameter von fo_InsertPosting_Pu bzw. fo_ModifyPosting_Pu !

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:

• ac_InsertActionLog_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/ac_InsertActionLog_Ad?ActionID=<value>'

Mit xmllint ³⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/ac_InsertActionLog_Ad?ActionID=<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'),
	'ac_InsertActionLog_Ad',
		array(
			'ActionID' => <value>,
			// 'ReplaceLastLogPart' => 1,
			// 'MaintainSearchPostings' => 1,
			// 'SavePostingProperties' => 0,
			// '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="ac_InsertActionLog_Ad">
			<Parameters>
				<Parameter Name="ActionID"><!-- integer value --></Parameter>
				<!-- <Parameter Name="ReplaceLastLogPart">1</Parameter> -->
				<!-- <Parameter Name="MaintainSearchPostings">1</Parameter> -->
				<!-- <Parameter Name="SavePostingProperties">0</Parameter> -->
				<!-- <Parameter Name="Country">'german'</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>