Ändert das Paßwort des zu einem „dStore“-Benutzer (s. mi_GetUserInfo_Ad) zugehörigen Datenbank-Logins.

Anmerkungen zum Parameter „EncryptedPassword“ :

1.) Bei Angabe von „NULL“ ermittelt die Prozedur den SHA1-Wert von „NewPassword“ (um die „Password“-Eigenschaft der zu „UserName“ zugehörigen Person des Typs „dStoreUser“ - s. „Settings“-Eintrag zum Schlüssel „PersonTypeID_dStoreUser“ - zu speichern). I.d.R. wird dabei ein (geheimer) „salt“ verwendet, s. „PersonTypeSettings“-Eintrag zum Schlüssel „DefaultEncryptionAlgorithm“.

2.) Wenn „EncryptedPassword“ angegeben ist, sollte dies natürlich „NewPassword“ entsprechen - nur eben verschlüsselt !
Genauer muß „EncryptedPassword“ die Form…
{<Verschl.-Algorithmus (max. 10 Zeichen)>}<verschlüsseltes NewPassword, mind. 5 Zeichen, nur Zahlen/Buchst.>
… haben (s.a. pm_GetEncryptionAlgorithm_Pu).
Falls „EncryptedPassword“ nicht diese Form hat oder andere Zeichen außer Buchstaben, Zahlen, „-“, „{“ und „}“ enthält, gibt es einen Fehler !

3.) Die Aktion der Änderung der Passwort-Eigenschaft kann aufgrund von Beschränkungen im ASE leider nicht zusammen mit der eigentlichen Änderung (des Datenbank-Login-Kennworts) in einer Transaktion ausgeführt werden. Wir versuchen aber, alle möglichen Fehler VORHER festzustellen (die „-500“-Fehler z.B.), so daß diese Situation hoffentlich eher selten vorkommt.

Anmerkungen zum Parameter „CreatedStoreUserIfNotExists“ :

1.) Sollte es keine Person zum Typ „dStoreUser“ für „UserName“ geben, wird eine solche angelegt, falls für den optionalen Parameter „CreatedStoreUserIfNotExists“ der Wert „1“ angegeben wurde (Standardbelegung für diesen Parameter ist „0“).
Hintergrund : Die Konstellation, daß keine zugehörige Person existiert, kann bei Installationen vor Version 6.5.0 vorliegen, weil erst ab dieser Version bei Anlage eines neuen Benutzers (durch mi_CreatedStoreUser_Ad) auch immer eine korrespondierende Person erstellt wird.

2.) Im Falle der Neu-Anlage der Person (wenn also „CreatedStoreUserIfNotExists = 1“ ist UND keine Person des Typs „dStoreUser“ zu „UserName“ gefunden wurde) wird mi_CreatedStoreUser_Ad aufgerufen, um gleichzeitig sicherzustellen, daß auch ein entsprechender Datensatz in „UserInfo“ (mit „UserName“) existiert. Diese wiederum setzt voraus, daß das zugehörige ASE-Login des Benutzers, der diese Prozedur hier aufruft, die sogenante „sso_role“ besitzt.
⇒ Daher kann es zum Fehler „-518“ kommen !

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

Unformatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/mi_ChangedStoreUserPassword_Ad?UserName=<value>&CallerPassword=<value>&NewPassword=<value>'

Mit xmllint ⁵⁾ formatierte Ausgabe:

curl -X POST  'http://<partner>-<project>.dstore.de/default/engine/mi_ChangedStoreUserPassword_Ad?UserName=<value>&CallerPassword=<value>&NewPassword=<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_ChangedStoreUserPassword_Ad',
		array(
			'UserName' => '<value>',
			'CallerPassword' => '<value>',
			'NewPassword' => '<value>',
			// 'DBLogin' => NULL,
			// 'EncryptedPassword' => NULL,
			// 'CreatedStoreUserIfNotExists' => 0,
			// 'IgnoreErrorNewPasswdSameAsOld' => 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_ChangedStoreUserPassword_Ad">
			<Parameters>
				<Parameter Name="UserName"><!-- varchar value --></Parameter>
				<Parameter Name="CallerPassword"><!-- varchar value --></Parameter>
				<Parameter Name="NewPassword"><!-- varchar value --></Parameter>
				<!-- <Parameter Name="DBLogin">NULL</Parameter> -->
				<!-- <Parameter Name="EncryptedPassword">NULL</Parameter> -->
				<!-- <Parameter Name="CreatedStoreUserIfNotExists">0</Parameter> -->
				<!-- <Parameter Name="IgnoreErrorNewPasswdSameAsOld">0</Parameter> -->
			</Parameters>
		</Procedure>
	</Batch>
</ListOfBatches>