FAQ

Wie kann ich den WebKatalog mit einem anderen Katalogpfad starten?

Beim Aufruf kann der Parameter parentnode übergeben werden. Dieser gibt den Startordner an. Wenn parentnode leer ist, wird der oberste Ordner verwendet.

parentnode ist die nodeid aus der Rückgabe eines Katalogaufrufs.

Beispiel:

https://web.3doffice.de/webkatalog2_5/planning?parentnode=tische

Wie erhalte ich einen Token?

Siehe Authentifizierung — dort finden Sie die Schritt-für-Schritt-Anleitung und eine PHP-Beispielimplementierung.

Kann ich den WebKatalog ohne Token aufrufen?

Nein. Ohne token-Parameter erfolgt ein Redirect zur Login-Seite. Für automatisierte Aufrufe ist immer ein gültiger Token erforderlich.

Wie lange ist ein Token gültig?

• Standard (RememberMe=false): 12 Stunden nach der letzten Nutzung
• Mit RememberMe=true: 90 Tage

Was ist der Unterschied zwischen reinitstring und ocdreinitstring?

• reinitstring — Für die Nutzung in odb.dll (Grafikdaten)
• ocdreinitstring — Für die Nutzung in ofml.dll (kaufmännische Daten)
• ocdreinit — URL-Parameter für die Nutzung im Frontend

Alle enthalten die gleichen kaufmännischen Konfigurationsdaten, werden aber an unterschiedlichen Stellen verwendet.

Wie kann ich einen konfigurierten Artikel speichern?

Es gibt zwei Varianten:

1. PermanentID (komplette Meta-Konfiguration): Über den Button "ID generieren" im Frontend (Parameter buttongeneratereinitid=true). Siehe PermanentIDs.
2. Nachkonfiguration über ID: Artikel-Daten per POST an /api/ofml.dll/ofml/reinit senden. Die zurückgegebene ID mit ?id= übergeben.

Wie binde ich den WebKatalog in meinen Webshop ein?

1. Token generieren
2. WebKatalog per iFrame einbinden: {BASE}/planning?token={TOKEN}
3. Warenkorb-URL übergeben: &urlwarenkorb=...
4. POST-Daten im Warenkorb verarbeiten

Siehe Warenkorb-Integration.

Wie ändere ich ein Merkmal über die API?

POST an /api/ofml.dll/ofml/articles mit dem vollständigen Artikel-JSON und den zu ändernden Merkmalen im Body. Siehe Artikel ändern.

Wie rendere ich ein Artikelbild?

GET an /api/odb.dll/odb/articlesimage.jpg mit den erforderlichen Parametern. Siehe Artikelbilder.

Sind PermanentIDs zwischen Test- und Produktionssystem übertragbar?

Nein. PermanentIDs sind nicht zwischen den Systemen übertragbar. Siehe PermanentIDs.