Ermittelt bestimmte „Einstellungen“ einer Person, die als „Lieferant“ charakterisiert wird.
Hintergrund :
Eigentlich sind sämtliche Informationen, also insbesondere auch „Einstellungen“, zu einer Person über pm_GetPersonProperties_Ad einsehbar, aber es gibt diverse Einstellungen, die erst über „Referenzen“ von Eigenschaften (s. Rückgabespalten „TableID“ und „TableKeyID“ von pm_GetPersonPredefinedVals_Ad) „lesbar“ sind.
Um solche „Einstellungen“ also einfach leichter einsehen zu können, und um überhaupt zu wissen, welche „Einstellungen“ dieser Art es zu einem „Lieferanten“ gibt, dient diese Prozedur.
Hinweis :
Wird „NULL“ in einigen Spalten zurückgegeben, ist dies auf fehlende oder falsche Konfigurationen zurückzuführen. Genaueres kann man in der Regel den Ausgaben auf „standard out“ entnehmen.
Derzeitiger Algorithmus zur Ermittlung des „Einkauf-Preis“-Merkmals „PurchasePriceCharacteristicID“ :
Wir ermitteln zum Personen-Typ von „SupplierID“ aus „PersonTypeSettings“ den Eintrag zum Schlüssel „PurchasePriceCharacteristicID“, und verwenden die zu diesem Merkmal hinterlegte Eigenschaft (des Lieferanten), und wählen dann als Merkmal die ID, die zu dieser Eigenschaft via „PersonCharacValueReferences“ (Spalten „TableID“, „TableKeyID“) konfiguriert ist.
Dieses so ermittelte Merkmal wird aber nur beachtet, wenn konfiguriert ist, daß die Preise NETTO-Preise sind UND wenn das Merkmal der Kategorie zugeordnet ist, die in „Settings“ zum Schlüssel „NodeCharacCategoryID_PurchasePriceCharacs“ hinterlegt ist !
Derzeitiger Algorithmus zur Ermittlung der Standard-Zahlungsart und -Versandart („PaymentTypeID“, „ShippingTypeID“) :
Wir ermitteln zum Personen-Typ von „SupplierID“ aus „PersonTypeSettings“ den Eintrag zum Schlüssel „PaymentTypeCharacteristicID“ bzw. „ShippingTypeCharacteristicID“, und verwenden die zu diesem Merkmal hinterlegte Eigenschaft (des Lieferanten), und wählen dann als Merkmal die ID, die zu dieser Eigenschaft via „PersonCharacValueReferences“ (Spalten „TableID“, „TableKeyID“) konfiguriert ist.
HTTP-Method | GET |
HTTP-Auth | Optional |
Tags | |
Engine-Kategorie | order management |
Engine-Typ | Daten-Ermittlung |
Letzte Aktualisierung | 7.0.7 (2015-01-29) |
Spaltenname | Beschreibung | SQL-Datentyp4) | ab Version |
---|---|---|---|
PurchasePriceCharacteristicID | ID des Merkmals, zu dem zu Artikel-Elementen die Einkaufs-Preise des Lieferanten „SupplierID“ hinterlegt sind | smallint | 5.1.9 |
PurchasePriceCharacDescription | Bezeichnung der „PurchasePriceCharacteristicID“ | varchar(100) | 5.1.9 |
PurchasePriceCurrencyID | ID der Währung in der die Einkaufs-Preise zu verstehen sind (das ist die zur „PurchasePriceCharacteristicID“ konfigurierte „UnitID“) | tinyint | 5.1.9 |
PurchasePriceCurrencySymbol | Symbol (im Regelfall der ISO-Code) der Einheit „PurchasePriceCurrencyID“ | varchar(10) | 5.1.9 |
PaymentTypeID | ID der Standard-Zahlungsart für „Einkaufs-Aufträge“ beim Lieferanten „SupplierID“ | smallint | 5.1.9 |
PaymentTypeDescription | Bezeichnung der „PaymentTypeID“ | varchar(100) | 5.1.9 |
ShippingTypeID | ID der Standard-Versandart für „Einkaufs-Aufträge“ beim Lieferanten „SupplierID“ | tinyint | 5.1.9 |
ShippingTypeDescription | Bezeichnung der „ShippingTypeID“ | varchar(100) | 5.1.9 |
Die Prozedur hat keine Output-Parameter.
Code | Beschreibung | Quelle 5) |
---|---|---|
-661 | Die Person besitzt keine oder eine ungültige Eigenschaft zu einem bestimmten Merkmal | nur indirekt |
-621 | Fehlender oder falscher Eintrag in PersonTypeSettings | nur indirekt |
-569 | Der Benutzer hat kein Ausführungsrecht für die Prozedur | nur indirekt |
-567 | Die Prozedur darf z. Zt. nicht ausgeführt werden | nur indirekt |
-566 | Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werden | nur indirekt |
-550 | Fehlender oder falscher Eintrag in Settings | nur indirekt |
-535 | Das Datum liegt nicht in der Vergangenheit | nur indirekt |
-530 | Der Wert ist nicht konvertierbar | nur indirekt |
-510 | Der Benutzer ist nicht registriert | nur indirekt |
-504 | Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochen | nur indirekt |
-500 | Falsche Parameter | nur indirekt |
Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.
7.0.7 | 2015-01-29 | Interne Änderung : Datentyp-Erweiterung des „ReferenceKey“ [für „_mi_StartProcedure“-Aufruf] |
5.1.9 | 2007-01-26 | Erstmalig in dieser Version erstellt |
Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:
Unformatierte Ausgabe:
curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/om_GetSupplierConfiguration_Ad?SupplierID=<value>'
Mit xmllint 6) formatierte Ausgabe:
curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/om_GetSupplierConfiguration_Ad?SupplierID=<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'), 'om_GetSupplierConfiguration_Ad', array( 'SupplierID' => <value> ) ); $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="om_GetSupplierConfiguration_Ad"> <Parameters> <Parameter Name="SupplierID"><!-- integer value --></Parameter> </Parameters> </Procedure> </Batch> </ListOfBatches>