Guide d'utilisation de l'utilitaire d'importation

Utilitaire d’importation et d’exportation de données pour NewWayService 4

Copyright © 1996-2009 OroLogic Inc. http://www.orologic.com Révision 4.01

Table des matières


I

Table des matières

Introduction à l'utilitaire d'importation et d'exportation de données ______________________ 1

Qu'est-ce que l'utilitaire d'importation et d'exportation de données __________________________ 1

Accès aux données à l'aide de Microsoft ADO ____________________________________________ 1

Démarrage de l’utilitaire d’importation et d’exportation de données _________________________ 2

Importation de données __________________________________________________________ 3

Introduction à l'importation de données _________________________________________________ 3

Importer des données, étape par étape __________________________________________________ 3 Étape 1/8: Que voulez-vous faire ? ______________________________________________________________3 Étape 2/8: Sélection de la source de données ______________________________________________________4 Étape 3/8: Sélection de la table à importer ________________________________________________________5 Étape 4/8: Spécifiez la base de données de NewWayService 4_________________________________________5 Étape 5/8: Code de technicien et mot de passe _____________________________________________________5 Étape 6/8: Sélectionnez le module où seront importées les données_____________________________________6 Étape 7/8: Association des champs source aux champs destination _____________________________________7 Étape 8/8: Derniers paramètres et démarrage de l'importation _________________________________________9

Exportation de données _________________________________________________________ 11

Introduction à l'exportation de données ________________________________________________ 11

Exporter des données, étapes par étape_________________________________________________ 11 Étape 1/8: Que voulez-vous faire ? _____________________________________________________________11 Étape 2/8: Spécifiez la base de données de NewWayService 4________________________________________11 Étape 3/8: Code de technicien et mot de passe ____________________________________________________12 Étape 4/8: Sélection des données à exporter ______________________________________________________12 Étape 5/8: Sélection de la destination des données à exporter_________________________________________13 Étape 6/8: Sélection de la table destination _______________________________________________________14 Étape 7/8: Association des champs sources aux champs destinations___________________________________14 Étape 8/8: Derniers paramètres et démarrage de l'exportation ________________________________________15

Utilisation de scripts à l'aide du langage Pascal Objet_________________________________ 18

Référence du langage Pascal Objet ________________________________________________ 22

Vue d’ensemble du langage Pascal Objet _______________________________________________ 22 Instructions:_______________________________________________________________________________22 Types de données: __________________________________________________________________________22 Operateurs: _______________________________________________________________________________22

Routines standards _________________________________________________________________ 23 Fonctions de manipulation des chaînes de caractères _______________________________________________23 Fonctions de conversion de données ____________________________________________________________24 Fonctions de Formatage _____________________________________________________________________26 Fonctions Date et heure______________________________________________________________________30 Fonctions Mathématique _____________________________________________________________________31 Autres fonctions utiles_______________________________________________________________________34

Importations et exportations automatisées __________________________________________ 35

Table des matières


II

Dictionnaire de données_________________________________________________________ 37

Liste des entités de la base de données de NewWayService 4 _______________________________ 37

Tutoriels _____________________________________________________________________ 38

Tutoriel 1 – Importation de produits ___________________________________________________ 38

Tutoriel 2 – Importation de clients et écriture de scripts à l’aide du langage Pascal Objet _______ 40

Tutoriel 3 – Exportation de la liste des clients vers un fichier MS Access _____________________ 42

Tutoriel 4 – Exportation de pièces de rechange et écriture de scripts à l’aide du langage Pascal

Objet _____________________________________________________________________________ 44

Introduction à l'utilitaire d'importation et d'exportation de données


1

Introduction à l'utilitaire d'importation et d'exportation de données Qu'est-ce que l'utilitaire d'importation et d'exportation de données L’utilitaire d’importation et d’exportation de données pour NewWayService 4 est un programme très puissant, vous permettant de mettre à jour des données de NewWayService 4 à partir d’une source externe de données (importation), ou de mettre à jour des données externes à partir de données de NewWayService 4 (exportation). Par exemple, à l’aide de l’utilitaire d’importation et d’exportation de données, vous pourriez importer la liste de vos clients ou la liste des produits vendus, de votre logiciel de comptabilité vers NewWayService 4. Vous pourriez également, au contraire, exporter la liste des pièces de rechange utilisées sur vos bons de travail, de NewWayService 4 vers votre logiciel de comptabilité (voir figure 1 ci-dessous).

Figure 1 En plus des fonctions de base d’importation et d’exportation de données, cet utilitaire vous permet : - D’utiliser des scripts (langage Pascal Objet) pour vous permettre plus de flexibilité lors de l’importation

ou l’exportation de données (ex.: filtrer les enregistrements à importer ou exporter, concaténation ou formatage de champs, etc.).

- D’enregistrer vos paramètres d’importation et d’exportation pour une utilisation ultérieure. - D’exécuter automatiquement des importations ou exportations de données (par exemple, durant la nuit)

à l’aide d’un logiciel de planification de tâches comme le planificateur de tâches de Windows ou le service Schedule de Windows.

IMPORTANT : Avant d'exporter des données directement vers une base de données d'un autre logiciel (comme par exemple la base de données de votre logiciel de comptabilité), vérifiez avec le manufacturier de votre logiciel que vous pouvez faire cette opération sans risque. En effet, puisque chaque manufacturier a sa propre façon de garder l'information dans les bases de données, exporter des données vers une de ces bases de données sans aucune précaution pourrait causer de sérieux dommages à ces données. Accès aux données à l'aide de Microsoft ADO L’utilitaire d’importation et d’exportation de données utilise le système d’accès aux données ADO (ActiveX Data Objects) développé par Microsoft. ADO est un système d’accès aux données qui comporte l’avantage de pouvoir accéder uniformément à plusieurs types de bases de données différentes à l’aide de pilotes comme par exemple des pilotes OLE DB ou ODBC. Par exemple, à l’aide de ADO et d’un pilote compatible,

Introduction à l'utilitaire d'importation et d'exportation de données


2

vous pouvez aussi bien accéder à de simples fichiers dBase, MS Excel ou MS Access qu’à des bases de données très évoluées comme Firebird, Oracle ou MS SQL. ADO est compatible avec la technologie ODBC (Open DataBase Connectivity). Ainsi, si vous possédez un pilote ODBC pour accéder à une base de données spécifique, vous pourrez accéder à cette base de données à l’aide de l’utilitaire d’importation et d’exportation de données. Le système d’accès aux données ADO fait partie du MDAC (Microsoft Data Access Components) de Microsoft. Le MDAC est un ensemble de composants spécifiquement conçus pour l’accès aux données et contient les systèmes d’accès aux données ADO, OLE DB et ODBC. Le MDAC est maintenant automatiquement installé avec les nouvelles version de Windows (Windows 2000 ou ultérieur) ainsi qu’avec la plupart des produits de Microsoft comme, par exemple, la suite MS Office 2000 ou ultérieure. Lors de son utilisation, l’utilitaire d’importation et d’exportation de données vérifie que le MDAC de Microsoft est installé sur votre ordinateur. Si le MDAC n’est pas détecté, vous recevrez un message d’indication à cet effet. Dans un tel cas, vous n’avez qu’à télécharger et installer gratuitement le MDAC de Microsoft à partir de la section du site Internet de Microsoft réservée à cet effet à l’adresse http://www.microsoft.com/data/ . Notez que seule la version 2.1 ou ultérieure du MDAC de Microsoft est compatible avec l’utilitaire d’importation et d’exportation de données de NewWayService 4. Si vous avez besoin de plus amples informations à propos de ADO ou du MDAC de Microsoft, veuillez visiter la section réservée à cet effet sur le site Internet de Microsoft à l’adresse http://www.microsoft.com/data/. Cette section contient une multitude de renseignements à propos de l’accès à différentes sources de données. Démarrage de l’utilitaire d’importation et d’exportation de données Pour démarrer l’utilitaire d’importation et d’exportation de données, cliquez sur Démarrer dans la barre des tâches de Windows et sélectionnez le menu Programmes. Sélectionnez ensuite le dossier NewWayService 4 et cliquez sur l’icône Utilitaire Importation-Exportation. Après quelques instants, vous vous retrouverez dans la fenêtre principale de l’application. Sélectionnez Importer des données vers NewWayService 4 pour importer des données ou Exporter des données de NewWayService 4 pour exporter des données. Cliquez ensuite sur le bouton Démarrer pour démarrer l’assistant qui vous guidera tout au long du processus.

Référez-vous aux sections ci-après Importation de données et Exportation de données selon le cas, pour de plus amples informations sur l’importation et l’exportation de données. Si vous recevez un message indiquant que le MDAC de Microsoft n’a pas été détecté, téléchargez et installez gratuitement le MDAC de Microsoft tel qu’indiqué à la section précédente puis redémarrez l’utilitaire d’importation et d’exportation de données.

Importation de données


3

Importation de données Introduction à l'importation de données Cette section vous explique comment importer des données dans NewWayService 4. Vous pouvez importer des données dans les modules suivants : - Produits - Clients - Numéros de série - Pièces de rechange - Articles (Base de connaissance) - Fournisseurs Notez que puisque l’ajout de bons de travail est un processus qui demande de nombreuses validations, vous ne pouvez importer des bons de travail dans NewWayService 4. Veuillez cependant noter que les utilisateurs de NewWayService 3 peuvent utiliser l’utilitaire de transfert des données de NewWayService 3 vers NewWayService 4 inclus avec NewWayService 4 pour transférer toutes leurs données vers NewWayService 4, d’un simple clic de souris. Un utilitaire de transfert des données de NewWayService 2 vers NewWayService 4 est également inclus avec NewWayService 4.

Importer des données, étape par étape Étape 1/8: Que voulez-vous faire ? Cette étape vous permet de charger un fichier contenant des paramètres d’importation que vous avez créé puis sauvegardé lors d’une importation antérieure. Ceci est très utile lorsque importez, sur une base régulière, des données provenant toujours de la même source. Ceci vous évite d'avoir à saisir les paramètres d’importation à chaque fois. Si c’est la première fois que vous importez des données à l’aide de cet utilitaire, sélectionnez Démarrer une nouvelle importation de données puis cliquez sur le bouton Suivant pour continuer à l’étape 2. Si vous voulez charger les paramètres d’une importation antérieure, sélectionnez Importer des données à partir de paramètres précédemment sauvegardés. Sélectionnez le fichier



4

contenant les paramètres à l’aide du bouton … puis cliquez sur le bouton Suivant pour continuer à l’étape 2. Étape 2/8: Sélection de la source de données Cette étape vous permet de spécifier où sont stockées les données que vous désirez importer et dans quel format ces données sont disponibles. Si vos données sont dans un fichier au format MS Access, dBase, MS Excel, Paradox, Lotus, Html ou texte, veuillez tout simplement sélectionner le fichier à importer à l’aide du bouton … puis cliquez ensuite sur Suivant pour continuer à l’étape 3. Si vos données sont dans un autre format de fichier ou de base de données, sélectionnez l’option d’une autre source de données (ADO, Autres formats de fichier, SQL, ODBC, etc.). Ensuite, cliquez sur le bouton Sélectionnez la source de données pour faire apparaître l’utilitaire de connexion ADO, puis cliquez sur le bouton Build pour accéder à ses différents onglets.

L’utilitaire de connexion ADO peut être différent selon la version de ADO et/ou Windows que vous utilisez. À partir de cet utilitaire, sélectionnez le type de la source de données à laquelle vous désirez accéder (normalement à partir de l’onglet Fournisseur) puis saisissez ensuite les paramètres de connexion spécifiques à votre source de données (normalement onglet Connexion) . La liste des fournisseurs disponibles à partir de l’utilitaire de connexion ADO (onglet Fournisseur) peut être différente d’un ordinateur à l’autre, selon la version de Windows utilisée, les logiciels installés ainsi que la version de ADO utilisée. Tel qu’indiqué précédemment, veuillez visiter la section ADO du site web de Microsoft à l’adresse http://www.microsoft.com/data/ pour plus d’informations et/ou télécharger la dernière mise à jour du MDAC. Quelques exemples de fournisseurs qui peuvent être disponibles : Le fournisseur appelé Microsoft Jet 4.0 OLE DB Provider est normalement toujours présent et est utilisé pour accéder aux données de type MS Access, MS Excel, dBase, Lotus, Exchange, Paradox, Text, Html ou tout autre type de données que Microsoft pourrait éventuellement ajouter. Le fournisseur Microsoft OLE DB Provider for SQL server devrait être présent si vous utilisez MS SQL serveur dans votre entreprise et que le logiciel client de MS SQL serveur a été installé sur votre ordinateur. Utilisez ce fournisseur pour accéder à une base de données MS SQL. Le fournisseur Microsoft OLE DB Provider for ODBC Drivers est, normalement, lui aussi toujours présent. Utilisez ce fournisseur pour vous connecter à votre source de données à travers un pilote ODBC.



5

Comme vous pouvez le constater, ADO peut vous permettre d’accéder à la majorité des bases de données existantes sur le marché. Cependant, la configuration de la connexion ADO peut être différente selon le type de votre source de données. Veuillez consulter la documentation spécifique à votre type de source de données pour saisir les paramètres de connexion ADO. Notez également que l’aide de votre administrateur de base de données est fortement conseillée. Lorsque vous avez terminé de saisir les paramètres de votre connexion à l‘aide de l’utilitaire de connexion ADO, utilisez le bouton Tester la connexion pour vérifier la connexion à votre source de données. Si le test de connexion s’exécute avec succès, cliquez sur le bouton OK pour fermer l’utilitaire de connexion ADO et revenir à l’utilitaire d’importation et d’exportation de données. Vous remarquerez que les paramètres saisis à partir de l’utilitaire de connexion ADO seront automatiquement saisis dans la boîte de saisie sous le bouton Sélectionnez la source de données. Cliquez sur le bouton Suivant pour continuer à l’étape 3. Étape 3/8: Sélection de la table à importer Après avoir spécifié la source des données, vous devez maintenant indiquer quelle est la table qui contient les informations à importer. Par exemple, dans le cas d’une base de données relationnelle (comme par exemple Firebird, MS SQL, Oracle, etc.) c’est la liste des tables et des vues de la base de données source qui seront affichées. Dans le cas d’un fichier de feuille de calcul (par exemple Excel ou Lotus), c'est la liste des différentes feuilles du fichier (onglets de la feuille de calcul) qui sera affichée. Sélectionnez la table désirée à partir de la liste déroulante, puis cliquez sur le bouton Suivant pour continuer à l’étape 4. Étape 4/8: Spécifiez la base de données de NewWayService 4 Maintenant que vous avez indiqué quelles sont les données à importer, vous devez spécifier dans quelle base de données de NewWayService 4 vous voulez que les données soient importées. Si vous ne travaillez habituellement qu’avec une seule base de données de NewWayService 4, ses paramètres de connexion seront automatiquement saisis. Si vous avez plusieurs bases de données différentes de NewWayService 4 (comme par exemple une base de données test ainsi qu’une base de données de production), cliquez sur le bouton Sélectionnez une connexion à partir de la liste des connexions existantes et sélectionnez la connexion désirée. Notez que les nom d’usager et mot de passe demandés à cette étape sont les nom d’usager et mot de passe de la base de données Firebird et non un code de technicien et un mot de passe de NewWayService 4. Lors de l’installation initiale de Firebird, le nom d’utilisateur qui a les droits d’administrateur est SYSDBA et le mot de passe est masterkey . Il est important que le mot de passe masterkey soit saisi en lettres minuscules. Normalement, vous n’avez pas à saisir ces informations. En sélectionnant une connexion à partir de la liste des connexions, ces champs sont habituellement saisis de façon automatique. Cliquez ensuite sur le bouton Suivant pour continuer à l’étape 5. Étape 5/8: Code de technicien et mot de passe Pour pouvoir importer des données dans une base de données de NewWayService 4, vous devez obligatoirement avoir les droits d’administrateur si la sécurité de la base de données de NewWayService 4 sélectionnée a été activée. Vous n’avez besoin d'aucun droit si la sécurité de la base de données sélectionnée n’a pas été activée. Dans ce cas, les contrôles seront désactivés. Après avoir saisi un code de technicien de NewWayService 4 qui a les droits d’administrateur ainsi qu’un mot de passe valide, cliquez sur le bouton Suivant pour continuer à l’étape 6. Si la sécurité de la base de données n’a pas été activée, cliquez simplement sur le bouton Suivant pour continuer à l’étape 6.



6

Étape 6/8: Sélectionnez le module où seront importées les données Tel qu’indiqué précédemment, des données peuvent être importées dans les modules suivants : - Produits - Clients - Numéros de série - Pièces de rechange - Articles (Base de connaissance) - Fournisseurs Sélectionnez le module où vous désirez que les données soient importées puis cliquez sur le bouton Suivant pour continuer à l’étape 7. Tel qu’indiqué précédemment, puisque l’ajout de bons de travail est un processus qui demande de nombreuses validations, vous ne pouvez importer des bons de travail dans NewWayService 4. Veuillez cependant noter que les utilisateurs de NewWayService 3 peuvent utiliser l’utilitaire de transfert des données de NewWayService 3 vers NewWayService 4 inclus avec NewWayService 4 pour transférer toutes leurs données vers NewWayService 4, d’un simple clic de souris. Un utilitaire de transfert des données de NewWayService 2 vers NewWayService 4 est également inclus avec NewWayService 4. Importation de données dans le module Produits : Lors de l’importation de produits, assurez-vous que le code de produit ainsi que la description de chaque produit importé ait une valeur. Un produit sans code ou sans description sera automatiquement rejeté. D’autres champs sont obligatoires, mais vous remarquerez que vous pouvez leur attribuer une valeur par défaut à partir de la liste déroulante. De plus, chaque produit importé doit avoir un code de produit unique. Si la liste de produits que vous désirez importer ne comportent pas un code de produit unique, vous pouvez sélectionner l’option >> Générer automatiquement << . Cette option tentera de générer un code de produit unique pour chaque produit importé. Cependant, n’utilisez pas cette option si vous prévoyez, par la suite, importer des numéros de série qui seront reliés à ces produits. Importation de données dans le module Clients : Lors de l’importation de clients, assurez-vous que le code de client ainsi que le nom de chaque client importé ait une valeur. Un client sans code ou sans nom sera automatiquement rejeté. D’autres champs sont obligatoires, mais vous remarquerez que vous pouvez leur attribuer une valeur par défaut à partir de la liste déroulante. De plus, chaque client importé doit avoir un code de client unique. Si la liste de clients que vous désirez importer ne comportent pas un code de client unique, vous pouvez sélectionner l’option >> Générer automatiquement << . Cette option tentera de générer un code de client unique pour chaque client importé. Cependant, n’utilisez pas cette option si vous prévoyez, par la suite, importer des numéros de série qui seront reliés à ces clients. Importation de données dans le module Numéros de série : Lors de l’importation de numéros de série, trois champs sont obligatoires soit le code de produit, le code de client ainsi que le numéro de série. D’autres champs sont obligatoires, mais vous remarquerez que vous pouvez leur attribuer une valeur par défaut à partir de la liste déroulante.



7

Pour chaque enregistrement importé, le code de produit ainsi que le code de client doit correspondre à un code de produit et un code de client existant dans la base de données. De plus, chaque enregistrement importé doit avoir un numéro de série unique. Par exemple, si vous n’avez qu’un fichier à importer, contenant à la fois les informations sur vos produits, vos clients ainsi que les numéros de série vendus, commencez par importer vos produits et vos clients. Ensuite, vous pourrez importer vos numéros de série, puisqu’un code de produit et de client existera déjà dans la base de données pour chaque numéro de série importé. Ne jamais utiliser l’option >> Générer automatiquement << lors de l’importation de produits ou de clients si vous prévoyez, pas la suite, importer des numéros de série. Importation de données dans le module Pièces de rechange : Lors de l’importation de pièces de rechange, assurez-vous que le code de pièce ainsi que la description de chaque pièce importée ait une valeur. Une pièce sans code ou sans description sera automatiquement rejetée. D’autres champs sont obligatoires, mais vous remarquerez que vous pouvez leur attribuer une valeur par défaut à partir de la liste déroulante. De plus, chaque pièce importée doit avoir un code de pièce unique. Si la liste des pièces que vous désirez importer ne comportent pas un code de pièce unique, vous pouvez sélectionnez l’option >> Générer automatiquement << . Cette option tentera de générer un code de pièce unique pour chaque pièce importée. Importation de données dans le module Articles (Base de connaissance) : Lors de l’importation d’articles, assurez-vous que le code de l’article ainsi que le titre de chaque article importé ait une valeur. Un article sans code ou sans titre sera automatiquement rejeté. D’autres champs sont obligatoires, mais vous remarquerez que vous pouvez leur attribuer une valeur par défaut à partir de la liste déroulante. De plus, chaque article importé doit avoir un code d’article unique. Si la liste des articles que vous désirez importer ne comportent pas un code d’article, vous pouvez sélectionner l’option >> Générer automatiquement << . Cette option tentera de générer un code d’article unique pour chaque article importé. Importation de données dans le module Fournisseurs : Lors de l’importation de fournisseurs, assurez-vous que le code de fournisseur ainsi que le nom de chaque fournisseur importé ait une valeur. Un fournisseur sans code ou sans nom sera automatiquement rejeté. D’autres champs sont obligatoires, mais vous remarquerez que vous pouvez leur attribuer une valeur par défaut à partir de la liste déroulante. De plus, chaque fournisseur importé doit avoir un code de fournisseur unique. Si la liste de fournisseur que vous désirez importer ne comportent pas un code de fournisseur unique, vous pouvez sélectionner l’option >> Générer automatiquement << . Cette option tentera de générer un code de fournisseur unique pour chaque fournisseur importé. Étape 7/8: Association des champs source aux champs destination Maintenant, vous devez spécifier quel champ de la table source sera transféré pour chaque champ du module destination. Lorsque vous avez terminé d’associer chaque champ, cliquez sur le bouton Suivant pour continuer à l’étape 8. A droite de l’écran, vous retrouvez tous les champs disponibles du module destination choisi, ainsi que leurs types entre parenthèses. Les champs précédés d’une étoile (*) indiquent que ces champs sont obligatoires.



8

La partie de gauche contient une liste déroulante pour chaque champ destination. C’est à partir de cette liste déroulante que vous devez spécifier quel champ source sera associé à chaque champ destination. Chaque liste déroulante contient la liste des champs sources (précédés par le mot Field_) ainsi que leurs types entre parenthèses. De plus, chaque liste déroulante peut contenir les différentes options suivantes : >> Générer automatiquement << Cette option n’est disponible que pour les champs code produit, code client, code de pièce de rechange et code d’article. Utilisez cette option si vous importez, par exemple, une liste de produits et que les produits importés n’ont pas de code de produit unique. En sélectionnant cette option, l’utilitaire d’importation et d’exportation de données tentera de générer un code de produit unique pour chaque produit importé. Veuillez cependant noter qu’il est préférable d’importer une liste d’enregistrements avec un code unique pour chaque enregistrement plutôt que d’utiliser cette option. >> Utiliser Script << Cette option vous permet d’écrire votre propre script en langage Pascal Objet au lieu de tout simplement associer un champ source à un champ destination. Exemple : Vous désirez importer des données dans le module Clients. Dans votre table source vous avez les quatre champs suivants : Adresse 1, Adresse 2 , Ville et Code postal. Cependant, dans le module Clients de NewWayService 4, seul un champ est nécessaire pour y saisir toutes vos informations sur l’adresse d’un client. Étant donné qu’à l’aide de la liste déroulante vous ne pouvez que sélectionner un champ source pour chaque champ destination, vous ne pouvez indiquer que vous désirez que les quatre champs sources mentionnés soient associés à un seul champ destination, soit le champ Adresse du module client. Pour corriger ce genre de problème, vous pouvez utiliser un script au lieu de simplement associer un champ source à un champ destination. En sélectionnant l’option >> Utiliser Script <<, le bouton Script… à droite de la liste déroulante devient actif. Cliquez sur ce bouton pour pouvoir y saisir votre script. Voici l’exemple d’un script qui indique à l’utilitaire d’importation et d’exportation de données d’associer les champs source Adresse 1, Adresse 2, Ville et Code postal au champ destination Adresse du module Clients. : begin ImportValue := Field_Adresse1 + #13#10 + Field_Adresse2 + #13#10 + Field_Ville + ' ' + Field_CodePostal; end;

Le champ Adresse du module Clients de NewWayService 4 est un champ de type Mémo. Un champ de type Mémo permet à l’utilisateur de saisir plusieurs lignes de texte. Ainsi, vous remarquerez que les



9

caractères #13#10 ont été utilisés dans ce script. Ceci indique de faire un retour de chariot entre certains champs pour pouvoir disposer l’information sur plusieurs lignes. Par exemple, si le champ Adresse 1 avait comme valeur 99, boul. Demers, le champ Adresse 2 Suite #123, le champ Ville Montréal et le champ Code postal H3A 1Y2, le résultat obtenu serait : 99, boul. Demers Suite #123 Montréal H3A 1Y2 Pour plus de détails sur l’utilisation de scripts, référez-vous aux sections Utilisation de scripts à l'aide du langage Pascal Objet et Référence du langage Pascal Objet. >> Ne pas importer << Sélectionnez cette option si vous ne voulez rien assigner à certains champs du module destination. Statuts, catégories et zones En plus des options mentionnées précédemment, chaque liste déroulante peut contenir dans certains cas la liste des statuts (Actif et Inactif), la liste des catégories de client, de produit, de pièce de rechange d’article ainsi que la liste des zones correspondant à la base de données de NewWayService 4 sélectionnée. Par exemple, lors de l’importation de données vers le module Clients, la liste déroulante correspondant au champ destination Code de catégorie contiendrait, en plus, la liste de toutes les catégories de client disponibles dans la base de données. Ainsi, vous pourriez sélectionner directement une catégorie de client existante pour ce champ. Étape 8/8: Derniers paramètres et démarrage de l'importation Cette étape est la dernière étape avant de démarrer l’importation de données. Indiquez ici si vous désirez effacer tous les enregistrements du module destination avant de débuter l’importation. Notez que si vous cochez cette option, seuls les enregistrements qui ne sont liés à aucun bon de travail ou aucun autre modules seront effacés. Les autres enregistrements ne seront pas effacés. Par exemple, si vous importez une liste de clients dans le module clients et que vous cochez l’option Effacer tous les clients existants avant l’importation, les clients qui sont associés à des bons de travail, des numéros de série, des documents, ou autres modules ne seront pas effacés. Vous devez aussi indiquer quoi faire lorsqu’un enregistrement dont le code existe déjà dans la base de données est rencontré. Ensuite, si vous voulez sauvegarder tous les paramètres que vous avez saisis pour cette importation, cochez l’option Sauvegarder les paramètres de cette importation pour une utilisation ultérieure et saisissez un nom de fichier où seront sauvegardées les informations. Cette fonction est également utile si vous désirez automatiser l’importation de données à partir d’un fichier de commandes (fichier BATCH) ou d’un logiciel de planification de tâches. Référez-vous à la section Importations et exportations automatisées pour plus d’informations sur ce sujet.



10

Cliquez maintenant sur le bouton Démarrer l’importation pour importer vos données. Lors de l’importation, si des erreurs sont rencontrées, elles seront affichées à l’écran. De plus, un sommaire sur l’importation sera également affiché à l’écran à la fin de l’opération. Veuillez noter que vous pouvez arrêter une importation de données en tout temps en cliquant sur le bouton Arrêter. Si vous arrêtez une importation avant qu'elle ne soit terminée, aucune information ne sera enregistrée dans la base de données. Si des erreurs sont rencontrées pendant l’importation, veuillez changer vos paramètres d’importation et redémarrez celle-ci. Dans la plupart des cas, le genre d’erreurs rencontrées sont des erreurs de données. Voici quelques erreurs fréquemment rencontrées : - Type de données incompatible (Ex. : Tentative d’associer une chaîne de caractères à un champ de type

Date ou Entier). - Valeur hors de portée (Ex. : Tentative d’associer une valeur autre que 0 (Inactif) ou 1 (Actif) à un champ

Statut ou association d’un code de catégorie inexistant dans la base de données pour un champ catégorie).

- Erreur dans un script ce qui cause le rejet de l’enregistrement. L’utilitaire d’importation et d’exportation de données pour NewWayService 4 est très flexible et très puissant, principalement à cause des nombreuses possibilités qu’offre l’utilisation de scripts. De plus, l’utilisation du système d’accès aux données ADO rend possible l’accès à la plupart des types de base de données disponibles sur le marché. Ainsi, puisqu'une multitude de possibilités sont offertes à travers cet utilitaire, toutes les possibilités ne peuvent être testées. Si éprouvez des difficultés à accéder à certains types de données, nous vous conseillons de vérifier vos paramètres de connexion à votre base de données et de vous référer à la documentation de la base de données à laquelle vous tentez d’accéder. Après ces vérifications, si vous éprouvez toujours des problèmes, référez-vous à la section Support technique de Guide d'utilisation de NewWayService 4 pour savoir comment obtenir du support. Il est cependant important de noter qu'étant donné le grand nombre de bases de données différentes, disponibles sur le marché, nous ne pouvons certifier que l’utilitaire d’importation et d’exportation de données sera à 100% compatible avec chacune d'entre elles.

Exportation de données


11

Exportation de données Introduction à l'exportation de données Cette section vous explique comment exporter des données de NewWayService 4 vers un fichier ou une base de données. Il n’y a pas de limite au niveau de l’exportation de données. Toutes les données disponibles dans une base de données de NewWayService 4 sont exportables. Veuillez noter qu’en plus des possibilités d’exportation que vous offre l’utilitaire d’importation et d’exportation de données, tous les rapports de NewWayService 4 sont aussi exportables dans différents formats de fichier. Référez-vous au document Générateur de rapports pour NewWayService 4 pour plus d’informations sur la façon d’exporter des rapports.

Exporter des données, étapes par étape Étape 1/8: Que voulez-vous faire ? Cette étape vous permet de charger un fichier contenant des paramètres d’exportation que vous avez créé puis sauvegardé lors d’une exportation antérieure. Ceci est très utile lorsque exportez toujours les mêmes données, sur une base régulière. Ceci vous évite d'avoir à saisir les paramètres d’exportation à chaque fois. Si c’est la première fois que vous exportez des données à l’aide de cet utilitaire, sélectionnez Démarrer une nouvelle exportation de données puis cliquez sur le bouton Suivant pour continuer à l’étape 2. Si vous voulez charger les paramètres d’une exportation antérieure, sélectionnez Exporter des données à partir de paramètres précédemment sauvegardés. Sélectionnez le fichier contenant les paramètres à l’aide du bouton … puis cliquez sur le bouton Suivant pour continuer à l’étape 2. Étape 2/8: Spécifiez la base de données de NewWayService 4 Vous devez spécifier à partir de quelle base de données de NewWayService 4, les données seront exportées. Si vous ne travaillez habituellement qu’avec une seule base de données de NewWayService 4, ses paramètres de connexion seront automatiquement saisis. Si vous avez plusieurs bases de données différentes de NewWayService 4 (comme par exemple une base de données test ainsi qu’une base de données de production), cliquez sur le bouton Sélectionnez une connexion à partir de la liste des connexions existantes et sélectionnez la connexion désirée.



12

Notez que les nom d’usager ainsi que le mot de passe, demandés à cette étape, sont un nom d’usager et mot de passe de la base de données Firebird et non un code de technicien et un mot de passe de NewWayService 4. Lors de l’installation initiale de Firebird, le nom d’utilisateur ayant les droits d’administrateur est SYSDBA et le mot de passe est masterkey . Il est important que le mot de passe masterkey soit saisi en lettres minuscules. Normalement, vous n’avez pas à saisir ces informations. En sélectionnant une connexion à partir de la liste des connexions, ces champs sont habituellement saisis de façon automatique. Cliquez ensuite sur le bouton Suivant pour continuer à l’étape 3. Étape 3/8: Code de technicien et mot de passe Pour pouvoir exporter des données à partir d’une base de données de NewWayService 4, vous devez obligatoirement avoir les droits d’administrateur si la sécurité de la base de données de NewWayService 4 sélectionnée a été activée. Vous n’avez besoin d'aucun droit si la sécurité de la base de données sélectionnée n’a pas été activée. Dans ce cas, les contrôles seront désactivés. Après avoir saisi un code de technicien de NewWayService 4 ayant les droits d’administrateur ainsi qu’un mot de passe valide, cliquez sur le bouton Suivant pour continuer à l’étape 4. Si la sécurité de la base de données n’a pas été activée, cliquez simplement sur le bouton Suivant pour continuer à l’étape 4. Étape 4/8: Sélection des données à exporter A cette étape, vous devez spécifier les données que vous désirez exporter (par exemple, la liste des clients). La sélection des données à exporter s’effectue à l’aide d’une requête SQL. SQL (Structured Query Language ) est un langage universel, utilisé pour communiquer avec une base de données. Le SQL est un langage simple. Cependant, si vous n’êtes pas familier avec celui-ci, et que vous désirez créer vos propres requêtes pour l’exportation de données, nous vous conseillons de vous référer à un des nombreux ouvrages sur ce sujet. Si vous ne connaissez pas le langage SQL, ceci ne pose pas un problème. Plusieurs requêtes SQL pour l’exportation de données sont déjà incluses avec l’utilitaire d’importation et d’exportation de données. Cliquez sur le bouton Sélection d’une requête prédéfinie puis sélectionnez une requête dans la liste. Voici quelques unes des requêtes déjà incluses : Clients.sql Utilisez cette requête pour exporter la liste des clients. Produits.slq Utilisez cette requête pour exporter la liste des produits. Bons_Travail.sql Utilisez cette requête pour exporter la liste des bons de travail. Actions.sql Utilisez cette requête pour exporter la liste des actions de chaque bon de travail. Si vous le désirez, vous pouvez modifier une requête prédéfinie et l’ajuster selon vos besoins. Par exemple, la requête suivante indique que vous désirez exporter le code ainsi que la description de vos produits : SELECT PROCODDES, PRODES FROM PRO; En utilisant cette requête, tous les produits seront inclus dans la requête. En ajoutant une condition à cette requête, vous pouvez indiquer que vous ne désirez que les produits actifs : SELECT PROCODDES, PRODES FROM PRO WHERE PROSTA = 1; Pour vérifier que votre requête fonctionne correctement et qu'elle extrait l’information désirée, cliquez sur le bouton Tester la requête. Si la requête s’exécute correctement, son résultat sera affiché dans la grille plus bas, sinon un message d’erreur s’affichera à l’écran, indiquant que la requête ne peut être exécutée.



13

Vous pouvez cliquez sur le bouton Plus d’info…>> pour connaître exactement le problème rencontré lors de l’exécution. Lorsque vous avez terminé de saisir votre requête et que le test s’est effectué correctement, cliquez sur le bouton Suivant pour continuer à l’étape 5. Étape 5/8: Sélection de la destination des données à exporter Cette étape vous permet de spécifier où seront sauvegardées les données que vous désirez exporter. Si vous désirez exporter vos données vers un fichier au format MS Access, dBase ou MS Excel, veuillez tout simplement sélectionner le fichier à l’aide du bouton … puis cliquez sur Suivant pour continuer à l’étape 6. Veuillez noter que si le fichier sélectionné n’existe pas, il sera automatiquement créé lors de l’exportation. De plus, vous pouvez spécifier un format de fichier spécifique à l’aide de la liste déroulante. Par exemple, pour un fichier MS Access, vous avez le choix de créer un fichier MS Access 2000, MS Access 97, MS Access 7.0 ou MS Access 2.0. Même chose si vous voulez exporter vos données vers un fichier qui existe déjà, vous pouvez spécifier le type exact du fichier à accéder. Si vous voulez exporter vos données vers un autre format de fichier, ou vers une base de données plus évoluée, sélectionnez l’option une autre destination (Autres types de fichier, Bases de données SQL ODBC, etc.). Veuillez notez que dans ce cas, la destination où seront exportées les données doit exister. Ensuite, cliquez sur le bouton Sélectionnez la destination des données pour faire apparaître l’utilitaire de connexion ADO, puis cliquez sur le bouton Build pour accéder à ses différents onglets.

L’utilitaire de connexion ADO peut être différent selon la version de ADO et/ou Windows que vous utilisez. À partir de cet utilitaire, sélectionnez le type des données auxquelles vous désirez accéder (normalement à partir de l’onglet Fournisseur) puis saisissez les paramètres de connexion spécifiques à votre destination (normalement onglet Connexion) . La liste des fournisseurs disponibles à partir de l’utilitaire de connexion ADO (onglet Fournisseur) peut être différente d’un ordinateur à l’autre, selon la version de Windows utilisée, les logiciels installés ainsi que la version de ADO utilisée. Tel qu’indiqué précédemment, veuillez visiter la section ADO du site web de Microsoft à l’adresse http://www.microsoft.com/data/ pour plus d’informations et/ou télécharger la dernière mise à jour du MDAC. Quelques exemples de fournisseurs qui peuvent être disponibles :



14

Le fournisseur appelé Microsoft Jet 4.0 OLE DB Provider est normalement toujours présent et est utilisé pour exporter des données vers des fichiers de type MS Access, MS Excel, dBase, Lotus, Exchange, Paradox, Text, Html ou tout autre type de données que Microsoft pourrait éventuellement ajouter. Le fournisseur Microsoft OLE DB Provider for SQL server devrait être présent si vous utilisez MS SQL serveur dans votre entreprise et que le logiciel client de MS SQL serveur a été installé sur votre ordinateur. Utilisez ce fournisseur pour exporter vos données vers une base de données MS SQL. Le fournisseur Microsoft OLE DB Provider for ODBC Drivers est normalement lui aussi toujours présent. Utilisez ce fournisseur pour exporter vos données vers une base de données à laquelle vous voulez accéder à travers un pilote ODBC. Comme vous pouvez le constater, ADO peut vous permettre d’exporter vos données vers la majorité des bases de données existantes sur le marché. Cependant, la configuration de la connexion ADO peut être différente, selon le type de données à accéder. Veuillez consulter la documentation spécifique à votre type de données pour saisir les paramètres de connexion ADO. Notez également que l’aide de votre administrateur de base de données est fortement conseillée. Lorsque vous avez terminé de saisir les paramètres de votre connexion à l‘aide de l’utilitaire de connexion ADO, utilisez le bouton Tester la connexion pour vérifier la connexion à votre base de données. Si le test de connexion s’exécute avec succès, cliquez sur le bouton OK pour fermer l’utilitaire de connexion ADO et revenir à l’utilitaire d’importation et d’exportation de données. Vous remarquerez que les paramètres saisis à partir de l’utilitaire de connexion ADO seront automatiquement saisis dans la boîte de saisie sous le bouton Sélectionnez la destination des données. Cliquez sur le bouton Suivant pour continuer à l’étape 6. Étape 6/8: Sélection de la table destination Après avoir spécifié votre destination, vous devez indiquer vers quelle table les données seront exportées. Par exemple, dans le cas d’une base de données relationnelle (comme par exemple Firebird, MS SQL, Oracle, etc.) c’est la liste des tables de la base de données destination qui sera affichée. Dans le cas d’un fichier de feuille de calcul (par exemple Excel), c'est la liste des différentes feuilles du fichier (onglets de la feuille de calcul) qui sera affichée. Veuillez noter que si vous exportez vos données vers un fichier MS Access, dBase ou MS Excel, si vous spécifiez un nom de table qui n'existe pas, la structure de la table créée contiendra la liste des champs de votre requête SQL. Sélectionnez la table où seront exportées les données à partir de la liste déroulante, puis cliquez sur le bouton Suivant pour continuer à l’étape 7. Étape 7/8: Association des champs sources aux champs destinations Maintenant, vous devez spécifier quel champ de la requête source sera transféré pour chaque champ de la table destination. Lorsque vous avez terminé d’associer chaque champ, cliquez sur le bouton Suivant pour continuer à l’étape 8. À droite de l’écran, vous retrouvez tous les champs disponibles de la table destination que vous avez choisie ainsi que leurs types, entre parenthèse.



15

La partie de gauche contient une liste déroulante pour chaque champ destination. C’est à partir de cette liste déroulante que vous devez spécifier quel champ source sera associé à chaque champ destination. Chaque liste déroulante contient la liste des champs de la requête que vous avez saisie à l’étape 4 (précédé par le mot Field_) ainsi que leurs types, entre parenthèse. De plus, chaque liste déroulante peut contenir les différentes options suivantes : >> Utiliser Script << Cette option vous permet d’écrire votre propre script en langage Pascal Objet au lieu de tout simplement associer un champ source à un champ destination. Exemple : Vous désirez exporter la liste des clients. Dans votre requête d’exportation, vous avez le champ CUSSTA qui indique le statut du client, soit la valeur 0 si le client est inactif et la valeur 1 si le client est actif. Cependant, dans votre table destination, vous désirez inscrire dans le champ statut AC si le client est actif et IN si le client est inactif. Puisqu’à l’aide de la liste déroulante, vous ne pouvez obtenir ce résultat, vous pouvez, à la place, utiliser un script pour obtenir le résultat désiré. En sélectionnant l’option >> Utiliser Script <<, le bouton Script… à droite de la liste déroulante devient actif. Cliquez sur ce bouton pour pouvoir y saisir votre script. Voici l’exemple d’un script qui indique à l’utilitaire d’importation et d’exportation de données d’associer AC pour les clients actif et IN pour les clients inactifs, au champ statut de la table destination : begin If Field_CUSSTA = 1 Then ExportValue := 'AC' Else ExportValue := 'IN'; end;

Pour plus de détails sur l’utilisation de scripts, référez-vous aux sections Utilisation de scripts à l'aide du langage Pascal Objet et Référence du langage Pascal Objet . >> Ne pas exporter << Sélectionnez cette option si vous ne voulez rien assigner à certains champs de la table destination. Étape 8/8: Derniers paramètres et démarrage de l'exportation Cette étape est la dernière étape avant de démarrer l’exportation de données. Vous pouvez indiquer ici d’effacer tous les enregistrements de la table destination avant de procéder à l’exportation. Si vous ne voulez pas effacer tous les enregistrements avant l’importation, vous pouvez sélectionner l’une des 3 options suivantes :



16

Ajouter à la suite des enregistrements Si vous sélectionnez cette option, les enregistrements exportés seront tout simplement ajoutés à la suite des enregistrements existants de la table destination. Ajouter à la suite mais mettre à jour les enregistrements existants qui correspondent à la clé. Si vous sélectionnez cette option, les enregistrements exportés, dont la valeur du ou des champs clé sélectionnés n’existe pas dans la table destination, seront ajoutés à la suite des enregistrements existants. Si la valeur du ou des champs clé est trouvée, les informations de l’enregistrement trouvé seront mises à jour. Si vous sélectionnez cette option, vous devez sélectionner au moins un champ clé qui sera utilisé pour vérifier si l’enregistrement existe dans la table destination. Si vous sélectionnez plus d'un champ, tous les champs sélectionnés constitueront la clé. Seulement mettre à jour les enregistrements existants qui correspondent à la clé. Si vous sélectionnez cette option, seuls les enregistrements exportés dont la valeur du ou des champs clé sélectionnés existe dans la table destination seront mis à jour. Aucun nouvel enregistrement ne sera ajouté. Si vous sélectionnez cette option, vous devez sélectionner au moins un champ clé qui sera utilisé pour vérifier si l’enregistrement existe dans la table destination. Si vous sélectionnez plus d'un champ, tous les champs sélectionnés constitueront la clé. Si vous voulez sauvegarder tous les paramètres que vous avez saisis pour cette exportation, cochez l’option Sauvegarder les paramètres de cette exportation pour une utilisation ultérieure et saisissez un nom de fichier où seront sauvegarder les informations. Cette option est aussi utile si vous désirez automatiser l’exportation de données à partir d’un fichier de commandes (fichier BATCH) ou d’un logiciel de planification de tâches. Référez-vous à la section Importations et exportations automatisées pour plus d’informations sur ce sujet.

Cliquez maintenant sur le bouton Démarrer l’exportation pour exporter vos données. Lors de l’exportation, si des erreurs sont rencontrées, elles seront affichées à l’écran. De plus, un sommaire sur l’exportation sera aussi affiché à l’écran à la fin de l’opération. Veuillez noter que vous pouvez arrêter une exportation de données en tout temps, en cliquant sur le bouton Arrêter. Si vous arrêtez une exportation avant qu'elle ne soit terminée, l’utilitaire d’importation et d’exportation de données tentera d’annuler les modifications apportées à la table destination en renversant la transaction. IMPORTANT : Si votre base de données destination supporte les transactions (comme par exemple Firebird, MS SQL, Oracle) , si vous arrêtez manuellement l’exportation, les modifications devraient automatiquement êtres annulées. Cependant, si votre base de données destination ne supporte pas les transactions (par exemple un fichier MS Access ou un fichier MS Excel) les enregistrements déjà ajoutés et/ou mis à jour ne pourront être annulés.



17

Si des erreurs sont rencontrées pendant l’exportation, veuillez changer vos paramètres d’exportation et redémarrez-la. Dans la plupart des cas, les erreurs rencontrées sont des erreurs de données. Voici quelques erreurs fréquemment rencontrées : - Type de données incompatible (Ex. : Tentative d’associer une chaîne de caractères à un champ de type

Date ou Entier). - Erreur dans un script ce qui cause le rejet de l’enregistrement. L’utilitaire d’importation et d’exportation de données pour NewWayService 4 est très flexible et très puissant surtout à cause des nombreuses possibilités qu’offre l’utilisation de scripts. De plus, l’utilisation du système d’accès aux données ADO rend possible l’accès à la plupart des types de bases de données disponibles sur le marché. Ainsi, puisqu'une multitude de possibilités sont disponibles à travers cet utilitaire, toutes les possibilités ne peuvent être testées. Si éprouvez des difficultés à accéder à certains types de données, nous vous conseillons de vérifier vos paramètres de connexion à votre base de données et de vous référez à la documentation de la base de données à laquelle vous tentez d’accéder. Après ces vérifications, si vous éprouvez toujours des problèmes, référez-vous à la section Support technique de Guide d'utilisation de NewWayService 4 pour savoir comment obtenir du support. Cependant, il est important de noter qu'étant donné le grand nombre de bases de données différentes, disponibles sur le marché, nous ne pouvons certifier que l’utilitaire d’importation et d’exportation de données sera à 100% compatible avec chacune de ces bases de données.

Utilisation de scripts à l'aide du langage Pascal Objet


18

Utilisation de scripts à l'aide du langage Pascal Objet Tel que discuté brièvement dans les sections Importation de données et Exportation de données, il est possible d’écrire des scripts pour combler certains besoins précis comme par exemple, le formatage de champs, la concaténation de champs, etc. Les scripts n’ont généralement qu’une ou quelque lignes de code. Cependant, dans certains cas, il pourrait arriver que vous ayez besoin d’écrire des scripts de plusieurs lignes.

Vous pouvez saisir un script différent pour chaque champ à importer ou exporter. Chaque script de chaque champ est exécuté à chaque enregistrement exporté ou importé. Exemple: Vous désirez importer une liste de 50 clients. Pour la plupart des champs, vous décidez d’associer tout simplement un champ de votre table source à un champ de votre module destination, mais pour le champ Adresse du module destination, vous décidez d’utiliser un script. Puisque vous avez 50 clients (donc 50 enregistrements) à importer, le script que vous avez saisi pour le champ Adresse sera exécuté 50 fois, soit une fois pour chaque enregistrement. Voici les principales informations nécessaires à l’écriture de script à l’aide du langage Pascal Objet. Si vous n’êtes pas familier avec les notions de programmation générales, il est conseillé de vous faire aider par quelqu’un qui a des notions de programmation. Ce chapitre n’est pas un cours de programmation en langage Pascal Objet mais plutôt les lignes directrices à connaître pour pouvoir écrire des scripts qui fonctionneront correctement avec l’utilitaire d’importation et d’exportation de données. Pour plus d’informations sur le langage Pascal Objet, référez-vous à la section Référence du langage Pascal Objet ci-dessous. Éditeur de script L’éditeur de script apparaît lorsque vous cliquez sur le bouton Script, situé à côté d’un champ à l’étape 7 de l’importation ou l’exportation de données. Saisissez votre script dans la boîte de saisie prévue à cet effet. Vous remarquerez certains onglets. L’onglet Champs sources contient la liste des champs sources disponibles lors d’une importation ou exportation de données. L’onglet Variables contient certaines variables utiles pour l’écriture de vos scripts (Voir la section Les variables disponibles ci-dessous). Lors de l’écriture de vos scripts, vous n’êtes pas obligé de saisir manuellement le nom des champs sources ou des variables. Vous pouvez, tout simplement, positionner le curseur dans la boîte de saisie, à l’endroit



19

où vous désirez saisir le nom du champ ou de la variable. Cliquez ensuite sur le champ ou la variable désiré, glissez la souris vers la boîte de saisie (glisser-déplacer) puis relâchez l’objet sélectionné. Le nom du champ ou de la variable sera automatiquement saisi à la position du curseur. Si vous avez sélectionné du texte dans l’éditeur, il est automatiquement remplacé. Lorsque vous avez terminé de saisir votre script, vous pouvez cliquer sur le bouton Vérifier la syntaxe pour vérifier que le script ne comporte pas d’erreur. Cliquez sur le bouton OK pour enregistrer vos modifications et quitter l’éditeur de script ou sinon, cliquez sur le bouton Annuler pour quitter l’éditeur de script et ne pas enregistrer vos changements. Syntaxe générale Un script commence toujours par le mot begin et se termine toujours par le mot end; (le point-virgule qui suit le mot end est important et doit être présent). De plus, chaque ligne de code doit se terminer par le caractère ; . Exemple 1: begin ImportValue := Trim(Field_CustomerName); end; Vous pouvez déclarer des variables dans un script à l’aide du mot var . Le mot var doit précéder le mot begin . Vous pouvez également déclarer des constantes à l’aide du mot const . Le mot const doit précéder le mot var si vous y déclarez des variables ou précéder le mot begin dans le cas contraire. Exemple 2: var NomCLient: String; begin NomCLient := Trim(Field_Nom); ImportValue := NomClient; end;

Exemple 3 : const RETOUR_A_LA_LIGNE = #13#10; var Adresse: String; begin Adresse := Field_Adresse1 + RETOUR_A_LA_LIGNE + Field_Ville + RETOUR_A_LA_LIGNE + Field_CodePostal; ImportValue := Adresse; end;

Vous pouvez déclarer des procédures ou des fonctions dans un script à l’aide des mots procedure et function . Exemple 4 :



20

Function StatutTexte: String; begin If Field_CUSSTA = 1 Then Result := 'Actif' Else Result := 'Inactif'; end; var MonStatut: String; begin MonStatut := StatutTexte; ExportValue := MonStatut; end; Les variables disponibles : Lors de l’écriture de script, certaines variables sont déjà présentes dont : La variable RecordNumber de type Entier (Integer) indique le numéro d’enregistrement en cours de traitement. La valeur de cette variable est 1 pour le premier enregistrement, 2 pour le deuxième, etc. La variable SkipRecord de type Booléen (Boolean) vous permet de décider si vous désirez passer un enregistrement spécifique lors de l’importation ou l’exportation de données. La valeur par défaut de cette variable est False (Faux) ce qui indique de ne pas passer cet enregistrement (donc l’enregistrement sera importé ou exporté selon le cas). La variable ImportValue (disponible en importation seulement) est utilisée pour indiquer la valeur finale qu’aura votre champ destination lors de l’importation. Le type de cette variable s’ajuste selon le champ à importer. Par exemple, cette variable aura le type Chaîne (String) si vous êtes en cours de traitement d’un champ de type chaîne, le type Entier (Integer) si vous êtes en cours de traitement d’un type Entier et ainsi de suite. Vous devez toujours assigner la valeur finale à cette variable lors de l’écriture d’un script d’importation. La variable ExportValue (disponible en exportation seulement) est utilisée pour indiquer la valeur finale qu’aura votre champ destination lors de l’exportation. Le type de cette variable s’ajuste selon le champ à exporter. Par exemple, cette variable aura le type Chaîne (String) si vous êtes en cours de traitement d’un champ de type chaîne, le type Entier (Integer) si vous êtes en cours de traitement d’un type Entier et ainsi de suite. Vous devez toujours assigner la valeur finale à cette variable lors de l’écriture d’un script d’exportation. L’exemple suivant est un script utilisé lors d’une exportation de la liste des clients. La valeur finale désirée est assignée à la variable ExportValue. De plus, une condition est faite pour vérifier si le client à exporter a le statut 1, soit actif. Si le client est actif, on l’exporte sinon, on ne l’exporte pas. En assignant la valeur True (Vrai) à la variable SkipRecord, ceci indique à l’utilitaire d’importation et d’exportation de données de passer cet enregistrement donc de ne pas l’exporter. Veuillez aussi noter les caractères // dans le script. Ces caractères sont utilisés pour ajouter des lignes de commentaires dans vos script. Ces lignes ne sont pas prises en considération lors de l’exécution du script. begin // Si le client est inactif, on ne l’exporte pas If Field_CUSSTA = 0 Then SkipRecord := True;



21

ExportValue := Field_CUSNAM; end; Plus d’informations Référez-vous à la section Référence du langage Pascal Objet ci-dessous pour plus d’informations sur les éléments du langage Pascal Objet que vous pouvez utiliser pour l’écriture de vos scripts. Pour de l’information sur des principes de programmation généraux, veuillez consulter l’un des nombreux ouvrages sur ce sujet.

Référence du langage Pascal Objet


22

Référence du langage Pascal Objet Vue d’ensemble du langage Pascal Objet Le langage Pascal Objet est un langage dérivé du Pascal et orienté objet. C’est ce langage qui est utilisé avec le logiciel de développement Delphi, du manufacturier de logiciels Borland Corporation. Vous devez utiliser la syntaxe et les éléments du langage Pascal Objet pour écrire des scripts dans l’utilitaire d’importation et d’exportation de données de NewWayService 4. Quoique la plupart des éléments du langage Pascal Objet de Delphi sont reconnus lors de l’écriture de vos scripts, vous retrouverez ci-dessous, les principaux éléments du langage Pascal Objet que vous pouvez utiliser. Veuillez noter que même si le langage Pascal Objet est relativement simple, le présent chapitre n’est qu’une référence aux principaux éléments de ce langage. Si vous n’êtes pas déjà familier avec le langage Pascal Objet, nous vous conseillons de vous référer à l'un des nombreux ouvrages qui traitent du langage Pascal Objet ou du logiciel de développement Delphi. Instructions: Case If–then If–then–else For Repeat While Types de données: Boolean Currency Double Extended Integer Word Single Char String TDateTime Variant Set Array Operateurs: Affectation (:=) Booléen (and, not, or, xor) Classes (as, is) Math (-, +, *, /, div, mod) Relationnel (<, <=, <>, =, >, >=) Chaîne de caractères (+) Unaire (-, +)



23

Routines standards Fonctions de manipulation des chaînes de caractères CompareText Déclaration function CompareText(const S1, S2: String): Integer; Description Compare des chaînes par valeur scalaire sans tenir compte de la distinction minuscules/majuscules. Copy Déclaration function Copy(S: String; Index, Count: Integer): String; Description Renvoie une sous-chaîne d'une chaîne ou un segment de tableau dynamique. Delete Déclaration procedure Delete(var S: String; Index, Count: Integer); Description Supprime une sous-chaîne d'une chaîne s. Insert Déclaration procedure Insert(Source: String; var S: String; Index: Integer); Description Insère une sous-chaîne dans une chaîne commençant au point spécifié. Length Déclaration function Length(S: String): Integer; Description Renvoie le nombre de caractères dans une chaîne ou le nombre d’éléments dans un tableau. LowerCase Déclaration function LowerCase(const S: String): String; Description Convertit une chaîne ASCII en minuscules. Pos Déclaration



24

function Pos(Substr: String; S: String): Integer; Description Renvoie la valeur d'index du premier caractère dans une sous-chaîne spécifiée qui se trouve dans une chaîne. Trim Déclaration function Trim(const S: String): String; Description Supprime les caractères de contrôle et les espaces se trouvant en début et en fin de chaîne. TrimLeft Déclaration function TrimLeft(const S: String): String; Description Efface de la chaîne S les caractères de contrôle et les espaces se trouvant au début de la chaîne. TrimRight Déclaration function TrimRight(const S: String): String; Description Supprime les caractères de contrôle et les espaces se trouvant en fin de chaîne. UpperCase Déclaration function UpperCase(const S: String): String; Description Renvoie une chaîne en majuscules. Fonctions de conversion de données Chr Déclaration function Chr(X: Byte): Char; Description Renvoie le caractère correspondant à une valeur ASCII. CurrToStr Déclaration function CurrToStr(Value: Currency): String; Description Convertit une variable monétaire en chaîne.



25

DateTimeToStr Déclaration function DateTimeToStr(aDateTime: DateTime): String; Description Convertit une variable de type TDateTime en chaîne. DateToStr Déclaration function DateToStr(aDate: Date): String; Description Convertit une variable de type TDateTime en chaîne. FloatToStr Déclaration function FloatToStr(Value: Extended): String; Description Convertit une valeur à virgule flottante en chaîne. IntToStr Déclaration function IntToStr(Value: Integer): String; Description Convertit un entier en chaîne. StrToCurr Déclaration function StrToCurr(const S: String): Currency; Description Convertit un nombre à virgule flottante en une valeur monétaire. StrToDate Déclaration function StrToDate(const S: String): Date; Description Convertit une chaîne en date. StrToDateTime Déclaration function StrToDateTime(const S: String): DateTime; Description Convertit une chaîne en format TDateTime.



26

StrToFloat Déclaration function StrToFloat(const S: String): Extended; Description Convertit une chaîne en une valeur à virgule flottante. StrToInt Déclaration function StrToInt(const S: String): Integer; Description Convertit en nombre une chaîne représentant un entier (décimal ou hexadécimal). StrToTime Déclaration function StrToTime(const S: String): Time; Description Convertit une chaîne en une heure. TimeToStr Déclaration function TimeToStr(aTime: Time): String; Description Renvoie une chaîne depuis une variable TDateTime. Fonctions de Formatage FormatCurr Déclaration function FormatCurr(const Format: String; Value: Currency): String; Description Formate une valeur monétaire. Voir la fonction FormatFloat pour plus d’informations sur les formats supportés. FormatDateTime Déclaration function FormatDateTime(const Format: String; aDateTime: DateTime): String; Description Formate une valeur date/heure. Les spécificateurs de format suivants sont supportés (Référez-vous à l’aide de Windows pour plus d’informations sur les formats date et heure): Spécificateur: C



27

Affiche la date, en utilisant le format date court de Windows, puis l'heure, en utilisant aussi le format défini par Windows. L'heure n'est pas affichée si la partie fractionnaire de DateTime est égale à zéro.

d Affiche le numéro du jour sans le préfixer d'un zéro (1 à 31). dd Affiche le numéro du jour en le préfixant d'un zéro (01 à 31). ddd Affiche le jour abrégé (Dim à Sam). dddd Affiche le jour complet (Dimanche à Samedi). ddddd Affiche la date en utilisant le format de date court fourni par Windows. dddddd Affiche la date en utilisant le format de date long fourni par Windows. m Affiche le numéro du mois sans le préfixer d'un zéro (1 à 12). Si le spécificateur m suit immédiatement un spécificateur h ou hh, les minutes sont affichées plutôt que le numéro du mois. mm Affiche le numéro du mois en le préfixant d'un zéro (01 à 12). Si le spécificateur m suit immédiatement un spécificateur h ou hh, les minutes sont affichées plutôt que le numéro du mois. mmm Affiche le mois abrégé (Jan à Déc). mmmm Affiche le mois complet (Janvier à Décembre). yy Affiche le numéro de l'année sous la forme de deux chiffres (00 à 99). yyyy Affiche l'année sous la forme de quatre chiffres (0000-9999). h Affiche l'heure sans la préfixer d'un zéro (0 à 23). hh Affiche l'heure en la préfixant d'un zéro (00 à 23). n Affiche les minutes sans les préfixer d'un zéro (0 à 59). nn Affiche les minutes en les préfixant d'un zéro (00 à 59). s Affiche les secondes sans les préfixer d'un zéro (0 à 59).



28

ss Affiche les secondes en les préfixant d'un zéro (00 à 59). z Affiche les millisecondes sans les préfixer d’un zéro (0-999). zzz Affiche les millisecondes en les préfixant d’un zéro (000-999). t Affiche l'heure en utilisant le format heure courte fourni par Windows. tt Affiche l'heure en utilisant le format heure longue fourni par Windows. am/pm Utilise le format sur 12 heures avec le spécificateur h ou hh qui le précède. Affiche 'am' pour les heures avant midi et 'pm' pour les heures après midi. Le spécificateur am/pm peut utiliser indifféremment les majuscules ou les minuscules. a/p Utilise le format sur 12 heures avec le spécificateur h ou hh qui le précède. Affiche 'a' pour les heures avant midi et 'p' pour les heures après midi. Le spécificateur a/p peut utiliser indifféremment les majuscules ou les minuscules. ampm Utilise le format sur 12 heures avec le spécificateur h ou hh qui le précède. Affiche le contenu du symbole AM de Windows pour les heures avant midi et le contenu du symbole PM de Windows pour les heures après midi. / Affiche le caractère de séparation de date fourni par Windows. : Affiche le séparateur des heures fourni par Windows. 'xx'/"xx" Les caractères compris entre des simples ou doubles guillemets sont affichés tels quels et n'affectent pas le format. Les spécificateurs de format peuvent être indifféremment en majuscules ou en minuscules ; le résultat obtenu est identique. Si la chaîne fournie par le paramètre Format est vide, la date et l'heure sont implicitement formatées avec le spécificateur de format 'c'. Exemple: L’exemple suivant assigne la valeur 'La rencontre sera Mercredi le 15 février 1995 à 10:30 AM' à la variable de type Chaîne S. S := FormatDateTime('"La rencontre sera "dddd "le" d mmmm yyyy " à " hh:mm AM/PM', StrToDateTime('2/15/95 10:30am'));

FormatFloat Déclaration function FormatFloat(const Format: String; Value: Extended): String;



29

Description Formate une valeur à virgule flottante. Les spécificateurs suivants sont supportés (Référez-vous à l’aide de Windows pour plus d’informations sur les formats numériques et monétaires) : 0 Emplacement d'un chiffre. Si la valeur formatée dispose d'un chiffre à la position du '0' dans la chaîne de format, ce chiffre est copié dans la chaîne en sortie. Sinon, un '0' est inclus à cette position dans la chaîne en sortie. # Emplacement d'un chiffre. Si la valeur formatée dispose d'un chiffre à la position du '#' dans la chaîne de format, ce chiffre est copié dans la chaîne en sortie. Sinon, rien n'est inclus à cette position dans la chaîne en sortie. . Séparateur décimal. Le premier caractère '.' dans la chaîne de format détermine l'emplacement du séparateur décimal dans la valeur formatée ; les caractères '.' supplémentaires sont ignorés. Le caractère effectivement utilisé comme séparateur décimal dans la chaîne en sortie est déterminé par séparateur de décimal de Windows défini dans le groupe Format des nombres de la section International du Panneau de configuration Windows. , Séparateur des milliers. Si la chaîne de format contient un ou plusieurs caractères ',', un séparateur des milliers sera inséré entre chaque groupe de trois chiffres situés à gauche de la virgule. L'emplacement et le nombre de caractères ',' dans la chaîne de format n'affectent en rien la sortie ; la présence de ce caractère indique simplement que les milliers doivent être séparés. Le caractère effectivement utilisé comme séparateur de milliers dans la chaîne en sortie est déterminé par le séparateur de milliers de Windows défini dans le groupe Format des nombres de la section International du Panneau de configuration Windows. E+ Notation scientifique. Si l'une des quatre chaînes 'E+', 'E-', 'e+' ou 'e-' est incluse dans la chaîne de format, le nombre est formaté en utilisant la notation scientifique. Un groupe de quatre caractères '0' au plus peut immédiatement suivre la chaîne 'E+', 'E-' 'e+' ou 'e-' afin de déterminer le nombre de chiffres de l'exposant. Les spécificateurs de format 'E+' et 'e+' provoquent l'apparition d'un signe plus pour les exposants positifs et d'un signe moins pour les exposants négatifs. 'E-' et 'e-' ne provoque l'apparition du signe que pour les exposants négatifs. 'xx'/"xx" Les caractères compris entre des guillemets simples ou doubles sont renvoyés tels quels et n'affectent pas le format. ; Sépare les sections des nombres positifs, négatifs et nuls dans la chaîne de format. Les emplacements du '0' le plus à gauche avant la virgule dans la chaîne de format et du '0' le plus à droite après cette même virgule déterminent l'étendue de chiffres qui seront toujours présents dans la chaîne en sortie. Le nombre formaté est toujours arrondi en fonction du nombre de décimales prévues ('0' ou '#') à droite de la virgule dans la chaîne de format. Si cette dernière ne contient pas de séparateur décimal, la valeur formatée est arrondie au nombre entier le plus proche. Si, dans la valeur numérique formatée, le nombre de chiffres à gauche de la virgule est supérieur à celui prévu à gauche du séparateur décimal '.' dans la chaîne de format, les chiffres en trop sont inclus avant l'emplacement du premier chiffre.



30

La chaîne de format peut contenir une, deux ou trois sections séparées par des points-virgules pour autoriser des formats différents pour les valeurs positives, négatives et nulles. - S'il y a une section : la chaîne de format s'applique à toutes les valeurs. - S'il y a deux sections : la première section s'applique aux valeurs positives et nulles et la deuxième aux

valeurs négatives. - S'il y a trois sections : la première section s'applique aux valeurs positives, la deuxième aux valeurs

négatives, et la troisième aux valeurs nulles. Si la section des valeurs négatives ou celle des valeurs nulles est vide (il n'y a rien entre les points-virgules qui délimite cette section), c'est la section des valeurs positives qui est utilisée. Le tableau suivant donne quelques échantillons de formats ainsi que les résultats produits quand ces formats sont appliqués à différentes valeurs : Chaîne de format 1234 -1234 0.5 0 0 1234 -1234 1 0 0.00 1234.00 -1234.00 0.50 0.00 #.## 1234 -1234 .5 #,##0.00 1,234.00 -1,234.00 0.50 0.00 #,##0.00;(#,##0.00) 1,234.00 (1,234.00) 0.50 0.00 #,##0.00;;Zéro 1,234.00 -1,234.00 0.50 Zéro 0.000E+00 1.234E+03 -1.234E+03 5.000E-01 0.000E+00 #.###E-0 1.234E3 -1.234E3 5E-1 0E0 Fonctions Date et heure Date Déclaration function Date: DateTime; Description Renvoie la date courante. DayOfWeek Déclaration function DayOfWeek(aDate: DateTime): Integer; Description Renvoie le jour de la semaine d'une date sous la forme d'un entier compris entre 1 et 7. Dimanche est le premier jour de la semaine et samedi le septième. DecodeDate Déclaration procedure DecodeDate(aDate: DateTime; var Year, Month, Day: Word); Description Sépare la valeur spécifiée par le paramètre Date en valeurs Année, Mois et Jour. Si la valeur TDateTime donnée est inférieure ou égale à zéro, l'année, le mois et le jour renvoient les paramètres initialisés à zéro.



31

DecodeTime Déclaration procedure DecodeTime(aTime: DateTime; var Hour, Min, Sec, MSec: Word); Description Sépare la valeur spécifiée par aTime en heures, minutes, secondes et millisecondes. EncodeDate Déclaration function EncodeDate(Year, Month, Day: Integer): DateTime; Description Renvoie une valeur de type TDateTime à partir des paramètres Year, Month et Day. L'année doit être comprise entre 1 et 9999. Les valeurs Month admises vont de 1 à 12. Les valeurs Day admises vont de 2 à 28, 29, 30 ou 31, selon la valeur de Month. Par exemple, les valeurs possibles de Day pour le mois 2 (février) vont de 1 à 28, ou de 1 à 29 dans le cas d'une année bissextile. EncodeTime Déclaration function EncodeTime(Hour, Min, Sec, MSec: Integer): DateTime; Description Renvoie une valeur de type TDateTime à partir des paramètres Hour, Min, Sec et MSec. Les valeurs admises pour Hour vont de 0 à 12, pour Min et Sec de 0 à 59. MSec doit être comprise entre 0 et 999. Now Déclaration function Now: DateTime; Description Renvoie la date et l’heure courante. Fonctions Mathématique ArcTan Déclaration function ArcTan(X: Extended): Extended; Description Calcule l'arc-tangente de la valeur donnée. Cos Déclaration function Cos(X: Extended): Extended; Description Calcule le cosinus d'un angle.



32

Cosh Déclaration function Cosh(X: Extended): Extended; Description Calcule le cosinus hyperbolique d'un angle. Cotan Déclaration function Cotan(X: Extended): Extended; Description Calcule la cotangente d'un angle. Exp Déclaration function Exp(X: Extended): Extended; Description Renvoie la valeur exponentielle de X. Frac Déclaration function Frac(X: Extended): Extended; Description Renvoie la partie décimale d'un réel. Int Déclaration function Int(X: Extended): Extended; Description Renvoie la partie entière d'un nombre réel. IntPower Déclaration function IntPower(Base: Extended; Exponent: Integer): Extended; Description Calcule Base puissance Exponent. Ln Déclaration function Ln(X: Extended): Extended; Description Renvoie le logarithme naturel d'une expression réelle.



33

Power Déclaration function Power(Base, Exponent: Extended): Extended; Description Élève Base à n'importe quelle puissance. Round Déclaration function Round(X: Extended): Integer; Description Renvoie la valeur de X arrondi au plus proche entier. Sin Déclaration function Sin(X: Extended): Extended; Description Renvoie le sinus de l'angle en radians. Sqr Déclaration function Sqr(X: Extended): Extended; Description Renvoie le carré d'un nombre. Sqrt Déclaration function Sqrt(X: Extended): Extended; Description Renvoie la racine carrée de X. Tan Déclaration function Tan(X: Extended): Extended; Description Renvoie la tangente de X. Tanh Déclaration function Tanh(X: Extended): Extended; Description Renvoie la tangente hyperbolique de X.



34

Trunc Déclaration function Trunc(X: Extended): Integer; Description Tronque un réel en entier. Autres fonctions utiles ShowMessage Déclaration procedure ShowMessage(const Msg: string); Description Affiche une boîte de dialogue de message avec un bouton OK. Le paramètre Msg est la chaîne qui apparaît dans la boîte de dialogue. Surtout utilisé comme par exemple, pour faire une trace lors de l’exécution d’un script. ATTENTION : Ne pas utiliser cette procédure si vous projetez d’utiliser le script en mode automatique, c’est à dire exécuter automatiquement en arrière plan à partir d’un logiciel à cet effet comme par exemple le service Schedule de Windows, sinon la procédure ShowMessage arrêtera l'exécution du script.

Importations et exportations automatisées


35

Importations et exportations automatisées Tel que discuté dans les sections précédentes, vous pouvez enregistrer vos paramètres d’importation ou d’exportation de données pour usage ultérieur. Ainsi, lors d’une prochaine importation ou exportation de données, vous n’avez pas à saisir de nouveau tous vos paramètres. Vous n’avez qu’à indiquer à l’utilitaire d’importation et d’exportation de données que vous désirez utiliser un fichier de paramètres précédemment sauvegardé. Ainsi, tous vos paramètres seront automatiquement chargés. Ceci est très utile surtout lorsque vous avez à importer et/ou exporter des données sur une base régulière. Par exemple, si vous désirez importer quotidiennement la liste des nouveaux clients et mettre à jour les informations des clients existants à partir de votre logiciel de comptabilité, vous n’aurez qu'à saisir les paramètres d’importation une première fois puis, les enregistrer dans un fichier. Vous pourrez alors utiliser ces paramètres lors de vos prochaines importations de la liste de vos clients. En plus de vous permettre de charger des paramètres d’importation ou d’exportation de données préalablement sauvegardés dans un fichier, l’utilitaire d’importation et d’exportation de données vous permet d’exécuter une importation ou une exportation de données sans aucune intervention de l'utilisateur. Vous pouvez exécuter l’utilitaire d’importation et d’exportation de données en lui donnant comme paramètre le nom d’un fichier contenant vos paramètres d’importation ou d’exportation. Ainsi, l’utilitaire d’importation et d’exportation de données exécutera l’importation ou l’exportation selon le cas puis ensuite, se terminera tout à fait automatiquement. Ceci est très utile lorsque vous désirez exécuter des importation ou exportation de données la nuit et sur une base régulière. Vous pouvez exécuter l’utilitaire d’importation et d’exportation de données à partir de fichiers de commandes (Batch) ou de tout utilitaire de planification de tâches comme le planificateur de tâches de Windows ou le service Schedule de Windows. Paramètre –IMPORT Utilisez ce paramètres pour indiquer à l’utilitaire d’importation et d’exportation de données que vous désirez exécuter une importation à partir du fichier de paramètres spécifié. Paramètre –EXPORT Utilisez ce paramètres pour indiquer à l’utilitaire d’importation et d’exportation de données que vous désirez exécuter une exportation à partir du fichier de paramètres spécifié. Paramètre –LOG Utilisez ce paramètres pour indiquer à l’utilitaire d’importation et d’exportation de données que vous désirez enregistrer le journal de l’importation ou de l’exportation dans un fichier spécifique. Si ce paramètre n’est pas spécifié, le fichier journal sera créé dans le même dossier où est situé l’utilitaire d’importation et d’exportation de données. Dans le cas d’une importation, le fichier s’appellera import.log et dans le cas d’une exportation, le fichier s’appellera export.log. Voici quelques exemples d’appel du programme IMEX.EXE (Utilitaire d’importation et d’exportation de données). Veuillez utiliser le caractère " lorsque qu’il y a des espaces dans les noms de fichier et/ou dossier. Exemple 1 : imex.exe –import=clients.nix

Exemple 2 : imex.exe –export=c:\export\pieces.nix

Exemple 3 : imex.exe –export=pieces.nix –log="C:\Mes Documents\Journal\import_pieces.log"

Importations et exportations automatisées


36

Exemple 4 : "C:\Program Files\OroLogic\NewWayService4\imex.exe" –export=c:\import\pieces.nix –log="C:\Mes Documents\Journal\import_pieces.log"

Dictionnaire de données


37

Dictionnaire de données Liste des entités de la base de données de NewWayService 4 Référez-vous au document DIC.XLS (Format Microsoft Excel) inclut avec NewWayService 4 et disponible à partir du dossier d’installation (normalement C:\Program Files\OroLogic\NewWayService4) pour connaître la liste des tables et champs de NewWayService 4.

Tutoriels


38

Tutoriels Cette section vous présente 4 tutoriels que vous pouvez exécuter étape par étape, pour apprendre rapidement à utiliser l’utilitaire d’importation et d’exportation de données. Tutoriel 1 – Importation de produits Ce tutoriel vous explique étape par étape, comment importer une liste de produits à partir d’un fichier Excel. 1- Démarrez l’utilitaire d’importation et d’exportation de données. 2- Sélectionnez l’option Importer des données vers NewWayService 4 à partir du bouton radio puis cliquez sur le bouton Démarrer. 3- Sélectionnez l’option Démarrer une nouvelle importation de données à partir du bouton radio puis cliquez sur le bouton Suivant. 4- À partir du groupe Importer des données à partir, sélectionnez l’option d’un fichier (Excel, Lotus, Access, dBase, etc.) puis cliquez sur le bouton … à droite de la boîte de saisie du nom du fichier. À partir de la boîte de dialogue, sélectionnez le type de fichier Fichiers Excel (*.xls). Ensuite, sélectionnez le fichier tutorial.xls situé dans le dossier d'installation, habituellement C:\Progam Files\OroLogic\NewWayService4 puis cliquez sur le bouton Ouvrir. Cliquez ensuite sur le bouton Suivant. 5- À partir de la liste déroulante, sélectionnez la table Produits$ puis cliquez sur le bouton Suivant. 6- Laissez les paramètres de connexion déjà saisis pour vous connecter à votre base de données de NewWayService 4 par défaut ou changez ces paramètres pour vous connecter à une autre base de données de NewWayService 4. Cliquez ensuite sur le bouton Suivant. 7- Si la sécurité est activée dans la base de données de NewWayService 4 sélectionnée, saisissez un code de technicien et un mot de passe valide (un code de technicien possédant les droits d’administrateur) puis cliquez sur le bouton Suivant. Cliquez directement sur le bouton Suivant si la sécurité n’est pas activée. 8- À partir du groupe Importer vers, sélectionnez Produits puis cliquez sur le bouton Suivant. 9- À partir de la première liste déroulante (à gauche du champ * Code produit (Chaîne)), sélectionnez Field_CODE (Chaîne). À partir de la deuxième liste déroulante (à gauche du champ * Description du produit (Chaîne)), sélectionnez Field_DESCRIPTION (Chaîne). À partir de la troisième liste déroulante (à gauche du champ * Code de catégorie (Entier)), sélectionnez une catégorie, comme par exemple 1 (Défaut). Cliquez ensuite sur le bouton Suivant. 10- Comme derniers paramètres, cochez la case Sauvegarder les paramètres de cette importation pour une utilisation ultérieure, puis sélectionnez un nom de fichier où seront sauvegardés les paramètres de cette importation. Laissez les autres paramètres par défaut puis cliquez sur le bouton Démarrer l’importation. À la demande de confirmation Êtes-vous sûr de vouloir démarrer l’importation?, cliquez sur le bouton Oui. 11- Après le processus d’importation, vous devriez avoir un résumé de l’importation qui vous indique que 5 enregistrements ont été ajoutés (L’onglet Produits du fichier Excel contenait 5 produits).

Tutoriels


39

12- Cliquez sur le bouton Fermer puis quittez l’utilitaire d’importation et d’exportation de données. 13- Exécutez NewWayService 4 puis vérifiez que vous avez bien 5 nouveaux produits. Ensuite, quittez le logiciel NewWayService 4. 14- Ouvrez le fichier Excel qui a servi à l’importation de données (le fichier tutorial.xls situé dans le dossier C:\Progam Files\OroLogic\NewWayService4) à l’aide de votre logiciel de chiffrier électronique. 15- Modifier la description MON PRODUIT 1 pour MON PRODUIT TEST. 16- Sauvegardez vos changements puis quittez votre logiciel de chiffrier électronique. 17- Exécutez de nouveau l’utilitaire d’importation et d’exportation de données, sélectionnez l’option Importer des données vers NewWayService 4 à partir du bouton radio puis cliquez sur le bouton Démarrer. 18- Maintenant, au lieu de sélectionner l’option Démarrer une nouvelle importation de données, sélectionnez plutôt l’option Importer des données à partir de paramètres précédemment sauvegardés. Sélectionnez le fichier où vous aviez sauvegardés vos paramètres d’importation à l’étape 10 de ce tutoriel puis cliquez sur le bouton Suivant. 19- Cliquez toujours sur le bouton Suivant pour ne changer aucun paramètres jusqu’à la dernière étape, puis cliquez sur le bouton Démarrer l’importation. Après le processus d’importation, vous devriez avoir un résumé de l’importation qui vous indique que 5 enregistrements ont été mis à jour. En effet, puisque que les codes de produit existent déjà, les informations sur ces produits ont été mises à jour. Quittez l’utilitaire d’importation et d’exportation de données. 20- Exécutez NewWayService 4 puis vérifiez que la description du produit dont le code est PRO001 a été mise à jour avec la nouvelle description MON PRODUIT TEST. Quittez le logiciel NewWayService 4. À l’aide de ce tutoriel, vous avez appris à importer des produits dans NewWayService 4. De plus, ce tutoriel vous a démontré qu’en modifiant certaines informations de la source de données (votre fichier Excel contenant vos produits) et en exécutant de nouveau votre importation, les informations sur vos produits se mettaient automatiquement à jour. Ce principe reste le même, peu importe la source de données utilisée (dans ce cas-ci un fichier Excel, mais aurait pu être par exemple, votre base de données de votre logiciel de comptabilité). N’oubliez pas d’effacer vos 5 produits tests (à partir de l’option Produits de NewWayService 4) qui ont été ajoutés à votre base de données de NewWayService 4 lors de ce tutoriel. Le prochain tutoriel vous enseigne comment importer une liste de clients dans NewWayService 4 et comment manipuler les données sources à l’aide d’un script en langage Pascal Objet.

Tutoriels


40

Tutoriel 2 – Importation de clients et écriture de scripts à l’aide du langage Pascal Objet Ce tutoriel vous enseigne comment importer une liste de clients dans NewWayService 4 et comment manipuler les données source à l’aide d’un script en langage Pascal Objet. 1- Démarrez l’utilitaire d’importation et d’exportation de données. 2- Sélectionnez l’option Importer des données vers NewWayService 4 à partir du bouton radio puis cliquez sur le bouton Démarrer. 3- Sélectionnez l’option Démarrer une nouvelle importation de données à partir du bouton radio puis cliquez sur le bouton Suivant. 4- À partir du groupe Importer des données à partir, sélectionnez l’option d’un fichier (Excel, Access, Lotus, dBase, etc.) puis cliquez sur le bouton … à droite de la boîte de saisie du nom du fichier. À partir de la boîte de dialogue, sélectionnez le type de fichier Fichiers Excel (*.xls). Sélectionnez le fichier tutorial.xls situé dans le dossier d'installation habituellement C:\Progam Files\OroLogic\NewWayService4 puis cliquez sur le bouton Ouvrir. Cliquez ensuite sur le bouton Suivant. 5- À partir de la liste déroulante, sélectionnez la table Clients$ puis cliquez sur le bouton Suivant. 6- Laissez les paramètres de connexion par défaut pour vous connecter à votre base de données de NewWayService 4 par défaut ou changez ces paramètres pour vous connecter à une autre base de données de NewWayService 4. Cliquez ensuite sur le bouton Suivant. 7- Si la sécurité est activée dans la base de données de NewWayService 4 sélectionnée, saisissez un code de technicien et un mot de passe valide (un code de technicien possédant les droits d’administrateur) puis cliquez sur le bouton Suivant. Cliquez directement sur le bouton Suivant si la sécurité n’est pas activée. 8- À partir du groupe Importer vers, sélectionnez Clients puis cliquez sur le bouton Suivant. 9- À partir de la première liste déroulante (à gauche du champ * Code client (Chaîne)), sélectionnez Field_CODE (Chaîne). À partir de la deuxième liste déroulante (à gauche du champ * Nom du client (Chaîne)), sélectionnez Field_NOM (Chaîne). À partir de la troisième liste déroulante (à gauche du champ Adresse (Chaîne)), sélectionnez >> Utiliser Script <<. Cliquez sur le bouton Script… à droite de la liste déroulante. Saisissez le script suivant dans la boîte de saisie (Utiliser copier/coller pour éviter les erreurs de saisie): begin ImportValue := Field_ADRESSE + #13#10 + Field_VILLE + ' ' + Field_CODE_POSTAL + ' ' + Field_PROVINCE + #13#10 + Field_PAYS; end; Cliquez ensuite sur le bouton OK pour enregistrer ce script. Si une erreur est détectée, c’est probablement que le script n’a pas été saisi intégralement. À partir de la quatrième liste déroulante (à gauche du champ Téléphone 1 (Chaîne)), sélectionnez Field_TELEPHONE (Chaîne). Un peu plus bas, à partir de la septième liste déroulante (à gauche du champ Contact (Chaîne)) sélectionnez également >>Utiliser Script <<. Cliquez sur le bouton Script à droite de cette liste déroulante puis saisissez le script suivant (Utiliser copier/coller pour éviter les erreurs de saisie) :

Tutoriels


41

// Ce script a 2 utilités begin // Vérification de l'état du client. //Importe seulement les clients actifs. If Field_ACTIF = 'NON' Then SkipRecord := True; // Ne prend que la première lettre du prénom et ensuite le nom. ImportValue := Copy(Field_CONTACT_PRENOM,1,1) + '. ' +Field_CONTACT_NOM; end; Cliquez ensuite sur le bouton OK pour enregistrer ce script. Cliquez ensuite sur le bouton Suivant. Notes sur les scripts utilisés dans ce tutoriel: Le premier script sert à formater l’adresse selon nos besoins. Puisque le champ adresse du module Clients de NewWayService 4 est un champ unique qui peut contenir plusieurs lignes (champ mémo) et que dans le fichier Excel, les informations sur l’adresse sont divisées en plusieurs champs (Adresse, Ville, Code postal, etc.), un script est nécessaire pour formater tous ces champs et les concaténer en un seul. Vous remarquerez également l’utilisation des caractères #13#10 . Ces caractères sont utilisés pour faire un retour de chariot dans le champ adresse de NewWayService 4 et ainsi, avoir les informations de l’adresse sur plusieurs lignes. Le deuxième script est utilisé à 2 fins. La première partie sert à indiquer à l’utilitaire d’importation et d’exportation de données qu'il ne doit pas importer les enregistrements dont le champ ACTIF est à NON. La variable SkipRecord est utilisée à cet effet. La deuxième partie sert à formater le champ Contact. Seule la première lettre du prénom est importée, suivie du caractère ., du caractère espace puis du nom de la personne contact. 10- Comme derniers paramètres, cochez la case Sauvegarder les paramètres de cette importation pour une utilisation ultérieure, puis sélectionnez un nom de fichier où seront sauvegardés les paramètres de cette importation. Laissez les autres paramètres par défaut puis cliquez sur le bouton Démarrer l’importation. À la demande de confirmation Êtes-vous sûr de vouloir démarrer l’importation?, cliquez sur le bouton Oui. 11- Après le processus d’importation, vous devriez avoir un résumé de l’importation qui vous indique que 4 enregistrements ont été ajoutés (L’onglet Clients du fichier Excel contient 5 clients mais seulement 4 de ses clients sont importés parce que le champ ACTIF d’un des clients est à NON). 12- Cliquez sur le bouton Fermer puis quittez l’utilitaire d’importation et d’exportation de données. 13- Exécutez NewWayService 4 puis vérifiez que vous avez bien 4 nouveaux clients. Ensuite, quittez le logiciel NewWayService 4. À l’aide de ce tutoriel, vous avez appris à importer des clients dans NewWayService 4 à l’aide de scripts en langage Pascal Objet. Pour plus de détails sur l’utilisation de scripts, référez-vous aux sections Utilisation de scripts à l'aide du langage Pascal Objet et Référence du langage Pascal Objet. N’oubliez pas d’effacer vos 4 clients tests (à partir de l’option Clients de NewWayService 4) qui ont été ajoutés à votre base de données de NewWayService 4 lors de ce tutoriel. Le prochain tutoriel vous enseigne comment exporter une liste de produits de NewWayService 4 vers une base de données MS Access.

Tutoriels


42

Tutoriel 3 – Exportation de la liste des clients vers un fichier MS Access Ce tutoriel vous explique étape par étape comment exporter une liste de clients vers un fichier MS Access. 1- Démarrez l’utilitaire d’importation et d’exportation de données. 2- Sélectionnez l’option Exporter des données de NewWayService 4 à partir du bouton radio puis cliquez sur le bouton Démarrer. 3- Sélectionnez l’option Démarrer une nouvelle exportation de données à partir du bouton radio puis cliquez sur le bouton Suivant. 4- Laissez les paramètres de connexion par défaut pour vous connecter à votre base de données de NewWayService 4 par défaut ou changez ces paramètres pour vous connecter à une autre base de données de NewWayService 4. Cliquez ensuite sur le bouton Suivant. 5- Si la sécurité est activée dans la base de données de NewWayService 4 sélectionnée, saisissez un code de technicien et un mot de passe valide (un code de technicien possédant les droits d’administrateur) puis cliquez sur le bouton Suivant. Cliquez directement sur le bouton Suivant si la sécurité n’est pas activée. 6- Cliquez sur le bouton Sélection d’une requête prédéfinie, sélectionnez la requête appelée Clients puis cliquez sur le bouton Ouvrir. Cliquez ensuite sur le bouton Tester la requête pour vérifier que cette requête fonctionne correctement puis cliquez sur le bouton Suivant. 7- À partir du groupe Exporter vers, sélectionnez l’option un fichier (Access, Excel, etc...) puis cliquez sur le bouton … à droite de la boîte de saisie du nom du fichier. À partir de la boîte de dialogue, sélectionnez le type de fichier Fichiers MS Access (*.mdb) à partir de la liste déroulante des types de fichier puis sélectionnez le dossier où vous désirez créer votre fichier MS Access. Saisissez Test comme nom de fichier puis cliquez sur le bouton Enregistrer. Sélectionnez le type de fichier MS Access que vous désirez créer à partir de la liste déroulante. Sélectionnez le type correspondant à votre version de MS Access. Par exemple, si vous utilisez la version 97 de MS Access sélectionnez Access 97. Notez que si vous sélectionnez (par exemple) Access 2000 mais que vous utilisez la version de MS Access 97, l’exportation fonctionnera quand même correctement mais vous ne pourrez pas lire le fichier MS Access 2000 à partir de MS Access 97. Cliquez ensuite sur le bouton Suivant. 8- À partir de la liste déroulante vous devriez voir NOUVEAU1. Remplacez ce nom de table par CLIENTS, puis cliquez sur le bouton Suivant. 9- À cette étape, puisque la table destination n’existe pas, une table ayant la même structure que votre requête est automatiquement générée et tous les champs sources (champs de la requête) sont automatiquement assignés aux champs de la table destination. Cliquez tout simplement sur le bouton Suivant pour continuer à la dernière étape. 10- Comme derniers paramètres, sélectionnez l’option Ajouter à la suite mais mettre à jour les enregistrements existants qui correspondent à la clé puis cochez le champ CUSCODDES dans la liste des champs clé. Cochez ensuite la case Sauvegarder les paramètres de cette exportation pour une utilisation ultérieure, puis sélectionnez un nom de fichier où seront sauvegardés les paramètres de cette exportation. Cliquez ensuite sur le bouton Démarrer l’exportation. À la demande de confirmation Êtes-vous sûr de vouloir démarrer l’exportation?, cliquez sur le bouton Oui.

Tutoriels


43

11- Après le processus d’exportation, vous devriez avoir un résumé de l’exportation qui vous indique que les enregistrements ont été exportés. Cliquez sur le bouton Fermer puis quittez l’utilitaire d’importation et d’exportation de données. 12- Ouvrez maintenant votre fichier MS Access pour vérifier que ce fichier contient bien une table appelée Clients qui contient la liste des clients de NewWayService 4. À l’aide de ce tutoriel, vous avez appris à exporter la liste de vos clients de NewWayService 4 vers un fichier MS Access. Vous remarquerez que si vous modifiez certaines informations sur vos clients dans NewWayService 4 et que vous exécutez de nouveau cette exportation, les clients seront automatiquement mis à jour dans votre fichier MS Access. Si le fichier MS Access n’existe plus, il sera créé de nouveau. Dans ce tutoriel, un fichier MS Access a été utilisé, mais vous pourriez, par exemple, exporter votre liste de clients de NewWayService 4 directement dans la base de données de votre logiciel de comptabilité. Le prochain tutoriel vous enseigne comment exporter la liste des pièces de rechange utilisées sur vos différents bons de travail pour alimenter, par exemple, votre logiciel de gestion d’inventaire. De plus, un exemple d’utilisation de script en langage Pascal Objet sera aussi inclus dans ce tutoriel.

Tutoriels


44

Tutoriel 4 – Exportation de pièces de rechange et écriture de scripts à l’aide du langage Pascal Objet Ce tutoriel vous explique, étape par étape, comment exporter la liste des pièces de rechange utilisées sur les bons de travail vers un fichier dBase III. Seules les pièces des bons de travail modifiés depuis les 15 derniers jours et qui ont le statut Terminé (Statut 3 dans la base de données) sont exportées. 1- Démarrez l’utilitaire d’importation et d’exportation de données. 2- Sélectionnez l’option Exporter des données de NewWayService 4 à partir du bouton radio puis cliquez sur le bouton Démarrer. 3- Sélectionnez l’option Démarrer une nouvelle exportation de données à partir du bouton radio puis cliquez sur le bouton Suivant. 4- Laissez les paramètres de connexions par défaut pour vous connecter à votre base de données de NewWayService 4 par défaut ou changez ces paramètres pour vous connecter à une autre base de données de NewWayService 4. Cliquez ensuite sur le bouton Suivant. 5- Si la sécurité est activée dans la base de données de NewWayService 4 sélectionnée, saisissez un code de technicien et un mot de passe valide (un code de technicien possédant les droits d’administrateur) puis cliquez sur le bouton Suivant. Cliquez directement sur le bouton Suivant si la sécurité n’est pas activée. 6- Saisissez la requête suivante puis cliquez sur le bouton Tester la requête pour vérifier que cette requête fonctionne correctement. Cliquez ensuite sur le bouton Suivant. Note: Nous vous conseillons d’utiliser l'option copier/coller au lieu de saisir cette requête manuellement afin d'éviter les erreurs. SELECT WORACTPAR.WORCOD, WORACTPAR.WORACTCOD, WORACTPAR.WORACTPARCOD, WORACT.WORACTDAT, PAR.PARCODDES, WORACTPAR.WORACTPARDES, WORACTPAR.WORACTPARQTY, WORACTPAR.WORACTPARPRI FROM WORACTPAR, WORACT, WOR, PAR WHERE WORACTPAR.WORCOD = WORACT.WORCOD AND WORACTPAR.WORACTCOD = WORACT.WORACTCOD AND WORACT.WORCOD = WOR.WORCOD AND WORACTPAR.PARCOD = PAR.PARCOD AND WOR.WORMODDAT >= CURRENT_DATE – 15 AND WOR.WORSTA = 3; Cette requête extrait la liste des pièces de rechange qui ont été utilisées sur les bons de travail. Notez les deux dernières lignes de cette requête qui indiquent de sélectionner seulement les pièces sur les bons de travail qui ont été modifiés depuis les 15 derniers jours et dont le statut est égal à 3 (lors de l’installation initial de NewWayService 4, le statut 3 équivaut au statut Terminé). Référez-vous à la section Dictionnaire de données de NewWayService 4 pour connaître les différentes tables et champs de NewWayService 4 disponibles pour utilisation dans les requêtes, ainsi que leurs relations. Consultez la documentation de Firebird pour plus d’informations sur le langage SQL vs Firebird. 7- À partir du groupe Exporter vers, sélectionnez l’option un fichier (Access, Excel, etc...) puis cliquez sur le bouton … à droite de la boîte de saisie du nom du fichier. À partir de la boîte de dialogue, sélectionnez le type de fichier Fichiers dBase (*.dbf) à partir de la liste déroulante des types de fichier puis sélectionnez ensuite le fichier tutorial.dbf, situé dans le dossier d'installation habituellement C:\Progam Files\OroLogic\NewWayService4. Cliquez ensuite sur le bouton Enregistrer, puis sur le bouton Suivant. 8- À partir de la liste déroulante, vous devriez retrouver TUTORIAL. Cliquez simplement sur le bouton Suivant.

Tutoriels


45

9- À cette étape, à partir de la première liste déroulante (à gauche du champ TRANS_NO (Chaîne)), sélectionnez >> Utiliser Script <<. Cliquez sur le bouton Script… à droite de la liste déroulante. Saisissez le script suivant dans la boîte de saisie. Nous vous suggérons d'utiliser copier/coller pour éviter les erreurs de saisie: var NumeroTrans: String; begin NumeroTrans := Trim(IntToStr(Field_WORCOD)) + '-' + Trim(IntToStr(Field_WORACTCOD)) + '-' + Trim(Field_PARCODDES); ExportValue := NumeroTrans; end; Cliquez sur le bouton OK pour enregistrer ce script. Si une erreur est détectée, c’est probablement que le script n’a pas été saisi intégralement. Notes sur le script utilisé dans ce tutoriel: Le script utilisé sert à générer un numéro de transaction unique. Ainsi, par exemple, si cette exportation de données est exécutée à toutes les nuits, même si les pièces d’un même bon de travail peuvent être exportées plusieurs fois, les enregistrements ne seront pas créés en double dans la base de données destination. Ainsi, si l’enregistrement existe déjà dans la table destination, ses informations seront plutôt mises à jour. Ensuite, à partir de la deuxième liste déroulante, à gauche du champ TRANS_DATE (Date et heure), sélectionnez Field_WORACTDAT. À partir de la troisième liste déroulante, à gauche du champ PIECE_NO (Chaîne), sélectionnez Field_PARCODDES. À partir de la quatrième liste déroulante, à gauche du champ QUANTITE (Décimal), sélectionnez Field_ WORACTPARQTY. À partir de la cinquième liste déroulante, à gauche du champ PRIX (Décimal), sélectionnez Field_ WORACTPARPRI. Cliquez ensuite sur le bouton Suivant pour continuer à la dernière étape. 10- Comme derniers paramètres, sélectionnez l’option Ajouter à la suite mais mettre à jour les enregistrements existants qui correspondent à la clé puis cochez le champ TRANS_NO dans la liste des champs clé. Cochez ensuite la case Sauvegarder les paramètres de cette exportation pour une utilisation ultérieure, puis sélectionnez un nom de fichier où seront sauvegardés les paramètres de cette exportation. Cliquez ensuite sur le bouton Démarrer l’exportation. À la demande de confirmation Êtes-vous sûr de vouloir démarrer l’exportation?, cliquez sur le bouton Oui. 12- Après le processus d’exportation, vous devriez avoir un résumé de l’exportation qui vous indique que les enregistrements ont été exportés. Cliquez sur le bouton Fermer puis quittez l’utilitaire d’importation et d’exportation de données. 13- Ouvrez maintenant votre fichier dBase (Notez que MS Excel peut ouvrir les fichiers de type dBase) pour vérifier que ce fichier contient bien les informations exportées. À l’aide de ce tutoriel, vous avez appris à exporter les pièces utilisées sur vos bons de travail vers un fichier dBase. De plus, vous avez appris à utiliser un script lors d’une exportation de données. Dans ce tutoriel, un fichier dBase a été utilisé, mais vous pourriez, par exemple, exporter vos pièces utilisées directement dans votre base de données de votre logiciel de comptabilité.