Copyright: Copyright © 1998 Software602, a.s.


Zde upravte text komentáře.


Potvrdí provedené změny a uzavře dialog.


Odvolá (stornuje) provedené změny a uzavře dialog.


Zobrazí nápovědu, která se vztahuje k tomuto oknu.


Vyberte globální proměnnou projektu, jejíž alias chcete vytvořit.


Zadejte alias, pod kterým má být dostupná hodnota vybrané globální proměnné projektu ve WBC konektoru a v HTW šabloně.


Vyberte název WinBase602 SQL serveru, ke kterému se má přihlášovat vytvářený WBC konektor.


Vyberte uživatelské jméno ze seznamu.


Zadejte heslo k uživatelskému účtu.


Vyberte aplikaci, se kterou má pracovat vytvářený WBC konektor.


Vyberte vstupní formulářovou proměnnou, jejíž hodnotu má WBC konektor vkládat na vybrané místo.

Po výběru musíte stisknout tlačítko pro vložení značky.


Vloží na aktuální místo v textu značku (citace vstupní proměnné formuláře), kterou WinBase602 Internet klient bude nahrazovat hodnotou vybrané vstupní proměnné HTML formuláře.


Vyberte ze seznamu vnitřních programů v dané aplikaci program, který bude projektem pro tuto komponentu Program.


Zadejte název SELECTu, pomocí kterého se budete v šabloně odkazovat na odpověď.


Zatržením stanovíte, že z databáze bude WinBase602 Internet klient číst všechny záznamy, které vyhovují danému SELECTu.


Zatržením stanovíte, že WinBase602 Internet klient bude číst z databáze pouze některé záznamy z těch, které vyhovují SELECTu. Musíte určit, které to budou.


Zadejte pořadové číslo prvního záznamu (číslováno od nuly), který má být přečten z databáze.

Pořadovým číslem se myslí pořadí v seznamu všech záznamů, které vyhovují danému SELECTu.


Zatržením stanovíte, že má být přečten pouze záznam s daným pořadovým číslem a žádný jiný.


Zatržením stanovíte, že má být přečteno prvních n záznamů od zadaného záznamu (včetně něj) z odpovědi na SELECT.


Zadejte, kolik záznamů od zadaného (včetně něj) má být přečteno z odpovědi na SELECT.


Umožní editaci WBC konektoru ve vizuálním editoru.


Zadejte název HTW šablony, která má být používána WinBase602 Internet klientem pro generování HTML stránky.


Umožní vybrat HTW šablonu, kterou má používat WinBase602 Internet klient pro generování HTML stránky.


Zadejte název chybové HTW šablony, která má být používána WinBase602 Internet klientem pro generování HTML stránky, pokud při zpracování WBC konektoru, nebo HTW šablony nastane chyba.


Umožní vybrat chybovou HTW šablonu, kterou má používat WinBase602 Internet klient pro generování HTML stránky, pokud při zpracování WBC konektoru, nebo HTW šablony nastane chyba.


Zde je seznam vstupních proměnných formuláře, jejichž předání má WBC konektor vyžadovat (pokud by nebyla aspoň jedna z těchto proměnných předána, zpracování konektoru skončí chybou).

U každé proměnné je uveden počet jejích hodnot, které má konektor vyžadovat.

Změnit počet hodnot vybrané proměnné můžete stisknutím klávesy F2.


Vyberte název vstupní formulářové proměnné, jejíž předání má WBC konektor vyžadovat. V seznamu jsou pouze proměnné, jejichž předání WBC konektor zatím nevyžaduje.


Zadejte, kolik hodnot vybrané vstupní proměnné formuláře má WBC konektor při běhu vyžadovat.


Přidá vybranou vstupní proměnnou formuláře do seznamu vyžadovaných vstupních proměnných (RequiredValues). Bude vyžadováno předání zadaného počtu hodnot této proměnné.


Ze seznamu proměnných, jejichž hodnota(y) bude vyžadována při běhu WBC konektoru, odstraní vstupní proměnnou formuláře, která je momentálně v tomto seznamu vybraná.


Vyberte ze seznamu vnitřních programů dané aplikace ten program, který obsahuje proceduru RunProgram, podle které má být provedeno generování textu na HTW návěští v HTW šabloně.


Zadejte, kolik nejvýše může být přečteno záznamů z odpovědi na jeden SELECT.

Prázdný údaj znamená, že může být přečten libovolný počet záznamů.


Zde je seznam komponent daného WBC konektoru.

WinBase602 Internet klient bude zpracovávat komponenty v tom pořadí, v jakém jsou uvedeny v tomto seznamu.


Vytvoří novou komponentu WBC konektoru.


Změní vybranou komponentu WBC konektoru.


Smaže (odstraní) vybranou komponentu WBC konektoru.


Přesune vybranou komponentu WBC konektoru o jednu pozici k začátku seznamu komponent.


Přesune vybranou komponentu WBC konektoru o jednu pozici ke konci seznamu komponent.


Umožní editovat zdrojový text WBC konektoru.


Vyberte tabulku, ve které bude tento SQL příkaz INSERT vytvářet nové záznamy.


Označte atributy, jejichž hodnoty bude tento SQL příkaz INSERT nastavovat.


Označí všechny atributy dané tabulky.


Odznačí všechny atributy dané tabulky.


Vyberte atribut, jehož hodnotu chcete nastavit.

Tento seznam obsahuje ty atributy, které byly označeny v předchozím kroku, a hodnoty, které budou při provádění WBC konektoru přiřazeny těmto atributům.


Zadejte hodnotu, která bude přiřazena vybranému atributu.


Nastaví zadanou hodnotu vybranému atributu.


Poklepáním (doubleclick) na vybrané vstupní formulářové proměnné vložíte její citaci do hodnoty vybraného atributu.

Tento seznam obsahuje vstupní formulářové proměnné.


Zatržením stanovíte, že název databáze bude do tohoto konektoru předáván pomocí vstupní formulářové proměnné.


Zadejte název vstupní formulářové proměnné, která bude obsahovat název databáze, ke které se má WBC konektor připojovat.


Zatržením stanovíte, že název aplikace bude do tohoto konektoru předáván pomocí vstupní formulářové proměnné.


Zadejte název vstupní formulářové proměnné, která bude obsahovat název aplikace, ke které se má WBC konektor připojovat.


Zatržením stanovíte, že předání proměnné s názvem databáze, resp. s názvem aplikace, bude při běhu WBC konektoru vyžadováno (tyto proměnné budou uvedeny v bloku RequiredValues).


Volbou této možnosti bude smazán obsah tohoto konektoru.


Volbou této možnosti nebude smazán obsah konektoru.

Musíte zajistit, aby všechny komponenty pracovaly s existujícími databázovými objekty (tabulky, vnitřní programy), což se při změně připojení k SQL serveru nedá implicitně předpokládat.


Seznam vstupních proměnných. Hodnotu proměnné editujte stiskem klávesy F2, nebo poklepáním na proměnné.


Návrhář dynamických HTML stránek

Tento návrhář slouží k vytváření WBC konektorů. Tyto konektory spolu s HTW šablonami definují obsah a vzhled dynamicky generovaných HTML stránek, které pracují s databází WinBase602 prostřednictvím některého z WinBase602 Internet klientů.

Pomocí tohoto návrháře můžete nastavovat parametry WBC konektoru a vytvářet a měnit komponenty WBC konektoru.

Pokud chcete pochopit principy provozu dynamických HTML stránek, přečtěte si úvod do vytváření dynamických HTML stránek.

Můžete nám také na adresu wb_comment@software602.cz zaslat popis problému, který se vyskytl při provozu, nebo návrhu dynamických HTML stránek .


Seznam příkazů v menu

Konektor

Editovat v textovém editoru

Konec editace

Změnit

Připojení k SQL serveru...

Parametry konektoru...

Vzorové hodnoty proměnných...

Nápověda

Kontextová nápověda

Seznam témat

O Návrháři dynamických HTML stránek...


Úvod do vytváření dynamických HTML stránek pomocí WinTextu602 a WinBase602

Pomocí těchto nástrojů můžete snadno vytvořit dynamické HTML stránky, které mají číst a zapisovat údaje do databáze WinBase602.

K čemu slouží tato technologie?

Pomocí dynamických HTML stránek lze vytvořit internetové uživatelské rozhraní libovolné aplikace napsané ve WinBase602.

Nejlepším příkladem použití dynamických HTML stránek je produkt 602WebCatalog (systém pro objednávání zboží prostřednictvím Internetu), jehož internetová uživatelská část je celá vytvořena pomocí těchto dynamických HTML stránek. Tento produkt si můžete vyzkoušet na adrese http://www.software602.cz.

Dalším produktem, jehož internetová uživatelská část je celá vytvořena pomocí této technologie, je 602WebForum (diskusní fórum, do kterého přispívají účastníci prostřednictvím Internetu). Pomocí 602WebForum je realizována on-line podpora produktů, které vyvíjí a prodává Software602, a.s. Tato on-line podpora je umístěna na adrese http://www.software602.cz.

Co je potřebné k provozu dynamických HTML stránek?

1. WinBase602 SQL server (případně také WinBase602 Personální databáze)

2. WinBase602 Internet klienta (je součástí dodávky WinBase602 SQL serveru)

3. webserver, který podporuje aspoň jeden z protokolů CGI, FastCGI, ISAPI

Co je potřebné k vytváření dynamických HTML stránek?

1. Textový editor WinText602 - pomocí něj navrhujete vzhled stránek

2. WinBase602 (libovolnou instalaci) - součástí WinBase602 je tento Návrhář, pomocí kterého stanovujete, které akce má dynamická HTML stránka provádět s databází (tj. např. které údaje se mají z databáze přečíst, které údaje se mají do databáze zapsat atd.). Návrhář je volaný WinTextem při nastavování akce formulářového tlačítka typu Submit.

Pokračování:

Jakým způsobem jsou při provozu vytvářeny dynamické HTML stránky?


Jak jsou při provozu vytvářeny dynamické HTML stránky

Bližší představu o mechanismu tvorby dynamické HTML stránky Vám dá následující obrázek:

Při vytváření dynamické HTML stránky spolupracuje několik aplikací:

1. www browser - s touto aplikací pracuje uživatel, browser odesílá požadavky webserveru a zobrazuje výslednou stránku

2. webserver - komunikuje s browserem, předává uživatelův požadavek WinBase602 Internet klientovi, přebírá od něj sestavenou stránku a odesílá ji browseru

3. WinBase602 Internet klient

- přebere od webserveru požadavek na sestavení dynamické HTML stránky

- vyhledá a přečte WBC konektor (jeho název je obsažen v požadavku, který Internet klient obdržel od webserveru) a provede operace s databází, které jsou popsány v tomto konektoru (tj. typicky sestaví a provede SQL příkazy a v případě příkazu SELECT přečte ty údaje z databáze, které vyhovují podmínce v příkazu SELECT)

- vyhledá a přečte HTW šablonu a podle ní sestaví výslednou HTML stránku, přičemž podle příkazů v šabloně zformátuje přečtené údaje z databáze do výsledné stránky

- výslednou stránku předá webserveru

4. WinBase602 SQL server - spravuje data, se kterými pracuje daná aplikace a provádí SQL příkazy, které sestavil Internet klient

Struktura požadavku, který vysílá www browser a který obdrží Internet klient, je následující:

Zároveň s požadavkem www browser vysílá také seznam tzv. formulářových proměnných a jejich hodnot. Jsou to údaje, které uživatel zadal v HTML formuláři (tag <FORM>), respektive v jednotlivých prvcích formuláře (tagy <INPUT>). Internet klient je volán typicky v okamžiku, kdy uživatel stiskne tlačítko SUBMIT (tj. <INPUT TYPE=”SUBMIT” VALUE=”Odeslat”>) a Internet klient zpracuje zadané údaje (které dostane prostřednictvím formulářových proměnných) a vygeneruje HTML stránku, kterou následně browser zobrazí.

WinBase602 Internet klienti jsou realizováni formou skriptů, které rozšiřují možnosti webserveru. Z tohoto důvodu je nutno v požadavku uvést adresář se skripty webserveru a také název skriptu (tj. Internet klienta), který má vyřídit tento požadavek (protože samotný webserver neumí sestavovat dynamické HTML stránky s údaji z databáze WinBase602).

Místo názvu konektoru lze uvést název HTW šablony, která však musí obsahovat tzv. WBC sekci, což je vlastně konektor ve zcela stejné podobě, v jaké by byl v samostatném souboru.


WinBase602 Internet klienti

Jsou to programy, které zpracovávají WBC konektory a HTW šablony a podle nich provádějí požadované akce s databází a generují dynamické HTML stránky.

Jsou realizovány ve formě skriptů, které rozšiřují schopnosti webserveru. Bližší představu o principu jejich činnosti naleznete zde.

S WinBase602 SQL serverem se dodává několik druhů Internet klientů: CGI klient, FastCGI klient a ISAPI klient. Tito klienti rozumějí naprosto stejným WBC a HTW příkazům a z toho samého konektoru a šablony vygenerují naprosto stejnou HTML stránku. Jejich jedinou odlišností je komunikační protokol, kterým komunikují s webserverem. Každý Internet klient je pojmenován podle toho komunikačního protokolu, který “ovládá”.

Pokračování:

Další informace o Internet klientech (např. popis instalace k webserveru atd.) naleznete v souboru Přečtěte si o CGI, který byl nainstalován spolu s WinBase602 a jehož zástupce (shortcut) naleznete v seskupení WinBase602.


Co je WBC konektor

WBC konektor je buď samostatný textový soubor (s příponou WBC), nebo část HTW šablony. Jsou v něm popsány jazykem WBC konektorů následující informace:

- název databáze a aplikace, se kterou bude daný konektor pracovat, a uživatelské jméno a heslo, pomocí kterého se má Internet klient přihlásit k SQL serveru

- SQL příkazy a procedury ve vnitřním programovacím jazyku WinBase602, které musí být provedeny, aby bylo možno sestavit výslednou HTML stránku, a ostatní komponenty

- ostatní parametry

Název WBC konektoru je obsažen v požadavku, který převezme Internet klient od webserveru (blíže viz mechanismus sestavování výsledné HTML stránky).

Pomocí tohoto Návrháře dynamických HTML stránek vytváříte WBC konektor, pomocí WinTextu602 vytváříte HTW šablonu.

Pokračování:

Podrobný popis jazyka WBC konektorů je součástí Příručky SQL serveru ze sady manuálů k WinBase602 SQL serveru, nebo jej lze nalézt v Nápovědě k CGI klientovi (wbcgi.hlp - součást instalace WinBase602).


Co je HTW šablona

Je to textový soubor, který obsahuje jednak text ve formátu HTML, jednak speciální HTW příkazy, kterými je řízeno formátování dat z databáze do HTML textu. Internet klient provádí toto formátování dat do HTML textu podle výše zmíněných HTW příkazů. Výsledkem práce Internet klienta je text pouze ve formátu HTML, tj. bez HTW příkazů (blíže viz mechanismus sestavování výsledné HTML stránky).

HTW šablony lze vytvářet vizuálně pomocí textového editoru WinText602.

Pokračování:

Podrobný popis HTW příkazů je uveden v Příručce SQL serveru ze sady manuálů k WinBase602 SQL serveru, nebo v Nápovědě k CGI klientovi (wbcgi.hlp - součást instalace WinBase602).


Co jsou komponenty WBC konektoru
Komponenty WBC konektoru

Jsou to SQL příkazy a zdrojové texty ve vnitřním programovacím jazyku WinBase602, které jsou prováděny při běhu konektoru. Např. konektor může pomocí SQL příkazu INSERT vytvořit nový záznam v tabulce a pomocí SQL příkazu SELECT vybrat z téže tabulky záznamy, které posléze HTW šablona zformátuje do HTML textu.

Při běhu konektoru jsou komponenty prováděny v tom samém pořadí, v jakém jsou zobrazeny v hlavním okně Návrháře.

WBC konektor obsahuje komponenty čtyř druhů:

1. SQLStatement - SQL příkazy (SELECT, INSERT, UPDATE, DELETE)

2. Program - zdrojové texty ve vniřním programovacím jazyku WinBase602

3. GetVariable - zpřístupňují globální proměnné programů aplikace WinBase602 v HTW šabloně

4. komentář - používá se na psaní krátkých poznámek k WBC konektoru

Pokračování:

Co je WBC konektor.

Jak vytvořit komponentu.

Jak editovat komponentu.

Jak smazat komponentu.

Jak změnit pořadí komponent.


Co je komponenta SQLStatement
Komponenta SQLStatement

Je to SQL příkaz, který bude prováděn při běhu konektoru.

K vytváření a editaci SQL příkazů SELECT je využíván Návrhář dotazů, který je součástí vývojového prostředí WinBase602. Práce s Návrhářem dotazů je popsána v manuálech, které jsou dodávány s WinBase602, nebo také v nápovědě, která se zobrazí po stisknutí klávesy F1, když je tento Návrhář aktivní.

SQL příkazy INSERT jsou vytvářeny pomocí Průvodce vytvořením SQL příkazu INSERT.

Ostatní SQL příkazy (např. UPDATE, DELETE) jsou vytvářeny a editovány v textovém editoru.

SELECT

Je to dotaz, kterým vybíráme řádky z tabulek v databázi, které vyhovují podmínce zapsané v dotazu. Výsledkem dotazu je seznam řádků, které vyhovují podmínce. Tento výsledek musíme pojmenovat nějakým názvem, který začíná písmenem anglické abecedy, nebo znakem podtržítko, obsahuje písmena anglické abecedy, znak podtržítko, nebo číslice a je libovolně dlouhý. Tímto názvem se na výsledek odkazujeme v HTW šabloně při formátování údajů z databáze do HTML textu.

Pokud v hlavním okně Návrháře dynamických HTML stránek klikneme pravým tlačítkem myši na komponentě typu SQLStatement, která obsahuje příkaz SELECT, zobrazí se toto kontextové menu:

 Dotaz vytváříme a editujeme pomocí Návrháře dotazů, který je součástí vývojového prostředí WinBase602. Návrhář dotazů spustíme pomocí příkazu Změnit z kontextového menu. Práce s Návrhářem dotazů je popsána v manuálech, které jsou dodávány s WinBase602, nebo také v nápovědě, která se zobrazí po stisknutí klávesy F1, když je tento Návrhář aktivní.

Ve vlastnostech SELECTu (příkaz Vlastnosti SELECTu z kontextového menu) můžeme dále uvést, že se mají z databáze přečíst pouze některé řádky, a také zde můžeme pojmenovat výsledek SELECTu.

Příkazem Změnit - editovat text můžeme editovat textovou podobu příkazu SELECT v textovém editoru.

Ostatní SQL příkazy

Všechny ostatní SQL příkazy editujeme v textovém editoru.

Příkaz INSERT vytváříme Průvodcem vytvořením příkazu INSERT, úpravy příkazu po jeho vytvoření provádíme opět v textovém editoru.


Co je komponenta Program
Komponenta Program

V této komponentě můžeme napsat (a při běhu konektoru provádět) libovolné příkazy vnitřního programovacího jazyka WinBase602. Každá komponenta Program může mít nastavený tzv. projekt. Projektem rozumíme objekt typu program definovaný v aplikaci WinBase602 v databázi, se kterou daný konektor pracuje. Pokud komponenta Program nastavuje projekt, můžeme v této komponentě volat procedury a funkce definované v projektu a nastavovat a číst hodnoty globálních proměnných projektu. Jiný projekt bude nastaven až v okamžiku, kdy začne provádění další komponenty Program, která nastavuje projekt.

Typicky komponenta Program nastavuje určitý projekt a tělo komponenty Program sestává pouze z volání určité procedury projektu.

Příklad:

Mějme aplikaci pro sběr objednávek po Internetu. V daném konektoru chceme založit novou objednávku a zapsat do databáze její údaje. Vytvoříme komponentu Program s následujícím obsahem; komponenta Program nastavuje projekt Web_objednavka, ve kterém je definována procedura Vytvor_novou_objednavku, která zakládá novou prázdnou objednávku a její číslo zapíše do globální proměnné cislo_nove_objednavky:

Vytvor_novou_objednavku;

Následně pomocí komponenty GetVariable získáme číslo nové objednávky:

proměnná v projektu: cislo_nove_objednavky

její alias v šabloně: nova_obj

A nyní můžeme pomocí SQL příkazu UPDATE zapsat údaje o objednávce:

UPDATE objednavky

SET firma="%firma%", adresa="%adresa%", datum=Today

WHERE cislo_objednavky=%nova_obj%;

Pokračování:

Podrobnější popis (spolu s příklady použití) lze nalézt v Nápovědě k CGI klientovi.


Co je komponenta GetVariable
Komponenta GetVariable

Pomocí této komponenty můžeme vytvořit kopii (alias) globální proměnné projektu, pomocí kterého se můžeme na tuto proměnnou odkazovat v HTW šabloně a v komponentách konektoru, které následují za touto komponentou GetVariable.

Aby bylo zřejmé, ze kterého projektu bude globální proměnná zkopírována, musí být před komponentou GetVariable komponenta Program, která nastavuje požadovaný projekt.

Ve zbytku konektoru se na hodnotu proměnné odkazujeme pomocí zápisu:
%alias%

V šabloně se na proměnnou odkazujeme přímo, bez znaků procenta. Např. citace této proměnné v šabloně se zadá zápisem:
<% alias %>

Pokračování:

Podrobnější popis (spolu s příklady použití) lze nalézt v Nápovědě k CGI klientovi.


Co je komponenta komentář
Komponenta komentář

Obsahem této komponenty může býl libovolně dlouhý libovolný text. Komponenty tohoto typu jsou při běhu konektorů ignorovány. Slouží pro vkládání krátkých popisů do konektoru, které pomáhají autorovi snadněji se v konektoru orientovat.


Dialog Vlastnosti komentáře

V tomto okně můžete upravit text komentáře. Komentář je jeden z několika druhů komponent WBC konektoru.

Tento dialog otevřeme stisknutím tlačítka [image] v hlavním okně Návrháře, zatímco je v seznamu komponent vybrána komponenta typu komentář, nebo při vytváření nové komponenty typu komentář (tlačítkem [image] v hlavním okně Návrháře).

Pokračování:

Co je to WBC konektor

Co jsou komponenty WBC konektoru

Co je komponenta komentář


Dialog Vlastnosti komponenty GetVariable

V rozvinovacím seznamu Proměnná projektu vybereme název globální proměnné projektu, který nastavuje komponenta typu Program předcházející této komponentě typu GetVariable.

V editačním řádku Její alias v šabloně zadáme, pod jakým jménem chceme mít vybranou globální proměnnou přístupnou v šabloně a v komponentách WBC konektoru, které následují po této komponentě typu GetVariable.

Tento dialog otevřeme stisknutím tlačítka [image] v hlavním okně Návrháře, zatímco je v seznamu komponent vybrána komponenta typu GetVariable, nebo při vytváření nové komponenty typu GetVariable (tlačítkem [image] v hlavním okně Návrháře).

Pokračování:

Co je to WBC konektor

Co jsou komponenty WBC konektoru

Co je komponenta GetVariable


Dialog Přihlášení se k WinBase602 SQL serveru

V okamžiku, kdy Návrhář dynamických HTML stránek potřebuje získat údaje z databáze spravované WinBase602 SQL serverem, musíte se k tomuto serveru přihlásit.

Nejdříve musíte vybrat název databáze, ke které se chcete přihlásit. Vyberte jej ze seznamu databází, které máte registrovány na Vašem počítači. Tento seznam je nadepsán Databáze WinBase602.

Poté bude kontaktována tato databáze a Návrhář zjistí seznam uživatelů této databáze a seznam aplikací v této databázi. Těmito údaji naplní příslušné rozvinovací seznamy (tj. Vaše uživatelské jméno a Název aplikace).

Nyní vyberte z výše uvedeného seznamu uživatelské jméno, které používáte pro vývoj dané aplikace a zadejte heslo (do editačního řádku Vaše heslo). Jméno a heslo uživatelského účtu, který má používat WBC konektor při generování HTML stránky, zadáváte v Průvodci připojením k SQL serveru, konkrétně v kroku účet pro použití v konektoru.

Nakonec vyberte název aplikace, se kterou má pracovat Vámi editovaný WBC konektor.

Pokud bylo zadáno nesprávné heslo, bude zobrazeno okno, které Vás o tomto informuje. Po zavření tohoto informačního okna můžete zadat správné heslo.

Tento dialog je otevřen v okamžiku, kdy je třeba se připojit k databázi. Jakmile je toto připojení ustanoveno, následující čtení informací z databáze už probíhá bez opětovného připojování a vyplňování tohoto dialogu.

Pozor: Pokud tento dialog ukončíte tlačítkem Storno (tj. nepřihlásíte se korektně k databázi, případně nevyberete aplikaci), nebude správně fungovat akce, kterou chcete právě teď provést! Např. při nastavování vlastností komponenty GetVariable nebude nabídnut seznam globálních proměnných projektu v odpovídajícím dialogu, a tím nebudete moci změnit vlastnosti vybrané komponenty GetVariable.


Dialog Komponenta SQLStatement

V editačním boxu upravte zdrojový text komponenty SQLStatement.

Odkazy na vstupní formulářové proměnné můžete do textu vložit tak, že nedříve umístíte kurzor ve zdrojovém textu komponenty na to místo, kam chcete vložit odkaz. Dále v rozvinovacím seznamu Formulářové proměnné vyberete proměnnou, jejíž odkaz chcete vložit do textu. Nyní stisknete tlačítko [image] a na místo, kde se nachází kurzor, bude vložen odkaz na vybranou formulářovou proměnnou.

Komponentu uložíte tlačítkem Uložit, provedené změny odvoláte tlačítkem Storno.

Tento dialog je otevřen tlačítkem [image] v hlavním okně Návrháře, pokud je zároveň vybrána v seznamu komponent komponenta SQLStatement, která není SELECT. Stejný dialog je použit v případě, že je zvolen příkaz Změnit - editovat text z kontextového menu komponenty SQLStatement SELECT, která se nachází v seznamu komponent v hlavním okně Návrháře.

Pokračování:

Co je to WBC konektor

Co jsou komponenty WBC konektoru

Co je komponenta SQLStatement


Dialog Komponenta Program

V editačním boxu upravte zdrojový text komponenty Program.

Projekt, který bude nastavovat tato komponenta, vyberte z rozvinovacího seznamu Projekt. V tomto seznamu jsou všechny programy ve vnitřním jazyku WinBase602, které jsou definovány v aplikaci, se kterou konektor pracuje.

Odkazy na vstupní formulářové proměnné můžete do textu vložit tak, že nedříve umístíte kurzor ve zdrojovém textu komponenty na to místo, kam chcete vložit odkaz. Dále v rozvinovacím seznamu Formulářové proměnné vyberete proměnnou, jejíž odkaz chcete vložit do textu. Nyní stisknete tlačítko [image] a na místo, kde se nachází kurzor, bude vložen odkaz na vybranou formulářovou proměnnou.

Komponentu uložíte tlačítkem Uložit, provedené změny odvoláte tlačítkem Storno.

Tento dialog je otevřen tlačítkem [image] v hlavním okně Návrháře, pokud je zároveň vybrána v seznamu komponent komponenta Program.

Pokračování:

Co je to WBC konektor

Co jsou komponenty WBC konektoru

Co je komponenta Program


Dialog Vlastnosti komponenty SQLStatement - SELECT

V editačním řádku Pojmenování výsledku SELECTu zadejte název, kterým se budete v šabloně odvolávat na výsledek tohoto příkazu SELECT, tj. na řádky (záznamy), které vyhovují podmínce v tomto příkazu SELECT.

Dále můžete zadat, zda budou přečteny z databáze všechny vyhovující řádky (přepínač všechny, které vyhovují dotazu), nebo zda budou přečteny jen některé (přepínač jen některé z vyhovujících, a to). Ve druhém případě zadejte v editačním řádku od záznamu číslo pořadové číslo prvního záznamu, který má být přečten z databáze a buď zatrhněte přepínač pouze tento záznam (pak bude přečten ze všech vyhovujících záznamů pouze tento), nebo zatrhněte přepínač prvních a zadejte, kolik záznamů má být z databáze přečteno.

Tento dialog je vyvolán příkazem Vlastnosti SELECTu z kontextového menu komponenty SQLStatement typu SELECT v seznamu komponent v hlavním okně Návrháře.

Pokračování:

Co je to WBC konektor

Co jsou komponenty WBC konektoru

Co je komponenta SQLStatement


Dialog WBC konektor

V editačním boxu upravte zdrojový text konektoru.

Odkazy na vstupní formulářové proměnné můžete do textu vložit tak, že nedříve umístíte kurzor ve zdrojovém textu komponenty na to místo, kam chcete vložit odkaz. Dále v rozvinovacím seznamu Formulářové proměnné vyberete proměnnou, jejíž odkaz chcete vložit do textu. Nyní stisknete tlačítko [image] a na místo, kde se nachází kurzor, bude vložen odkaz na vybranou formulářovou proměnnou.

Konektor uložíte tlačítkem Uložit, provedené změny odvoláte tlačítkem Storno.

Tento dialog je otevřen, pokud stisknete tlačítko [image] v hlavním okně Návrháře, nebo při pokusu o editaci konektoru, který je příliš složitý na to, aby jej bylo možno editovat vizuálním editorem.

Pokračování:

Co je to WBC konektor

Jazyk WBC konektorů je popsán v Nápovědě k CGI klientovi, která byla nainstalována spolu s WinBase602 SQL serverem.


Dialog Parametry WBC konektoru

V tomto dialogu nastavujete následující parametry konektoru:

1. Šablona, podle které má být vygenerována dynamická HTML stránka (Šablony - pro odpověď); pokud je editovaný WBC konektor součástí HTW šablony, tento údaj se nezadává (ovládací prvky jsou šedé).

2. Šablona, podle které má být vygenerována dynamická HTML stránka, pokud při zpracování konektoru, nebo šablony pro odpověď nastala chyba (Šablony - chybová); pokud není tato šablona zvolena a nastane chyba při zpracování, použije se standardní chybová šablona. Tuto standardní chybovou šablonu vybíráte pomocí Administrátora CGI klienta (jeho popis je v nápovědě k němu nebo v Příručce k SQL serveru).

3. Vstupní proměnné, jejichž předání do WBC konektoru má být vyžadováno (pokud aspoň jedna z těchto vstupních formulářových proměnných nebude předána do WBC konektoru, zpracování skončí s chybou). Jsou uvedeny v seznamu RequiredValues.
Do seznamu přidáváme proměnnou tak, že ji vybereme v rozvinovacím seznamu název proměnné a v editačním řádku počet hodnot zadáme, kolik hodnot této proměnné má být vyžadováno. Následně stiskneme tlačítko Přidat.
Proměnnou odstraníme ze seznamu tak, že ji v seznamu vybereme a stiskneme tlačítko Smazat.
Počet hodnot proměnné, která už je v seznamu, změníme tak, že ji opět v seznamu vybereme a stiskem klávesy F2 vyvoláme editační řádek s počtem hodnot, upravíme počet hodnot a stiskneme klávesu Enter.

4. RunProgram: je to název vnitřního programu v aplikaci WinBase602, který obsahuje proceduru RunProgram, podle které má být vygenerována výsledná dynamická HTML stránka. Tento způsob generování je zcela odlišný od klasického, tj. od toho, že v konektoru jsou vykonány SQL příkazy a v šabloně jsou získaná data pomocí formátovacích příkazů zalámána do HTML textu. Princip fungování procedury RunProgram je takový, že v šabloně jsou pouze stanovena pojmenovaná místa v HTML textu (tzv. návěští) a v proceduře RunProgram je procedurálním způsobem vkládán libovolný text na tato návěští. V šabloně může být definováno libovolné množství návěští a v proceduře RunProgram může být libovolně dlouhý text vkládán na libovolná návěští libovolně-krát.
Tato problematika je podrobněji diskutována v Nápovědě k CGI klientovi.

5. V editačním řádku MaxRecords lze stanovit, kolik záznamů může být maximálně přečteno z databáze při čtení odpovědi na SQL příkaz SELECT.

Tento dialog lze otevřít pomocí příkazu Změnit | Parametry konektoru... v menu hlavního okna Návrháře.


Dialog Návrhář dynamických HTML stránek

Jedná se o hlavní okno Návrháře. Je v něm zobrazen seznam komponent editovaného WBC konektoru (v seznamu Seznam komponent v konektoru). Vpravo od seznamu jsou tlačítka, kterými lze manipulovat s komponentami (přidávat nové, měnit existující, mazat existující a měnit jejich pořadí).

Toto okno má také nabídku příkazů (menu).

V titulku okna je název editovaného WBC konektoru (nebo HTW šablony, ve které je editovaný konektor umístěn). Tento název je vypsán v hranatých závorkách za názvem okna a je uveden v relativně vzhledem k základnímu adresáři s WBC konektory (resp. s HTW šablonami).

Ve stavovém řádku (u spodního okraje okna) jsou vypisovány krátké pokyny, informace o činnosti Návrháře a krátká nápověda k jednotlivým příkazům v menu. Např. pokud přesuneme kurzor myši nad některé tlačítko v dialogu, bude ve stavovém řádku vypsán popis jeho funkce.

Jak...

vytvořit novou komponentu

změnit existující komponentu

smazat existující komponentu

změnit pořadí komponent

Co je...

WBC konektor

komponenta WBC konektoru

HTW šablona

Úvod do vytváření dynamických HTML stránek pomocí WinTextu602 a WinBase602.


Jak vytvořit novou komponentu

Komponenty vytváříme v hlavním okně Návrháře tlačítkem [image]. Po jeho stisku se zobrazí kontextové menu, ze kterého vybereme typ nové komponenty.

V následujícím dialogu upravíme vlastnosti nové komponenty.

Další možností je vyvolat kontextové menu (kliknutím pravým tlačítkem myši) kdekoliv v seznamu komponent a v něm buď rozvinout podmenu Vytvořit a v něm zvolit typ (pokud bylo kontextové menu vyvoláno pro některou z už existujících komponent),

nebo přímo zvolit typ nové komponenty (v ostatních případech).

Nová komponenta bude přidána za momentálně vybranou komponentu v seznamu komponent.

Pokračování:

Co je WBC konektor.

Co jsou komponenty WBC konektoru.

Jak editovat komponentu.

Jak smazat komponentu.

Jak změnit pořadí komponent.


Jak editovat komponentu

V hlavním okně Návrháře vybereme tuto komponentu v seznamu komponent a stiskneme tlačítko [image].

Další možností je vyvolat kontextové menu komponenty, kterou chceme editovat a v něm zvolit příkaz Změnit.

Kontextové menu komponenty typu SQLStatement, která obsahuje příkaz SELECT, vypadá takto:

Dotaz editujeme pomocí Návrháře dotazů, který je součástí vývojového prostředí WinBase602. Návrhář dotazů spustíme pomocí příkazu Změnit z kontextového menu. Práce s Návrhářem dotazů je popsána v manuálech, které jsou dodávány s WinBase602, nebo také v nápovědě, která se zobrazí po stisknutí klávesy F1, když je tento Návrhář aktivní.

Ve vlastnostech SELECTu (příkaz Vlastnosti SELECTu z kontextového menu) můžeme dále uvést, že se mají z databáze přečíst pouze některé řádky, a také zde můžeme pojmenovat výsledek SELECTu.

Příkazem Změnit - editovat text můžeme editovat textovou podobu příkazu SELECT v textovém editoru.

Pokračování:

Co je WBC konektor.

Co jsou komponenty WBC konektoru.

Jak vytvořit komponentu.

Jak smazat komponentu.

Jak změnit pořadí komponent.


Jak smazat komponentu

V hlavním okně Návrháře v seznamu komponent vybereme tuto komponentu a stiskneme tlačítko [image]. Tím bude vybraná komponenta smazána.

Další možností je vyvolat kontextové menu komponenty, kterou chceme smazat, a v něm zvolit příkaz Odstranit.

Pokračování:

Co je WBC konektor.

Co jsou komponenty WBC konektoru.

Jak vytvořit komponentu.

Jak editovat komponentu.

Jak změnit pořadí komponent.


Jak změnit pořadí komponent

V hlavním okně Návrháře můžeme přesouvat vybranou komponentu v seznamu komponent pomocí tlačítek [image] a [image].

Dále lze využít myši, konkrétně techniky drag and drop. Nejdříve komponentu uchopíme (přesuneme na ni kurzor myši, stiskneme levé tlačítko myši a držíme jej stisknuté). Nyní vybereme pohybem myši komponentě jiné místo v seznamu, přičemž stále držíme stisknuté levé tlačítko. Uvolněním levého tlačítka myši přesuneme vybranou komponentu na jiné místo v seznamu komponent.

Proč měnit pořadí komponent

Pořadí komponent v konektoru je důležité při provádění konektoru. Jednotlivé komponenty jsou prováděny WinBase602 Internet klientem v tom pořadí, v jakém jsou zobrazeny v Návrháři. Je tedy nutné např. příkaz INSERT (tj. komponenta SQLStatement - INSERT) umístit před příkaz SELECT (předp. oba příkazy pracují se stejnou tabulkou), aby se ve výsledku příkazu SELECT mohl objevit příkazem INSERT nově vytvořený záznam. Naopak pokud nechceme, aby do výsledku příkazu SELECT byl zahrnut nově vytvořený záznam, musíme příkaz SELECT umístit před příkaz INSERT.

Pořadí komponent je zcela zásadní pro správné použití komponenty GetVariable. Tato komponenta vytváří kopii globální proměnné projektu, který musí nastavit komponenta Program, která musí být umístěna před komponentou GetVariable.

Pokračování:

Co je WBC konektor.

Co jsou komponenty WBC konektoru.

Co je komponenta SQLStatement

Co je komponenta Program

Co je komponenta GetVariable

Jak vytvořit komponentu.

Jak editovat komponentu.

Jak smazat komponentu.


Dialog pro výběr HTW šablony

V tomto dialogu vybíráme šablonu, podle které bude sestavena výsledná HTML stránka, nebo šablonu, která bude použita v případě výskytu chyby.

Lze vybrat pouze soubory s příponou HTW (tj. šablony), které jsou umístěny v podstromu určeném pro HTW šablony (parametr HTWRootDirectory v parametrech Internet klientů - zadáváme je pomocí aplikace Administrátor CGI klienta).

K jednotlivým ovládacím prvkům dialogu lze vyvolat nápovědu pomocí tlačítka s otazníkem v titulku okna.

Tento dialog lze otevřít tlačítky Vyhledat... v dialogu Parametry WBC konektoru.


Průvodce vytvořením SQL příkazu INSERT - úvod
Průvodce vytvořením SQL příkazu INSERT
>> krok 1

Tento Průvodce Vám pomůže vytvořit nový SQL příkaz INSERT. Pomocí tohoto příkazu se vytváří nový záznam (řádek) v databázové tabulce. V rámci tohoto příkazu předepisujete hodnoty některých sloupců nově vytvářeného řádku databázové tabulky.

Další podrobnosti o databázových tabulkách a o příkazu INSERT naleznete v Nápovědě WinBase602, nebo v manuálech k WinBase602.

V tomto úvodním kroku Průvodce si přečtěte pokyny pro práci s ním a stiskněte tlačítko Next > (Další >).

Průvodce je spuštěn, pokud vytváříte novou komponentu WBC konektoru typu SQLStatement - INSERT.


Průvodce vytvořením SQL příkazu INSERT - výběr tabulky
<< pokyny  >> krok 2

Nejdříve musíte vybrat tabulku, do které bude tento příkaz INSERT přidávat nové záznamy.

Seznam tabulek, které jsou definovány v aplikaci WinBase602, je zobrazen v rozvinovacím seznamu Tabulka. Vyberte jednu z těchto tabulek a přejděte k následujícímu kroku Průvodce.


Průvodce vytvořením SQL příkazu INSERT - výběr atributů
<< krok 1  >> krok 3

Vyberte atributy (sloupce), jejichž hodnoty bude tento příkaz INSERT nastavovat v nově vytvořeném řádku databázové tabulky.

Je zobrazen seznam atributů spolu s jejich typy. V tomto seznamu pomocí myši označte ty atributy, které bude INSERT nastavovat.

Tlačítkem Vybrat vše můžete vybrat všechny atributy dané tabulky.

Tlačítkem Nevybrat nic můžete zrušit vybrání atributů.


Průvodce vytvořením SQL příkazu INSERT - hodnoty atributů
<< krok 2

V posledním kroku Průvodce je třeba určit hodnoty všech atributů, které bude příkaz INSERT nastavovat.

V seznamu Atributy a jejich hodnoty jsou zobrazeny vybrané atributy, jejich typ a hodnotu, kterou bude mít nastaven nově vytvářený záznam. Dále je v seznamu Formulářové proměnné zobrazen seznam vstupních formulářových proměnných.

Hodnotu určitému atributu nastavíme (změníme) takto: Nejdříve jej vybereme v seznamu atributů. Dále v editačním řádku Hodnota vybraného atributu upravíme hodnotu atributu. Nakonec stiskneme tlačítko Nastavit.

Při úpravě hodnoty vybraného atributu můžeme využít seznam vstupních formulářových proměnných. Dvojitým kliknutím na určité proměnné bude na aktuální místo kurzoru v editačním řádku Hodnota vybraného atributu přídána citace hodnoty této proměnné.

Musíme nastavit hodnoty všech atributů, které jsme označili v předcházejícím kroku Průvodce. Stiskem tlačítka Finish (Dokončit) Průvodce vytvoří nový příkaz INSERT.


Průvodce připojením k SQL serveru - aktuální parametry připojení

Toto je úvodní krok Průvodce, pokud byl Průvodce vyvolán příkazem v menu hlavního okna Změnit | Parametry připojení.... Pokud byl Průvodce vyvolán za účelem vytvoření nového konektoru, pak úvodním krokem Průvodce jsou obecné informace o činnosti Průvodce.

Následujícím krokem je vývojářský účet.

V tomto kroku jsou zobrazeny aktuální informace o připojení editovaného WBC konektoru k WinBase602 SQL serveru. Tj. název SQL serveru, název aplikace a uživatelské jméno a heslo, kterým se bude WinBase602 Internet klient připojovat k SQL serveru.

Pokud je název SQL serveru, nebo název aplikace zobrazen ve formátu %název%, pak je příslušný údaj předáván do konektoru pomocí vstupní formulářové proměnné. Tato možnost je podrobněji vysvětlena v nápovědě ke kroku Průvodce ” Předávání serveru a aplikace”.


Průvodce připojením k SQL serveru - úvod

Toto je úvodní krok Průvodce, pokud byl Průvodce vyvolán za účelem vytvoření nového konektoru. Pokud byl Průvodce vyvolán příkazem v menu hlavního okna Změnit | Parametry připojení..., pak úvodním krokem Průvodce jsou aktuální parametry připojení.

Následujícím krokem je vývojářský účet.

Jsou zde uvedeny pouze pokyny pro práci s Průvodcem.


Průvodce připojením k SQL serveru - vývojářský účet

Předcházejícím krokem je krok aktuální parametry připojení, pokud byl Průvodce vyvolán příkazem v menu hlavního okna Změnit | Parametry připojení.... Pokud byl Průvodce vyvolán za účelem vytvoření nového konektoru, pak předcházejícím krokem Průvodce jsou obecné informace o činnosti Průvodce.

Následujícím krokem je účet pro použití v konektoru.

Nejdříve musíte vybrat název databáze, ke které se chcete přihlásit. Vyberte jej ze seznamu databází, které máte registrovány na Vašem počítači. Tento seznam je nadepsán Databáze WinBase602.

Poté bude kontaktována tato databáze a Průvodce zjistí seznam uživatelů této databáze a seznam aplikací v této databázi. Těmito údaji naplní příslušné rozvinovací seznamy (tj. Vaše uživatelské jméno a Název aplikace).

Nyní vyberte z výše uvedeného seznamu uživatelské jméno, které používáte pro vývoj dané aplikace a zadejte heslo (do editačního řádku Vaše heslo). Jméno a heslo uživatelského účtu, který má používat WBC konektor při generování HTML stránky, zadáváte v následujícím kroku účet pro použití v konektoru.

Nakonec vyberte název aplikace, se kterou má pracovat Vámi editovaný WBC konektor.

Pokud bylo zadáno nesprávné heslo, bude zobrazeno okno, které Vás o tomto informuje. Po zavření tohoto informačního okna můžete zadat správné heslo.


Průvodce připojením k SQL serveru - účet pro použití v konektoru

Předcházejícím krokem Průvodce je krok vývojářský účet. Následujícím krokem je krok předávání serveru a aplikace.

V tomto kroku stanovujete, prostřednictvím kterého uživatelského účtu se bude WinBase602 Internet klient připojovat k SQL serveru.

Vyberte uživatelské jméno z rozvinovacího seznamu Uživatelské jméno a zadejte odpovídající heslo (v editačním řádku Heslo). Pokud zadáte chybné heslo, budete o tomto informováni dialogem a po jeho zavření můžete zadat heslo správné.

Pozn.: Pro přístup do databáze prostřednictvím WinBase602 Internet klienta se typicky používají uživatelské účty, jejichž název začíná znakem podtržítko (např. _webforum). Důvod je jednoduchý: WinBase602 od verze 5.0 používá při přihlašování klienta na server mechanismus one-time-password. Jedná se o bezpečnostně velmi silný způsob přihlašování, který při pokusu o neoprávněné proniknutí do databáze zcela znemožňuje použít odposlouchávání počítačové sítě, pomocí které komunikují klient a server. Je však třeba, aby si klient po řádově 10 000 přihlášeních změnil heslo. K tomuto je automaticky vyzván odpovídajícím dialogem při spuštění ať už vývojového prostředí WinBase602, nebo aplikace WinBase602. Internet klient nemůže takový dialog vyplnit (musel by si např. ”vymyslet” nové heslo). Z tohoto důvodu se pro uživatelské účty, jejichž název začíná podtržítkem, používá starší způsob přihlašování na SQL server, použitý ve WinBase 4.x. Pokud se tedy WinBase602 Internet klient přihlašuje pomocí uživatelského jména, které začíná podtržítkem, pak odpadá nutnost jednou za čas zadat nové, odlišné heslo. Všichni uživatelé, jejichž jméno nezačíná podtržítkem, používají výše zmíněný mechanismus one-time-password.


Průvodce připojením k SQL serveru - předávání serveru a aplikace

Předcházejícím krokem Průvodce je krok účet pro použití v konektoru. V případě, že byl Průvodce vyvolán příkazem v menu hlavního okna Změnit | Parametry připojení..., pak následujícím krokem je krok smazání obsahu konektoru. Pokud byl Průvodce vyvolán při vytváření nového WBC konektoru, pak je tento krok poslední.

V případě, že chceme název databáze a aplikace uvést přímo v konektoru, odškrtneme oba zaškrtávací čtverečky zapsat název databáze a zapsat název aplikace.

Pokud chceme předávat název serveru, či aplikace, prostřednictvím vstupní formulářové proměnné, zaškrtneme příslušný zaškrtávací čtvereček a název proměnné zadáme do odpovídajícího editačního řádku.

Zaškrtnutím čtverečku vyžadovat předání těchto proměnných do konektoru zajistíme, že provádění tohoto konektoru skončí chybou, pokud některá ze zadaných proměnných nebude konektoru předána.

Pokračování:

Princip vytváření dynamických HTML stránek

Co je to WBC konektor

Popis předávání názvů SQL serveru a aplikace prostřednictvím proměnných


Průvodce připojením k SQL serveru - smazání obsahu konektoru

Tento krok Průvodce se zobrazuje pouze, pokud byl Průvodce vyvolán příkazem v menu hlavního okna Změnit | Parametry připojení.... Předcházejícím krokem je předávání serveru a aplikace. Tento krok je posledním krokem Průvodce.

Pokud změníte připojení WBC konektoru k SQL serveru, pak typicky aplikace, ke které se konektor nyní připojuje, obsahuje rozdílné tabulky a vnitřní programy, než aplikace, ke které se konektor připojoval dříve. Je tedy na Vašem zvážení, zda by po změně připojení nebylo lepší smazat všechny komponenty tohoto konektoru a začít vytvářet konektor znovu (kvůli tomu, že nová aplikace většinou neobsahuje tytéž tabulky a vnitřní programy).

Rozhodněte se, zda smazat všechny komponenty konektoru, vyberte odpovídající možnost a stiskněte tlačítko Dokončit. Tím je završeno připojování WBC konektoru k SQL serveru.


Popis předávání názvů SQL serveru a aplikace prostřednictvím proměnných

Tento způsob předávání názvů SQL serveru a aplikace lze s výhodou využít v případě, kdy plánujete instalaci dané aplikace na různé počítače. Pokud vytváříte aplikaci pro použití na pouze jednom počítači a ani neplánujete přesun této aplikace na jiný počítač, pak se tímto způsobem tvorby WBC konektorů nezabývejte a do všech konektorů zadávejte názvy SQL serveru a aplikace přímo.

Přednosti tohoto řešení

Výhodou tohoto způsobu předávání je to, že při instalaci aplikace (a všech konektorů a šablon) na jiný počítač je nutno změnit pouze úvodní vstupní stránku (případně stránky), aby konektory fungovaly s SQL serverem a aplikací, které jsou pojmenovány odlišně od SQL serveru a aplikace na počítači, na kterém probíhal vývoj.

Popis problému

Programátor obecně nemůže předpokládat, že každý jeho zákazník bude mít svůj SQL server pojmenován stejně jako on na svém počítači. Pokud si uvědomíme, že ve WBC konektoru je třeba uvést název SQL serveru a aplikace, uvidíme podstatu problému.

WBC konektor musí ”znát” název SQL serveru a aplikace, se kterou má pracovat. Zcela zřejmě tyto údaje musí odpovídat pojmenování SQL serveru a aplikace na počítači, na který byla aplikace WinBase602 nainstalována. Při instalaci aplikace (a WBC konektorů a HTW šablon) na jiném počítači je tedy třeba změnit ve všech konektorech a šablonách původní název SQL serveru na název SQL serveru, do kterého byla aplikace WinBase602 naimportována. Totéž je třeba provést s názvem aplikace (uvědomme si, že aplikaci lze importovat pod jiným jménem, než pod kterým byla vyexportována).

Možným řešením je použít hromadnou úpravu WBC konektorů, což je funkce poskytovaná v rámci Administrátora CGI klienta (blíže viz nápověda k Administrátoru CGI klienta).

Princip řešení

Princip si vysvětlíme na příkladu: Mějme aplikaci, jejíž internetové rozhraní je realizováno pomocí jedné statické HTML stránky (VSTUP.HTM) a čtyř dynamických stránek, jejichž konektory jsou PRVNÍ.WBC, DRUHY.WBC, TRETI.WBC a KONEC.WBC. Nechť vzájemné volání těchto stránek je takové, jak je zachyceno na obrázku. Tj. např. stránka VSTUP.HTM je vstupní stránkou do internetového rozhraní aplikace atd.

Místo, aby měl každý konektor v sobě uveden název SQL serveru a aplikace, má jako název SQL serveru uvedenu hodnotu proměnné wbs (tj. vstupní formulářová proměnná wbs je v tomto internetovém rozhraní používána pro předávání skutečného názvu SQL serveru) a jako název aplikace WinBase602 hodnotu proměnné wba.

Ve statické stránce VSTUP.HTM jsou pevně nastaveny hodnoty proměnných wbs a wba. První dynamicky generovaná stránka, PRVNI.WBC, se ”dozví” skutečné názvy databáze a aplikace prostřednictvím hodnot proměnných wbs a wba, které převezme od statické stránky VSTUP.HTM. Ostatním dynamicky generovaným stránkám jsou skutečné názvy databáze a aplikace předávány vždy v okamžiku jejich vytváření.

Výhodou tohoto způsobu je to, že při přejmenování např. databáze stačí změnit hodnotu proměnné wbs ve statické stránce VSTUP.HTM tak, aby obsahovala nový název databáze, a není potřeba přepisovat všechny konektory a šablony dynamických stránek.

Názvy proměnných wbs a wba jsou volitelné, ale musí být shodné ve všech konektorech, které patří do internetového rozhraní dané aplikace. V HTW šablonách musíme zajistit, aby byly tyto proměnné předávány při každém volání WBC konektoru (resp. HTW šablony).

Tento způsob předávání názvů databáze a aplikace je použit např. v aplikaci 602WebForum, nebo v aplikaci 602WebCatalog. Jejich demonstrační verze můžete získat na Internetu na adrese http://www.software602.cz. Obsahují také zdrojové texty WBC konektorů a HTW šablon, které jsou nejlepším příkladem využití tohoto způsobu předávání názvů.


Jak změnit připojení WBC konektoru k SQL serveru

Pokud chcete připojit existující WBC konektor na jiný zdroj dat (tj. jiný SQL server a jiná aplikace WinBase602), pak v hlavním okně Návrháře zvolte příkaz Změnit | Připojení k SQL serveru.... Tím spustíte Průvodce připojením k SQL serveru, který Vám při změně připojení pomůže.

Pokračování:

Průvodce připojením k SQL serveru


Dialog Vzorové hodnoty vstupních proměnných

V seznamu vstupních proměnných jsou uvedeny ty vstupní formulářové proměnné, jejichž citace jsou obsaženy v SQL příkazu, který je právě analyzován (např. jsou zjišťovány atributy (sloupce) SQL příkazu SELECT, nebo je zjišťován typ určitého atributu). Pokud byl dialog vyvolán příkazem Změnit|Vzorové hodnoty proměnných... z menu, pak seznam obsahuje všechny proměnné, kterým byly dosud nastaveny vzorové hodnoty.

Vyberte vstupní proměnnou v seznamu, stiskněte klávesu F2, nebo myší poklepejte (doubleclick) na názvu proměnné. V editačním řádku změňte vzorovou hodnotu.

Stiskem OK dialog ukončete.

Tento dialog je zobrazen v okamžiku, kdy Návrhář provádí analýzu SQL příkazu, který obsahuje citace vstupních formulářových proměnných. Druhou možností, jak vyvolat tento dialog, je použít příkaz Změnit|Vzorové hodnoty proměnných... z menu hlavního okna Návrháře.

Pokračování:

K čemu se používají vzorové hodnoty vstupních proměnných


Co jsou vzorové hodnoty vstupních proměnných

Tyto hodnoty používá Návrhář v okamžiku, kdy musí analyzovat SQL příkaz, který obsahuje citace vstupních formulářových proměnných. Při analýze se zjišťuje, které atributy (sloupce) obsahuje odpověď na SQL příkaz, typy těchto atributů atd.

Takový příkaz (např. SELECT * FROM tabulka WHERE příjmení.=”%začátek%”) nelze analyzovat v této podobě, je třeba nahradit citace vstupních formulářových proměnných (v tomto případě se jedná o proměnnou začátek) jejich hodnotami. Při běhu konektorů a šablon tímto způsobem pracuje WinBase602 Internet klient, přičemž hodnoty proměnných přebírá z webového browseru, kam je zadává internetový uživatel.

Vzorové hodnoty vstupních formulářových proměnných jsou právě ty hodnoty, které používá Návrhář při analýze SQL příkazů.

Vlastnosti vzorových hodnot

Vzorové hodnoty se zaznamenávají do zdrojového tvaru konektoru, a to ve formě komentáře:

;var jméno_proměnné=vzorová_hodnota_proměnné

Návrhář uchovává jednou zadanou vzorovou hodnotu i pro pozdější použití. Jednou zadanou vzorovou hodnotu lze změnit příkazem Změnit|Vzorové hodnoty proměnných... z menu hlavního okna Návrháře.

Pokračování:

Dialog Vzorové hodnoty vstupních proměnných


Slovníček pojmů

CGI
protokol, kterým komunikují webserver a skript

FastCGI
protokol, kterým komunikují webserver a skript

HTML
jazyk, který popisuje formátování textu; v tomto jazyku jsou psány internetové stránky

HTW šablona
soubor, ve kterém je popsáno formátování databázových údajů do HTML textu; blíže viz Co je HTW šablona

ISAPI
protokol, kterým komunikují webserver a skript

komponenta
jedna část WBC konektoru; blíže viz Co jsou komponenty

skript
v souvislosti s webservery se tímto označením myslí programy, které rozšiřují schopnosti webserveru (např. o schopnost generovat dynamické HTML stránky, které obsahují údaje z databáze - tak je tomu v případě WinBase602 Internet klientů)

SQL
jazyk, který je používán pro manipulaci s databází; jeho nejznámější část je určena k formulování dotazů na údaje v databázi

vzorové hodnoty vstupních proměnných
tyto hodnoty používá Návrhář při analýze SQL příkazu, který obsahuje citaci vstupních proměnných; blíže viz Co jsou vzorové hodnoty vstupních proměnných

WBC konektor
soubor, nebo blok v HTW šabloně, ve kterém jsou popsány operace s databází; blíže viz Co je WBC konektor

webserver
program, který odesílá www browserům HTML stránky

www browser
program, který zobrazuje na obrazovce HTML stránky