Guide d`utilisation de l`utilitaire d`importation

Transcription

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
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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,
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Importation de données
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Importation de données
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Importation de données
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Importation de données
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Importation de données
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
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Importation de données
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Importation de données
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Exportation de données
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
Produits.slq
Bons_Travail.sql
Actions.sql
Utilisez cette requête pour exporter la liste des clients.
Utilisez cette requête pour exporter la liste des produits.
Utilisez cette requête pour exporter la liste des bons de travail.
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Exportation de données
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 :
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Exportation de données
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Exportation de données
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 :
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Exportation de données
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Exportation de données
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Utilisation de scripts à l'aide du langage Pascal Objet
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 :
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Utilisation de scripts à l'aide du langage Pascal Objet
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;
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Utilisation de scripts à l'aide du langage Pascal Objet
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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 (-, +)
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Référence du langage Pascal Objet
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
Utilitaire d’importation et d’exportation de données pour NewWayService 4
23
Référence du langage Pascal Objet
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Référence du langage Pascal Objet
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
25
Référence du langage Pascal Objet
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
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Référence du langage Pascal Objet
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).
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Référence du langage Pascal Objet
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;
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Référence du langage Pascal Objet
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Référence du langage Pascal Objet
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
0.00
#.##
#,##0.00
#,##0.00;(#,##0.00)
#,##0.00;;Zéro
0.000E+00
#.###E-0
1234
1234.00
1234
1,234.00
1,234.00
1,234.00
1.234E+03
1.234E3
-1234
-1234.00
-1234
-1,234.00
(1,234.00)
-1,234.00
-1.234E+03
-1.234E3
1
0.50
.5
0.50
0.50
0.50
5.000E-01
5E-1
0
0.00
0.00
0.00
Zéro
0.000E+00
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Référence du langage Pascal Objet
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
Référence du langage Pascal Objet
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
32
Référence du langage Pascal Objet
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
33
Référence du langage Pascal Objet
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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"
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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"
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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.
Utilitaire d’importation et d’exportation de données pour 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).
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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
Field_VILLE
Field_CODE_POSTAL
Field_PROVINCE
Field_PAYS;
end;
+
+
+
+
#13#10
'
'
'
'
#13#10
+
+
+
+
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) :
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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.
Utilitaire d’importation et d’exportation de données pour NewWayService 4
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é.
Utilitaire d’importation et d’exportation de données pour NewWayService 4