Článok popisuje najjednoduchší spôsob, ako sa z PHP aplikácie najlepšie pripojiť do systému ABRA Flexi pomocou REST-API a získať tak dáta z evidencie tretej strany.
Prvé kroky
Vytvorte pre API pripojenie samostatného používateľa. U tohto používateľa postačí nastaviť Typ používateľa na REST-API. Nebude možné sa s ním prihlásovať cez desktopového klienta ani cez webové rozhranie.
Rola používateľa závisí iba od toho, ku ktorým evidenciám má mať používateľ prístup. Napríklad používateľ pre prepojenie s e-shopom určite nemusí byť ADMIN. Plne mu postačí rola POUŽÍVATEĽ.Licencia musí podporovať REST-API. V súčasnosti je REST-API pre čítanie súčasťou každej licencie ABRA Flexi (Typ používateľa: Iba na čítanie). Ak budete potrebovať do systému zapisovať dáta, bude potrebná licencia s REST-API pre zápis (Typ používateľa: REST API). Tento modul je doplnkový, avšak automatizácia, ktorú je s jeho pomocou možné dosiahnuť, mnohonásobne prevýši počiatočnú investíciu.
Zistite identifikátor firmy a adresu a port servera, ku ktorému sa budeme pripájať.
Adresu a port servera je možné zistiť v desktopovej aplikácii, v správe dátových zdrojov alebo po pripojení do firmy v dialógu O aplikácii Flexi (Pomocník – O aplikácii Flexi), na záložke Detaily o aplikácii, v poli Adresa centrálneho servera (bude sa v ňom vyskytovať výraz podobný napr. demo.flexibee.eu:5434).
Identifikátor firmy je možné zistiť iba cez webové rozhranie. Na adrese server:port/c (napr. demo.flexibee.eu/c) je možné nechať si vypísať firmy, ktoré má používateľ vo Flexi dostupné. Po kliknutí na ktorúkoľvek z nich sa pripojíte do tejto firmy a URL sa zmení na server:port/c/identifikátor (napr. demo.flexibee.eu/c/demo). Identifikátor je teda koniec URL adresy od posledného lomítka (v demo príklade teda demo).
Programovanie
Nižšie uvedený program sa pripojí k serveru demo.flexibee.eu. Pomocou http autentizácie sa prihlási ako používateľ winstrom, s heslom winstrom, do firmy s identifikátorom demo. Z tejto firmy stiahne XML súbor adresára a vypíše ho ako tabuľku, v ktorej bude v prvom stĺpci skratka firmy a v druhom názov firmy.
Pri chybe počas načítavania vypíše chybu „Pri operácii nastala chyba" a kód chyby.
<?xml version="1.0"?>
