====== Data Abstraction Layer ======

Der dal bietet Services um Daten aus der Datenbank (aktuell MongoDB) zu lesen, oder Daten (new/changed/deleted) in der Datenbank und in den search engines zu aktuallisieren.


===== Anfragen stellen allgemein =====

Anfragen werden via POST an den dal-Server gesendet. Mittels ''%%service=<…>%%'' werden die gewünschten services ausgewählt. Es ist möglich mehrere Services mit einer Anfrage aufzurufen. Diese werden sequentiell abgearbeitet. Je nach Service sind weitere Informationen zu übermitteln.


===== Services =====

Allgemein werden Anfragen mit

<code>
service=<service> {weitere Parameter}
</code>
gestellt und Antworten in der Form

<code>
{"duration": <duration for request in seconds>, "<service>": {<answer>}}
</code>
**hello**

<code>
service=hello
</code>
, wenn der Dienst läuft antwortet er mit:

<code>
{"duration": <deltaT>, "hello": "at your service"}
</code>
**getShopList** Antwortet mit einer Listen von allen ShopIds, die existieren.

<code>
service=getShopList
{"getShopIds": [1,2,...]}
</code>
**getShopInfo** Antwortet mit allen Infos die über den Shop zur Verfügung stehen. {{/dokuwiki/lib/images/smileys/fixme.gif|FIXME}} url etc.in der Antwort

<code>
service=getShopInfo shopId=<shopId>
{"duration": 0.09932303428649902, "getShopInfo": {"lastUpdate": "2015-04-29 12:55:12.882000", "currency": "EUR", "shopId": "stest2", "productCount": 25, "visible": true, "coundryCode": "DE", "active": true, "rejectedCount": 2}}
</code>
**getFeedInfo** Antwortet mit zwei Listen, in denen alle ''%%imgIds%%'' und alle ''%%hash%%''es von Produkten dieses Kunden aufgeführt sind.

<code>
service=getFeedInfo shopId=<shopId>
{"duration": 0.10866522789001465, "getFeedInfo": {<imgId>: <hash>, ...}}
</code>
**cancelShopUpdate** Bricht ein Update eines Shops ab

<code>
service=cancelShopUpdate shopId=<shopId>
{"cancelShopUpdate": {"ack": True}}
</code>
**shopUpdatePush** Erlaubt es Felder in den Infos eines Shops zu ändern

<code>
service=shopUpdatePush shopId=<shopId> fields={name1: value1}
{"shopUpdatePush": {"ack": True}}
</code>
**startNewShopUpdate** Anmelden eines shopUpdates, Antwortet mit einer updateId oder einer Meldung falls noch ein Update für den Shop in der Query liegt

<code>
service=startNewShopUpdate shopId=<shopId>
{"duration": 0.04, "startNewShopUpdate": {"updateId": <updateId>}} oder
{"duration": 0.04, "startNewShopUpdate": {"error": <message>}}
</code>
**shopUpdateDone** Hinweis das der Parser fertig ist.

<code>
service=shopUpdateDone updateId=<updateId> new=<count new> changed=<count changed> removed=<count removed>
{"duration": 0.0, "shopUpdateDone": {"ack": true}}
</code>
**getPendingImages** Gibt ein Dictionary {id→imgurl} von alle Produkten eines Shops zurück, die **nicht** aktiv sind.

<code>
service=getPendingImages shopId=<shopId>
{"getPendingImages" : {"id1": "http://foo.de/bild.jpg, ..}} 
</code>
**workload** Ergebnisse vom Parsen übermitteln {{/dokuwiki/lib/images/smileys/fixme.gif|FIXME}} <info> Felder noch definieren

<code>
service=workload action={new,changed,remove} updateId=<updateId> [item=<info>]
{"duration": 0.0, "workload": {"ack": true, "n": <int>}}

<info for new/changed>: imgId + metaData
<info for removed>: imgId
</code>
**removeImg** Löscht Bilder

<code>
service=removeImg shopId=<shopId> [item=<imgId>]
{"duration": 0.0, "removeImg": {"ack": true, "deleted": <int>}}
</code>
**newShopImg** Berechnet das enrichment und übernimmt das Bild ins System

<code>
service=newShopImg shopId=<shopId> [item=<info>]
{"duration": 0.0, "newShopImg": {"rejected": <int>, "added": <int>}}
</code>
**changeImgMeta** Ändert die hinterlegten MetaDaten zum Bild

<code>
service=changeImgMeta shopId=<shopId> [item=<info>]
{"duration": 0.0, "changeImgMeta": {"ack": true}}
</code>
**removeShop** Löscht alle Bilder von diesem Shop aus der ''%%shop_images%%''

<code>
?? tbd
</code>