Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
engine:procedures:co_getlostpassword_pu [11.01.2016 ] |
engine:procedures:co_getlostpassword_pu [11.01.2016 ] (aktuell) |
||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
+ | ===== co_GetLostPassword_Pu ===== | ||
+ | |||
+ | Ermittelt das Paßwort eines Community-Mitglieds, sofern die richtige Antwort zur "Paßwort vergessen"-Frage gegeben wird. Die Frage kann man sich durch [[dstoreproc>co_GetLostPasswordQuestion_Pu]] holen.\\ | ||
+ | |||
+ | Vorgehensweise:\\ Die durch den Parameter "Answer" übergebene Antwort wird mit der Eigenschaft des Mitglieds ("Nickname") zum Merkmal mit der in "CommunitySettings" zum Schlüssel "AnswerCharacteristicID" angegebenen ID verglichen. Bei Übereinstimmung liefert die Prozedur das Paßwort, d.h. die Eigenschaft zum Merkmal mit der ID, die durch "PasswordCharacteristicID" aus "CommunitySettings" definiert ist, zurück.\\ Anmerkung : Eine evtl. konfigurierte Zugriffsbeschränkung (s. [[dstoreproc>pm_GetPChAccRestrForUsers_Ad]]) für das Identifizierungs-Merkmal ("Nickname"-Merkmal) oder für das "Frage"- oder "Antwort"-Merkmal wird bewußt NICHT beachtet (denn das widerspräche ja der gewünschten Funktionalität dieser Prozedur).\\ | ||
+ | |HTTP-Method|GET | | ||
+ | |HTTP-Auth|Optional | | ||
+ | |Tags|{{tag>[co Get Lost Password Pu]}}| | ||
+ | |Engine-Kategorie|communities | | ||
+ | |Engine-Typ|Daten-Ermittlung | | ||
+ | |Letzte Aktualisierung|6.5.4 (2013-04-29)| | ||
+ | |||
+ | ==== Parameter ==== | ||
+ | |||
+ | |__CommunityID__| |ID einer Community\\ |smallint|3.5.0| | ||
+ | |__Nickname__| |"Nickname" des Mitglieds, das sein Paßwort vergessen hat. Mitglieder werden innerhalb der Community durch den "Nickname" eindeutig identifiziert. Die ID des zugehörigen Merkmals steht in "CommunitySettings" (zum Schlüssel "IdentifyingCharacteristicID").\\ |varchar(100)|3.5.0| | ||
+ | |__Answer__| |Die Antwort zur "Paßwort vergessen"-Frage (siehe [[dstoreproc>co_GetLostPasswordQuestion_Pu]])\\ |varchar(100)|3.5.0| | ||
+ | ==== Rückgabe ==== | ||
+ | |||
+ | === (parameterunabhängig) === | ||
+ | |||
+ | ^Spaltenname ^Beschreibung ^SQL-Datentyp((siehe [[:webservice:engine_datatypes|Datentypen im Bereich "engine"]])) ^ab Version ^ | ||
+ | |Password|Das Kennwort des Mitglieds (wenn die Antwort richtig war...)\\ |varchar(100)|3.5.0 | | ||
+ | ==== Output-Parameter ==== | ||
+ | |||
+ | Die Prozedur hat keine Output-Parameter.==== Mögliche Return-Codes ==== | ||
+ | |||
+ | ^Code ^Beschreibung ^Quelle ((direkt meint "von der Prozedur selber" und indirekt meint "von intern aufgerufenen Unterprozeduren")) ^ | ||
+ | |-781|Fehlender oder falscher Eintrag in CommunitySettings|nur indirekt| | ||
+ | |-660|Identifikation fehlgeschlagen|nur direkt| | ||
+ | |-500|Falsche Parameter|nur direkt| | ||
+ | ==== XML-Schema ==== | ||
+ | |||
+ | Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema [[http://resources.dstore.de/xsd/webservice_SmartGate/Response/EngineProcedure_v1_0.xsd|Response/EngineProcedure_v1_0.xsd]] validiert. | ||
+ | ==== Historie ==== | ||
+ | |||
+ | |6.5.4 |2013-04-29|1. Hinweis in der Doku, daß bewusst NICHT eine evtl. konfigurierte Zugriffsbeschränkung für das "Nickname"- oder das "Frage"-Merkmal beachtet wird (widerspräche der gewünschten Funktionalität)\\ 2. Anpassungen des Quellcodes an den aktuellen Standard\\ | | ||
+ | |3.5.2 |2001-01-28|\\ | | ||
+ | |3.5.0 |2000-11-23|Erstmalig in dieser Version erstellt\\ | | ||
+ | |||
+ | ==== Code-Snippets ==== | ||
+ | |||
+ | == Engine Playground == | ||
+ | Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist: | ||
+ | * [[http://playground.dstore.de/index.php?proc=co_GetLostPassword_Pu|co_GetLostPassword_Pu im Engine Playground öffnen]] | ||
+ | == cURL == | ||
+ | Unformatierte Ausgabe: | ||
+ | <code bash> | ||
+ | curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/co_GetLostPassword_Pu?CommunityID=<value>&Nickname=<value>&Answer=<value>'</code>Mit xmllint ((I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org)) formatierte Ausgabe: | ||
+ | <code bash> | ||
+ | curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/co_GetLostPassword_Pu?CommunityID=<value>&Nickname=<value>&Answer=<value>' | xmllint --format -</code>== dStore_php == | ||
+ | <code php> | ||
+ | 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'), | ||
+ | 'co_GetLostPassword_Pu', | ||
+ | array( | ||
+ | 'CommunityID' => <value>, | ||
+ | 'Nickname' => '<value>', | ||
+ | 'Answer' => '<value>' | ||
+ | ) | ||
+ | ); | ||
+ | |||
+ | $service->execute($request); | ||
+ | |||
+ | $xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument(); | ||
+ | $ResultSet = $xml_result->getRowsAsArray(); | ||
+ | |||
+ | </code> | ||
+ | == engine/execute == | ||
+ | XML zur Ausführung mit der Methode [[:webservice:engine:execute|engine/execute]], z.B. per | ||
+ | curl --header 'Content-Type: application/xml' -X POST 'http://<partner>-<kunde>.dstore.de/default/engine/execute' -d '<xml-daten>' | ||
+ | |||
+ | <code xml> | ||
+ | <?xml version="1.0" encoding="UTF-8"?> | ||
+ | <ListOfBatches> | ||
+ | <Batch No="0"> | ||
+ | <Procedure Name="co_GetLostPassword_Pu"> | ||
+ | <Parameters> | ||
+ | <Parameter Name="CommunityID"><!-- smallint value --></Parameter> | ||
+ | <Parameter Name="Nickname"><!-- varchar value --></Parameter> | ||
+ | <Parameter Name="Answer"><!-- varchar value --></Parameter> | ||
+ | </Parameters> | ||
+ | </Procedure> | ||
+ | </Batch> | ||
+ | </ListOfBatches></code> | ||