
Již několik generací umožňuje FileMaker přímý přístup k externím SQL-zdroje dat, jako je MySQLDatabáze internetového obchodu založeného na xt:Commerce a číst a zapisovat do něj data. V tomto článku popisuji, jak můžete pomocí FileMakeru Pro pod Mac OS X nebo Windows přímo přistupovat k databázi MySQL z xt:Commerce, jak můžete importovat data z xt:Commerce do FileMakeru a jak můžete přenášet stavové zprávy z FileMakeru do xt:Commerce.
Co je potřeba pro přístup k databázi SQL?
K externímu zdroji dat SQL se přistupuje prostřednictvím příkazu ODBC-Rozhraní. K nastavení datového zdroje ODBC je zapotřebí správce ODBC pro Mac OS X. Ten lze stáhnout ze stránek www.odbcmanager.net lze stáhnout zdarma jako freeware. Správce ODBC z Mac OS X lze použít i na Macu a správce ODBC Manager, který je součástí systému, lze použít i pod Windows.
Kromě toho potřebujete konektor ODBC pro Mac OS X pro přístup k databázi MySQL systému xt:Commerce. Webové stránky MySQL lze stáhnout. Pro stabilní datové připojení k databázi xt:Commerce potřebujete konektor ODBC ve starší verzi 3.51.27. Verze DMG pro Mac OS X 10.5 (x86, 32bitová) funguje bez problémů i pod Mac OS X 10.6 Snow Leopard.
Instalace konektoru ODBC pro MySQL
Před nastavením zdroje dat ve Správci ODBC je třeba nejprve nainstalovat konektor ODBC pro MySQL. Po stažení programu se automaticky spustí průvodce instalací Konektoru ODBC pro MySQL:
Po pokračování a přijetí licenčních podmínek můžete vybrat cílový svazek pro instalaci a nainstalovat konektor ODBC do systému.
Během instalace se do systému automaticky nainstaluje konektor ODBC, takže při příštím spuštění Správce ODBC bude k dispozici ovladač pro tento konektor.
Nastavení zdroje dat ODBC
Po stažení nástroje SQL-Connector,
V následujícím textu popíšu, jak nastavit konektor ODBC pomocí programu ODBC Manager pro Mac OS X - dále v textu je odkaz na stažení tohoto programu. V systému Windows nebo pod Mac OS X s jinými správci ODBC je třeba provést nastavení stejným způsobem.
Po stažení programu ODBC Manager a jeho zkopírování do adresáře aplikace Mac OS X spusťte program ODBC Manager poklepáním na ikonu programu. Program se poté spustí a otevře hlavní okno programu ODBC Manager. Zdroje dat ODBC lze vždy nastavit pro celý systém (systémová DSN), tj. pro všechny uživatele v systému, nebo pro jednoho uživatele (uživatelská DSN). V oblasti [Tracing] (Sledování) lze používání datového zdroje ODBC zaznamenávat do textového protokolu.
Podle toho, zda chcete nastavit zdroj dat pro aktivního uživatele nebo pro celý systém, klikněte v příslušné oblasti na tlačítko [Přidat...].
Pro xt:Commerce vyberte v tomto bodě verzi 3.51 ovladače ODBC MySQL a klikněte na tlačítko [OK]. V následujícím okně zadejte všechna data z vaší databáze MySQL, která obsahuje datové tabulky pro váš internetový obchod xt:Commerce.
Po zadání všech údajů do příslušných polí klikněte na tlačítko [Test], abyste navázali spojení prostřednictvím nově vytvořeného zdroje dat a otestovali jej.

Použití zdroje dat ODBC s aplikací FileMaker
Spusťte FileMaker a otevřete databázi, se kterou chcete navázat spojení s databází xt:Commerce. Pokud již máte řešení FileMakeru pro objednávky v obchodě, je nejlepší otevřít verzi, kterou chcete dále rozvíjet.
Čtení dat z databáze xt:Commerce
K importu dat z xt:Commerce do FileMakeru přes rozhraní ODBC stačí známý příkaz "Importovat záznamy" v aplikaci Scriptmaker. Pro data z xt:Commerce doporučuji vytvořit obraz originálu. Tabulka z xt:Commerce ve vašem řešení. To usnadní import díky stejným názvům polí a vaše řešení má vlastní tabulku se všemi objednávkami z xt:Commerce.
Vytvoření obrazu tabulky z xt:Commerce
Chcete-li vytvořit obraz tabulky z xt:Commerce v aplikaci FileMaker, je nejlepší importovat tabulku s názvy polí do řešení FileMaker. V panelu nabídek souboru FileMaker, do kterého chcete tabulku importovat, vyberte položku
Soubor > Import datových záznamů > Zdroj dat ODBC
z. Nyní vyberte zdroj dat ODBC vašeho SQL serveru nastavený ve Správci ODBC s databázemi z xt:Commerce a v následujícím dialogu zadejte uživatelské jméno a heslo pro databázi MySQL. Nyní se zobrazí dialog Zadat ODBC SQL dotaz, do kterého můžete zadat SQL příkaz buď z výpočtu, nebo jako statický text.
Chcete-li do aplikace FileMaker importovat celou tabulku, stačí kliknout na tlačítko [Vytvoření dotazu...], čímž se otevře průvodce pro vytvoření dotazu SQL.
V levém sloupci najdete všechny tabulky, které se nacházejí na vzdáleném serveru SQL.Server se nacházejí. Chcete-li například importovat tabulku "orders" z xt:Commerce, vyberte v levém sloupci příslušnou tabulku "orders". Dostupná pole tabulky vybrané vlevo se nyní zobrazí v pravém sloupci. Chcete-li dotaz vytvořit automaticky, stačí dvakrát kliknout na každé pole, které má být importováno, v pravém sloupci. Ve spodním okně vidíte, jak se dotaz automaticky vytváří pole po poli. Na konci by okno mělo vypadat takto:
Nyní vyberte celý text (cmd-A) v poli "SQL dotaz", vložte jej do dokumentu v textovém editoru (např. Textedit) a uložte text, např. jako "SQL_xtC_orders.txt".
Po kliknutí na tlačítko [OK] se zobrazí dialog pro přiřazení polí. V tomto dialogu vyberte v části "Cíl" možnost [Nová tabulka: "Název zdroje dat"]. Po kliknutí na tlačítko [Importovat] se v nové tabulce vytvoří všechna pole vybraná v dotazu a importují se související data. Po importu najdete tabulku ve správě databáze a můžete ji libovolně přejmenovat, např. na "xtC_orders".
Vytvoření skriptu pro import dat z xt:Commerce
Chcete-li do svého řešení integrovat import dat, otevřete aplikaci Scriptmaker a vytvořte novou aplikaci. Skript. Do nového skriptu přidejte příkaz "Importovat datové záznamy". Nyní jako zdroj dat vyberte "Zdroj dat ODBC" a vyberte zdroj dat ODBC vytvořený ve Správci ODBC. Nyní zadejte přihlašovací údaje k databázi SQL a zaškrtněte políčko "Uložit uživatelské jméno a heslo". Po kliknutí na tlačítko [OK] můžete nyní SQL dotaz vložit opět jako vypočtený vzorec nebo jako text. Pokud budete chtít v budoucnu pomocí skriptu importovat pouze konkrétní zakázku, musíte vytvořit vypočtený SQL dotaz. V našem příkladu předpokládáme, že číslo zakázky, které má být importováno v. Variabilní $orders_id je uloženo.
Nyní otevřete uložený textový dokument s dotazem SQL. Na začátek dotazu přidejte uvozovky (") a na jeho konec následující příkaz:
WHERE `orders`.`orders_id` = " & $orders_id
Tento příkaz omezí import na datovou větu, jejíž pole obsahuje hodnotu proměnné $orders_id. Celý váš příkaz SQL by nyní měl vypadat následovně:
"SELECT `orders`.`account_type`, `orders`.`afterbuy_id`, `orders`.`afterbuy_success`, `orders`.`billing_address_format_id`, `orders`.`billing_city`, `orders`.`billing_company`, `orders`.`billing_country`, `orders`.`billing_country_iso_code_2`, `orders`.`billing_firstname`, `orders`.`billing_lastname`, `orders`.`billing_name`, `orders`.`billing_postcode`, `orders`.`billing_state`, `orders`.`billing_street_address`, `orders`.`billing_suburb`, `orders`.`cc_cvv`, `orders`.`cc_expires`, `orders`.`cc_issue`, `orders`.`cc_number`, `orders`.`cc_owner`, `orders`.`cc_start`, `orders`.`cc_type`, `orders`.`comments`, `orders`.`conversion_type`, `orders`.`currency`, `orders`.`currency_value`, `orders`.`customers_address_format_id`, `orders`.`customers_cid`, `orders`.`customers_city`, `orders`.`customers_company`, `orders`.`customers_country`, `orders`.`customers_email_address`, `orders`.`customers_firstname`, `orders`.`customers_id`, `orders`.`customers_ip`, `orders`.`customers_lastname`, `orders`.`customers_name`, `orders`.`customers_postcode`, `orders`.`customers_state`, `orders`.`customers_status`, `orders`.`customers_status_discount`, `orders`.`customers_status_image`, `orders`.`customers_status_name`, `orders`.`customers_street_address`, `orders`.`customers_suburb`, `orders`.`customers_telephone`, `orders`.`customers_vat_id`, `orders`.`date_purchased`, `orders`.`delivery_address_format_id`, `orders`.`delivery_city`, `orders`.`delivery_company`, `orders`.`delivery_country`, `orders`.`delivery_country_iso_code_2`, `orders`.`delivery_firstname`, `orders`.`delivery_lastname`, `orders`.`delivery_name`, `orders`.`delivery_postcode`, `orders`.`delivery_state`, `orders`.`delivery_street_address`, `orders`.`delivery_suburb`, `orders`.`hanseaticbank_reference`, `orders`.`language`, `orders`.`last_modified`, `orders`.`orders_date_finished`, `orders`.`orders_id`, `orders`.`orders_ident_key`, `orders`.`orders_status`, `orders`.`payment_class`, `orders`.`payment_method`, `orders`.`refferers_id`, `orders`.`shipping_class`, `orders`.`shipping_method` FROM `orders` WHERE `orders`.`orders_id` = " & $orders_id
Nyní můžete například nechat skript vyžádat od uživatele požadované číslo objednávky a automaticky importovat příslušnou objednávku do řešení FileMaker pomocí skriptu.
Zápis dat do datové tabulky SQL
FileMaker lze také použít k zápisu nebo aktualizaci dat přímo do tabulky z xt:Commerce prostřednictvím ODBC. Pro tento účel je ve Scriptmakeru k dispozici následující příkaz:
Vykonat dotaz SQL [...]
V následujícím příkladu vytvoříme nový datový záznam v tabulce xt:Commerce orders_status_history. Do této tabulky se ukládají stavové zprávy z xt:Commerce, které si zákazník může obvykle prohlédnout také v přihlašovací oblasti obchodu. Nový datový záznam v této tabulce vytvoříme následujícím příkazem:
Vykonat dotaz SQL [
"INSERT INTO `orders_status_history` (`comments`, `customer_notified`, `date_added`, `orders_id`, `orders_status_history_id`, `orders_status_id`)
VALUES ("" &
"Status text'" & ", 0, '" & xtc_date(Get(SystemDate)) &
"', " & xtcommerce::_Order_No & ", " & "'''" & ", " & "2)"]
Tento příkaz lze použít buď přímo ve skriptu, nebo pomocí nové vlastní funkce (Vlastní funkce) lze zapouzdřit. xtc_date je Vlastní funkcekterou můžete definovat jako samostatnou funkci nebo vyřešit přímo v příkazu skriptu. Samostatná funkce xtc_date převede přenesené datum do formátu, ve kterém xt:Commerce očekává datum:
xtc_date (pole data) =
ReadAsText(YearNumber ( pole data ) & "-" &
CharacterRight( "0" & MonthNumber (pole data); 2) & "-" &
CharacterRight("0" & CalendarDayNumber (pole data); 2)) & " " &
ReadAsText(Get(SystemTime))
Pro změnu samotného stavu se v tabulce MySQL <> nastaví odpovídající ID stavu. V následujícím příkladu je ID stavu objednávky nastaveno na ID "2":
Proveďte dotaz SQL ["UPDATE `orders` SET `orders_status` = 2 WHERE `orders_id` = " & xtcommerce::_Order_No]
ID stavů, které jste v xt:Commerce přiřadili, můžete zobrazit a upravit v backendu xt:Commerce.
Možnosti integrace dat z xt:commerce ve spojení s FileMakerem jsou prakticky neomezené. Stejně jako údaje o objednávkách lze samozřejmě i údaje o zboží nebo adresách z xt:commerce použít ve FileMakeru a naopak.
Postup popsaný v tomto článku samozřejmě funguje s jakoukoli tabulkou z xt:Commerce a v zásadě s jakýmkoli jiným internetovým obchodem, jehož databáze umožňuje přístup přes konektor ODBC. Pro podrobné informace o struktuře databáze systému vašeho obchodu doporučuji prostudovat příslušnou technickou dokumentaci.

Markus Schall vyvíjí od roku 1994 databáze, rozhraní a podnikové aplikace na míru založené na Claris FileMaker. Je partnerem společnosti Claris, držitelem ocenění FMM Award 2011 a vývojářem aplikace Software ERP gFM-Business. Je také autorem knih a zakladatelem organizace M. Schall Publishers.








