Koppelingen overslaan

FileMaker en MySQL aan de hand van het voorbeeld van xt:Commerce.

FileMaker training, cursussen, coaching

FileMaker en MySQL aan de hand van het voorbeeld van xt:CommerceDoor de vele automatiseringsmogelijkheden en het grote volume aan gegevens is FileMaker een ideale oplossing voor het optimaliseren van bedrijfsprocessen, vooral voor exploitanten van online winkels. FileMaker-oplossingen kunnen snel en eenvoudig worden aangepast aan uw eigen vereisten.

Al verschillende generaties lang heeft FileMaker rechtstreeks toegang tot externe SQL-gegevensbronnen zoals een MySQLDatabase van een xt:Commerce-gebaseerde online winkel en om daar gegevens te lezen en te schrijven. In dit artikel beschrijf ik hoe u FileMaker Pro onder Mac OS X of Windows kunt gebruiken om rechtstreeks toegang te krijgen tot een MySQL database vanuit xt:Commerce, hoe u gegevens vanuit xt:Commerce kunt importeren in FileMaker en hoe u statusberichten kunt overbrengen van FileMaker naar xt:Commerce.

Wat is er nodig om toegang te krijgen tot de SQL-database?

Een externe SQL-gegevensbron wordt benaderd via de ODBC-Interface. Om een ODBC-gegevensbron in te stellen, is een ODBC-manager voor Mac OS X nodig. Deze kan worden gedownload van www.odbcmanager.net kan gratis worden gedownload als freeware. De ODBC Administrator van Mac OS X kan ook op de Mac worden gebruikt en de ODBC Manager die in het systeem is opgenomen kan onder Windows worden gebruikt.

Daarnaast heb je een ODBC-connector voor Mac OS X nodig om toegang te krijgen tot de MySQL database van xt:Commerce. Website van MySQL kan worden gedownload. Voor een stabiele gegevensverbinding met de xt:Commerce-database heb je de ODBC-connector nodig in de oudere versie 3.51.27. De DMG-versie voor Mac OS X 10.5 (x86, 32-bits) werkt ook probleemloos onder Mac OS X 10.6 Snow Leopard.

De MySQL ODBC-connector installeren

Voordat de gegevensbron kan worden ingesteld in de ODBC Manager, moet eerst de ODBC Connector voor MySQL worden geïnstalleerd. Zodra het programma is gedownload, start de MySQL ODBC Connector installatiewizard automatisch:

Installatie van de ODBC-connector voor Mac OS X.

Nadat je verder bent gegaan en de licentievoorwaarden hebt geaccepteerd, kun je het doelvolume voor de installatie selecteren en de ODBC-connector op je systeem installeren.

Installatie ODBC Connector: selectie van het doelvolume

Tijdens het installatieproces wordt de ODBC-connector automatisch op je systeem geïnstalleerd, zodat het stuurprogramma voor deze connector beschikbaar is wanneer je ODBC Manager de volgende keer start.

De ODBC-gegevensbron instellen

Nadat de SQL-connector is gedownload,

Programmapictogram van de ODBC-managerHieronder beschrijf ik hoe je de ODBC Connector instelt met de ODBC Manager voor Mac OS X - verderop in de tekst staat een link om dit programma te downloaden. In Windows of onder Mac OS X met andere ODBC-managers moeten de instellingen op dezelfde manier gemaakt worden.

Zodra ODBC Manager is gedownload en gekopieerd naar de Mac OS X-programmamap, start je ODBC Manager door te dubbelklikken op het programmapictogram. Het programma start dan en opent het hoofdvenster van ODBC Manager. ODBC-gegevensbronnen kunnen altijd systeembreed worden ingesteld (systeem-DSN), d.w.z. voor alle gebruikers op het systeem of voor één gebruiker (gebruikers-DSN). In het gedeelte [Traceren] kan het gebruik van de ODBC-gegevensbron worden vastgelegd in een tekstlogboek.

Hoofdvenster ODBC-manager

Afhankelijk van of u de gegevensbron voor de actieve gebruiker of systeembreed wilt instellen, klikt u op de knop [Toevoegen...] in het overeenkomstige gebied.

ODBC Manager: Een gegevensbron toevoegen

Voor xt:Commerce selecteert u op dit punt versie 3.51 van het MySQL ODBC-stuurprogramma en klikt u op de knop [OK]. Voer in het volgende venster alle gegevens in van uw MySQL database die de gegevenstabellen voor uw xt:Commerce online shop bevat.

Configuratie van de ODBC-gegevensbron

Zodra u alle gegevens in de overeenkomstige velden hebt ingevoerd, klikt u op de knop [Test] om een verbinding tot stand te brengen via uw nieuw aangemaakte gegevensbron en deze te testen.

ODBC-gegevensbron met succes getest.Als de ODBC-gegevensbrontest met succes is doorstaan, verschijnt er een bijbehorend waarschuwingsvenster en kan de gegevensbron worden ingesteld door op de knop [OK] te klikken. Deze is nu beschikbaar voor de actieve gebruiker of systeembreed als ODBC-bron voor alle programma's die ODBC-verbindingen ondersteunen, dus ook in FileMaker, wat we hierna gaan uitproberen. Zodra de nieuwe ODBC-gegevensbron is ingesteld, kan de ODBC Manager worden gesloten.

De ODBC-gegevensbron gebruiken met FileMaker

Start FileMaker en open een database waarmee u een verbinding wilt maken met uw xt:Commerce database. Als u al een FileMaker-oplossing hebt voor uw winkelbestellingen, kunt u het beste de versie openen die u verder wilt ontwikkelen.

Gegevens lezen uit de xt:Commerce-database

Om gegevens van xt:Commerce via de ODBC-interface in FileMaker te importeren, hebt u alleen de bekende opdracht "Records importeren" in Scriptmaker nodig. Voor de gegevens van xt:Commerce raad ik u aan een image te maken van de oorspronkelijke Tabel van xt:Commerce in je oplossing. Dit maakt het importeren eenvoudiger vanwege dezelfde veldnamen, en je oplossing heeft een eigen tabel met alle bestellingen uit xt:Commerce.

Een afbeelding van een tabel maken vanuit xt:Commerce

Om een afbeelding te maken van een tabel uit xt:Commerce in FileMaker, kunt u het beste de tabel met veldnamen importeren in uw FileMaker oplossing. Selecteer in de menubalk van het FileMaker-bestand waarin u de tabel wilt importeren het item

Bestand > Gegevensrecords importeren > ODBC-gegevensbron

vanaf. Selecteer nu de ODBC-gegevensbron van uw SQL-server die is ingesteld in de ODBC Manager met de databases van xt:Commerce en voer uw gebruikersnaam en wachtwoord voor de MySQL-database in het volgende dialoogvenster in. Het dialoogvenster ODBC SQL-query opgeven verschijnt nu, waarin u een SQL-opdracht kunt invoeren vanuit een berekening of als statische tekst.

FileMaker: ODBC SQL-query opgeven

Om een volledige tabel in FileMaker te importeren, klikt u gewoon op de knop [Query maken...], waarna een wizard voor het maken van de SQL-query wordt geopend.

Wizard voor het maken van een SQL-query

In de linkerkolom staan alle tabellen die zich op de externe SQL-server bevinden.Server staan. Om bijvoorbeeld de tabel "orders" uit xt:Commerce te importeren, selecteert u de overeenkomstige tabel "orders" in de linkerkolom. De beschikbare velden van de links geselecteerde tabel verschijnen nu in de rechterkolom. Om de query automatisch te maken, dubbelklik je gewoon op elk te importeren veld in de rechterkolom. In het onderste venster zie je hoe de query automatisch veld voor veld wordt aangemaakt. Aan het einde zou het venster er zo uit moeten zien:

SQL-query van de tabel 'orders' van xt:Commerce

Selecteer nu de hele tekst (cmd-A) in het veld "SQL query", plak het in een document in een teksteditor (bijv. Textedit) en sla de tekst op, bijv. als "SQL_xtC_orders.txt".

Nadat u op de knop [OK] hebt geklikt, verschijnt het dialoogvenster voor het toewijzen van de velden. Selecteer in deze dialoog [Nieuwe tabel: "Naam gegevensbron"] onder "Doel". Nadat u op de knop [Importeren] hebt geklikt, worden alle in de query geselecteerde velden in een nieuwe tabel aangemaakt en worden de bijbehorende gegevens geïmporteerd. Na het importeren vindt u de tabel terug in het databasebeheer en kunt u deze naar wens hernoemen, bijvoorbeeld naar "xtC_orders".

Maak een script voor het importeren van gegevens uit xt:Commerce

Om een gegevensimport in je oplossing te integreren, open je Scriptmaker en maak je een nieuw Script. Voeg de opdracht "Gegevensrecords importeren" toe aan je nieuwe script. Selecteer nu "ODBC-gegevensbron" als gegevensbron en selecteer de ODBC-gegevensbron die is gemaakt in de ODBC Manager. Voer nu je inloggegevens voor de SQL-database in en vink het vakje "Save user name and password" (Gebruikersnaam en wachtwoord opslaan) aan. Nadat u op de knop [OK] hebt geklikt, kunt u nu de SQL-query opnieuw invoegen als een berekende formule of als tekst. Als u in de toekomst alleen een specifieke order wilt importeren met uw script, moet u een berekende SQL-query maken. In ons voorbeeld gaan we ervan uit dat het ordernummer dat geïmporteerd moet worden in de Variabele $orders_id is opgeslagen.

Open nu je opgeslagen tekstdocument met de SQL-query. Voeg aan het begin aanhalingstekens (") toe en de volgende opdracht aan het einde van de query:

WHERE `orders`.`orders_id` = " & $orders_id

Deze opdracht beperkt het importeren tot de gegevensrecord waarvan het veld de waarde bevat van de variabele $orders_id. Uw volledige SQL-instructie zou er nu ongeveer zo uit moeten zien:

"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`.`klanten_stad`, `orders`.`klanten_bedrijf`, `orders`.`klanten_land`,
`orders`.`klanten_email_adres`, `orders`.`klanten_voornaam`, `orders`.`klanten_id`,
`orders`.`klanten_ip`, `orders`.`klanten_achternaam`, `orders`.`klanten_naam`,
`orders`.`klanten_postcode`, `orders`.`klanten_staat`, `orders`.`klanten_status`,
`orders`.`klanten_status_korting`, `orders`.`klanten_status_afbeelding`,
`orders`.`klanten_status_naam`, `orders`.`klanten_straat_adres`,
`orders`.`klanten_wijk`, `orders`.`klanten_telefoon`, `orders`.`klanten_vat_id`,
`orders`.`datum_gekocht`, `orders`.`levering_adres_opmaak_id`, `orders`.`levering_stad`,
`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`.`betaling_klasse`, `orders`.`betaling_methode`,
`orders`.`betalers_id`, `orders`.`verzendklasse`, `orders`.`verzendmethode`
FROM `orders` WHERE `orders`.`orders_id` = " & $orders_id

U kunt nu bijvoorbeeld uw script het gewenste ordernummer laten opvragen bij de gebruiker en de bijbehorende order automatisch importeren in uw FileMaker-oplossing met behulp van een script.

Gegevens naar een SQL-gegevenstabel schrijven

FileMaker kan ook worden gebruikt om gegevens rechtstreeks vanuit xt:Commerce via ODBC naar een tabel te schrijven of bij te werken. Hiervoor is de volgende opdracht beschikbaar in Scriptmaker:

SQL-query uitvoeren [...].

In het volgende voorbeeld maken we een nieuw gegevensrecord aan in de xt:Commerce tabel orders_status_history. De statusberichten van xt:Commerce worden opgeslagen in deze tabel, die de klant meestal ook kan bekijken in het inloggedeelte van de shop. Een nieuw gegevensrecord in deze tabel wordt gemaakt met het volgende commando:

SQL-query uitvoeren [
"INSERT INTO `orders_status_history` (`comments`, `customer_notified`, `date_added`,
`orders_id`, `orders_status_history_id`, `orders_status_id`)
VALUES ("" &
"Status tekst" & ", 0, '" & xtc_date(Get(SystemDate)) &
"', " & xtcommerce::_Order_No & ", " & "''" & ", " & "2)"]

Deze opdracht kan direct in een script worden gebruikt, of met een nieuwe aangepaste functie (Aangepaste functie) kan worden ingekapseld. De xtc_datum is een Eigen functiedie je als een aparte functie kunt definiëren of direct in het scriptcommando kunt oplossen. De aparte functie xtc_date converteert een verzonden datum naar het formaat waarin xt:Commerce een datum verwacht:

xtc_datum (datumveld) =
ReadAsText(YearNumber (datumveld) & "-" &
CharacterRight("0" & MonthNumber (datumveld); 2) & "-" &
CharacterRight( "0" & CalendarDayNumber (datumveld); 2)) & " " &
ReadAsText(Get(SystemTime))

Om de status zelf te wijzigen, wordt de corresponderende status ID ingesteld in de MySQL tabel <>. In het volgende voorbeeld wordt de status ID van de bestelling ingesteld op ID "2":

Voer een SQL-query uit ["UPDATE `orders` SET `orders_status` = 2
WHERE `orders_id` = " & xtcommerce::_Order_No]

U kunt de status-ID's van de statussen die u hebt toegewezen in xt:Commerce bekijken en bewerken in de backend van xt:Commerce.

De mogelijkheden om gegevens uit xt:commerce te integreren in FileMaker zijn vrijwel onbeperkt. Net als de bestelgegevens kunnen artikel- of adresgegevens uit xt:commerce natuurlijk ook in FileMaker worden gebruikt en omgekeerd.

Natuurlijk werkt de in dit artikel beschreven procedure met elke tabel van xt:Commerce en in principe met elke andere online winkel waarvan de database toegankelijk is via een ODBC-connector. Voor gedetailleerde informatie over de databasestructuur van je winkelsysteem raad ik je aan de relevante technische documentatie te bestuderen.

Laat een reactie achter

Deel deze pagina:

ERP-software zo flexibel als uw bedrijf.
We geven je graag advies.

Aanpasbare ERP-software voor Mac, Windows en iOS.

U bevindt zich hier: Een SQL-server verbinden met een FileMaker-database. Stap-voor-stap instructies voor een xt:commerce online shop | goFileMaker