Mit dieser Prozedur kann man für registrierte Prozeduren die Aufruf-Protokollierung und den Check von Ausführungsrechten anhand von Parameter-Bedingungen konfigurieren bzw. „customized“-Prozeduren neu registrieren.

Anmerkungen zu den Parametern „CheckForExecutionRestrictions“ und „LogExecutions“ :

Einschränkung bei Prozeduren, die NICHT „customized“ sind : Ist der bestehende Wert für „CheckForExecutionRestrictions“ bzw. „LogExecutions“ bereits „0“, kann dieser nicht mehr geändert werden, und von Werten ungleich „0“ kann nicht auf „0“ gewechselt werden !
Bei der Registrierung von Prozeduren, die mit „_ac_“ beginnen, werden die Parameter „CheckForExecutionRestrictions“ und „LogExecutions“ ignoriert - es wird für beide korrespondierenden Werte immer „0“ verwendet ! Insbesondere kann man diese Art registrierter Prozedur NICHT ändern (wohl aber löschen natürlich) !

Mögliche Werte für „CheckForExecutionRestrictions“ :

• „0“ : Überprüfung grundsätzlich nicht möglich
• „1“ : überprüfung grundsätzlich möglich
• „2“ : Überprüfung aktiviert

Mögliche Werte für „LogExecutions“ :

• „0“ : Protokollierung grundsätzlich nicht möglich
• „1“ : Protokollierung grundsätzlich möglich
• „2“ : Einfache Protokollierung aktiviert
• „6“ : Einfache Protokollierung inkl. der Parameter-Werte aktiviert
• „10“ : Einfache Protokollierung mit zus. Werten aus „master..sysprocesses“ aktiviert
• „14“ : Komplette Protokollierung aktiviert, d.h. sowohl inkl. der Parameter-Werte als auch bestimmter Werte aus „master..sysprocesses“

Ist die Protokollierung inkl. der Parameter-Werte aktiviert, werden auch Daten, die durch eine oder mehrere der „tempdb-Schnittstellen-Tabellen“ übergeben wurden, protokolliert : Pro Datensatz in einer der entsprechenden Tabellen in der „tempdb“ wird für jede Spalte der Wert gespeichert, und zwar zu einem Pseudo-Parameter-Namen, der so aussieht :

„<Eine Abkürzung des Tabellen-Namens mit maximal 10 Buchstaben>_<Spalten-Name>_<Datensatznummer>„

Derzeit werden nicht alle Tabelle der „tempdb“ unterstützt, sondern nur die folgenden (die Abkürzung des Tabellen-Namens, die für den „Pseudo-Parameternamen“ benötigt wird, entspricht dem Tabellen-Namen sofern nicht anders angegeben) :

• AnyValues
• CharacteristicConditions (Abkürzung des Tabellen-Namens : „CharacCond“)
• CharacteristicValues (Abkürzung des Tabellen-Namens : „CharacVals“)
• ImageData
• OneID
• TextData
• ThreeIDs
• TwoIDs

Werte aus Spalten vom Typ „text“ (wie z.B. in „TextData“) können natürlich nicht komplett gespeichert werden - es werden nur die ersten 255 Zeichen übernommen.
Analoges gilt für den Typ „Image“ (wie z.B. in „ImageData“) : hier wird zunächst eine Konvertierung nach „varbinary(255)“ vorgenommen, der dann als „string“ interpretiert (das ergibt nichts Sinnvolles) und gespeichert wird…

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:

• mi_ModifyRegisteredProcs_Ad im Engine Playground öffnen

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/mi_ModifyRegisteredProcs_Ad?ProcedureID=<value>&ProcedureName=<value>&CheckForExecutionRestrictions=<value>&LogExecutions=<value>'

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/mi_ModifyRegisteredProcs_Ad?ProcedureID=<value>&ProcedureName=<value>&CheckForExecutionRestrictions=<value>&LogExecutions=<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'),
	'mi_ModifyRegisteredProcs_Ad',
		array(
			'ProcedureID' => <value>,
			'ProcedureName' => '<value>',
			'CheckForExecutionRestrictions' => <value>,
			'LogExecutions' => <value>,
			// 'DeleteProcedure' => 0
		)
);
 
$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="mi_ModifyRegisteredProcs_Ad">
			<Parameters>
				<Parameter Name="ProcedureID"><!-- smallint value --></Parameter>
				<Parameter Name="ProcedureName"><!-- varchar value --></Parameter>
				<Parameter Name="CheckForExecutionRestrictions"><!-- tinyint value --></Parameter>
				<Parameter Name="LogExecutions"><!-- tinyint value --></Parameter>
				<!-- <Parameter Name="DeleteProcedure">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>