História stránky

...

Na prevádzkovanie TCL je potrebné mať okrem samotného systému D2000 (verzie 9.2.34 alebo vyššej) ešte webový server, na ktorý sa budú pripájať klienti s internetovými prehliadačmi. Webový server môže byť akýkoľvek s podporou java servlet spec 23.40+. Funkčnosť TCL bola odskúšaná so servermi Apache Tomcat, JBoss Application Server a WildFly

...

hostname IP adresa alebo názov počítača, na ktorom beží Apache Tomcat.

port Číslo portu pre pripojenie cez HTTP(S) k Apache Tomcat. Ak je port = 80, nemusí sa zadávať, vo východzom nastavení po inštalácii Apache Tomcat používa port 8080.

myApp Názov adresára v hlavnom adresári Apache Tomcatu (adresár aplikácie tenkého klienta).

urlparams

URL parametre. Pomocou parametrov v URL je možné špecifikovať správanie TCL. Je možné nastaviť tieto parametre:

__d2tcl__OverrideOpen=meno_schémy:číslo_inštancie
parameter určuje, že po úspešnom prihlásení používateľa sa otvorí schéma meno_schémy v inštancii číslo_inštancie. Číslo inštancie je nepovinné, v takom prípade sa schéma otvorí v základnej (nulovej) inštancii. Zadaná schéma sa otvorí vždy bez ohľadu na nastavenie východzej schémy/zostavy v parametroch používateľa D2000. Parameter je možné zapísať aj v skrátenom tvare !meno_schémy, napr. http://localhost:8080/myApp/?!S.Main

__d2tcl__FallbackOpen=meno_schémy:číslo_inštancie
daná schéma sa otvorí iba ak používateľ nemá žiadnu schému/zostavu nastavenú ako východziu v parametroch používateľa. Ak má nastavenú východziu, tento parameter je ignorovaný.

__d2tcl__UseCredentials=meno:heslo
parameter umožňuje automaticky prihlásiť užívateľa daným menom a heslom bez toho, aby sa mu zobrazil prihlasovací dialóg. V prípade, že v hodnote parametra je zadané len meno (bez dvojbodky), prihlasovací dialóg sa zobrazí s predvyplneným menom.

__d2tcl__NickName=nickname
parameter umožňuje pomenovať D2000 proces .SEE, ktorý vznikne pripojením klienta a slúži na interpretáciu ESL skriptov zobrazovaných schém. To je možné využiť pri ladení skriptu ESL, keď treba špecifikovať, na ktorom procese .SEE má ladenie prebiehať.

__d2tcl__AuthMethod=metódy
parameter umožňuje špecifikovať metódu autentifikácie. Prípustné metódy sú:

d2000 - overovanie užívateľa menom a heslom
spnego - overenie podľa aktualne prihláseného užívateľa v operačnom systéme, bez zadávania mena/hesla

Je možné zadať obe metódy, oddelené čiarkou. V takomto prípade sa vykoná 'spnego' autentifikácia ako prvá. Ak zlyhá, použije sa metóda 'd2000'.

Ak parameter nie je uvedený, východzia hodnota je 'd2000'

Vlastnosť je dostupná od D2000 release R067

Info
Parametre v URL sa zapisujú za znak '?' a oddeľujú sa znakom '&'.

Príklad URL s parametrami:

Žiadny formát
http://localhost:8080/myApp/?__d2tcl__OverrideOpen=S.Main&__d2tcl__UseCredentials=SystemD2000:SystemD2000&__d2tcl__NickName=debugsession1

alias Pre zjednodušenie zápisu URL parametrov je možné nakonfigurovať tzv. aliasy. Alias je pomenovaná množina URL parametrov, ktorej meno je špecifikované v URL ako text za znakom '?', napr.
http://hostname[:port]/myApp/?alias

...

Konfigurácia jednotlivých aliasov je čítaná z adresára web aplikácie na web serveri zo súboru WEB-INF\/d2tcl_config.xml (štandardne C:\Program Files\Apache Software Foundation\Tomcat X\webapps\myApp\WEB-INF\d2tcl_config.xml). Konfiguračný súbor vo východzom stave neexistuje, pre použitie aliasov je potrebné ho vytvoriť

V konfiguračnom súbore je ďalej možné nastaviť TCP port na ktorom má počúvať tctsconnector.

Príklad konfiguračného súboru d2tcl_config.xml:

...

Blok kódu

title	d2tcl_config.xml

<?xml version="1.0" encoding="UTF-8"?>
 <config>
   <tctsconnector port="7120"/>

   <alias name="*">
     <param>__d2tcl__UseCredentials=SystemD2000:SystemD2000</param>
   </alias>
   
   <alias name="">
     <param>__d2tcl__FallbackOpen=S.Main</param>
   </alias>
   
   <alias name="s1">
     <param>__d2tcl__OverrideOpen=S.Section1</param>
   </alias>
	
   <alias name="admin">
     <param>__d2tcl__UseCredentials=administrator</param>
     <param>!S.Admin</param>
   </alias>
 </config>

...

Zastavenie Tomcat servera.
Nakopírovať súbory z D2000_EXE\tcl\war\ do adresára aplikácie vo web serveri (meno adresára musí byť vyhradené pre túto inštanciu TCL, napríklad webapps\/myOtherApp
Vytvoriť service "tcts.exe --WStomcatHost:port" a Watchdog (WD) na tento service.
tomcatHost je meno servera, na ktorom beží inštancia tomcat-u,
port je unikátne číslo komunikačného portu medzi tcts a D2WTC, napríklad 7121, 7122, 7123, ..
Prvá inštancia TCL využíva port 7120, ak nie je špecifikované inakTCP portu na ktorom počúva TCTS connector. Default je 7120.
Vytvoriť service na automatickú synchronizáciu bitových máp potrebných súborov (obrázky, súbory, ...) tcldeployer.exe --WStomcatHost:port a Watchdog (WD) na tento service, kde číslo portu zostáva rovnaké ako v predchádzajúcom bode.
Konfigurácia portu nasadenej aplikácie na aplikačnom serveri je servlet-init parametrov. V tomto prípade je číslo komunikačného portu D2000 zadané ako init parameter pre servlety GWTTCLServiceImpl a GWTTCLServiceImpl2 v súboroch WEB-INF/web*.xml.
Príklad konfigurácie:
<servlet> <servlet-name>GWTTCLServiceImpl</servlet-name> <servlet-class>sk.ipesoft.d2wtc.servlet.D2WASServiceImpl</servlet-class> <init-param> <param-name>d2000_servlet_log_dir</param-name> <param-value></param-value> </init-param> <init-param> <param-name>d2port</param-name> <param-value>7121</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> . Port sa nastavuje v súbore d2tcl_config.xml, ako atribút elementu tctsconnector, viď vyššie.
Vytvoriť service event.exe podľa potreby a popisu v predchádzajúcom odseku.
Nová inštancia TCL bude dostupná na URL:
http://hostname[:port]/myOtherApp/[?alias]

...

Strom stránky

Porovnávané verzie

Stará verzia 6

Nová verzia Aktuálny

Kľúč