Prozedur, um sämtliche Daten in allen Tabellen (evtl. Ausnahmen s. „SkipTablesForDevelopment“) zu löschen und wieder mit
default-Werten zu füllen.

Hinweis : Die Ausführung ist nur möglich, wenn der „Settings“-Eintrag für „AllowRestoringOfDefaultValues“ auf „1“ konfiguriert ist !

Anmerkungen zum Parameter „CreateSupAdmPersonWithPasswd“ :

Bei der Wiederherstellung werden Standard-Benutzer („publicuser“, „interfaceuser“ etc.) sowie zugehörige Personen des Typs
„dStoreUser“ (s. „Settings“-Eintrag „PersonTypeID_dStoreUser“) angelegt. Bei einer Neu-Installation (wenn diese Prozedur also
z.B. zum ersten Mal aufgerufen wird) ist es aber immer erforderlich, daß es einen sogenannten „Super-Admin“ gibt, dessen
Benutzername mit dem Namen der Datenbank (in der diese Prozedur hier installiert ist) übereinstimmt. Für diesen muß ebenfalls
eine zugehörige Person des Typs „dStoreUser“ angelegt werden, wozu aber wiederum ein Kennwort benötigt wird (das im Standard
nicht festgelegt ist).
Zu diesem Zweck also wird das (i.d.R. verschlüsselte) Kennwort des „Super-Admins“ benötigt und sollte daher in
„CreateSupAdmPersonWithPasswd“ angegeben werden. Hinweis : Das Kennwort sollte die Form…
{<Verschlüsselung-Algorithmus (max. 10 Zeichen)>}<verschlüsseltes Passwort>
… haben (s.a. pm_GetEncryptionAlgorithm_Pu).

Falls „NULL“ für „CreateSupAdmPersonWithPasswd“ übergeben wird, gehen wir davon aus, daß diese Prozedur hier erneut aufgerufen wird (in einer Test-Umgebung, um den Anfangs-Zustand wiederherzustellen) und stellen daher SÄMTLICHE Personen des Typs „dStoreUser“ (zusammen mit den „Pendants“ aus „UserInfo“ und den zugeordneten „UserGroups“) wieder her.

Anmerkungen zum Parameter „SkipTablesForDevelopment“ :

Eine Besonderheit stellen einige Tabellen dar, die der Prozedur-Entwicklung dienen, die also z.B. den Source-Code der (custom-)Prozeduren (insbesondere einer evtl. Historie) enthalten. Diese werden per default NICHT gelöscht. Möchte man auch diese Tabellen leeren lassen, übergibt man „SkipTablesForDevelopment = 0“.
Hinweise :
1.) Falls man auch diese Tabellen löscht, geht an relevanten Daten nur die Historie verloren, alles andere wird bei erneuter „Analyse“ (s. z.B. mi_AnalyseObjectContTSQL_Ad) wiederhergestellt.
2.) NIE gelöscht werden Datensätze aus „ObjectsContainingTSQL“ mit „DateAndTimeValsFromOtherSource = 1“ - egal, was in „SkipTablesForDevelopment“ angegeben wird (denn diese Datensätze enthalten Informationen zu den Standard-Objekten, die nicht ohne weiteres wiederhergestellt werden können) !

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

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/mi_RestoreDefaultValues_Ad'

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/mi_RestoreDefaultValues_Ad' | 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_RestoreDefaultValues_Ad',
		array(
			// 'CreateSupAdmPersonWithPasswd' => NULL,
			// 'SkipTablesForDevelopment' => 1,
			// 'GenerateItemTestData_Scenario' => NULL,
			// 'GeneratePersTestData_Scenario' => NULL,
			// 'GenerForumTestData_Scenario' => NULL,
			// 'GenerOrderTestData_Scenario' => 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="mi_RestoreDefaultValues_Ad">
			<Parameters>
				<!-- <Parameter Name="CreateSupAdmPersonWithPasswd">NULL</Parameter> -->
				<!-- <Parameter Name="SkipTablesForDevelopment">1</Parameter> -->
				<!-- <Parameter Name="GenerateItemTestData_Scenario">NULL</Parameter> -->
				<!-- <Parameter Name="GeneratePersTestData_Scenario">NULL</Parameter> -->
				<!-- <Parameter Name="GenerForumTestData_Scenario">NULL</Parameter> -->
				<!-- <Parameter Name="GenerOrderTestData_Scenario">NULL</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>