
Depuis plusieurs générations déjà, FileMaker est en mesure d'accéder directement à des fichiers externes. SQL-de données comme une base de données MySQL.Base de données d'une boutique en ligne basée sur xt-Commerce et d'y lire et écrire des données. Dans cet article, je vais décrire comment accéder directement à une base de données MySQL de xt:Commerce avec FileMaker Pro sous Mac OS X ou Windows, comment importer des données de xt:Commerce dans FileMaker et comment transférer des messages de statut de FileMaker vers xt:Commerce.
De quoi a-t-on besoin pour accéder à la base de données SQL ?
L'accès à une source de données SQL externe se fait par le biais de la ODBC-Interface. Pour pouvoir configurer une source de données ODBC, un gestionnaire ODBC pour Mac OS X est nécessaire. Un tel gestionnaire peut être téléchargé sous www.odbcmanager.net peut être téléchargé gratuitement en tant que freeware. Sur Mac, il est également possible d'utiliser l'administrateur ODBC de Mac OS X, et sous Windows, le gestionnaire ODBC inclus dans le système.
De plus, pour accéder spécifiquement à la base de données MySQL de xt:Commerce, vous avez besoin d'un connecteur ODBC pour Mac OS X, qui est disponible sur le site de xt:Commerce. Site web de MySQL peut être téléchargé. Pour une connexion de données stable à la base de données de xt:Commerce, vous avez besoin du connecteur ODBC dans l'ancienne version 3.51.27. La version DMG pour Mac OS X 10.5 (x86, 32 bits) fonctionne également sans problème sous Mac OS X 10.6 Snow Leopard.
Installer le connecteur ODBC MySQL
Avant de pouvoir configurer la source de données dans le gestionnaire ODBC, il faut d'abord installer le connecteur ODBC pour MySQL. Une fois le programme téléchargé, l'assistant d'installation du MySQL ODBC-Connector démarre automatiquement :
Après avoir poursuivi et accepté les conditions de licence, vous pouvez sélectionner le volume cible pour l'installation et installer le connecteur ODBC sur votre système.
Pendant le processus d'installation, le connecteur ODBC est automatiquement installé dans votre système, de sorte que le pilote pour ce connecteur sera disponible au prochain démarrage du gestionnaire ODBC.
Configuration de la source de données ODBC
Après avoir téléchargé le connecteur SQL,
Dans ce qui suit, je décris la configuration du connecteur ODBC avec le gestionnaire ODBC pour Mac OS X - plus haut dans le texte, vous trouverez un lien pour télécharger ce programme. Sous Windows ou sous Mac OS X avec d'autres gestionnaires ODBC, les réglages doivent être effectués de manière équivalente.
Après avoir téléchargé le gestionnaire ODBC et l'avoir copié dans le répertoire des applications de Mac OS X, lancez le gestionnaire ODBC en double-cliquant sur l'icône de l'application. Le programme démarre alors et ouvre la fenêtre principale du gestionnaire ODBC. Les sources de données ODBC peuvent toujours être configurées pour l'ensemble du système (DSN système), c'est-à-dire pour tous les utilisateurs du système, ou pour un utilisateur (DSN utilisateur). Dans la zone [Suivi du déroulement], l'utilisation de la source de données ODBC peut être consignée dans un protocole texte.
Selon que vous souhaitez configurer la source de données pour l'utilisateur actif ou pour l'ensemble du système, cliquez sur le bouton [Ajouter...] dans la zone correspondante.
Pour xt:Commerce, sélectionnez à ce stade la version 3.51 du pilote MySQL ODBC et cliquez sur le bouton [OK]. Dans la fenêtre suivante, saisissez toutes les données de votre base de données MySQL, qui contient les tableaux de données pour votre boutique en ligne xt:Commerce.
Après avoir saisi toutes les données dans les champs correspondants, cliquez ensuite sur le bouton [Test] pour établir une connexion via votre source de données nouvellement configurée et la tester.

Utilisation de la source de données ODBC avec FileMaker
Démarrez FileMaker et ouvrez une base de données avec laquelle vous souhaitez établir une connexion à votre base de données xt:Commerce. Si vous disposez déjà d'une solution FileMaker pour vos commandes en boutique, il est préférable d'ouvrir la version que vous souhaitez développer.
Extraire des données de la base de données xt:Commerce
Pour importer des données dans FileMaker à partir de xt:Commerce via l'interface ODBC, il suffit désormais d'utiliser la commande "Importer des enregistrements" bien connue dans Scriptmaker. Je vous conseille de créer une image des données originales pour les données de xt:Commerce. Tableau de xt:Commerce dans votre solution. Ainsi, l'importation est plus simple grâce aux noms de champs identiques et votre solution possède son propre tableau avec toutes les commandes de xt:Commerce.
Créer une image d'un tableau à partir de xt:Commerce
Pour créer une image d'une table de xt:Commerce dans FileMaker, il est préférable d'importer la table avec les noms des rubriques dans votre solution FileMaker. Dans la barre de menus du fichier FileMaker dans lequel vous souhaitez importer la table, sélectionnez l'option
Fichier > Importer des enregistrements > Source de données ODBC
dans le menu déroulant. Sélectionnez maintenant la source de données ODBC de votre serveur SQL configurée dans le gestionnaire ODBC avec les bases de données du xt:Commerce et saisissez dans le dialogue suivant votre nom d'utilisateur et votre mot de passe de la base de données MySQL. La boîte de dialogue Indiquer une requête SQL ODBC apparaît alors, dans laquelle vous pouvez indiquer une commande SQL soit à partir d'un calcul, soit sous forme de texte statique.
Pour importer une table entière dans FileMaker, il suffit de cliquer sur le bouton [Création de requête...], ce qui ouvre un assistant de création de requête SQL.
Dans la colonne de gauche, vous trouverez toutes les tables qui se trouvent sur le serveur SQL distant.Serveur se trouvent. Par exemple, pour importer le tableau "orders" de xt:Commerce, sélectionnez dans la colonne de gauche le tableau "orders" correspondant. Dans la colonne de droite apparaissent alors les champs disponibles de la table sélectionnée à gauche. Pour créer automatiquement la requête, il suffit de double-cliquer dans la colonne de droite sur chaque champ à importer. Dans la fenêtre inférieure, vous pouvez voir comment la requête est créée automatiquement champ par champ. A la fin, la fenêtre devrait ressembler à ceci :
Dans le champ "SQL-Query", sélectionnez maintenant l'ensemble du texte (cmd-A), insérez-le dans un document dans un éditeur de texte (par ex. Textedit) et enregistrez le texte par ex. sous "SQL_xtC_orders.txt".
Après avoir cliqué sur le bouton [OK], la boîte de dialogue pour l'affectation des champs apparaît. Dans cette boîte de dialogue, sélectionnez [Nouvelle table : "Nom de la source de données"] sous la désignation "Cible". Après avoir cliqué sur le bouton [Importer], tous les champs sélectionnés dans la requête sont maintenant créés dans une nouvelle table et les données correspondantes sont importées. Après l'importation, vous trouverez le tableau dans la gestion de la base de données et pourrez le renommer à votre convenance, par exemple en "xtC_orders".
Créer un script pour l'importation de données depuis xt:Commerce
Pour intégrer une importation de données dans votre solution, ouvrez le Scriptmaker et créez un nouveau Script. Ajoutez la commande "Importer des enregistrements" dans votre nouveau script. Sélectionnez maintenant comme source de données "Source de données ODBC" et sélectionnez la source de données ODBC créée dans le gestionnaire ODBC. Saisissez maintenant vos données de connexion pour la base de données SQL et activez la case "Enregistrer le nom d'utilisateur et le mot de passe". Après avoir cliqué sur le bouton [OK], vous pouvez maintenant insérer à nouveau la requête SQL sous forme de formule calculée ou de texte. Si vous souhaitez à l'avenir n'importer qu'un ordre précis avec votre script, vous devez pour cela créer une requête SQL calculée. Dans notre exemple, nous partons du principe que le numéro de commande à importer se trouve dans la Variable $orders_id est enregistré.
Ouvrez maintenant votre document texte enregistré avec la requête SQL. Ajoutez des guillemets (") au début et la commande suivante à la fin de la requête :
WHERE `orders`.`orders_id` = " & $orders_id
Avec cette commande, vous limitez l'importation à l'enregistrement dont le champ contient la valeur de la variable $orders_id. L'ensemble de votre déclaration SQL devrait maintenant ressembler à quelque chose comme ça :
"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
Dans votre script, vous pouvez désormais, par exemple, demander à l'utilisateur le numéro de commande souhaité et importer automatiquement la commande correspondante dans votre solution FileMaker par script.
Écriture de données dans une table de données SQL
FileMaker permet également d'écrire ou de mettre à jour des données directement dans une table de xt:Commerce via ODBC. Dans Scriptmaker, la commande suivante est disponible à cet effet :
Exécuter une requête SQL [...].
Dans l'exemple suivant, nous créons un nouvel enregistrement dans la table xt:Commerce orders_status_history. Dans cette table sont enregistrés les messages d'état de xt:Commerce, que le client peut en général aussi consulter dans la zone de connexion de la boutique. Un nouvel enregistrement dans cette table est créé avec la commande suivante :
Exécuter une requête SQL [
"INSERT INTO `orders_status_history` (`comments`, `customer_notified`, `date_added`, `orders_id`, `orders_status_history_id`, `orders_status_id`)
VALUES ('"
"Texte d'état'" & ", 0, '" & xtc_date(Obtenir(DateSystème)) &
"', " & xtcommerce::_Commande_N° & ", " & "'" & ", " & "2)"]
La commande mentionnée peut être utilisée soit directement dans un script, soit au moyen d'une nouvelle fonction propre (Fonction personnalisée). Dans le cas de xtc_date, il s'agit d'une fonction propreque vous pouvez soit définir comme fonction propre, soit résoudre directement dans la commande de script. La fonction propre xtc_date met une date transmise dans le format dans lequel xt:Commerce attend une date :
xtc_date (champ date) =
LireEnTexte(Année ( champDate ) & "-" & CaractèreDroite( "0" & MoisNombre (champDate) ; 2) & "-" & CaractèreDroit( "0" & NombreDeJourCalendrier (champDate) ; 2)) & " " & LiesAlsText(Obtenir(HeureSystème))
Pour modifier le statut lui-même, l'ID de statut correspondant est défini dans la table MySQL <>. Dans l'exemple suivant, l'ID de statut de l'ordre est fixé à l'ID "2" :
Exécuter une requête SQL ["UPDATE `orders` SET `orders_status` = 2 WHERE `orders_id` = " & xtcommerce::_numéro_de_commande]
Vous pouvez voir et modifier les ID de statut que vous avez attribués dans xt:Commerce dans le backend de xt:Commerce.
Les possibilités d'intégration des données de xt:commerce en combinaison avec FileMaker sont pratiquement illimitées. Tout comme les données de commande, les données d'articles ou d'adresses de xt:Commerce peuvent bien entendu être utilisées dans FileMaker et inversement.
Bien entendu, la procédure décrite dans cet article fonctionne avec n'importe quelle table de xt:Commerce et, en principe, avec toute autre boutique en ligne dont la base de données permet l'accès via un connecteur ODBC. Pour des informations détaillées concernant la structure de la base de données de votre système de boutique en ligne, je vous recommande d'étudier la documentation technique correspondante.

Markus Schall développe depuis 1994 des bases de données individuelles, des interfaces et des applications commerciales sur la base de Claris FileMaker. Il est partenaire de Claris, lauréat du FMM-Award 2011 et développeur de la Logiciel ERP gFM-Business. Il est en outre auteur de livres et fondateur du M. Schall Verlags.








