MANUEL D UTILISATION DE L EXTENSION scom POUR FILEMAKER PRO

Transcription

1

2 MANUEL D UTILISATION DE L EXTENSION scom POUR FILEMAKER PRO Par Henri et Mathieu Frappier 2012 Smi-t inc. Tus drits réservés 2

3 TABLE DES MATIÈRES PRÉAMBULE... 4 INTRODUCTION... 4 Résumé... 4 Exemples d utilisatin... 4 Installatin de l extensin... 4 FONCTIONS EXTERNES... 6 Liste des fnctins externes de l extensin scom... 6 scom_dcb( "" ; ParamName ; Value )... 6 scom_read( "" ; CmName ; NumBytesTRead )... 6 scom_register(name ; Key ))... 7 scom_timeuts( "" ; ReadIntervalTimeut ; ReadTtalTimeutMultiplier ; ReadTtalTimeutCnstant ; WriteTtalTimeutMultiplier ; WriteTtalTimeutCnstant ) 7 scom_versin( { Frmat } )... 7 scom_write( "" ; CmName ; Data )... 7 scom_writetread( "" ; CmName ; Data ; NumBytesTRead )... 8 RÉFÉRENCES... 8 Ntes techniques... 9 Dépannage («Trubleshting»)... 9 À prps de FileMaker, Inc

4 PRÉAMBULE Ce manuel assume que vus pssédez les cnnaissances de base cncernant la platefrme de dévelppement de bases de dnnées FileMaker Pr, de l utilisatin de ses extensins et de ses fnctins externes et persnnalisées. Ce manuel, ainsi que les fichiers qui y snt inclus, snt distribués sus licence d empli et ne peuvent être cpiés, phtcpiés, reprduits, traduits u cnvertis en frmat électrnique, en ttalité u en partie, sans autrisatin écrite btenue au préalable auprès de Smi-t inc. Le terme «FileMaker» utilisé dans les descriptins de ce manuel réfère généralement aux versins des lgiciels FileMaker Pr et FileMaker Pr Advanced. Smi-t Inc. is a prud FileMaker Business Alliance (FBA) member since Smi-t inc. n assume aucune respnsabilité déculant d erreurs u d inexactitude prvenant du présent manuel. N hésitez pas à cmmuniquer avec nus à guideinf@smi-t.cm Site Web : u Cette versin du manuel a été mise à jur le 27 juin 2012 pur la versin 1.0 de l extensin scom. INTRODUCTION Résumé L'extensin scom permet la cmmunicatin entre FileMaker Pr et les prts séries standards u virtuels d'un rdinateur utilisant le système d'explitatin Windws. Après l installatin de l extensin scom, il vus sera facile d utiliser les sept fnctins externes qui s affichent autmatiquement dans le dialgue de calcul de FileMaker Pr. Exemples d utilisatin Ouvrir u fermer un relais sur un relais "hardware" de type USB-Série (GCE Electrnics, USB-X220 par exemple) pur se cnnecter à un système d'alarme u à un système de gestin d'uverture-fermeture de prtes; Interagir avec un mdem téléphnique; Cntrôler des équipement pssédant une interface série u USB (lecteur de cde à barres u de bande magnétique, balance, tirir-caisse, etc.); Installatin de l extensin Veuillez nter que la cpie d essai de l extensin scom fera apparaître un message demandant l enregistrement de la cpie après chaque cinq (5) utilisatins des fnctins scom_write(), scom_read() et scom_writetread(). 4

5 Vus devez activer l'extensin dans vtre slutin FileMaker Pr pur que sn état change de Démnstrateur à Enregistré. Utiliser la fnctin externe scom_register() dans le script d uverture de la slutin FileMaker Pr pur enregistrer vtre extensin. Si vus expérimentez des prblèmes lrs du prcessus d'installatin, vus puvez cmmuniquer avec ntre service d'assistance technique à l'aide de ntre "Frmulaire de demande d'aide u d'infrmatin" situé dans la page de sutien de ntre site Web Résumé des étapes d installatin : 1) Le pilte scom.fmx dit être installé dans le répertire C:\Prgram Files\FileMaker\FileMaker Pr [versin]\extensins\ avant de démarrer le lgiciel FileMaker Pr. 2) Les fnctins externes de l extensin scom snt maintenant dispnibles à l aide des fnctins externes de FileMaker Pr. 5

6 FONCTIONS EXTERNES Liste des fnctins externes de l extensin scom scom_dcb( "" ; ParamName ; Value ) scom_read( "" ; CmName ; NumBytesTRead ) scom_register( Name ; Key ) scom_timeuts( "" ; ReadIntervalTimeut ; ReadTtalTimeutMultiplier ; ReadTtalTimeutCnstant ; WriteTtalTimeutMultiplier ; WriteTtalTimeutCnstant ) scom_versin( { Frmat } ) scom_write( "" ; CmName ; Data ) scom_writetread( "" ; CmName ; Data ; NumBytesTRead ) scom_dcb( "" ; ParamName ; Value ) Descriptin : Cette fnctin permet de cntrôler divers paramètres de cmmunicatin cmme la vitesse et le XON/XOFF. Paramètre "" : Nn-utilisé. Paramètre ParamName : Nm du paramètre à mdifier. Paramètre Value : Nuvelle valeur du paramètre. Exemple : scom_dcb( "" ; "BaudRate" ; ) Remarque : Pur plus d'infrmatin veuillez cnsulter le site suivant, scom_read( "" ; CmName ; NumBytesTRead ) Descriptin : Cette fnctin permet de lire sur le prt de cmmunicatin sélectinné. Paramètre "" : Nn-utilisé. Paramètre CmName : Nm du prt de cmmunicatin. Paramètre NumBytesTRead : Nmbre de caractères à lire. Exemple : scom_read( "" ;"COM1" ; 5 ) Résultat : Returne un cde cmmençant par!! si une erreur s'est prduite, sinn returne les caractères lue. 6

7 scom_register(name ; Key )) Descriptin : Enregistre l extensin. Paramètre Name : Nm que vus avez furni à Smi-t pur l'enregistrement de l extensin. Paramètre Key : Clé d'enregistrement furnie par Smi-t. scom_timeuts( "" ; ReadIntervalTimeut ; ReadTtalTimeutMultiplier ; ReadTtalTimeutCnstant ; WriteTtalTimeutMultiplier ; WriteTtalTimeutCnstant ) Descriptin : Cette fnctin permet de changer les délais relatif à l'écriture et à la lecture vers le prt de cmmunicatin utilisé. Les valeurs par défaut snt respectivement de 1, 1, 100, 0, 0. Paramètre "" : Nn-utilisé. Paramètre ReadIntervalTimeut" : Délai en millisecndes. Paramètre ReadTtalTimeutMultiplier : Délai en millisecndes. Paramètre ReadTtalTimeutCnstant : Délai en millisecndes. Paramètre WriteTtalTimeutMultiplier : Délai en millisecndes. Paramètre WriteTtalTimeutCnstant : Délai en millisecndes. Exemple : scom_timeuts( "" ; 10 ; 10 ; 100 ; 1 ; 1 ) Remarque: Pur plus d'infrmatin veuillez cnsulter le site suivant, scom_versin( { Frmat } ) Descriptin : Indique la versin de l extensin. Paramètre Frmat : "lng", returne le nm de l extensin et la versin. "shrt", returne seulement la versin de l extensin. Exemple : scom_versin scom_versin( "lng" ) Résultat : Returne la versin de l extensin. scom_write( "" ; CmName ; Data ) Descriptin : Cette fnctin permet d'écrire sur le prt de cmmunicatin sélectinné. 7

8 Paramètre "" : Nn-utilisé. Paramètre CmName : Nm du prt de cmmunicatin. Paramètre Data : Dnnées à écrire sur le prt de cmmunicatin. Exemple : scom_write( "" ; "COM1" ; "Hell Wrld!" ) Résultat : Returne un cde cmmençant par!! si une erreur s'est prduite, sinn returne rien. scom_writetread( "" ; CmName ; Data ; NumBytesTRead ) Descriptin : Cette fnctin permet d'écrire sur le prt de cmmunicatin sélectinné et de faire une lecture subséquente. Paramètre "" : Nn-utilisé. Paramètre CmName : Nm du prt de cmmunicatin. Paramètre Data : Dnnées à écrire sur le prt de cmmunicatin. Paramètre NumBytesTRead : Nmbre de caractères à lire après l'écriture. Exemple : scom_writetread( "" ; "COM1" ; "Hell Wrld!" ; 5 ) Résultat : Returne un cde cmmençant par!! si une erreur s'est prduite, sinn returne les caractères lue. Cdes d erreurs et leur significatin pur l extensin scom Applicable seulement aux fnctins scom_write(), scom_read() et scom_writetread() :!!-1 : Erreur de paramètre!!-2 : Erreur de cnnexin au prt (E012_CreateFile_failed)!!-3 : Impssible de mdifier les délais (E013_SetCmmTimeuts_failed)!!-4 : N a pu définir les paramètres de cntrôle de cmmunicatin avec l appareil (E014_SetCmmState_failed) Applicable seulement aux fnctins scom_write() et scom_writetread() :!!-5 x : Erreur d écriture (x_unknwn_errr) La valeur x puvant dnner différents résultats. Se référer à : Applicable seulement à la fnctin scom_register() :!!Errr registering : Erreur d enregistrement. Mauvaise cmbinaisn de nm et de clé d enregistrement.!!invalid Key : Erreur d enregistrement. Mauvaise clé d enregistrement. 8

9 RÉFÉRENCES Ntes techniques L extensin scom requiert le système d explitatin Micrsft Windws XP u plus récent. L'extensin scom est cmpatible avec les versins 9, 10, 11 et 12 de FileMaker Pr et FileMaker Pr Advanced. L'extensin scom est cmpatible avec la technlgie Server-side scripting (SSS) de FileMaker. Il pssible de cmmuniquer avec plusieurs prts dans le même script. La vitesse de transmissin maximal lrs d une cnnexin est de bps. Il n y a pas de mise en mémire-tampn. Les fnctins scom_read() et scom_writetread() pssédant un paramètre qui détermine le nmbre de bytes à lire. Dépannage («Trubleshting») Puisqu il s agit de la première versin du manuel de l utilisateur pur l extensin scom pur FileMaker Pr, nus invitns les utilisateurs à cmmuniquer avec nus pur nus aider à bâtir cette sectin du manuel. À prps de FileMaker, Inc. FileMaker dévelppe des prgrammes de base de dnnées primés depuis Ses prduits cmprennent la légendaire ligne de prduits FileMaker Pr pur Windws, Mac et FileMaker G pur iphne, ipd et ipad. FileMaker a gagné plus de 52 prix, plus que ses huit cmpétiteurs cmbinés de 2003 à 2009 aux États-Unis, et un ttal de 134 prix dans le mnde durant ces mêmes années. Des millins d utilisateurs des individus aux grandes entreprises fnt cnfiance aux applicatins FileMaker pur gérer, analyser et échanger de l infrmatin. FileMaker, Inc. est une filiale d Apple Inc. 9

10 10