Pokročilé funkce FlexiBee REST API. Ladislav Thon

Transkript

1 Pokročilé funkce FlexiBee REST API Ladislav Thon

2 Obsah Dotazování Navázané objekty a kolekce Úrovně detailu XPath Stránkování, řazení Filtrování (WQL) Hromadné čtení Našeptávání Uložené dotazy

3 Obsah Zkušební uložení (dry run) Smazání a storno Hromadné úpravy Řízení transakcí Původ importu Sledování změn Import dokladů Odesílání dokladů em Přílohy Sumace

4 Dotazování

5 Navázané objekty a kolekce?relations= polozky vazby prilohy sklad-karty *?includes= /winstrom/faktura-vydana/firma /faktura-vydana/firma

6 Úrovně detailu?detail=id?detail=summary výchozí pro seznam záznamů?detail=full výchozí pro detail záznamu?detail=custom:kod,nazev?detail=custom:kod,polozky(nazev,cena) ID vždy?detail=custom:...&includes=...

7 XPath?xpath=...

8 Stránkování, řazení?limit=100?limit=0?start=100&limit=100 (Ext JS)?p=2&s=100 (jquery DESC (Ext JS)

9 Filtrování (WQL) /c/firma/adresar/(nazev like 'Firma') vlastnost operátor hodnota and, or, not, ( ) operátory: =, <>, <, <=, >, >=, in, between [and] [not] like, begins [with], ends [with] in subtree [nonrecursive] (jen pro ceník) is true, is false is [not] null, is [not] empty

10 Filtrování (WQL) vlastnosti: nazev firma.nazev (bez negativních operátorů) hodnoty: -1, 10, 5.8, "abc", 'def' true, false T12:30:00 now(), me() ID: 1, "code:firma", 'ext:sys:123'

11 Filtrování (WQL) štítky stitky = 'code:vip' stitky = 'code:vip' or stitky = 'code:dulezite' strom ceníku.../cenik/(in subtree 3).../cenik/(id in subtree 3).../cenik/(in subtree 7 nonrecursive).../skladova-karta/(cenik in subtree 3)

12 Hromadné čtení PUT POST /c/firma/faktura-vydana/get.xml Content-Type: application/xml <winstrom> <id>1</id> <id>code:2</id> <id>ext:sys:3</id> </winstrom>

13 Našeptávání.../adresar.json?q=firma&mode=suggest { "results": [ { "id": 399, "name": "FIRMA: Firma" } ], "total": 1, "query": "firma" } pro webové aplikace (jquery FlexBox, Ext JS)

14 Uložené dotazy SQL /c/firma/uzivatelsky-dotaz /c/firma/uzivatelsky-dotaz/call.xml (.json)?date= ?firma=code:firma1&firma=code:firma2

15 Úpravy a další

16 Zkušební uložení (dry run)?dry-run=true <winstrom version="1.0"> <success>true</success> <stats>...</stats> <results> <result> <content>...</content> </result> </results> </winstrom>

17 Zkušební uložení (dry run)?dry-run=true <winstrom version="1.0"> <success>false</success> <stats>...</stats> <results> <result> <errors>...</errors> </result> </results> </winstrom>

18 Smazání a storno Smazání záznamu <adresar action="delete"> <id>...</id> </adresar> Storno dokladu <faktura-vydana action="storno"> <id>...</id> </faktura-vydana>

19 Hromadné úpravy WQL <winstrom> <cenik filter="dodavatel = 'code:firma'">... </cenik> </winstrom> žádné <id>

20 Řízení transakcí obvykle jedno XML = jedna transakce <winstrom atomic="false"> <adresar>...</adresar> <faktura-vydana>... <polozkyfaktury>...</polozkyfaktury> </faktura-vydana> </winstrom> jeden top-level element = jedna transakce

21 Původ importu <winstrom source="migrace 2012"> <adresar>...</adresar> <faktura-vydana>... <polozkyfaktury>...</polozkyfaktury> </faktura-vydana> </winstrom>

22 Sledování změn /c/firma/changes /c/firma/changes/enable disable

23 Sledování změn <winstrom globalversion="42"> <faktura-vydana in-version="1" operation="create"> <id>1</id> </faktura-vydana> <faktura-vydana in-version="2" operation="update"> <id>1</id> <id>code:vf1-0001/2012</id> <id>ext:sys:13</id> </faktura-vydana> <next>3</next> (none) </winstrom>

24 Sledování změn?since=123?count=500?evidence=faktura-vydana?evidence=faktura-vydana&evidence=faktura-prijata?add-global-version=true <winstrom globalversion="42">... </winstrom>

25 Import dokladů FlexiBee umí počítat nezadané částky se dopočítají z těch zadaných u položkového dokladu se sčítají částky položek a kontrolovat nesmí být 3 částka tuz, částka měn a kurz musí souhlasit měn = 2599, kurz = tuz = 2599 * = = / = 2600 proto přepočteme kurz na (chtělo by to ještě víc desetinných míst, ale nemáme...)

26 Odesílání dokladů ABC tělo požadavku = text u (v naší šabloně) přílohy: PDF, příp. ISDOC

27 Přílohy?relations=prilohy /c/firma/adresar/12/prilohy /c/firma/adresar/12/prilohy/75/content /c/firma/adresar/12/prilohy/75/thumbnail PUT /c/firma/adresar/12/prilohy/new/a.jpg Content-Type: image/jpeg /c/firma/nastaveni/1/logo (podpis-razitko)

28 Sumace /c/firma/faktura-vydana/$sum jen pro doklady /c/firma/faktura-vydana/(...)/$sum

29 Q&A