Skip to main content

Příprava speciálních přehledů

Zatímco vlastní šablony umožňují změnit prezentační formát dat vracených přehledem, tzv. speciální stránka pro přehledy nabízí možnost (a vyžaduje) sestavit pro určitý přehled také SQL dotaz(y), obslužný skript a cokoli dalšího co je třeba. Principem této speciální stránky, jak název napovídá, je dodat pro dano destinaci intranetové plochy samostatnou HTML stránku nebo FRAMESET, jež se při přechodu na destinaci otevřou ve spodním rámu, kde se jinak zobrazují data. V rámu, kde bývá běžně hlavička se nyní zobrazuje pouze ikona typu a zadaný název přehledu, nic víc. Vše ostatní je totiž v režii speciální stránky, ať již to bude zařízeno jakkoli. Pokud chcete speciální stránku v intranetu použit, je třeba dvou věcí - jednak mít k dispozici na hlavním webovém sídle ve složce special připravenu podsložku se stránkami, skripty, styly a dalšímí příp. soubory a jednak v nastaveních přehledu v oblasti G) Další nastavení v základním způsobu zobrazení na místo výchozího způsobu "běžná tabulka" zvolit "speciální stránka". V takovém případě se všechny body nastavení (krom bodu B) vyřadí a nebude možné do nich nic nastavit a jednak bod H) vám umožní "Nastavení speciální stránky". Sem je především třeba nasavit podsložku spec. stránky. Pokud budete stránku a další teprve tvořit, můžete prozatím využít startovacího příkladu, který je možné si stahnout zde. Tento příklad obsahuje primitivní stránku, která nedělá nic jiného, než že po otevření zobrazí statickou ikonu a pod ní aktuální čas serveru v době otevření stránky. Tento čas je zjištěn SQL dotazem a předán dynamicky na připravenou stránku. Je však funkční a je možné z něj vyjít pro reálné použití. V příkladu je ukázáno, jak je možné snadno používat dotazy do databáze pomocí objektu a součástí je také výchozí soubor s nastaveními. U nastavení se chvíli zastavíme.

Podřízené stránky

📄️Použití souborů skriptů v běžných a speciálních přehledech

Zatímco v běžných přehledech je pro všechny přehledy jednotně využíván wrktbbody.js, pro speciální stránky je třeba připravit skript vlastní. Vedle tohoto výchohzího souboru běžné přehledy ještě dále využívají soubor se skripty služeb wtbservices.js, kde je obsažena podstatná část obsluhy přehledů a soubor se skripty pro zobrazování rychlých menu (tj. menu sourozenců, pravý inforámeček a mřížku rychlé nabídky u položek v přehledu) fastmenus.js. V přehledech využívajících speciální stránky ze složky special pak záleží na tom, co daná stránka přehledu vyžaduje (Ve složce special jsou umístěni podsložky se soubory jednotlivých speciálních přehledů). Hlavní skript obsluhující takové stránky se buď umisťuje buď přímo do stránky index.htm, která je umístěna v dané speciální podsložce nebo se tento skript umisťuje do souboru index.js (jeho pojmenování je samozřejmě volitelné, ale pro účely dalšího vysvětlování se držme názvu souboru index.js). Každá stránka speciálního přehledu (steně tak i speciální složka - viz. popis tvorby stránek spec. složky) musí vždy načítat soubor specpage.js a to hlavní stránkou přehledu (index.htm). Tento soubor skriptu zajišťuje základní funkcionalitu stránky tak, aby s ní mohla zacházet pracovní plocha webového rozhraní flexideo a zároveň vytváří základní prostředí pro případnou tvorbu objektů pro usnadnění tvorbu speciálních stránek. Ve skriptu index.js je dále zapotřebí nastavit proměnnou workWind tak, aby odkazovala na objekt typu window, ve kterém se zobrazuje hlavní část speciální stránky. Speciální stránky dále většinou využívají objektů služeb pro přehledy a někdy též objektů pro rychlá menu. Jde o již zmíněné soubory skriptů wtbservices.js a fastmenus.js, jež jsou využívány i běžnými přehledy. Pro tyto objekty jsou k dispozici konstruktory v uvedených souborech. Zatímco první z uvedených je umisťován do stránky index.htm speciální stránky, durhý, obsluhující rychlá menu, musí být umístěn buď též do stránky index.htm nebo - pokud speciální stránky využívají rámů - se umisťují až do html stránek jednotlivých rámů (většinou jen do hlavního rámu). Soubor s konstruktory menu musí být vždy načítán do okna, kde budou menu zobrazována (možno i více než do jednoho). Objekty menu pak pro svou funkcionalitu využívají objekty služeb, jejichž konstruktory jsou v souboru wtbservices.js. Odkaz na objekt speciálních služeb (většinou s názvem spcs) se předává konstruktoru objektu rychlého menu (FMNMenu).

📄️Speciální nastavení

Speciální přehledy jsou pořád ještě přehledy a mají tedy svá nastavení. Ale na druhou stranu jsou to vlastně předem nedefinovatelné stránky, které slouží k různým účelům a můžeme jen předpokládat, že se zde nějakým způsobem budou prezentovat data (ale nikde není napsáno že musí), nic víc. Proto v okamžiku zvolení speciální stránky se znemožní provádět drtivou většinu nastavení, která je možné provádět v přehledu běžném, ale i v přehledu s uživatelským vzhledem. Zůstane pouze možnost v bodu B) nastavit výstupní údje - to proto, aby bylo možné prezentovat otevřenou položku ve spec. přehledu, pokud ji tento umožní otevřít a zůstaně několik voleb v části G). Je však praktické, aby i speciální přehled měl možnost ukládat určitá nastavení. K tomu slouží bod "H) Nastavení speciální stránky". Zde je třeba zvolit připravenu podsložku se stránkami. V této složce pak také musí existovat soubor s příponou *.mxl (XML soubor), jehož název musí začínat slovem "set-" a pak musí následovat jméno typu dokumentu, na kterém jste se rozhodli přehled založit. Jedna speciální stránka tak může existovat pro několik typů dokumentů s tím, že možnost použít speciální stránku nad určitým typem je dána právě existencí odpovídajícího souboru nastavení ve složce dané spec. stránky přehledu. Tento soubor obsahuje v kmenovém uzlu special-settings jeden nebo několik uzlů admin a jeden uzel user. Další obsah je již závislý na konkrétních potřebách stránky, která si do těchto nastavení přistupuje. Rozdíl mezi admin a user je v tom, že zatímco první je pevně dán souborem, druhý je načten do stránky nastavení přehledu (v bodu H) a uživatel zadávající přehled tato nastavení může změnit. Také platí, že zatímco admin může mít téměř libovolnou strukturu (odkazkuje se pak tečkovým operátorem objektového modelu), uživatelský kvůli možnosti editace uživatelem musí být uveden jako seznam uzlů setting s atributy udávajícími jméno, popisek, vysvětlivky a typ (number, string, date, time, boolean). Přístup k těmto nastastavením je pak ze skriptu pomocí objektu (konstruktoru) SPCServices() (popis viz. zde). Ve startovacím příkladu je tak např. demostrována jedna admin vlastnost, která pro určitý typ povoluje zobrazování datumu před časem a v uživatelské části nastavení pak uživateli umožňuje si v preferencích zvolit, zda toto datum chce či nechce zobrazovat (účel berte s rezervou, je to jen demonstrační příklad).