Inhaltsverzeichnis
im_SetProductDescriptions_Ad
Für alle Artikel-Elemente auf der Produkt- bzw. Varianten-Hierarchie werden die „Produktbezeichnungen“ in einer angegebenen Sprache neu generiert. Eine „Produktebezeichnung“ in einer Sprache ist derzeit eine Eigenschaft zum Merkmal mit einer Bezeichnung, die mit „Produktebez“ beginnt und für die in „ValueLanguageID“ die entsprechende Sprache konfiguriert ist.
Das Merkmal für die Produktbezeichnung in der Standardsprache (siehe „Settings“-Eintrag zum Schlüssel „DefaultLanguageID“) ist derzeit immer die ID „7“ !
Die Produkt-Hierarchie ist in „Settings“ durch den Eintrag „ProductLevelID“ festgelegt, die Varianten-Hierarchie ist immer die Hierarchie mit der größten „LevelNo“ (siehe im_GetLevels_Ad, welche Hierarchien definiert sind).
Die Produktbezeichnungen werden derzeit nach folgendem Muster generiert :
Für Produkte…
<Bezeichnung („NodeDescription“) des Vorgängers> + ' „' + <Bezeichnung („NodeDescription“) des Produkt-Elementes> + '“'
Für Varianten…
<Produktbezeichnung des Produkt-Vorgängers> + ' ' + <Bezeichnung („NodeDescription“) des Varianten-Elementes>
| HTTP-Method | POST |
| HTTP-Auth | Optional |
| Tags | |
| Engine-Kategorie | item management |
| Engine-Typ | Daten-Änderung |
| Letzte Aktualisierung | 7.0.7 (2015-01-29) |
Parameter
| Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
|---|---|---|---|---|
| LanguageID | 0 | ID einer Sprache, für die die Produktbezeichnungen neu generiert werden sollen. „0“ bedeutet, daß die Standardsprache (siehe „Settings“-Eintrag zum Schlüssel „DefaultLanguageID“) gewählt wird. | tinyint | 3.5.0 |
| SkipElementsWithProductDescr | 0 | Möchte man nur Produktbezeichnungen für Elemente generieren lassen, die aktuell KEINE Produktbezeichnung besitzen, setzt man disen Parameter auf „1“ | bit | 4.0.1 |
Rückgabe
Die Prozedur hat keine Rückgaben.
Output-Parameter
Die Prozedur hat keine Output-Parameter.
Mögliche Return-Codes
| Code | Beschreibung | Quelle 4) |
|---|---|---|
| -621 | Fehlender oder falscher Eintrag in PersonTypeSettings | nur indirekt |
| -599 | Lizenz ist ungültig oder abgelaufen | 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 | direkt und indirekt |
| -540 | Falsches Format | 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 | direkt und indirekt |
| -286 | Der Benutzer hat nicht die Berechtigung(en), Eigenschaften zu diesem(n) Merkmal(en) zu lesen/ändern | nur indirekt |
| -285 | Der Benutzer hat keine Berechtigung, vergangene Eigenschaften zu diesem(n) Merkmal(en) zu ändern | nur indirekt |
| -284 | Der Benutzer hat keine Berechtigung, Eigenschaften zu diesem(n) Merkmal(en) zu modifizieren | nur indirekt |
| -283 | Der Benutzer hat keine Berechtigung, Eigenschaften zu diesem(n) Merkmal(en) zu ermitteln | nur indirekt |
| -245 | Einige Artikel-Eigenschaften sind ungültig | nur indirekt |
| -242 | Relative Änderung nicht möglich, da es eine Eigenschaft gibt, deren Gültigkeit in d. Zukunft beginnt | nur indirekt |
| -241 | Änderung(en) der Eigenschaft(en) konnte(n) aufgrund paralleler Änderungen nicht durchgeführt werden | nur indirekt |
| -220 | Es konnte keine Merkmal-ID für die Produktbezeichnung ermittelt werden | nur indirekt |
| -110 | Das (die) Element(e) ist (sind) nicht vorhanden | nur indirekt |
XML-Schema
Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.
Historie
| 7.0.7 | 2015-01-29 | Interne Änderung : Datentyp-Erweiterung des „ReferenceKey“ [für „_mi_StartProcedure“-Aufruf] |
| 5.1.0 | 2006-02-08 | Verlagerung des Codes bzgl. Eigenschaften-Änderungen auf die neue Prozedur „_im_ModifyNodeProperties“ |
| 4.0.13 | 2004-05-18 | 1. Aufruf der Prozeduren „_mi_StartProcedure“ und „_mi_FinishProcedure“ 2. Ausführen von „set transaction isolation level 1“ und „set rowcount 0“ zu Beginn der Prozedur |
| 4.0.1 | 2003-05-16 | 1. Ab jetzt wird berücksichtigt, daß in „NodeProperties“ auch Gültigkeitszeiträume in der Zukunft vorhanden sein können ! 2. Aktualisierung von „NodeCharacteristicSearch“/„TreeViewDistributionStatistics“ |
| 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:
cURL
Unformatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/im_SetProductDescriptions_Ad'
Mit xmllint 5) formatierte Ausgabe:
curl -X POST 'http://<partner>-<project>.dstore.de/default/engine/im_SetProductDescriptions_Ad' | xmllint --format -
dStore_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'), 'im_SetProductDescriptions_Ad', array( // 'LanguageID' => 0, // 'SkipElementsWithProductDescr' => 0 ) ); $service->execute($request); $xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument(); $ResultSet = $xml_result->getRowsAsArray();
engine/execute
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="im_SetProductDescriptions_Ad"> <Parameters> <!-- <Parameter Name="LanguageID">0</Parameter> --> <!-- <Parameter Name="SkipElementsWithProductDescr">0</Parameter> --> </Parameters> </Procedure> </Batch> </ListOfBatches>