Prohlížeč Altair

Prohlížeč Altair si lze nainstalovat pro Firefox a Chrome z těchto odkazů:

Prohlížeč Altair spustíte klepnutím na ikonku v pravém horním rohu okna prohlížeče.

Okno prohlížeče Altair se dělí do několika sekcí, které ukazuje následující obrázek.

V levé horní části okna Altairu je tlačítko pro nastavení typu operace. Zde je třeba mít nastavený požadavek na vytvoření nového objektu – POST.

Dále je nutné do pole Enter URL vyplnit adresu pro zasílání dotazů, viz tabulka:

Autentizace k Sofa je možná dvěma způsoby. Pokud je uživatel v rámci stejného prohlížeče přihlášen v prostředí Sofa, jedná se o sdílenou session a není nutné se autentizovat pomocí tokenu.

Takže pokud je uživatel v prohlížeči přihlášený do daného prostředí Sofy, může provolávat GraphQL dotazy i bez použití tokenu a provolávat je jako aktuálně přihlášený uživatel.

Pokud je nutné provolávat dotaz nikoliv jako přihlášený uživatel, ale jako externí systém, je nutné použít token tohoto externího systému (získaný v kapitole Vystavení tokenu ExtIS pod identitou ExtIS).

Klepnutím na tlačítko Set Headers otevřete dialog pro zadání hlavičky – HEADERS.

Do políčka Header key zapište hodnotu Autentization. Ta je pro Sofu univerzálně platná.

Autentizační token se zadává do pole Header value. Zapisuje se jako Bearer a k tomu hodnota tokenu získaná v minulé kapitole (bez uvozovek).

GraphQL dotazy se zapisují do sekce na obrázku označené v obrázku jako Prostor pro zápis GraphQL dotazu. S výhodou lze dotazy nebo jejich části do této sekce kopírovat přes clipboard.

Při zadávání dotazů se kontroluje, zda neobsahují nějaké chyby. Pokud je Altair chybu schopen odhalit, pokusí se nabídnout řešení, jak ji odstranit. Například pokud je očekáváno označení pole currentUser a vy napíšete currentUse, nabídne se vám správný zápis.

Altair si automaticky načte GraphQL schéma z připojené databáze a je pak s výhodou možné pracovat s „našeptávačem“. Ten při zápisu dotazu automaticky nabízí možnosti, které by mohly přicházet v úvahu pro aktuálně zapsaný řetězec znaků.

Pokud je potřeba testovat dotaz s nějakou konkrétní proměnnou, zapíšete ji do sekce VARIABLES.

Dotaz odešlete k vyhodnocení klepnutím na tlačítko Send request.

Pokud dojde při vyhodnocení dotazu k chybě, je ohlášena v červeném políčku nad sekcí označenou v popisu okna jako Výsledek GraphQL dotazu.

Indikátor je doprovázen číselným kódem, kde například:

400 – Bad Request – server zjistil, že požadavek byl zaslán s chybějícími nebo nesprávnými parametry.

401 – Unauthorized – uživatel není (zatím) autorizován k provedení vyžadované akce.

404 – Not Found – hledaný zdroj nebyl v dané chvíli nalezen.

V sekci s výsledkem dotazu je pak vypsán popis chyby a také kde se v sekci pro zápis dotazu vyskytuje (řádek, sloupec). Pokud to charakter chyby umožňuje, je také příslušné místo označeno podtržením červenou vlnovkou.

Když je dotaz vyhodnocen jako správný, zobrazí se nad sekcí Výsledek GraphQL dotazu indikátor v zeleném políčku a pod ním se vypíše výsledek dotazu.

Indikátor je doprovázen číselným kódem, kde například:

Všimněte si tlačítka DOWNLOAD v pravém dolním rohu sekce. Jeho stiskem se výsledek dotazu uloží do souboru ve formátu JSON (soubor najdete ve složce se staženými soubory).

Práci s několika dotazy současně vám mohou značně usnadnit záložky, pod kterými je možné si ukládat různé dotazy (i s různými URL). Je tedy například možné vytvořit a uložit i sadu dotazů pro různá prostředí.

Pokud chcete pro aktuálně zobrazený dotaz vytvořit novou záložku, klepněte na systémové označení Window n pravým tlačítkem myši. Otevře se plovoucí příkazová nabídka. Příkazem Edit zpřístupníte název záložky pro editaci – přepište stávající označení požadovaným názvem a stiskněte klávesu Enter.

Pro další práci je třeba si vytvořit nové pracovní okno na nové systémové záložce. To docílíte klepnutím na odkaz +Add new. Otevře se nové čisté pracovní okno se záložkou pojmenovanou například Window 2.