Předkonfigurace "Asynchronní přístup k databázi"

připojení k databázi objektem PmaAdo a práce s tabulkou.

Tato předkonfigurace se vyvolá při zakládání nového objektu (např. volbou "Nový objekt ..." v kontextovém menu objektu nebo stisknutím klávesy Insert po označení objektu).

Tato předkonfigurace je zařazena ve skupině "/ Databáze / Přístup k databázím".

Tuto předkonfiguraci lze vytvořit v objektu PmaFolder, PmaRoot nebo PmaPrototype.

Tato předkonfigurace v základním nastavení vytvoří objekt PmaFolder s podobjekty PmaSequencer a PmaAdo s přednastavenym připojením ke zvolené databázi. (Ten bude nutný v některých případech upravit tak, aby vyhovoval požadavkům pro připojení k databázi na cílovém počítači.) Další volby vytvoří v objektu PmaSequencer metody pro rozhraní DtiOper a také obrazy pro testování nebo zobrazení tabulky.

Předkonfigurace Obraz je předkonfigurován tak, aby po připojení bylo možné okamžitě vytvořit testovací tabulku (datatest) s primárním klíčem ve sloupci cindex. SQL příkaz pro vytvoření tabulky je obsažen v objektu PmgString pole DbExecute a je aktivován tlačítkem "Run the SQL statement". Tlačítkem INSERT INTO lze přidat nový záznam do databázové tabulky. Hodnoty nového záznamu jsou náhodně generovány (v poli Values) tlačítkem se symbolem "šipky v kruhu". Tlačítka UPDATE a DELETE provedou změnu hodnot záznamu nebo jeho smazání. Tlačítko se symbolem "šipky v kruhu" v tom případě zobrazí hodnotu, která je na označeném řádku tabulky ve sloupci cindex. Ve spodní části obrazu je informační systém, který oznamuje výsledek prováděných operací.

Na začátku skriptu metody CallMethod objektu PmaFolder jsou zakomentované příklady volání metody projektanta Example1.

Konfigurátory které lze nastavit před vytvořením předkonfigurace:

Název vytvářeného objektu	Název nově vytvořeného objektu ve stromu Pma objektů. Maximální délka názvu je 30 znaků. Je to systémový název, může obsahovat pouze alfanumerické znaky a nesmí obsahovat diakritiku (tzn. národnostně závislé znaky), prázdný řetězec, mezery a první znak nesmí být číslo. Přednastaveno: "DbAsyncAdo"

Typ připojované databáze	dBase Microsoft Access Microsoft SQL Server Oracle MySQL Firebird PostgreSQL
Parametry připojení k databázi	Parametry připojení k databázi metodou DbOpen v podobě textového řetězce ADO ConnectionString. Řetězec ADO ConnectionString (http://www.connectionstrings.com) obsahuje všechny nutné parametry, aby se objekt ADO Connection mohl připojit k databázi pomocí vybraného poskytovatele připojení ADO Provider. Typické parametry jsou například poskytovatel připojení (provider), adresa serveru (server), název databáze (database), přihlašovací jméno a heslo (uid, pwd), atd. Seznam parametrů a jejich tvar je určen konkrétním ADO Provider, parametry se u jednotlivých ADO Provider liší. Nicméně z důvodu kompatability většina poskytovatelů připojení ADO Provider rozumí hlavním parametrům pod více názvy současně (např. název databáze jako database, data source, dbq, atd.). Upozornění: Tvar tohoto řetězce je odlišný od většiny podobných řetězců v systému PROMOTIC, hodnota je od jména oddělena znakem "rovnítko" (=) a nikoliv "dvojtečka" (:). Údaje s přiřazenou hodnotou jsou zde odděleny středníkem, například "provider=SQLOLEDB;server=.\SQLEXPRESS;database=pm_data;uid=pm_admin;pwd=pmadmin;". Tento konfigurátor nastaví počáteční hodnotu vlastnosti DbConnectionString. Pro zadání lze použít Makro výraz (vyhodnocuje se po spuštění aplikace). Hodnoty zde lze editovat ručně, nebo je lze vytvořit tlačítkem vpravo, které otevře okno pro Parametry připojení k databázi (connection string). Uvedené parametry nemusí platit vždy (platí pro nejběžněji používané případy), záleží na vybraném poskytovateli připojení ADO Provider. Po vytvoření předkonfigurace bude na tuto hodnotu nastaven konfigurátor "PmaAdo > ADO > Parametry připojení k databázi".

Vytvořit metody pro grafické zobrazení tabulky	Vytvoří základní metody rozhraní DtiOper pro grafické zobrazení tabulky
Vytvořit obrazy pro testování zobrazení tabulky	Vytvoří obraz "TestDbTable" pro testování a obraz "ViewerDataTable" pro zobrazení tabulky
Povolit jako Web komponentu	Určuje, zda tento objekt se má zaregistrovat jako komponenta Web serveru Po vytvoření předkonfigurace bude na tuto hodnotu nastaven konfigurátor "PmaPanel > Web server > Povolit jako Web komponentu".
PmaWeb objekt	Cesta ve stromu Pma objektů k objektu PmaWeb, PmaWebFolder nebo PmaWebLang, do kterého se provede zaregistrování. Pro zadání lze použít Makro výraz (vyhodnocuje se po spuštění aplikace). Po vytvoření předkonfigurace bude na tuto hodnotu nastaven konfigurátor "PmaPanel > Web server > PmaWeb objekt".