Kit ODBC 100. Version Référence

Transcription

1 Kit ODBC 100 Version Référence

2 COMPOSITION DU PROGICIEL PROPRIETE & USAGE CONFORMITE & MISE EN GARDE EVOLUTION LA FICHE SUGGESTION MARQUES Votre progiciel est composé d'un boîtier de rangement comprenant : le CD-ROM sur lequel est enregistré le programme, la documentation correspondante Tout usage, représentation ou reproduction intégral ou partiel, fait sans le consentement de Sage France est illicite (Loi du 11 Mars Loi du 3 Juillet 1985). Ils constitueraient une contrefaçon sanctionnée par les articles 425 et suivants du Code Pénal. Tous droits réservés dans tous pays. Logiciel original développé par Sage France. Documentation Sage France. Toute utilisation, à quelque titre que ce soit, non autorisée dans le cadre de la convention de licence, est strictement interdite sous peine de sanctions pénales (Loi du 3 Juillet 1985, Art. 46). Compte tenu des contraintes inhérentes à la présentation sous forme papier, les spécifications visées dans la présente documentation constituent une illustration aussi proche que possible des spécifications. Il appartient au client, parallèlement à la documentation, de mettre en œuvre le progiciel pour permettre de mesurer exactement l'adéquation de ses besoins aux fonctionnalités. Il est important, pour une utilisation sûre et opérationnelle du progiciel, de lire préalablement la documentation. La documentation correspond à la version référencée. Entre deux versions, des mises à jour du logiciel peuvent être opérées sans modification de la documentation. Toutefois, un additif peut être joint à la documentation existante pour présenter les modifications et améliorations apportées à ces mises à jour. Sage France recherche une constante amélioration du progiciel et de sa documentation. Nous invitons notre clientèle à nous faire parvenir ses suggestions et les éventuels défauts ou erreurs qu'elle pourrait relever sur la fiche suggestion figurant en dernière page du manuel. Ligne 30 est une marque déposée appartenant à Sage France. Ligne 100 est une marque déposée appartenant à Sage France. Ligne 500 est une marque déposée appartenant à Sage France. Windows 2000, Windows 98, Windows 95, Windows, MS-DOS sont des marques déposées de Microsoft Corporation. Macintosh, MAC/OS est une marque déposée de Apple Computer Inc.

3 Sommaire général Sommaire Chapitre 1 Généralités sur le programme 1 Définition d ODBC 2 Principe de fonctionnement 2 Compatibilité avec les bases de la ligne 100 Windows 3 Principe d utilisation dans les applications 4 Contenu du Kit ODBC Base de Données : ACC2000EX.MDB de Microsoft ACCESS... 5 Base de Données: ODBCNEW2000.MDB de Microsoft ACCESS... 5 Exemple d utilisation du Driver ODBC 100 avec Excel et Visual Basic (ExExc2000.XLS)... 5 Bases Bijou... 5 Exemple sur Crystal Report version 8 : COMPTET.RPT... 5 Fichier texte : t_descri.txt... 5 Fichier texte : fonction.txt... 6 Fichier texte : erreurs.txt... 6 Fichier ActiveX.Txt... 6 Sources de données 7 Définition... 7 Comptabilité Gestion Commerciale Immobilisations Manager Moyen de Paiement Paie Windows Types de Sources de Données... 9 Utilisateur...9 Système...9 Fichier...9 Création d une source de données Sage Création d une DSN de type fichier...14 Chapitre 2 Fonctions avancées et DLL Active X : déclaration des fonctions 15 Les fonctions avancées Sage 16 Introduction générale Description des fonctions de l API Sage Introduction...17 Description des fonctions avancées de la comptabilité TotalMvtDebit (CG_Num, CT_Num, JO_Num, Deb, Fin, Resultat)...18 TotalMvtCredit (CG_Num, CT_Num, JO_Num, Deb, Fin, Credit)...18 I Sage France

4 Sommaire général TotalMvtSolde (CG_Num, CT_Num, JO_Num, Deb, Fin, Resultat) TotalDevDebit (CG_Num, CT_Num, JO_Num, Deb, Fin, Resultat) TotalDevCredit (CG_Num, CT_Num, JO_Num, Deb, Fin, Resultat) TotalDevSolde (CG_Num, CT_Num, JO_Num, Deb, Fin, Resultat) TotalRepDebit (CR_Num, JO_Num, Deb, Fin, Resultat) TotalRepCredit (CR_Num, JO_Num, Deb, Fin, Resultat) TotalRepSolde (CR_Num, JO_Num, Deb, Fin, Resultat) TotalRepDevDebit (CR_Num, JO_Num, Deb, Fin, Resultat) TotalRepDevCredit (CR_Num, JO_Num, Deb, Fin, Resultat) TotalRepDevSolde (CR_Num, JO_Num, Deb, Fin, Resultat) RealisationBudg (BD_Num, Deb, Fin, Resultat) JournalNouvPiece (JO_Num, JM_Date, Resultat ) Description des fonctions avancées de la Gestion Commerciale CIALLigneMontantHT (DL_No, Resultat) CIALLigneMontantTTC (DL_NO, RESULTAT) CIALLigneRemiseGlobal (DL_NO, RESULTAT) CIALLignePrixUNet (DL_NO, RESULTAT) CIALLignePrixUNetTTC (DL_NO, RESULTAT) CIALLignePrixUNetDevise (DL_NO, RESULTAT) CIALLigneMontantTaxes (DL_NO, RESULTAT)...29 CIALLigneMontantHTSigne (DL_NO, RESULTAT)...29 CIALLigneMontantTTCSigne (DL_NO, RESULTAT)...29 CIALLigneMontantQteSigne (DL_NO, RESULTAT)...30 Algorithme de calcul des quantités signées...30 CIALDocTotalHT (DO_Type, DO_Piece, Résultat)...32 CIALDocEscompte (DO_TYPE, DO_PIECE, RESULTAT)...32 CIALDocTotalHTNet (DO_TYPE, DO_PIECE, RESULTAT)...32 CIALDocBaseTaxes (DO_Type, DO_Piece, Ntaxe)...33 CIALDocMontantTaxes (DO_Type, DO_Piece, Ntaxe)...33 CIALDocMontantTotalTaxes (DO_TYPE, DO_PIECE, RESULTAT)...33 CIALDocTotalTTC (DO_TYPE, DO_PIECE, RESULTAT)...34 CIALDocTotalPrixRevient (DO_TYPE, DO_PIECE, RESULTAT)...34 CIALDocTotalMarge (DO_TYPE, DO_PIECE, RESULTAT)...34 CIALDocNetaPayer (DO_TYPE, DO_PIECE, RESULTAT)...35 CIALDocMontantEcheance (DO_TYPE, DO_PIECE, RESULTAT)...35 CIALDocPoidsNet (DO_TYPE, DO_PIECE, RESULTAT)...35 CIALDocPoidsBrut (DO_TYPE, DO_PIECE, RESULTAT)...36 CIALDocQuantites (DO_TYPE, DO_PIECE, RESULTAT)...36 II Sage France

5 Sommaire général CIALDocQtesColisee (DO_TYPE, DO_PIECE, RESULTAT) CIALDocTotalHTDev (DO_TYPE, DO_PIECE, RESULTAT) CIALDocEscompteDev (DO_TYPE, DO_PIECE, RESULTAT) CIALDocTotalHTNetDev (DO_TYPE, DO_PIECE, RESULTAT) CIALDocMontantTaxesDev (DO_Type, DO_Piece, Ntaxe, RESULTAT) CIALDocMontantTotalTaxesDev (DO_TYPE, DO_PIECE, RESULTAT) CIALDocTotalTTCDev (DO_TYPE, DO_PIECE, RESULTAT) CIALDocNouvPiece (DO_Type, DO_SOUCHE, RESULTAT) CIALTiersCAHTBrut (CT_NUM, Debut, Fin, TypeDocDe, TypeDocA, RESULTAT) CIALTiersCAHTNet (CT_NUM, Debut, Fin, TypeDocDe, TypeDocA, RESULTAT) CIALTiersCATTC (CT_NUM, Debut, Fin, TypeDocDe, TypeDocA, RESULTAT) CIALTiersPrixRevient (CT_NUM, Debut, Fin, TypeDocDe, TypeDocA, RESULTAT) CIALTiersQuantites (CT_NUM, Debut, Fin, TypeDocDe, TypeDocA, RESULTAT) CIALTiersQtesColisee (CT_NUM, Debut, Fin, TypeDocDe, TypeDocA, RESULTAT) CIALTiersPoidsNet (CT_NUM, Debut, Fin, TypeDocDe, TypeDocA, RESULTAT) CIALTiersPoidsBrut (CT_NUM, Debut, Fin, TypeDocDe, TypeDocA, RESULTAT) CIALTiersMarge (CT_NUM, Debut, Fin, TypeDocDe, TypeDocA, RESULTAT) CIALTiersRemise (CT_Num, Debut, Fin, TypeDocDe, TypeDocA, RESULTAT) CIALTiersSolde(CT_NUM, Résultat) CIALTiersEchus1(CT_NUM, RESULTAT)...45 CIALTiersEchus2(CT_NUM, RESULTAT)...45 CIALTiersEchus3(CT_NUM, RESULTAT)...46 CIALTiersNonEchus(CT_NUM, RESULTAT)...46 CIALTiersDepassement1(CT_NUM, RESULTAT)...46 CIALTiersDepassement2(CT_NUM, RESULTAT)...47 CIALTiersBLFA(CT_NUM, RESULTAT)...47 CIALTiersRisque(CT_NUM, RESULTAT)...47 CIALTiersBC(CT_NUM, RESULTAT)...48 CIALTiersFact(CT_NUM, RESULTAT)...48 CIALTiersRegl(CT_NUM, RESULTAT)...48 CIALArtCAHTBrut (AR_Ref, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...49 CIALArtCAHTNet (AR_Ref, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...49 CIALArtCATTC (AR_Ref, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...50 CIALArtRemise (AR_Ref, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...51 CIALArtPrixRevient (AR_R ef, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat) 51 CIALArtMarge (AR_Ref, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...52 CIALArtQuantites (AR_Ref, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...53 CIALArtQtesColisee (AR_Ref, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...53 III Sage France

6 Sommaire général CIALArtPoidsNet (AR_Ref, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat) CIALArtPoidsBrut (AR_Ref, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat) CIALArtMarge (AR_REF, CT_NumA, CT_NumDe, Debut, Fin, TypeDocDe, TypeDocA, Résultat) CIALArtCompteA (AR_Ref, Domaine, CatCompta, Résultat) CIALArtCompteG (AR_Ref, Domaine, CatCompta, Résultat) CIALArtTaxe1 (AR_Ref, Domaine, CatCompta, Taxe1) CIALArtTaxe2 (AR_Ref, Domaine, CatCompta, Résultat) CIALArtTaxe3 (AR_Ref, Domaine, CatCompta, Résultat) CIALArtPrixCat (AR_Ref, CatTarif, AG_No1, Ag_No2, Résultat) CIALArtCoefCat (AR_Ref, CatTarif, Résultat) CIALArtPrixClient (AR_Ref, CT_Num, CatTarif, AG_No1, AG_No2, Résultat) CIALArtCoefClient (AR_Ref, CatTarif, Résultat) CIALArtPrixFourniss(AR_Ref, CT_NUM,AG_NO1, AG_NO2, Résultat) CIALFamCAHTBrut (Fa_CodeFamille, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat) CIALFamCAHTNet (Fa_CodeFamille, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat) CIALFamCATTC (Fa_CodeFamille, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat) CIALFamRemise (Fa_CodeFamille, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...62 CIALFamPrixRevient (Fa_CodeFamille, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...63 CIALFamMarge (Fa_CodeFamille, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...64 CIALFamQuantites (Fa_CodeFamille, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...64 CIALFamQtesColisee (Fa_CodeFamille, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...65 CIALFamPoidsNet (Fa_CodeFamille, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...66 CIALFamPoidsBrut (Fa_CodeFamille, CT_NumDe, CT_NumA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...66 CIALRepCAHTBrut (RE_No, CT_NumDe, CT_NumA, AR_RefDe, AR_RefA, FA_CodeFamilleDe, FA_CodeFamilleA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...67 CIALRepCAHTNet (RE_No, CT_NumDe, CT_NumA, AR_RefDe, AR_RefA, FA_CodeFamilleDe, FA_CodeFamilleA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...68 CIALRepCATTC (RE_No, CT_NumDe, CT_NumA, AR_RefDe, AR_RefA, FA_CodeFamilleDe, FA_CodeFamilleA, Debut, Fin, TypeDocDe, TypeDocA, Résultat)...69 CIALRepRemise (RE_No, CT_NumDe, CT_NumA, AR_RefDe, AR_RefA, FA_CodeFamilleDe, FA_CodeFamilleA, IV Sage France

7 Sommaire général Debut, Fin, TypeDocDe, TypeDocA, Résultat) CIALRepPrixRevient (RE_No, CT_NumDe, CT_NumA, AR_RefDe, AR_RefA, FA_CodeFamilleDe, FA_CodeFamilleA, Debut, Fin, TypeDocDe, TypeDocA, Résultat) CIALRepMarge (RE_No, CT_NumDe, CT_NumA, AR_RefDe, AR_RefA, FA_CodeFamilleDe, FA_CodeFamilleA, Debut, Fin, TypeDocDe, TypeDocA, Résultat) CIALRepQuantites (RE_No, CT_NumDe, CT_NumA, AR_RefDe, AR_RefA, FA_CodeFamilleDe, FA_CodeFamilleA, Debut, Fin, TypeDocDe, TypeDocA, Résultat) CIALRepQtesColisee (RE_No, CT_NumDe, CT_NumA, AR_RefDe, AR_RefA, FA_CodeFamilleDe, FA_CodeFamilleA, Debut, Fin, TypeDocDe, TypeDocA, Résultat) CIALRepPoidsNet (RE_No, CT_NumDe, CT_NumA, AR_RefDe, AR_RefA, FA_CodeFamilleDe, FA_CodeFamilleA, Debut, Fin, TypeDocDe, TypeDocA, Résultat) CIALRepPoidsBrut (RE_No, CT_NumDe, CT_NumA, AR_RefDe, AR_RefA, FA_CodeFamilleDe, FA_CodeFamilleA, Debut, Fin, TypeDocDe, TypeDocA, Résultat) CIALStockVal(DE_No, AR_REF, AG_NO1,AG_NO2, Date, Résultat) CIALStockQte(DE_No, AR_REF, AG_NO1,AG_NO2, Date, Résultat) GetParamValeurStr (TypeBase, NomTable, NomChamp, Résultat) GetParamValeurDbl (TypeBase, NomTable, NomChamp, Résultat) GetParamValeurEnt (TypeBase, NomTable, NomChamp, Résultat)...79 GetParamValeurDate (TypeBase, NomTable, NomChamp, Résultat)...79 GetParamReplication (TypeBase, Résultat)...80 GetParamType (TypeBase, Fichier, Field, Résultat)...80 Description des fonctions avancées de la Paie Maestria Windows FSalCumul (SA_Num, RB_Num, Debut, Fin, Résultat)...82 FSALCumulbase (SA_Num, RB_Num, Debut, Fin, Résultat)...82 FSALCumulCotPat (SA_Num, RB_Num, Debut, Fin, Résultat)...83 FSALCumulRes (SA_Num, RB_Num, Debut, Fin, Résultat)...83 FSALCumulTaux (SA_Num, RB_Num, Debut, Fin, Résultat)...84 FSALCumulTauxPat (SA_Num, RB_Num, Debut, Fin, Résultat)...84 Description des objets de l ActiveX Sage 85 Introduction Principe d utilisation de L ActiveX Sage Exemple de Propriétés de l objet CPTA (base comptable) TotalMvtDebit (CG_Num, CT_Num, JO_Num, Deb, Fin)...87 Exemple de propriétés de l objet CIAL (Gestion Commerciale) LigneMontantHT (DL_NO)...88 V Sage France

8 Sommaire général TiersCAHTBrut (CT_NUM, Debut, Fin, TypeDocDe, TypeDocA) Propriétés de l objet Param (pages paramètres) GetParamValeurStr (TypeBase, NomTable, NomChamp) Propriétés de l objet Fsal (la paie Maestria Windows) FSalCumul (SA_Num, RB_Num, Debut, Fin) Chapitre 3 Description des exemples fournis avec le Kit ODBC 91 Base Exemple ACC2000EX.MDB sous Microsoft Access Introduction Contenu de la base ACC2000EX.MDB Visualisation de tous les Champs des tables de la Base Etat : Annuaire Client Etat : Palmarès Client Etat : Grand Livre Tiers Etat : Distribution Analytique Etat : balance des comptes Etat : Mouvements articles Etat : tarifs par catégorie tarifaire Exemple d écriture dans un journal Exemple d écriture dans un Document de vente Utilisation des fonctions avancées de Comptabilité et de Gestion Commerciale Exemple de génération automatique de documents en gestion commerciale...94 Exemple de génération automatique d articles...95 Exemple de génération automatique d écritures comptables...95 Base de Données ODBCNEW2000.MDB sous Microsoft Access Contenu de la base de données Utilisation des formulaires fournis Aide à la création de requêtes et états...97 Visualisation des champs de toutes les tables de votre base...97 Fichier Exemple Exc2000odbc.xls sous Microsoft Excel Contenu de cet exemple...98 Etat CompteT.rpt sous Crystal Reports Contenu de cet exemple...98 Annexe 1 Rappel sur le langage SQL 99 Remarques générales 100 Ajout d un enregistrement Modification d enregistrements Suppression d Enregistrements Exemples de requêtes Exemple VI Sage France

9 Sommaire général Exemple Exemple Annexe 2 Fonctions SQL supportées par Sage ODBC Ligne Grammaire SQL supportée par le driver 104 Fonctions de la grammaire ODBC supportées par le driver Sage Ligne Fonctions sur les chaînes de caractères CONCAT (Chaîne1, Chaîne2) LENGTH (CHAINE) RIGHT (CHAINE, NB) UCASE (CHAINE) LCASE (CHAINE) LOCATE (CHAINE1, CHAINE2, [START]) RTRIM (CHAINE) LEFT (CHAINE, NB) LTRIM (CHAINE) SUBSTRING (CHAINE, DEBUT, LONG) MOD (ENTIER1, ENTIER2) Fonctions sur les dates CURDATE () DAYOFMONTH (DATE) MONTH (DATE) CURTIME () DAYOFWEEK (DATE) YEAR (DATE) Fonctions système DATABASE () USER () Annexe 3 Conseils d optimisation 112 Les éléments perturbants 113 Annexe 4 Les codes erreurs Sage 114 Description des erreurs générales CBASE 115 Description des codes erreurs des fonctions évoluées 117 Erreurs en écriture dans les différentes applications 121 Annexe 5 Les erreurs les plus fréquentes 178 Avant propos 179 Mauvaise version de fichier Erreur Sage 5002 obtenue au moment de l exécution d une requête d écriture Refus d'autorisation erreur Sage 1807 obtenue au moment de l exécution d une requête d écriture VII Sage France

10 Sommaire général Domaine de validité du champ incorrect, veuillez vous référer à la documentation Annexe 6 Utilisation d ODBC avec Visual Basic 181 Introduction 182 Les ADO Connexion Déconnexion Recherche d enregistrements Ecriture dans les bases Récupération des erreurs Les DAO Connexion Déconnexion Recherche d enregistrements Ecriture dans les bases Récupération des erreurs Annexe 7 Utilisation d ODBC avec Windev 201 Introduction 202 Connexion Déconnexion Recherche d enregistrements 204 Ecriture dans les bases 206 Récupération des erreurs Syntaxe de la procédure SQLInfoGene Fonctions disponibles Annexe 8 Utilisation d ODBC avec Visual FoxPro 211 Introduction 212 Les vues distantes Programmation en Visual FoxPro Connexion Déconnexion Recherche d enregistrements Ecriture dans les bases Récupération des erreurs Annexe 9 Utilisation d ODBC avec Delphi 221 Introduction 222 Connexion Déconnexion 223 Recherche d enregistrements 224 Utilisation de l objet TQuery Utilisation de l objet TTable Ecriture dans les bases 229 Utilisation de l objet TQuery Utilisation de l objet TTable Récupération des erreurs 234 VIII Sage France

11 Sommaire général Annexe 10 Utilisation des fonctions avancées Sage 237 Introduction 238 API Sage DLL ActiveX Principe d utilisation Descriptif des fonctions utilisées dans les exemples TotalMvtSolde (CG_Num, CT_Num, JO_Num, Deb, Fin, [Résultat] ) CIALDocNouvPiece (DO_Type, DO_SOUCHE, [Résultat] ) GetParamValeurDate (TypeBase, NomTable, NomChamp, [Résultat] ) Visual Basic 242 API Sage TotalMvtSolde () CIALDocNouvPiece () GetParamValeurDate () DLL ActiveX TotalMvtSolde () CIALDocNouvPiece () GetParamValeurDate () GetParamValeurDate () DLL ActiveX Visual FoxPro 253 API Sage TotalMvtSolde () CIALDocNouvPiece () GetParamValeurDate () DLL ActiveX Déclaration des fonctions avancées Sage Delphi 257 API Sage TotalMvtSolde () CIALDocNouvPiece () GetParamValeurDate () DLL ActiveX TotalMvtSolde () CIALDocNouvPiece () GetParamValeurDate () Déclaration des fonctions avancées Sage Déclaration des fonctions avancées Sage WinDev 248 API Sage TotalMvtSolde () CIALDocNouvPiece () IX Sage France

12 Chapitre 1 Généralités sur le programme Définition d ODBC 2 Principe de fonctionnement 2 Compatibilité avec les bases de la ligne 100 Windows 3 Principe d utilisation dans les applications 4 Contenu du Kit ODBC Sources de données 7 Définition 7 Types de Sources de Données 9 Création d une source de données Sage 11 1

13 Chapitre 1 Généralités sur le programme Définition d ODBC La norme ODBC (Open Database Connectivity) permet de se connecter à une source d informations externe et d utiliser ses données. Elle est gérée par le Gestionnaire ODBC qui contient les drivers nécessaires à cette procédure. Ce gestionnaire se place automatiquement dans le Panneau de configuration de Microsoft Windows lors de l installation de la plupart des bases de données. Les drivers des fichiers que vous souhaitez interroger sont, en général, installés automatiquement avec la plupart des applications. Principe de fonctionnement La norme ODBC permet aux applications qui l utilisent, d exploiter la pleine puissance du langage de requête SQL (Structured Query Language). Elle est généralement utilisée pour les connexions aux bases implantées sur des serveurs. Des drivers ODBC sont disponibles pour Oracle, Microsoft SQL Server, Sybase SQL Server et de nombreux autres gestionnaires de bases de données sur un grand nombre de plates-formes. Le schéma ci-après permet de comprendre le fonctionnement d ODBC. L application envoie une requête SQL. Le Driver Manager intercepte cet appel et le redirige vers le bon driver ODBC. Ce driver analyse alors la requête SQL puis récupère les données par l intermédiaire de la source de données. Ces données sont alors renvoyées à l application. La source de données est donc le lien entre l application et le fichier physique. 2

14 Chapitre 1 Généralités sur le programme Compatibilité avec les bases de la ligne 100 Windows Avec Sage Kit ODBC 100, vous pouvez accéder aux bases (fichier physique) des principaux produits de la ligne 100 propriétaire, à savoir : Comptabilité 100, Gestion Commerciale 100, Saisie de Caisse Décentralisée 100 Immobilisations 100 Moyen de paiement 100 Manager 100 Paie Windows 100 La plupart des tables sont en lecture/écriture. Vous trouverez plus avant le détail de chaque table en lecture et écriture. 3

15 Chapitre 1 Généralités sur le programme Principe d utilisation dans les applications Chaque application compatible ODBC peut se connecter aux bases de la ligne 100 Windows. Les applications compatibles ODBC testées sont décrites en Annexe de ce guide. Le principe est en fait le même pour chaque application. On se connecte à une source de données qui permet d accéder aux données que l on désire via des requêtes SQL. Les données peuvent être alors lues à partir d un système de gestion de bases de données comme Microsoft Access ou de générateurs de requêtes comme Query de Microsoft Excel qui utilisent le gestionnaire ODBC. Vous pouvez ainsi générer dans Microsoft Access vos propres modèles d impression en sélectionnant les données dont vous avez réellement besoin et en les présentant sous la forme de formulaires ou d états que vous paramétrez très facilement. De plus, il vous est possible avec Microsoft Excel par l intermédiaire de Microsoft Query, de créer des graphiques complexes avec vos données de gestion. Pour l écriture dans les bases de la ligne 100 Windows, des explications et des exemples sont fournis dans ce guide. Néanmoins, pour l écriture, il vaut mieux utiliser un outil de développement comme par exemple Visual basic ou Delphi pour pouvoir gérer les différents cas possibles d erreurs. Ces erreurs sont gérées par le driver. Si par exemple vous détruisez un compte alors qu il y a des écritures associées, le driver renverra une erreur et ne créera pas le compte. Il faudra intercepter cette erreur et en fonction du type de l erreur agir en conséquence. 4

16 Chapitre 1 Généralités sur le programme Contenu du Kit ODBC 100 Base de Données : ACC2000EX.MDB de Microsoft ACCESS La base de données ACC2000EX.MDB fournie avec le kit, vous permet de vous familiariser avec la structure des Fichiers ligne 100 via ODBC (en l occurrence pour l exemple fourni, ceux de la Comptabilité 100, la Gestion commerciale 100) et vous montre au travers de certains Formulaires et Etats ce que l on peut faire réellement avec ODBC au travers notamment d exemples d écriture dans les bases Sage. Base de Données: ODBCNEW2000.MDB de Microsoft ACCESS Cette base de données contient plusieurs formulaires déjà fournis dans la base de données exemple ACC2000EX.MDB. Vous pouvez toutefois, vous en servir si vous créez votre propre base avec des attaches de tables du Kit ODBC 100. Le premier formulaire vous permet de créer automatiquement les jointures entre les tables, le deuxième vous montre les champs de toutes les tables de votre base et le troisième vous permet de créer le descriptif de chaque champ des tables ODBC. Exemple d utilisation du Driver ODBC 100 avec Excel et Visual Basic (ExExc2000.XLS) Ce classeur vous présente des exemples de connexion à ODBC avec Microsoft Excel via Visual Basic. Bases Bijou Les fichiers d exemples sont ceux de la base BIJOU, à savoir C_Bijou.Mae, G_Bijou.Gcm, IM_Bijou.Imo et T_Bijou.Mdp. Exemple sur Crystal Report version 8 : COMPTET.RPT Exemple d état créé avec Crystal Report : Grand-livre des Tiers. Fichier texte : t_descri.txt Descriptif de toutes les tables, champs ODBC. 5

17 Chapitre 1 Généralités sur le programme Fichier texte : fonction.txt Déclaration des fonctions évoluées dans Visual Basic (Visual Basic, Access et Excel ), Delphi et Visual FoxPro. Fichier texte : erreurs.txt Description de l'ensemble des codes erreurs pour l'écriture dans les bases de la ligne 100 Windows. Fichier ActiveX.Txt Description de l ensemble des objets de l activex ASD100.Dll avec leurs propriétés et méthodes. 6

18 Chapitre 1 Généralités sur le programme Sources de données Définition Une source de données est le lien entre l application et le driver ODBC. Elle est composée de 2 éléments : Un Driver ODBC, Un ou plusieurs fichiers physiques associés. Vous trouverez ci-dessous les différents cas suivant le type de base de données Sage Ligne 100. Comptabilité 100 Driver : Sage Comptabilité 100 Fichier physique : fichier comptable (*.MAE) Gestion Commerciale 100 Driver : Sage Gestion commerciale 100 Fichiers physiques : fichier commercial (*.GCM) fichier comptable (*.MAE) Les mots de passe de ces fichiers (mots de passe des applications Comptabilité 100 et Gestion Commerciale 100) doivent être identiques, sinon la connexion échouera. Immobilisations 100 Driver : Sage Immobilisations 100 Fichiers physiques : fichier immobilisations (*.IMO) fichier comptable (*.MAE) 7

19 Chapitre 1 Généralités sur le programme Manager 100 Driver : Sage Manager 100 Fichiers physiques : fichier bibliothèque (*.CHP) fichier annexe (*.CHL) Moyen de Paiement 100 Driver : Sage Moyen de Paiement 100 Fichiers physiques : Fichier moyens de paiement (*.MDP) fichier comptable (*.MAE) Paie Windows 100 Driver : Sage Paie 100 Fichier physique : fichier paie (*.PRH) 8

20 Chapitre 1 Généralités sur le programme Types de Sources de Données Il existe 3 types de sources de données : Utilisateur, Système, Fichier. Utilisateur Une source de données de type «Utilisateur» n est visible que par l utilisateur connecté sur sa machine et uniquement sur celle-ci. Un utilisateur connecté sur un poste Windows NT sous le login «DUPONT» ne verra donc que les sources de données que celui-ci a créées sur cette machine. Système Une source de données de type «Système» est visible par tous les utilisateurs connectés sur sa machine et uniquement sur celle-ci. Un utilisateur connecté sur un poste Windows NT sous le login «DUPONT» verra donc toutes les sources de données créées sur cette machine. Ce type de sources de données est utile lorsque vous voulez par exemple exécuter une tâche planifiée pour un programme que vous avez créé. Le compte sous lequel va s exécuter la tâche est généralement le compte SYSTEM ou un compte qui n est pas celui avec lequel vous testez votre programme. Si vous utilisez une source de données «Utilisateur» la tâche planifiée provoquera une erreur, mais fonctionnera correctement si vous utilisez une source de données de type SYSTEM. Fichier Les sources de données File DSN fournies sont ComptaC_Bijou.dsn GestcomG_Bijou.dsn Param_Bijou.dsn Immo_Bijou.dsn PaieP_Essai.dsn 9

21 Chapitre 1 Généralités sur le programme Ce fichier a le format suivant : [ODBC] DSN=Nom_Source_de_données_existante (système ou utilisateur) La source de données système ou utilisateur doit exister sur votre poste. 10

22 Chapitre 1 Généralités sur le programme Création d une source de données Sage La création d une source de données Sage s effectue via l administrateur ODBC 32 bits du Panneau de configuration. Ci-dessous est explicité un exemple de création d une source de données Utilisateur de type «Gestion commerciale 100» : GestCom_Ligne Cliquez sur l icône «ODBC 32 bits» sous Windows 95 ou 98, ou sur «Sources de données (ODBC)» dans «Outils d administration» sous Windows NT 4, 2000 ou XP. 11

23 Chapitre 1 Généralités sur le programme 2. Cliquez sur le bouton Ajouter. 3. Cliquez sur le bouton Terminer. 4. Sélectionnez dans la fenêtre «Installation CBase», les fichiers respectivement de comptabilité et de gestion commerciale (*.GCM) et (*.MAE). 12

24 Chapitre 1 Généralités sur le programme 5. Cliquez alors sur le bouton OK pour terminer la création de cette source de données. Le premier fichier est obligatoire, le deuxième est facultatif. Cette association vous permet d'ouvrir directement toutes les tables de gestion commerciale et de comptabilité, ou toutes les tables d'immobilisations et de comptabilité, de même pour les autres bases. Pour l'exemple ci-dessus, si vous utilisez Microsoft QUERY, en sélectionnant la source de données Gestcom_Ligne100 vous verrez alors à la fois les tables de gestion commerciale et de comptabilité, comme ci-dessous. Lorsque le paramétrage est effectué, cliquez sur le bouton OK pour enregistrer cette Source de Données. L écriture des informations relatives à cette source de données s effectue dans la Base de Registre de Windows. 13

25 Création d une DSN de type fichier Automatiquement à la création de DSN utilisateur ou DSN système Lorsque vous créez des sources utilisateurs ou systèmes, une source de données de type fichier (File DSN) est automatiquement créée avec le nom de la source de données utilisateur ou système avec l extension.dsn. Manuellement Il n est pas possible de créer directement des sources de données de type fichier par l administrateur ODBC 32 bits. Vous devez créer ce fichier de toute pièce. Voici ci-dessous un exemple d un tel fichier : édition du fichier ComptaC_Bijou.dsn [ODBC] DSN=ComptaC_Bijou Il suffit donc d indiquer dans la première ligne : [ODBC] Sur la deuxième ligne, indiquer : DSN= et le nom d une source de données utilisateur ou système existante, ici ComptaC_Bijou. Enregistrer ensuite ce fichier dans le répertoire Program Files\Fichiers communs\odbc\data Sources avec l extension.dsn. Ce répertoire par défaut peut être changé grâce à l administrateur ODBC 32 bits. Intérêt de ce type de sources de données Certains programmes, comme Microsoft Query, demandent exclusivement des sources de données de type fichier (File DSN). Le seul moyen pour que cela fonctionne avec ce logiciel est de créer auparavant des File DSN, comme ci-dessus, soit manuellement, soit automatiquement. Vous pourrez ensuite avoir accès à cette source de données dans Microsoft Query et l utiliser, comme toute autre source de données. 14