How-To : étendre le logiciel ERP gFM-Business avec FileMaker

Un des grands avantages de gFM-Business Logiciel ERP est la base de FileMaker. En effet, avec FileMaker Pro, vous pouvez, en tant qu'utilisateur, adapter et/ou étendre tous les modèles d'impression selon vos souhaits dans toutes les versions. De plus, dans toutes les versions, toutes les tables de données sont activées pour l'accès aux bases de données FileMaker externes. Avec FileMaker Pro, vous pouvez donc également développer vos propres solutions FileMaker, modifier ou ajouter des données de gFM-Business. Dans l'article suivant, vous apprendrez comment créer une petite solution FileMaker pour enregistrer les postes d'une liste d'articles sous forme de fichier Excel.Tableau à partir du logiciel Évolution de 3CAD en tant que positions dans une offre de gFM-Business. De telles solutions peuvent en principe être créées dans tous les domaines de gFM-Business, car toutes les tables de données sont libérées pour un accès externe. La solution présentée dans cet article peut également être achetée sous forme de module prêt à l'emploi, ouvert à l'adaptation à vos propres exigences avec FileMaker Pro.

Créer une nouvelle base de données FileMaker

Dans notre exemple, nous souhaitons ajouter des positions d'articles à une liste de produits de Évolution de 3CAD en tant que postes de devis dans un devis existant. Pour cela, nous avons d'abord besoin d'un nouveau fichier FileMaker.Base de donnéesNous pouvons y importer les données des feuilles de calcul Excel. Pour ce faire, ouvrez FileMaker Pro et sélectionnez dans la barre de menus l'option [Fichier/Dossier > Nouvelle solution...].

Dans la boîte de dialogue de sélection de fichiers suivante, choisissez d'abord le dossier dans lequel se trouvent les bases de données de gFM-Business (gFM_Business.fmp12 ou gFM_Business.gfm). Attribuez dans le champ [Sauvegarder sous] un nouveau nom pour votre solution FileMaker, dans notre cas nous inscrivons "3CAD-FileMaker.fmp12".

Importer une feuille de calcul Excel en tant que nouvelle feuille de calcul FileMaker

Après avoir créé la nouvelle base de données FileMaker sur le support de données, nous pouvons dans un deuxième temps importer le tableau Excel qui sera saisi ultérieurement comme postes dans l'offre. Pour ce faire, sélectionnez dans la barre de menus l'option [Fichier/Document > Importer des enregistrements > Fichier...] de.

Dans la boîte de dialogue de sélection des fichiers, choisissez le cas échéant sous [Afficher] le point "classeurs Excel (xlsx)" et ensuite votre feuille de calcul Excel qui a été exportée par le logiciel "3CAD-Evolution". Après avoir sélectionné le fichier, choisissez dans la boîte de dialogue suivante, le cas échéant, le classeur dans lequel les données ont été enregistrées au sein du tableau Excel, après quoi une boîte de dialogue apparaît pour l'attribution des champs d'importation :

Dans la partie inférieure, activez l'option [Ne pas importer le premier enregistrement]. Sélectionnez en haut à droite sous [Objectif] l'option [Nouveau tableau] dans le menu déroulant. Cliquez ensuite sur le bouton [Importer]pour importer la feuille de calcul Excel en tant que nouvelle feuille de calcul FileMaker dans votre solution. Une nouvelle table est alors automatiquement créée dans FileMaker avec les noms de rubriques indiqués dans la feuille de calcul Excel. Toutes les données de la feuille de calcul Excel sont également importées dans la nouvelle table. FileMaker crée également deux modèles pour la nouvelle table, qui contiennent les rubriques de la table. Ces modèles seront quelque peu modifiés plus loin dans cet article.

Créer des sources de données externes à gFM-Business

Ensuite, nous intégrons les bases de données des tables nécessaires de gFM-Business dans notre nouvelle solution FileMaker. Pour ce faire, sélectionnez dans la barre de menus l'option [Fichier/Dossier > Gérer > Sources de données externes] de la page d'accueil. Cliquez sur le bouton [Nouveau...]pour créer une nouvelle source de données externe.

Cliquez sur le bouton [Ajouter un fichier] et sélectionnez dans votre répertoire gFM-Business le fichier [gFMw_Artikel.fmp12] respectivement [...gfm] pour la sélectionner. Confirmez ensuite la boîte de dialogue en cliquant sur le bouton [OK]. Répétez cette procédure pour les fichiers suivants :

• gFMw_Faktura.fmp12 (ou .gfm)
• gFMw_Contacts.fmp12 (ou .gfm)
• gFMw_Données de base.fmp12 (ou .gfm)

Au final, la boîte de dialogue des sources de données externes devrait ressembler à ceci :

Créer un ID d'offre et une clé globale

Nous avons maintenant besoin d'un champ dans lequel l'ID d'offre de l'offre dans laquelle les positions de la liste d'articles doivent être importées pourra être saisi ultérieurement. Cette rubrique doit être enregistrée globalement afin que la valeur soit la même pour tous les enregistrements appelés. Pour créer les nouvelles rubriques dans FileMaker, sélectionnez l'option [Fichier/Dossier > Gérer > Base de données] pour le sélectionner. Sélectionnez l'onglet central [Champs] et donnent des informations sur [nom du champ] saisit le nom du nouveau champ : [_fk_offre_ID]. Cliquez sur le bouton [Créer] et cliquez ensuite sur le bouton [Options]. Sélectionnez l'onglet [Mémoire], activez l'option "Utiliser l'enregistrement global" et confirmez le dialogue.

Pour la création de la clé globale, saisissez dans le champ [nom du champ] le nom [_sGlobal] et choisissez le type [Formule]. Cliquez sur le bouton [Créer] et saisissez uniquement un 1 dans le dialogue suivant. Après confirmation de la boîte de dialogue, votre fenêtre de gestion des champs devrait se présenter comme suit :

Créer des liens entre les tables de données

Nous avons maintenant besoin de quelques relations pour pouvoir classer correctement les données dans gFM-Business. La première relation pointe vers la table [Fiche article] de gFM-Business, qui est colorée en vert dans le graphique des liens. Dans cet exemple, nous avons coloré notre tableau d'importation en rouge clair.

Créer une relation avec la base de données articles

Pour que la nouvelle relation [Fiche article] cliquez sur le bouton [+]-en bas à gauche de la fenêtre. Sous Source de données, sélectionnez d'abord le fichier [gFMw_article] puis le tableau [Fiche article]. Confirmez la boîte de dialogue en cliquant sur OK. La zone à laquelle vous liez la relation dans la base de données articles dépend de la zone dans laquelle vous avez indiqué le numéro livré dans la Gestion des articles enregistrer. Dans notre cas, le fichier Excel fournit le numéro d'article du fournisseur, qui est géré dans notre exemple dans le champ "N°_article_fournisseur". Dans ce cas, cliquer avec la souris sur le champ "ART. NR." du tableau "CAD_Evolution" et en maintenant le bouton de la souris enfoncé, faites glisser la souris sur le champ "N°_article_fournisseur" du tableau "Base de données articles". Vous avez ainsi créé la première relation.

Créer des liens globaux

Les relations "glo_offres" et "glo_données de base" sont définies à l'aide de la clé globale [_sGlobal] sont liées entre elles. Créez ces deux liens selon le modèle ci-dessus et reliez les tables comme indiqué dans l'image ci-dessus (les deux côtés ayant chacun la clé globale). Sélectionnez comme tables la table "Positions d'offre" de la source de données "gFMw_Faktura" et la table "Données de base" de la source de données "gFMw_Stammdaten".

Créer une relation avec les postes de l'offre

Ensuite, nous avons besoin d'une relation avec les postes d'offre. Comme les postes d'offre n'ont pas de clé globale dans gFM-Business, vous liez la table d'importation au champ [_sGlobal] et les postes d'offre avec [_Offre_ID]. Double-cliquez ensuite sur la ligne de jonction et sélectionnez "x" comme type de jonction (zone d'affichage entre les tableaux).

Relations pour les données qui doivent être reprises de gFM-Business

Pour finir, nous avons besoin des relations "Offres" et "Offres_Clients". Pour cela, créez d'abord le tableau "Offres" comme décrit ci-dessus et reliez-le à l'aide du champ [_pk_offre_ID] avec le champ [_Offre_ID] des postes de l'offre. Créez ensuite la table "Offres_Clients" (table "Clients" de la source de données "gFMw_Kunden") et reliez le champ [_pk_ID_client] avec le champ [_ID_client] du tableau "Offres".

Créer une interface utilisateur et des mises en page du système

Pour notre petite solution d'importation, nous avons besoin de trois mises en page :

• L'interface utilisateur sur laquelle l'importation doit être effectuée par la suite
• Une disposition du système de la table "CAD_Evolution
• Une mise en page du système du tableau "Postes d'offre".

Pour l'interface utilisateur, nous pouvons utiliser le premier modèle que FileMaker a déjà créé automatiquement. Passez dans le Mode de mise en page sur [Affichage > Mode de mise en page]. Dans la barre de menu, sélectionnez [Layouts > Réglage du layout] de la page d'accueil. Renommez le layout en "scr.transfert de données" et sous "Afficher les enregistrements de", sélectionnez "CAD_Evolution". Placez maintenant le champ global [_fk_offre_ID] de la table "CAD_Evolution" sur le layout ainsi qu'un bouton pour votre script d'exécution, que vous nommez par ex.

Créer des mises en page système pour les données d'exportation et les postes d'offre

Pour que notre Script peut accéder de manière traditionnelle aux données de la table des données d'exportation et de la table des postes de devis, nous avons besoin de deux modèles système. En mode Modèle, passez au deuxième modèle créé par FileMaker et renommez-le en tant que [sys.CAD_Evolution].

Pour la deuxième mise en page du système, sélectionnez dans la barre de menus la fonction [Layouts > Nouvelle mise en page/Nouveau rapport] pour la sélectionner. Saisissez comme nom de mise en page [sys.positions d'offre] sous "Afficher les enregistrements de", sélectionnez la table "Positions de l'offre", choisissez "Ordinateur" et "Formulaire" et confirmez la boîte de dialogue. Insérez toutes les rubriques de la table "Positions de l'offre" dans le nouveau modèle.

Script pour importer les données de 3CAD-Evolution dans gFM-Business

Nous devons maintenant programmer le script qui importera les données du tableau exporté en tant que postes d'offre dans gFM-Business. Il faut savoir que gFM-Business ne saisit pas automatiquement les données lors de l'importation depuis des solutions externes. Il faut donc transmettre toutes les valeurs à importer. Le script se compose des sous-scripts suivants :

• Vérification de l'ID d'offre vide - vérifie si une valeur a été saisie dans l'ID d'offre. Abandon si aucune valeur n'a été saisie. Sur la première ligne, nous activons l'enregistrement des erreurs, car les éventuelles erreurs sont directement interceptées dans le script.

• Vérification de l'ID d'offre erronée - vérifie si l'ID de l'offre existe dans gFM-Business. Si l'ID d'offre saisie n'existe pas dans gFM-Business, le script est interrompu.

• Vérification des postes existants - vérifie si des positions existent déjà dans l'offre. Si c'est le cas, une demande s'affiche pour savoir s'il faut quand même importer dans cette offre. Les positions existantes sont bien entendu conservées.

• Dialogue d'importation et importation de données - Demande si l'importation doit être effectuée et routine pour l'importation des données. Tout d'abord, une boîte de dialogue s'affiche pour indiquer que le fichier à importer doit être sélectionné dans la boîte de dialogue suivante. Une boîte de dialogue de sélection de fichier apparaît alors, développée avec des fonctions MBS, pour lire le chemin natif du fichier. Ce chemin est créé à l'aide de la fonction [PathPluginToFM] en un chemin d'accès conforme à FileMaker. Cette fonction est un ensemble de fonctions personnalisées que vous pouvez importer de gFM-Business. Pour ce faire, sélectionnez dans la barre de menus la fonction [Fichier/Dossier > Gérer > Fonctions personnelles]. Cliquez en bas sur le bouton [Importer]. Sélectionnez votre base de données gFM-Business, puis les fonctions suivantes : PathFMToPlugin, PathPluginToFM, Platform, PlatformIsMac, PlatformIsWin, TrimStart et LeftMatch. Confirmez la boîte de dialogue pour démarrer l'importation.Dans la commande [Importer des enregistrements] sélectionnez d'abord un de vos fichiers d'exportation de 3CAD-Evolution. Définissez ensuite dans la commande la séquence de champs pour l'importation et choisissez comme table cible [CAD_Evolution] de la souris. Après avoir défini la séquence de champs, cliquez à nouveau sur la commande, sélectionnez [Fichier]et supprimez le nom de votre fichier local en le remplaçant par le nom de fichier défini dans la partie supérieure du script. Variable $pfad_fm.

  Une fois la boucle d'exécution lancée, les données de la table [CAD_Evolution] toutes les variables nécessaires qui, après interrogation sur un numéro d'article existant, sont placées dans la table [Postes de l'offre] peuvent être écrites. Selon les données que contient le tableau Excel exporté et qui doivent être transmises, les définitions des variables et les remplacements des valeurs de champ peuvent être étendus à volonté.

Attribuer un script d'exécution à un bouton

La dernière étape consiste à appuyer sur la touche [Importation de données] sur la première mise en page [Transfert de données] est occupée par le nouveau script "sf.importation de données". Passez d'abord au premier layout "scr.reprise de données" en mode de mise en page, cliquez sur le bouton [Importation de données] avec le bouton droit de la souris et sélectionnez la fonction [Réglage des touches]. Dans la section "Action", sélectionnez dans le premier Menu déroulant la fonction [Exécuter le script]. Dans la boîte de dialogue suivante, sélectionnez le script "sf.Importation de données".

Le bouton [Importation de données] est maintenant occupé par le script d'importation, et votre petite solution FileMaker pour importer une liste de matériel de 3CAD-Evolution en tant que postes de devis dans gFM-Business est ainsi prête.

Importation de postes de documents à partir d'autres solutions tierces

Dans cet article, nous avons montré comment une solution FileMaker simple permet d'importer automatiquement des positions de devis dans gFM-Business à partir de listes de matériel exportées de 3CAD-Evolution. En principe, cette procédure peut également être utilisée pour des listes provenant d'autres programmes, si elle est adaptée en conséquence. Les processus d'importation dans d'autres tableaux de données, tels que les clients ou les articles, sont bien entendu également envisageables.