VÝBĚR Z OBLASTI
Uživatelské rozhraní
DAD
flexideo tools
Systém aktualizací
Ke stažení
Registr akcí
Aby bylo možné transformaci provést, musí být vsazena do rámce, který toto spuštění obslouží. Transformace jsou výhradně spouštěny v rámci akcí a to pomocí k tomu vyhrazené funkce runTransformProcedure (můžete se setkat i s alternativním názvem doXsltAction). Tato funkce má dva argumenty - sTempFld a sActLabel, kde první určuje složku, kde je transformace umístěna a odkud jsou načtena klíčová nastavení ze souboru settings.mxl, která řídí chod transformace. Druhý argument je čistě informativní a slouží pro ucelenější info uživateli, je-li jej zapotřebí.
Pro spuštění transformace je tedy vytvořena pomocná akce s jedinou instrukcí function a je uložena do složky shared/_independent, neboť se z principu nejedná o akci dokumentu, která by byla uložena do podsložky s typem.
Pokud se tedy transformace zveřejňuje k použití, je třeba provést její registraci. Registrace se v nástroji pro tvorbu transformačních procedur provádí buď v rámci vkládání na server pomocí tlačítka "Kopii na server" v hlavním okně transformací (pod seznamem dostupných procedur) a nebo je možné zobrazit přímo okno registrace přes pomocného klienta serveru flexideo. Vlastní dialog registrace vypadá takto:
V horní části je seznam dosud neregistrovaných procedur. Tedy těch, které jsou vytvořeny, mají svoji podsložku ve složce transformací na serveru (tedy nikoli v přípravné složce), ale nemají odpovídající registraci. Tlačítkem odstranit pod tímto seznamem provedete odstranění této složky i s obsahem. Tlačítkem registrovat pak naopak vytvoříte standardní soubor akce spouštějící zvolenou transformaci a také vytvořít výchozí záznam v registru akcí v databázi serveru. Po registraci položku akce najdete i s primárním klíčem (pdk) registrace v závorce ve spodním seznamu. Vedle tohoto setnamu je pak k dispozici formulář pro editaci vybrané položky registrace. Zde je možné upravit jednak výchozí jméno akce, její název zobrazovaný uživateli, popis a případně i skupinu. Důležité je si uvědomit, že upravujete parametry akce, která transformaci spouští, nikoli transformaci samotnou. Komentář je pracovní text čistě pro případné poznámky k registraci. Prostředí (enviroment) rozhoduje o tom, zda bude akce spouštějící transformaci dostupná v přehledu dokumentů, formuláři dokumentu, doplňku addOn. Další tři kolonky "doc-type", "only-for-role" a "only-for-user" určují, za jakých podmínek se akce určitému uživateli na určitém místě nabídne / zpřístupní. Pokud nejsou tyto kolonky vyplněny, je akce přístupná všem uživatelům ve všech typech dokumentů. Výchozím nastavením bývá omezení pouze na uživatele, který registraci provádí, tj. do kolonky "only-for-user" se vyplní do závorky jeho id (pdk z registru uživatelů). Je to z důvodu okamžité použitelnosti akce, která nebývá v okamžiku registrace žádoucí. Aby se ostatním uživatelům nezpřístupnila dříve, než je definitivně připravena, je omezena na použití pouze jedním uižvatelem. Často však bývá potřeba omezit použití transformace nikoli na uživatele, ale spíše na roli (tj. skupinu uživatelů) a také pouze pro určitý typ dokumentu. Tyto hodnoty je třeba uzavírat do závorek podobně, jako je tomu v registraci přes webové rozhraní transformací. Jednotlivé hodnoty se pak převádějí na samostatné záznamy v rámci jednoho registru, což je patrné zejména při editaci registru přes formulář typu action_register, kde je rovněž možné zavádět a upravovat registr akcí a tím i transformačních procesů.