Základní popis interface systému BLUEJET

Základní popis interface systému BLUEJET
BLUEJET je postaven na MS technologii (MS SQL Server, IIS, browser) a platformě .NET. Technologie tenkého
klienta je striktně tvořena pro HTML5 a CSS3. Důvodem je požadavek na nezávislost na platformě a podpora
různých zobrazovacích zařízení (mobil, tablet, notebook, desktop).
BLUEJET CRM systém zpravidla pro maximální využití vyžaduje integraci k dalším aplikacím v již existující
infrastruktuře. Zatím máme napojeny tyto typy systémů:

ERP/IS – ekonomické, účetní a jiné podnikové informační systémy pro plánování zdrojů, sklady,
ekonomickou i daňovou evidenci či komunikaci s bankou
Účel napojení: synchronizace firem, kontaktů, objednávek, fakturace, skladových zásob, pohledávek,
ekonomických ukazatelů, preference chování a jiné

Portálová řešení – rozmanité i specializované aplikace pro partnery, či zákazníky jako tzv.: „frontend“ či jiná proprietární řešení
Účel napojení: vždy specifický dle použití portálu, načítání kreditů, výpočet benefitů a zpětného rabatu,
rozřazení zájemců v rámci affiliate, automatický import zájemců z webu a jiné

Specializované aplikace – různé aplikace a systémy
Účel napojení: docházkový systém pro evidenci docházky, zakázkový systém pro automatickou evidenci
výkazů práce k projektu, logistické systémy apod.

Integrované webové aplikace – ARES, Insolvence, Justice, DIČ Vies, Creditcheck, Soliditet, Cribis,
LogoBox SMSbrána, FAXcz, Funambol, Dropbox, Google maps a další … (+ FTP klient, poštovní klient)
Systém BLUEJET podporuje tyto základní formy komunikace:
a)
Databázové propojení
Nejčastější typ komunikace pro složitější či objemnější dotazy. Zpravidla se na databázi BLUEJET a
databázi externího systému vytvoří pohledy a pomocí nich se aktualizují přímo tabulky na opačné
straně. Tento update pak obvykle probíhá dvojím způsobem podle požadavků klienta.
1. Update probíhá zpravidla jednou denně. Aktualizují se všechna potřebná data.
2. Update probíhá v krátkých intervalech (minuty) s časovou známkou a aktualizují se pouze
záznamy, které se změnily. Aktualizace probíhá sice častěji, ale dat je při každé aktualizaci
mnohem méně a data jsou dostupná uživateli velmi rychle.
b) Automatický import/export souboru
BLUEJET pomocí administrátorem naplánované úlohy exportuje popř. importuje soubor na
namapovaném FTP popř. síťovém disku.
c)
BLUEJET API, webové služby dle standardu WSDL
BLUEJET nabízí jednoduché webové služby pro vložení, aktualizaci, smazání a výběr záznamů. Ověření
uživatele je definováno v SOAP hlavičce zadáním jména a hesla uživatele a zabezpečení probíhá na
transportní vrstvě pomocí SSL.
Autentizace uživatele
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<APIHeader xmlns="http://www.bluejet.cz">
<UserName>uživatel</UserName>
<Password>heslo</Password>
</APIHeader>
</soap:Header>
<soap:Body>
<InsertObject xmlns="http://www.bluejet.cz" /> ...
</soap:Body>
</soap:Envelope>
Popis webových služeb BLUEJET API
/// <summary>
/// Vložení záznamu
/// </summary>
/// <param name="xml">XML s daným záznamem</param>
/// <param name="error">popis chyby</param>
/// <returns>záznam byl vložen úspěšně/neúspěšně</returns>
[WebMethod]
public bool InsertObject(string xml, out string error)
/// <summary>
/// Editace záznamu
/// </summary>
/// <param name="xml">XML s daným záznamem</param>
/// <param name="error">popis chyby</param>
/// <returns>záznam byl vložen úspěšně/neúspěšně</returns>
[WebMethod]
public bool UpdateObject(string xml, out string error)
/// <summary>
/// Smazání záznamu
/// </summary>
/// <param name="nObjectNO">číslo objektu</param>
/// <param name="id">ID záznamu</param>
/// <param name="error">popis chyby</param>
/// <returns>záznam byl vložen úspěšně/neúspěšně</returns>
[WebMethod]
public bool DeleteObject(int nObjectNO, string id, out string error)
/// <summary>
/// Vrátí požadovaný objekt (kontakt, firmu aj.) z databáze
/// </summary>
/// <param name="nObjectNO">číslo objektu</param>
/// <param name="foreignid">ID záznamu</param>
/// <param name="error">popis chyby</param>
/// <returns>XML formát daného objektu</returns>
[WebMethod]
public string SelectObject(int nObjectNO, string id, out string error)
/// <summary>
/// Vrátí primární klíč systému BLUEJET na základě cizího klíče
/// </summary>
/// <param name="nObjectNO">číslo objektu</param>
/// <param name="foreignid">ID záznamu</param>
/// <param name="error">popis chyby</param>
/// <returns>primární klíč BLUEJET</returns>
[WebMethod]
public string GetRecordPrimaryKey(int nObjectNO, string foreignid, out string error)