L100 Programmes Externes

2009 Sage

Sage 100

Version 16

Programmes externes

2009 Sage

Composition du progicielVotre progiciel est compos d'un botier de rangement comprenant :

le cdrom sur lequel est enregistr le programme, la documentation lectronique, prsente sur le cdrom.

Proprit & UsageTout usage, reprsentation ou reproduction intgral ou partiel, fait sans le consen-tement de Sage est illicite (Loi du 11 Mars 1957 - Loi du 3 Juillet 1985). Ils cons-titueraient une contrefaon sanctionne par les articles 425 et suivants du Code Pnal.

Tous droits rservs dans tous pays.

Logiciel original dvelopp par Sage.

Documentation Sage.

Toute utilisation, quelque titre que ce soit, non autorise dans le cadre de la con-vention de licence, est strictement interdite sous peine de sanctions pnales (Loi du 3 Juillet 1985, Art. 46).

Conformit & Mise en gardeCompte tenu des contraintes inhrentes la prsentation sous forme de manuel lectronique, les spcifications vises dans la prsente documentation consti-tuent une illustration aussi proche que possible des spcifications.

Il appartient au client, paralllement la documentation, de mettre en uvre le progiciel pour permettre de mesurer exactement l'adquation de ses besoins aux fonctionnalits.

Il est important, pour une utilisation sre et oprationnelle du progiciel, de lire pralablement la documentation.

EvolutionLa documentation correspond la version rfrence. Entre deux versions, des mises jour du logiciel peuvent tre opres sans modification de la documenta-tion. Toutefois, un additif peut tre joint la documentation existante pour prsen-ter les modifications et amliorations apportes ces mises jour.

La fiche SuggestionSage recherche une constante amlioration du progiciel et de sa documentation. Nous invitons notre clientle nous faire parvenir ses suggestions et les ven-tuels dfauts ou erreurs qu'elle pourrait relever sur la fiche suggestion figurant en dernire page du manuel.

Les noms de produits ou de socits, toute image, logo ou reprsentation visuelle mentionns dans ce document ne son utiliss que dans un but didentification et peuvent constituer des marques dposes par leurs propritaires respectifs.

SAGE SAS - Socit par Actions Simplifie au capital social de 500.000 eurosSige social : le Colise II, 10 rue Fructidor 75834 Paris Cedex 17

R.C.S. Paris 313 966 129 - Code APE 5829C.La socit Sage est locataire grante des socits Sage FDC, Euratec, Ciel,

Adonix et XRT.

Gnralits

2009 Sage 1

Sommaire

Gnralits ___________________________________ 5 Description de la fonction ....................................................... 5

Intitul________________________________________________ 6

Contexte ______________________________________________ 6

Type de programme _____________________________________ 6 Excutable ......................................................................... 6 Lien Internet....................................................................... 6 Page Web intgre................................................................ 7 Lien Internet intgr ............................................................. 8 Script intgr ...................................................................... 8

Ligne de commande _____________________________________ 8

Arguments _____________________________________________ 9

Attendre la fin de lexcution de la commande ________________ 9

Fermer la socit en cours avant excution ___________________ 9 Contextes et arguments........................................................ 10 Slection des arguments ....................................................... 10

Liste des contextes par application _______________ 12 Sage 100 Comptabilit ......................................................... 12 Sage 100 Gestion commerciale ............................................... 13 Sage 100 Saisie de caisse dcentralise ..................................... 15 Sage 100 Immobilisations ...................................................... 15 Sage 100 Moyens de paiement ................................................ 16 Sage 100 Trsorerie............................................................. 16 Sage 100 Etats comptables et fiscaux ....................................... 16

Liste des arguments par contexte_________________ 17 Global ........................................................................... 17 Tiers ........................................................................... 18 Sections analytiques ............................................................ 18 Banques ........................................................................... 19 Ecritures comptables ........................................................... 20 Articles ........................................................................... 21 Documents des ventes.......................................................... 21 Documents des achats.......................................................... 23

Gnralits

2009 Sage 2

Documents des stocks .......................................................... 24 Documents internes............................................................. 25 Lignes de document ............................................................ 26

Fonction publie _______________________________________ 27 Collaborateurs ................................................................... 27 Ressources........................................................................ 27 Dpts ........................................................................... 28 Immobilisations.................................................................. 28 Lieux de biens ................................................................... 29 Prvisions......................................................................... 29

Lignes de commandes - fonctions publies__________ 30 Options ........................................................................... 31 Sparateurs ...................................................................... 32

Caractre quote _______________________________________ 32

Caractre escape_______________________________________ 35

Caractre simple quote __________________________________ 36 Autorisations daccs........................................................... 37 Fonctions publies .............................................................. 37

Mthodes _____________________________________________ 37

Paramtres ___________________________________________ 38 Liste des fonctions par application........................................... 39

Sage 100 Comptabilit___________________________________ 39 Cration / Visualisation dun Tiers........................................... 39 Saisie / Visualisation dune pice .......................................... 40 Saisie des journaux ............................................................. 40 Interrogation tiers .............................................................. 40 Interrogation gnrale ......................................................... 41 Interrogation analytique ....................................................... 41 Rappel / relev.................................................................. 41 Recherche des critures ....................................................... 41 Import au format Sage 30 et 100 ............................................. 42 Import au format paramtrable .............................................. 42 Lettrage .......................................................................... 42 Intgration des extraits de compte .......................................... 42

Sage 100 Gestion commerciale ____________________________ 43 Cration / Visualisation dun Tiers........................................... 43 Visualisation dun Document (Achat, vente, stock ou interne).......... 43 Documents de vente............................................................ 44 Documents dachat ............................................................. 45

Gnralits

2009 Sage 3

Documents de stock ............................................................ 46 Documents internes............................................................. 47 Rapprovisionnement .......................................................... 47 Interrogation de compte client ou fournisseur ............................. 47 Interrogation de compte article .............................................. 48 Interrogation de compte affaire.............................................. 48 Interrogation de compte collaborateur...................................... 49 Inventaire ........................................................................ 49 Contrle qualit................................................................. 49 Picking ............................................................................ 49 Mise jour comptable.......................................................... 50 Visualisation de la fiche article............................................... 50 Cration d'une fiche article ................................................... 50

Sage 100 Trsorerie ____________________________________ 51 Cration / Visualisation dun Tiers........................................... 51 Import au format paramtrable .............................................. 51 Synthse de trsorerie ......................................................... 52 Intgration des extraits de compte .......................................... 52 Intgration des MCF ............................................................ 52

Sage 100 Moyens de paiement ____________________________ 53 Intgration des extraits de compte .......................................... 53 Intgration des relevs de LCR payer ..................................... 54 Edition des fichiers bancaires reus.......................................... 54 Intgration des relevs MCF................................................... 55 Intgration de tout type de fichier........................................... 55

Exemples de programmes externes _______________ 57 Appel dune application Sage 100 depuis une autre application Sage 100 .......................................................................... 57

Exemple 1 Ouverture d'une facture de la gestion commerciale depuis les critures comptables ________________ 57

Exemple 2 Affichage d'une pice comptable depuis la Gestion Commerciale __________________________________________ 58 Appel dune application Externe depuis une application Sage 100 ..... 60

Exemple 1 Utilisation de donnes Sage dans un programme externe ______________________________________________ 60

Exemple 2 Ouverture d'un document PDF __________________ 61 Appel dune application Sage 100 depuis une application externe ..... 62

Exemple 1 Utilisation de code Visual Basic__________________ 62

Gnralits

2009 Sage 4

Exemple 2 Ouverture de la Comptabilit depuis l'invite de commande Windows ____________________________________ 63 Appel dune page Web intgre .............................................. 64

Exemple Rsum Tiers _________________________________ 64 Rcupration des donnes dans les bases Sage 100 ....................... 65 Code html ........................................................................ 66 Implmentation de la page Web Intgre sous une application Sage 10068 Appel dun Script intgr ...................................................... 69

Exemple Ajout d'une ligne dans un document de vente________ 69 Implmentation du Script Intgr sous Sage 100 Gestion commerciale 69

Gnralits

2009 Sage 5

Gnralits

Les programmes externes publis par les applications Sage 100 permettent de raliser diffrents types de traitements :

A partir dune application Sage 100, dappeler et excuter une autre application : il peut sagir dune application Sage 100 ou de tout autre application (fichier xls, script, excutables, page Web). Suivant le type de programme externe, le dveloppement appel peut tre intgr aux applications Sage 100, il sera donc dpendant de celles-ci (cas des programmes externes de type Lien Internet, Page Web et Script intgrs). Le paramtrage permettant dexcuter une application externe depuis une application Sage 100 seffectue partir de lapplication Sage 100, sous longlet Programmes externes (menu Fentre / Personnaliser l'interface).

A partir dune application externe, dexcuter une application Sage 100 : depuis lapplication externe, des commandes spcifiques devront tre implmentes pour appeler et excuter une application Sage 100.

Ces fonctionnalits permettent par exemple :

Depuis une ligne dcriture de Sage 100 Comptabilit, de visualiser la facture correspondante sous Sage 100 Gestion commerciale ou dafficher un document pdf correspondant au numro de facture de lcriture comptable.

De dvelopper une application permettant dexcuter une application Sage 100 et dafficher automatiquement, la fiche dun compte tiers, dun article, de se placer en saisie de journaux ou documents

De dvelopper une page Web permettant dafficher les donnes dun lment Sage 100 ou dexcuter un traitement sur llment appelant la page Web (affichage de la localisation dun tiers sous Google map, modification des frais dexpdition dun document par exemple). La page est dpendante de lenregistrement lappelant, ainsi elle sera automatiquement ferme lorsque llment Sage 100 dont elle dpend est ferm.

Toutes ces fonctionnalits sont disponibles dans les applications suivantes :

Sage 100 Comptabilit Sage 100 Gestion commerciale Sage 100 Saisie de caisse dcentralise Sage 100 Immobilisations Sage 100 Moyens de paiement Sage 100 Trsorerie Sage 100 Etats comptables et fiscaux

Description de la fonction

Le paramtrage seffectue depuis la fonction Menu Fentre / Personnaliser linterface / Onglet Programmes externes. La fentre suivante saffiche :

Gnralits

2009 Sage 6

Cette fentre est compose des lments suivants :

Intitul Identifiant du programme externe. Ce paramtre est une zone alphanumrique de 35 caractres maximum.

Contexte Contexte dexcution du programme externe. Le contexte est en fait le domaine de publication du programme externe. Par exemple, le contexte Global permet dexcuter le programme externe quelle que soit la fonction en cours dutilisation sous lapplication Sage 100, alors que le contexte Articles ne permettra dappeler le programme externe que depuis une fiche article. Vous retrouverez dans le chapitre suivant la liste des contextes publis par les applications Sage 100.

Type de programme

Les types de programmes publis par les applications sont les suivants :

Excutable

Ce type de programme permet de saisir ou slectionner le nom et emplacement dun programme excutable. Cest par le biais de ce type de programme quil sera possible par exemple, dexcuter Sage 100 Gestion commerciale depuis Sage 100 Comptabilit. Dans la zone arguments, il sera possible de spcifier les paramtres devant tre transmis lors de lexcution de la ligne de commande.

Lien Internet Ce type de programme permet de saisir une adresse internet ou URL afin dafficher une page Web dans une fentre indpendante lapplication Sage 100. Cette page sera gre par le navigateur internet dfinit par dfaut sur le poste de travail.

Exemple : localisation dune adresse sous Google Maps partir des informations du Tiers (Adresse, Code postal et Ville). Le programme crer sera le suivant :

Gnralits

2009 Sage 7

Par convention, le caractre ? est le sparateur entre lURL et les arguments. LURL excuter sous un navigateur devra donc tre la suivante :

http://maps.google.fr/maps?f=q&hl=fr&q=Rue%20t%C3%AAte%20dOr+57000+Metz Cependant, lexcution de ce programme externe depuis les applications Sage 100, le caractre ? est automatiquement ajout ds lors que des arguments sont spcifis. Il nest donc pas ncessaire de saisir ce caractre en fin de lURL renseigne dans la zone Adresse Internet.

Page Web intgre

Ce type de programme permet de saisir ou slectionner un fichier HTML qui sera affich dans une fentre de lapplication Sage 100. La fentre de slection propose par dfaut laffichage des fichiers de type page web (*.htm ; *.html). Il est cependant possible de slectionner tout type de fichier lisible dans Internet Explorer.

Le rsultat saffiche dans une fentre de lapplication Sage 100 et est totalement dpendante de lapplication. Ainsi, cette fentre sera automatiquement ferme :

Lors de lexcution de certains traitements entranant la fermeture de toutes les fentres ouvertes (cration nouvel exercice en comptabilit, dun nouveau programme externe, fermeture de la base de donnes),

A la fermeture de llment partir duquel la page a t appele. Par exemple, la fermeture de la fiche dun client, toutes les pages Web intgres ouvertes et associes ce client seront automatiquement fermes.

De plus, laffichage de cette fentre est rgi par loption Affichage libre des fentres. Par exemple, dans le cas dune association dune page Web au contexte Tiers, selon loption Affichage libre des fentres :

Option coche : il peut safficher autant de pages Web que de tiers diffrents, Option dcoche : une seule page est affiche puisquil ne peut y avoir quune seule

fiche tiers en cours.

Par contre, il peut safficher autant de pages Web que de programmes externes Page Web Intgre dfinis sur le contexte (Tiers dans notre exemple).

Enfin, les pages Web intgres permettent dexcuter certaines actions dans lapplication. Ces actions sont cibles sur le contexte ayant appel la page. Par exemple : une page Web appele depuis un document de vente, ne permet des actions que sur ce document de vente (et pas sur les tiers, ). Ces pages peuvent ainsi utiliser des objets et fonctions publis par les applications afin, dlaborer leur contenu partir de donnes de la base, et ventuellement de modifier des informations dans la base ouverte (modification de certains champs des documents commerciaux).

3 Remarque Les objets et fonctions publis par les applications sont dcrits dans les paragraphes suivants.

Gnralits

2009 Sage 8

Lien Internet intgr

Ce type de programme permet de saisir ladresse Internet ou lURL du site afficher (http://...).

3 Remarque Le bouton Parcourir nest pas disponible pour ce type de programme

Le fonctionnement est identique celui dun programme de type Page Web Intgre : le site Web correspondant l'URL saisie saffiche dans une fentre de lapplication, totalement dpendante de lapplication.

Script intgr

Ce type de programme permet de saisir ou slectionner un fichier Script excuter. La fentre de slection propose par dfaut l'affichage des fichiers de type scripts installs sur le poste : VBScript (*.vbs), JavaScript (*.js)

Comme dans le cas des pages Web Intgres, les scripts intgrs dpendent des applications Sage 100, ils peuvent donc accder aux objets et fonctions publies par celles-ci. Ces dveloppements tant encapsuls dans les applications Sage 100, certains comportements sont noter :

Si le script affiche une fentre modale (de type msgbox() ou alert() par exemple), l'application Sage 100 est dans l'attente de la fermeture de la fentre,

Si le script prvoit dexcuter une application externe (feuille de calcul des frais de port dans Microsoft Excel par exemple), cette application sexcutera en dehors de l'application et sera alors indpendante de l'application. Ainsi, le script devra donc prvoir d'attendre l'enregistrement et la fermeture de la feuille MS Excel, pour pouvoir lire les donnes de la cellule contenant les frais de port, et renvoyer l'information dans l'application Sage 100,

Si le script comporte une action dclenchant des contrles dans l'application et affichant une fentre de l'application (la validation d'une ligne peut entraner l'affichage de la fentre Conflit de remise par exemple), le script sera en attente de la fermeture de la fentre affiche pour poursuivre son droulement.

2 Attention Durant lexcution dun script, lapplication Sage 100 nest pas disponible tant que le script na pas fini de sexcuter. En consquence, si le script boucle, il faudra forcer la fermeture de lapplication Sage 100 pour pouvoir de nouveau y accder. Ainsi, il est vivement conseill dimplmenter dans le code du script, un mcanisme permettant dinterrompre le traitement en cours dans le cas o celui-ci bouclerait linfini

Toutes ces remarques sont galement valables pour le dveloppement des pages Web Intgres puisquil est possible dimplanter du script dans le code HTML.

Ligne de commande Chemin daccs au fichier excuter par le programme externe. Ce paramtre est une zone alphanumrique de 230 caractres maximum. A noter quun bouton Parcourir permet de rechercher et slectionner directement le fichier devant tre excuter par le programme externe.

Gnralits

2009 Sage 9

La zone Ligne de commande est renomme selon le type de programme externe slectionn :

Type de programme Libell du champ

Excutable Ligne de commande Lien Internet Adresse Internet Lien Internet intgr Adresse Internet Page web intgre Fichier Script intgr Fichier

Arguments Chane de caractres transmise en tant que argument au programme dfini sur le paramtre Ligne de commande. Cette chane de 1024 caractres maximum, peut galement contenir, des valeurs saisies manuellement (chanes de caractres par exemple) et des variables faisant rfrence des informations des bases de donnes Sage 100 (arguments du contexte slectionn). La liste des arguments disponible est fonction du contexte slectionn.

3 Remarque Lors de la saisie manuelle de paramtres, certains caractres systme (\ et $) doivent tre prcds dun caractre dchappement (\) afin quils puissent tre transmis lapplication appele. Pour plus de dtails sur cette fonction, se reporter lexemple Appel dune application Sage 100 depuis une autre application Sage 100 de ce manuel.

Selon le type de programme externe slectionn, la zone Arguments peut tre inaccessible :

Type de programme Zone Arguments disponible

Excutable Oui Lien Internet Oui Lien Internet Intgr Oui. Les arguments peuvent galement tre appels depuis le code la

page Web. Page Web Intgre Non. Les arguments doivent tre appels depuis le code la page Web. Script Intgr Non. Les arguments doivent tre appels depuis le code du Script.

Attendre la fin de lexcution de la commande Commande permettant de bloquer lutilisation de lapplication Sage 100 tant que lapplication appele na pas termin son traitement.

Cette case cocher est disponible uniquement pour le type de programme Excutable.

En effet, pour les autres types : Lien Internet s'excute dans le navigateur du poste, donc en dehors de l'application ; Lien Internet intgr, Page Web intgre et Script intgr s'excutent dans l'application. L'application ne reprend la main qu' la fin de leur excution.

Fermer la socit en cours avant excution

Cette case cocher est disponible uniquement pour le type de programme Excutable.

Cette option doit tre coche pour les traitements multi-socits utilisant les favoris (incorporation des rlvs par exemple), mais galement pour permettre l'excution d'une commande externe sur une autre socit.

En effet, lorsqu'une commande externe est excute partir dune application Sage 100, une seconde instance de l'application est lance, ce qui ncessite la prsence de Sage Serveur 100 pour fonctionner en multi-utilisateurs. Ainsi, cette option permet l'excution des commandes externes dans l'application mme en labsence du serveur.

Gnralits

2009 Sage 10

Contextes et arguments

Un programme externe est paramtr pour un contexte donn. Cela veut dire que le programme externe peut tre appel partir de nimporte quelle fonction faisant appel cet lment.

Exemple : lappel dun programme externe pour les Ecritures comptables peut tre effectu naturellement partir de la fonction Saisie des journaux, mais galement :

Les fonctions de saisie : Saisie par pice (mode Visualisation/modification), Les fonctions dinterrogation : Interrogation Tiers et Interrogation Gnrale, Recherche des critures gnrales, ...

3 Remarque Les programmes externes dfinis pour le contexte Global ne sont affichs et accessibles que si un fichier Sage 100 est ouvert.

Slection des arguments

La slection des arguments peut se faire de manire manuelle ou au moyen de la fentre prvue cette effet :

Lorsque des arguments sont slectionns, ils apparaissent dans la zone Arguments, prcds du sigle Dollar $ et sont entre parenthses (). Exemple : $(Dossier.RaisonSociale) A lexcution du programme externe, chaque argument est remplac par la donne Sage 100 y correspondant.

Par exemple, pour un dossier commercial dfini avec les informations suivantes :

Gnralits

2009 Sage 11

A lexcution dun programme externe contenant largument $(Dossier.RaisonSociale), ce paramtre sera remplac par la valeur Bijou SA.

Pour les champs informations libres (ou tout autre champ ncessitant la dfinition dun numro), le numro doit tre renseign entre des crochets []. Exemple : $(CompteT.InfoLibreValeur[1])

3 Remarque Pour le contexte Global, seuls les paramtres dits globaux peuvent tre utiliss. Les arguments des autres contextes, par exemple Rfrence du contexte Articles, ne peuvent pas tre utiliss depuis un programme externe dfini pour le contexte Global. De plus, les programmes externes dfinis pour le contexte Global ne sont affichs et accessibles que si un fichier Sage 100 est ouvert.

La liste prsente uniquement les arguments utilisables pour le contexte slectionn.

En saisie manuelle, si un argument non disponible pour le contexte est renseign (exemple : pour le contexte Article, saisie du Numro pice du document de vente), un message dalerte bloquant est affich la validation de la commande :

Cliquer sur le bouton [OK] pour revenir sur la fentre, largument incrimin sera slectionn.

3 Remarque Si un argument saisi manuellement doit contenir le caractre Dollar suivi de parenthses ouvrante et fermante $(test) par exemple, il devra tre prcd du caractre escape afin quil ne soit pas interprt en tant quargument du contexte. Exemple :

\$(test) Lorsque le caractre escape est omis, la validation de la commande, le message un ou plusieurs arguments ne sont pas valides ! sera renvoy. Vous retrouverez la description du caractre escape sous le paragraphe Lignes de commandes fonctions publies de ce manuel.

Liste des contextes par application

2009 Sage 12


Vous trouverez ci-aprs la liste des contextes publis par les applications. La colonne Publication dans lapplication Sage 100 prcise les fonctions Sage 100 correspondantes au contexte slectionn.

Par exemple, sous Sage 100 Comptabilit, lajout dun programme externe pour le contexte Banques, ajoutera un bouton de commande sur la fentre dune fiche banque (Menu Structure / Banques / Fiche Banque) :

Sage 100 Comptabilit

Contexte Publication dans lapplication Sage 100

Global Barre de menu, barre doutils et barre verticale

Tiers Menu Structure / Plan tiers / Fiche Plan tiers

Menu Traitement / Interrogation tiers (Entte)

Sections analytiques Menu Structure / Plan analytique / Fiche Plan analytique

Menu Traitement / Interrogation analytique

Banques Menu Structure / Fiche Banque

Ecritures comptables Menu Traitement / Saisie des journaux

Menu Traitement / Saisie par pice

Menu Traitement / Interrogation tiers (Liste)

Menu Traitement / Interrogation gnrale

Menu Traitement / Rapprochement bancaire manuel

Menu Traitement / Rapprochement bancaire automatique

Menu Traitement / Rglement tiers

Menu Traitement / Rappel/relev

Menu Traitement / Recherche des critures


2009 Sage 13

Sage 100 Gestion commerciale



Tiers Tiers de type Client :

Menu Structure / Clients / Fiche client

Menu Traitement / Interrogation du compte client / Interrogation du compte client - Comptable (Entte)

Menu Traitement / Interrogation du compte client / Interrogation du compte client - Commerciale (Entte)

Tiers de type Fournisseur :

Menu Structure / Fournisseurs / Fiche fournisseur

Menu Traitement / Interrogation du compte client / Interrogation du compte fournisseur - Comptable (Entte)

Menu Traitement / Interrogation du compte client / Interrogation du compte fournisseur - Commerciale (Entte)

Sections analytiques/Codes affaires

Menu Structure / Codes affaire / Fiche code affaire

Menu Traitement / Interrogation du compte affaire / Interrogation commerciale (Entte)

Menu Traitement / Interrogation du compte affaire / Interrogation comptable

Menu Traitement / Interrogation du compte affaire / Interrogation des documents (Entte)

Menu Traitement / Interrogation du compte affaire / Statistiques affaire par domaine

Menu Traitement / Interrogation du compte affaire / Statistiques affaire par famille

Articles Menu Structure / Fiche article

Menu Structure / Fiche nomenclature

Menu Structure / Fiche nomenclature (Liste)

Menu Traitement / Gestion des fabrications / Interrogation de compte nomenclature / Commerciale (Entte)

Menu Traitement / Gestion des fabrications / Interrogation de compte nomenclature / Gamme opratoire (Entte)

Menu Traitement / Gestion des fabrications / Interrogation de compte nomenclature / Stock (Entte)

Menu Traitement / Gestion des fabrications / Interrogation de compte nomenclature / Stock (Liste)

Menu Traitement / Interrogation de compte article / Interrogation commerciale (Entte)

Menu Traitement / Interrogation de compte article / Interrogation des tarifs (Entte)

Menu Traitement / Interrogation de compte article / Interrogation du stock (Entte)

Menu Traitement / Interrogation de compte article / Interrogation du stock prvisionnel (Entte)

Menu Traitement / Saisie dinventaire (Liste)

Menu Traitement / Suivi de traabilit / Interrogation commerciale (Entte)

Menu Traitement / Suivi de traabilit / Interrogation composs (Entte)

Banques Menu Structure / Comptabilit / Banques / Fiche Banque


2009 Sage 14


Documents des ventes Menu Traitement / Document des ventes (Entte)

Menu Traitement / Interrogation de compte collaborateur / Interrogation des documents (Liste), avec choix du type de document

Menu Traitement / Recherche de documents / Recherche enttes de documents, avec choix du type de document

Menu Traitement / Interrogation du compte affaire / Interrogation des documents (Liste), avec choix du type de document

Documents des achats Menu Traitement / Document des achats (Entte)




Documents des stocks Menu Traitement / Document des stocks (Entte)


Documents internes Menu Traitement / Documents internes (Entte)




Lignes de document Menu Traitement / Document des achats (Liste)

Menu Traitement / Document des stocks (Liste)

Menu Traitement / Document des ventes (Liste)

Menu Traitement / Documents internes (Liste)

Menu Traitement / Gestion des fabrications / Interrogation de compte nomenclature / Commerciale (Liste)

Menu Traitement / Interrogation de compte article / Interrogation commerciale (Liste)

Menu Traitement / Interrogation de compte article / Interrogation du stock prvisionnel (Liste)

Menu Traitement / Interrogation de compte collaborateur / Interrogation commerciale (Liste)

Menu Traitement / Interrogation du compte affaire / Interrogation commerciale (Liste)

Menu Traitement / Interrogation du compte client / Interrogation du compte client - Commerciale (Liste)

Menu Traitement / Interrogation du compte client / Interrogation du compte fournisseur - Commerciale (Liste)

Menu Traitement / Recherche de documents / Recherche de lignes de documents

Menu Traitement / Suivi de traabilit / Interrogation commerciale (Liste)

Menu Traitement / Suivi de traabilit / Interrogation composs (Liste)


2009 Sage 15


Collaborateurs Menu Structure / Collaborateurs / Fiche collaborateur

Menu Traitement / Interrogation de compte collaborateur / Interrogation commerciale (Entte)

Menu Traitement / Interrogation de compte collaborateur / Interrogation des documents (Entte)

Ressources Menu Structure / Fiche centre de charges

Menu Structure / Fiche ressource

Menu Traitement / Gestion des fabrications / Interrogation de compte nomenclature / Gamme opratoire (Liste)

Dpts Menu Structure / Dpts / Fiche dpt

Menu Traitement / Saisie dinventaire (Entte)

Sage 100 Saisie de caisse dcentralise



Tiers Tiers de type Client :

Menu Structure / Fiche client

Sections analytiques/Codes affaires

Menu Structure / Fiche code affaire

Articles Menu Structure / Fiche article

Menu Structure / Fiche nomenclature

Menu Structure / Fiche nomenclature (Liste)

Banques Menu Structure / Comptabilit / Fiche Banque

Documents des ventes Menu Traitement / Document des ventes (Entte)

Documents des stocks Menu Traitement / Document des stocks (Entte)

Lignes de document Menu Traitement / Document des stocks (Liste)

Menu Traitement / Document des ventes (Liste)

Menu Traitement / Saisie dinventaire

Collaborateurs Menu Structure / Fiche collaborateur

Dpts Menu Structure / Fiche dpt

Menu Traitement / Saisie dinventaire (Entte)

Sage 100 Immobilisations



Tiers Menu Structure / Comptabilit / Fiche Plan tiers

Sections analytiques Menu Structure / Comptabilit / Fiche Plan analytique

Immobilisations Menu Structure / Fiche Immobilisation

Menu Traitement / Gestion des immobilisations / Elment

Lieux de bien Menu Structure / Fiche Lieux des biens


2009 Sage 16

Sage 100 Moyens de paiement



Tiers Menu Structure / Fiche Plan tiers

Sections analytiques Menu Structure / Fiche Plan analytique


Sage 100 Trsorerie



Tiers Menu Structure / Comptabilit / Fiche Plan tiers


Prvisions Menu Traitement / Liste des prvisions

Sage 100 Etats comptables et fiscaux



Liste des arguments par contexte

2009 Sage 17


Dans ce chapitre, sont lists les arguments disponibles pour chaque contexte publi par les applications. La colonne L/E permet dindiquer le type daccs possible sur les arguments. Ainsi :

L : Lecture uniquement

L/E : Lecture et Ecriture

3 Remarque Lcriture sur les arguments nest possible que depuis des programmes externes de type : Lien Internet intgr, Page Web intgre et Script Intgr.

Global

Le contexte Global est disponible pour les applications suivantes :

Sage 100 Comptabilit Sage 100 Gestion commerciale Sage 100 Saisie de caisse dcentralise Sage 100 Immobilisations Sage 100 Moyens de paiement Sage 100 Trsorerie Sage 100 Etats comptables et fiscaux Les arguments publis sont les suivants :

Argument Description L/E Dossier.RaisonSociale Raison sociale L Dossier.FichierComptable Nom du fichier comptable L Dossier.LocalisationComptable Emplacement et nom du fichier comptable L Dossier.FichierCommercial Nom du fichier commercial L Dossier.LocalisationCommercial Emplacement et nom du fichier commercial L Dossier.FichierImmo Nom du fichier immobilisations L Dossier.LocalisationImmo Emplacement et nom du fichier immobilisations L Dossier.FichierMdp Nom du fichier moyens de paiement L Dossier.LocalisationMdp Emplacement et nom du fichier moyens de paiement L Dossier.FichierTreso Nom du fichier trsorerie L Dossier.LocalisationTreso Emplacement et nom du fichier trsorerie L Dossier.FichierEcf Nom du fichier tats comptables et fiscaux L Dossier.LocalisationEcf Emplacement et nom du fichier tats comptables et

fiscaux L

Dossier.Utilisateur Code utilisateur L Dossier.MotDePasse Mot de passe L

Les arguments du contexte Global sont galement disponibles sur les contextes dcrits ci-aprs.


2009 Sage 18

Tiers

Le contexte Tiers est disponible pour les applications suivantes :

Sage 100 Comptabilit Sage 100 Gestion commerciale Sage 100 Saisie de caisse dcentralise Sage 100 Immobilisations Sage 100 Moyens de paiement Sage 100 Trsorerie Les arguments publis sont les suivants :

Argument Description L/E

CompteT.Numero Numro du compte tiers L

CompteT.Intitule Intitul du tiers L

CompteT.InfoLibValeur[Numero] Information Libre L

CompteT.SIRET N SIRET du tiers L

CompteT.Adresse Adresse du tiers L

CompteT.CodePostal Code Postal du tiers L

CompteT.Ville Ville du tiers L

CompteT.Pays Pays du tiers L

CompteT.Telephone Tlphone : numro de tlphone du contact lorsque le programme externe est appel avec slection dun contact, sinon ce sera le numro de tlphone de la fiche identification

L

CompteT.Telecopie Tlcopie : numro de tlcopie du contact lorsque le programme externe est appel avec slection dun contact, sinon ce sera le numro de tlcopie de la fiche identification

L

CompteT.Portable Tlphone portable du tiers L

ClientLieuLivr.Adresse Adresse du lieu de livraison L

ClientLieuLivr.CodePostal Code Postal du lieu de livraison L

ClientLieuLivr.Ville Ville du lieu de livraison L

ClientLieuLivr.Pays Pays du lieu de livraison L

: Ces arguments ne sont disponibles qu partir des applications Sage 100 Gestion commerciale et Sage 100 Saisie de caisse dcentralise.

Sections analytiques

Le contexte Sections analytiques est disponible pour les applications suivantes :



2009 Sage 19

Sage 100 Gestion commerciale Sage 100 Saisie de caisse dcentralise Sage 100 Immobilisations Sage 100 Moyens de paiement Les arguments publis sont les suivants :


SectionA.Plan Intitul du Plan analytique / Plan affaire L

SectionA.Numero Section / Code affaire L

SectionA.Intitule Intitul de la section L

SectionA.InfoLibValeur(Numero) Information libre L

Banques

Le contexte Banques est disponible pour les applications suivantes :

Sage 100 Comptabilit Sage 100 Gestion commerciale Sage 100 Saisie de caisse dcentralise Sage 100 Moyens de paiement Sage 100 Trsorerie Les arguments publis sont les suivants :


Banque.Abrege Code abrg de la banque L

Banque.Intitule Intitul de la banque L

Banque.Telephone Tlphone : numro de tlphone du contact lorsque le programme externe est appel avec slection dun contact, sinon ce sera le numro de tlphone de la fiche identification

L

Banque.Telecopie Tlcopie : numro de tlcopie du contact lorsque le programme externe est appel avec slection dun contact, sinon ce sera le numro de tlcopie de la fiche identification

L

Banque.Portable Tlphone portable du contact banque L


2009 Sage 20

Ecritures comptables

Le contexte Ecritures comptables est disponible pour lapplication suivante :

Sage 100 Comptabilit Les arguments publis sont les suivants :










CompteT.Telephone Tlphone du tiers L

CompteT.Telecopie Tlcopie du tiers L

EcritureC.Date Date de pice de l'criture L

EcritureC. Piece Numro de pice de l'criture L

EcritureC.NumFacture Numro de facture de l'criture L

EcritureC.RefPiece Rfrence pice de lcriture L

EcritureC.InfoLibValeur[Numero] Valeur de linformation libre de lcriture L


2009 Sage 21

Articles

Le contexte Article est disponible pour les applications suivantes :

Sage 100 Gestion commerciale Sage 100 Saisie de caisse dcentralise Les arguments publis sont les suivants :


Article.Reference Rfrence de l'article L

Article.Designation Dsignation de larticle L

Article.CodeBarres Code barres (article du volet Descriptif, ou gamme ou conditionnement selon le contexte)

L

Article.InfoLibValeur[Numero] Valeur de linformation libre de larticle L

Article.CodeFiscal Code fiscal de l'article L

Documents des ventes

Le contexte Documents des ventes est disponible pour les applications suivantes :













DocEntete.NumPiece Numro de pice du document de vente L

DocEntete.Reference Rfrence du document de vente L/E

DocEntete.Date Date de pice du document de vente L


2009 Sage 22


DocEntete.DateLivr Date de livraison du document de vente L

DocEntete.InfoLibValeur[Numero] Valeur de linformation libre L/E





DocEntete.ColisageNombre Nombre de colis L/E

DocEntete.ColisageUnite Unit de colisage L/E

DocEntete.Expedition Mode d'expdition L/E

DocEntete.TotalPoidsNet Total poids net L

DocEntete.TotalPoidsBrut Total poids brut L

DocEntete.Statut Statut du document L/E

DocEntete.FraisExpedition Montant des frais d'expdition L/E

DocEntete.TotalHT Total HT du document [Type] L

DocEntete.Type Type de document L

DocEntete.Souche Souche du document L/E

Depot.Code Code du dpt L

Depot.Intitule Intitul du dpt L

Depot.Adresse Adresse du dpt L

Depot.CodePostal Code Postal du dpt L

Depot.Ville Ville du dpt L

Depot.Pays Pays du dpt L


2009 Sage 23

Documents des achats

Le contexte Documents des achats est disponible pour lapplication suivante :

Sage 100 Gestion commerciale Les arguments publis sont les suivants :




CompteT.InfoLibValeur[Numero] Information Libre L/E








DocEntete.NumPiece Numro de pice du document dachat L

DocEntete.Reference Rfrence du document dachat L/E

DocEntete.Date Date de pice du document dachat L

DocEntete.DateLivr Date de livraison du document dachat L

DocEntete.InfoLibValeur[Numero] Valeur de linformation libre L





DocEntete.FraisExpedition Montant des frais d'expdition L/E









2009 Sage 24




Documents des stocks

Le contexte Documents des stocks est disponible pour les applications suivantes :



DocEntete.NumPiece Numro de pice du document dachat L

DocEntete.Reference Rfrence du document dachat L/E



DocEntete.InfoLibValeur[Numro] Valeur de l'information libre L/E










2009 Sage 25

Documents internes

Le contexte Documents internes est disponible sous lapplication suivante :













DocEntete.NumPiece Numro de pice du document de vente L

DocEntete.Reference Rfrence du document de vente L/E

DocEntete.Date Date de pice du document de vente L

DocEntete.DateLivr Date de livraison du document de vente L

DocEntete.InfoLibValeur[Numero] Valeur de linformation libre L/E


















2009 Sage 26

Lignes de document

Le contexte Lignes de document est disponible pour les applications suivantes :



DocLigne.Article Rfrence de l'article L/E

DocLigne.Enumere Rfrence de l'numr Gamme ou conditionnement ( dfaut, Rfrence de l'article)

L/E

DocLigne.Designation Dsignation L

DocLigne.InfoLibValeur[Numero] Valeur de linformation libre de la ligne L/E

DocLigne.NumPiece Numro de pice du document L

DocLigne.DateLivraison Date de livraison de la ligne L

DocLigne.NumPieceBL Numro de pice du BL d'origine L

DocLigne.NumPieceBC Numro de pice du BC d'origine L

DocLigne.CodeBarres Code barre de la ligne (article ou numr) L

DocLigne.Affaire Code affaire associ L

DocLigne.NumSerieLot N de srie L

DocLigne.NumColis N de colis L

DocLigne.Quantite Quantit L/E

DocLigne.QuantitColisee Quantit colise L/E

DocLigne.PrixUnitaire Prix Unitaire HT L/E

DocLigne.PrixUnitaireTTC Prix Unitaire TTC L/E

DocLigne.PRUnitaire Prix de revient unitaire L/E

DocLigne.Ressource.Code Code de la ressource L

DocLigne.Ressource.Intitul Intitul de la ressource L

DocLigne.QteRessource Quantit de la ressource L


2009 Sage 27

Fonction publie

Pour le contexte Lignes de document, une fonction non visible dans la liste des arguments est disponible : ValidLigne()

Cette fonction peut tre appele depuis un programme externe de type : Lien Internet Intgr, Page Web Intgre ou Script Intgr. A lappel de cette fonction, une ligne de document est ajoute au document commercial en respectant les mmes contrles que ceux raliss par Sage 100 Gestion commerciale (traitement quivalent la frappe sur la touche Entre du clavier). Ainsi, lappel de cette fonction peut dclencher sous la Gestion commerciale, laffichage de la fentre dindisponibilit en stocks, conflits de remises, slection dun numro de srie/lot

Les informations utilises pour crer la ligne de document seront celles qui auront t pralablement renseignes sur les arguments publis en criture (rfrence article, quantit, prix unitaire).

Un exemple dutilisation de cette fonction est prsent en fin de ce manuel.

Collaborateurs

Le contexte Collaborateurs est disponible pour les applications suivantes :


Argument Description L/E Collaborateur.Nom Nom du collaborateur L

Collaborateur. Prenom Prnom du collaborateur L

Collaborateur.Telephone Tlphone du collaborateur L

Collaborateur.Telecopie Tlcopie du collaborateur L

Ressources

Le contexte Ressources est disponible pour lapplication suivante :


Argument Description L/E Ressource.Code Code de la ressource L

Ressource.Intitule Intitul de la ressource L


2009 Sage 28

Dpts

Le contexte Dpts est disponible pour les applications suivantes :


Argument Description L/E Depot.Code Code du dpt L






Depot.Telephone Tlphone du dpt (fiche principale ou contact slectionn) L

Depot.Telecopie Tlcopie du dpt (fiche principale ou contact slectionn) L

Depot.Portable Tlphone portable du contact du dpt L

Immobilisations

Le contexte Immobilisations est disponible pour lapplication suivante :

Sage 100 Immobilisations Les arguments publis sont les suivants :

Argument Description L/E Immobilisation.Code Code de l'immobilisation L

Immobilisation.Intitul Intitul de l'immobilisation L

Immobilisation.CodeBarres Code barres de l'immobilisation L

Immobilisation.Lieu Lieu de l'immobilisation L


2009 Sage 29

Lieux de biens

Le contexte Lieux de biens est disponible pour lapplication suivante :

Sage 100 Immobilisations Les arguments publis sont les suivants :

Argument Description L/E Lieu.Intitule Intitul du lieu de biens L

Lieu.Adresse Adresse du lieu de biens L

Lieu.CodePostal Code Postal du lieu de biens L

Lieu.Ville Ville du lieu de biens L

Lieu.Pays Pays du lieu de biens L

Lieu.Telephone Tlphone du lieu de biens (fiche principale ou contact slectionn)

L

Lieu.Telecopie Tlcopie du lieu de biens (fiche principale ou contact slectionn)

L

Lieu.Portable Tlphone portable du contact du lieu de biens L

Prvisions

Le contexte Prvisions est disponible pour lapplication suivante :

Sage 100 Trsorerie Les arguments publis sont les suivants :

Argument Description L/E CompteT.Numero Numro de compte tiers de la prvision L

Previsions.Piece Numro de pice de la prvision L

Previsions.NumFacture Numro de facture de la prvision L

Previsions.RefPiece Rfrence de la prvision L

Lignes de commandes - fonctions publies

2009 Sage 30


Les applications Sage 100 publient certaines fonctions permettant une application externe dappeler une fonction donne des applications Sage 100 comme par exemple : ouvrir une fiche tiers de Sage 100 Comptabilit, accder un document de Sage 100 Gestion commerciale ou encore procder une importation de donnes.

Les fonctions peuvent tre communes toutes les applications (Tiers par exemple) alors que dautres sont spcifiques une application.

Lappel des fonctions publies par les applications Sage 100, ncessite dexcuter une ligne de commande rpondant une certaine syntaxe. Cette ligne de commande devra tre construite de la manire suivante :

Executable u=[Code_utilisateur] p=[Mot_de_passe] Fichier_Application [Fichier_Comptable] cmd "Commande.Action([Parametres])" [-q]

Exemple de ligne de commande Windows :

"C:\Program Files\Maestria\Maestria.exe" "C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae" -u= -p= -cmd="Tiers.Show(Tiers='CARAT')" -cmd="SaisiePiece.Create()"

Cette ligne est compose des lments suivants :

Paramtre Description Executable Emplacement du programme excutable lancer.

Par exemple pour Sage 100 Comptabilit :

C:\Program Files\Maestria\Maestria.exe

Pour Sage 100 Gestion commerciale :

C:\Program Files\GecoMaes\GecoMaes.exe

-u= Compte utilisateur avec lequel lapplication externe va ouvrir et se connecter aux bases Sage 100. Ce paramtre est facultatif. Sil nest pas renseign, lapplication tentera de se connecter avec le compte

-p= Mot de passe associ au compte utilisateur (Cf. paramtre u). Ce paramtre est facultatif.

Fichier_Application Nom et emplacement du fichier application ouvrir. Pour excuter une fonction disponible sur Sage 100 Gestion commerciale, ce paramtre devra prendre le nom et emplacement du fichier commercial. Par exemple :

C:\Documents and Settings\All Users\Documents\Sage\Gestion commerciale\Gescom Bijou.gcm

Pour excuter une fonction disponible sur Sage 100 Comptabilit, ce paramtre devra prendre le nom et emplacement du fichier de comptabilit. Par exemple :

C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae

[Fichier_Comptable] Nom et emplacement du fichier de comptabilit ouvrir. Ce paramtre est facultatif. Il ne doit tre renseign que lorsquun fichier commercial est affect au paramtre [Fichier_Application]

-cmd Instruction devant tre suivie de la commande excuter. A noter que les commandes doivent tre encadre par le caractre : "

Commande Commande excuter.

Action Action excuter. Suivant laction, plusieurs paramtres pourront tre renseigns.

[Parametres] Paramtres correspondants laction slectionne. Les paramtres sont indiqus entre parenthses () et spars entre eux par une virgule.


2009 Sage 31

Paramtre Description [-s] Instruction permettant de ne pas afficher les messages dalertes renvoys par

les applications Sage 100.

[-q] Instruction permettant de quitter lapplication Sage 100 aprs excution du traitement (par exemple aprs importation de donnes). Ce paramtre est facultatif.

Les lignes de commandes ne sont pas sensibles la casse. Ainsi, elles peuvent tre saisies aussi bien en minuscules que majuscules. Il est cependant conseill de respecter les syntaxes pour une meilleure lisibilit.

Dans une mme ligne de commande, plusieurs instructions cmd peuvent tre excute.

La distinction des lments qui composent cette ligne de commande seffectue sur des caractres rservs. Ils sont de deux types : Options et Sparateurs.

Options

Pour les lignes de commande, quatre types doptions sont disponibles :

u : permet de dfinir le code utilisateur avec lequel se connecter aux bases p : mot de passe associ au code utilisateur dfini sur loption u q : permet de fermer lapplication appele lorsque le traitement aura t ralis cmd : permet de dfinir les commandes et actions excuter Pour tre interprtes, ces options doivent tre prcdes dun caractre prefix. Le caractre prefix peut tre, soit le caractre tiret (-), soit le caractre slash (/).

Laffectation dune valeur une option seffectue en utilisant un caractre separator. Le caractre separator peut tre, soit le caractre gal (=), soit le caractre deux points (:).

Par exemple, pour renseigner un code utilisateur et un mot de passe :

u=User1 p=1234

3 Remarque La description des caractres prefix et separator se trouve sous le paragraphe Sparateurs. La description de loption cmd se trouve sous le paragraphe Commandes des applications.

Diffrentes syntaxes possibles :

Ci-dessous la liste exhaustive des diffrentes syntaxes supportes pour laffectation dune option (x reprsente une option) :

-x=valeur /x=valeur -x =valeur /x =valeur -x valeur /x valeur -xvaleur /xvaleur -x:valeur /x:valeur -x : valeur /x : valeur


2009 Sage 32

-x :valeur /x :valeur Exemple :

La commande :

C:\>"C:\Program Files\Maestria\Maestria.exe" "C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae" u=User1 p=1234 cmd Tiers.Show(Tiers='CARAT') -cmd=SaisiePiece.Create

Peut scrire sous la forme suivante:

C:\>"C:\Program Files\Maestria\Maestria.exe" "C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae" -uUser1 /p:1234 cmd Tiers.Show(Tiers='CARAT') /cmd=SaisiePiece.Create

Sparateurs

Les lments de la ligne de commande sont formats avec diffrents sparateurs :

Quote : "

Le caractre quote est utilis lorsque llment contient des caractres espace ou quote ou, lorsque la valeur de loption commence par le sparateur.

Escape : \

Le caractre escape est utilis lorsque llment contient des quotes ou simples quotes.

Simple quote : '

Le caractre simple quote est utilis pour dlimiter une valeur de type chane de caractres affecte un paramtre dune action.

Prefix : - ou /

Le caractre prefix prfixe les options.

Separator : = ou :

Le caractre separator spare loption de sa valeur.

Caractre quote

Le caractre quote (") doit tre utilis lorsque la valeur dun lment contient le caractre espace. Par exemple, pour passer en paramtre un chemin daccs un fichier comptable plac dans une arborescence de rpertoire contenant des espaces, le chemin doit tre dlimit par des quotes :

"C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae"

Lorsque la valeur de llment ne contient pas de caractre espace, il nest pas obligatoire dutiliser le caractre quote.

Ainsi, la ligne de commande :

C:\>"C:\Program Files\Maestria\Maestria.exe" "C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae" -u="User1" -p="1234" -cmd="Tiers.Show(Tiers='CARAT') " -cmd="SaisiePiece.Create"


2009 Sage 33

Peut scrire sous la forme suivante :

C:\>"C:\Program Files\Maestria\Maestria.exe" "C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae" -u=User1 -p=1234 -cmd=Tiers.Show(Tiers='CARAT') -cmd=SaisiePiece.Create

3 Remarque Les emplacements d'accs au programme excutable de Sage 100 Comptabilit et au fichier comptable sont dlimits par le caractre quote puisque dans cet exemple, ces emplacements contiennent le caractre espace.

Si dans cet exemple, le chemin daccs au fichier comptable nest pas dlimit par le caractre quote, lexcution de la ligne de commande, une erreur est renvoye car le chemin daccs naura pas t correctement interprt :

De la mme manire, si un code utilisateur est compos dun caractre espace (Anne Marie par exemple), il sera ncessaire de le dlimiter par le caractre quote.

Ainsi, lexcution de la ligne de commande suivante :

C:\>"C:\Program Files\Maestria\Maestria.exe" "C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae" -u=Anne Marie -p=1234 -cmd=Tiers.Show(Tiers='CARAT') -cmd=SaisiePiece.Create

Sage 100 Comptabilit bloque sur la fentre dauthentification en proposant lutilisateur Anne.

Pour que la ligne de commande puisse se connecter avec lutilisateur Anne Marie, il faut excuter linstruction suivante :

C:\>"C:\Program Files\Maestria\Maestria.exe" "C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae" -u="Anne Marie" -p=1234 -cmd=Tiers.Show(Tiers='CARAT') -cmd=SaisiePiece.Create

3 Remarque Le code utilisateur est dlimit par les caractres quote comme dans l'exemple ci-dessous -u="Anne Marie"

Important :

Depuis une invite de commande Windows, les caractres infrieur () sont des caractres rservs. De ce fait, lorsque ces caractres sont renseigns dans une valeur dun paramtre (code utilisateur par exemple), la valeur doit galement tre dlimite par les caractres quote.


2009 Sage 34

Par exemple, lexcution de linstruction suivante :

C:\>"C:\Program Files\Maestria\Maestria.exe" "C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae" -u= -p= -cmd=Tiers.Show(Tiers='CARAT')

Le message le fichier spcifi est introuvable est renvoy.

Pour cet exemple, la ligne de commande syntaxiquement correcte est la suivante :

C:\>"C:\Program Files\Maestria\Maestria.exe" "C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae" -u="" -p= -cmd=Tiers.Show(Tiers='CARAT')

3 Remarque Le code utilisateur est dlimit par les caractres quote comme dans l'exemple ci-dessous -u=""

Si des caractres espace, infrieur ou suprieur sont renseigns dans la valeur dun paramtre dune action et que celle-ci nest pas dlimite par les caractres quote, par exemple :

C:\>"C:\Program Files\Maestria\Maestria.exe" "C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae" -u="" -p= -cmd=SaisiePiece.Show(Reference='Ref>1')

Lerreur suivante est renvoye :

Pour cet exemple, pour rechercher une pice comptable ayant pour rfrence la valeur Ref>1, la ligne de commande suivante doit tre excute :

C:\>"C:\Program Files\Maestria\Maestria.exe" "C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae" -u="" -p= -cmd="SaisiePiece.Show(Reference='Ref>1')"

3 Remarque C'est l'action complte qui doit tre dlimite par les caractres quote (cf. l'exemple ci-dessous). cmd="SaisiePiece.Show(Reference = 'Ref>1')"

Dlimiter uniquement la valeur contenant le caractre espace, infrieur ou suprieur est incorrect. Ainsi, la commande :

cmd=SaisiePiece.Show(Reference = "'Ref>1'")

Renverra galement lerreur Erreur de syntaxe .

Dune manire gnrale, pour viter les erreurs de syntaxes dues aux caractres systme, il est vivement conseill de dlimiter chacun des paramtres de la ligne de commande avec les caractres quote.


2009 Sage 35

Caractre escape

Le caractre escape (\) permet dinclure le caractre quote ou simple quote (voir paragraphe suivant) dans une valeur. Par exemple, pour afficher une criture comptable dont la rfrence est gale Ref"1, la ligne de commande devra tre de la forme suivante :

C:\>"C:\Program Files\Maestria\Maestria.exe" "C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae" -u=User1 -p=1234 -cmd=SaisiePiece.Show(Reference='Ref\"1')

3 Remarque Le caractre quote plac dans la valeur Rfrence doit tre prcd du caractre escape.

Le caractre escape nest interprt en tant que caractre systme que sil prcde le caractre quote ou simple quote. De plus, deux caractres quote de suite ont le mme effet que le caractre escape suivi de quote. Ainsi, la prcdente ligne de commande pourra tre crite de la manire suivante :

C:\>"C:\Program Files\Maestria\Maestria.exe" "C:\Documents and Settings\All Users\Documents\Sage\Comptabilit\Compta Bijou.mae" -u=User1 -p=1234 -cmd=SaisiePiece.Show(Reference='Ref""1')

La commande :

-cmd=SaisiePiece.Show(Reference='Ref\"1')

Est quivalente :

-cmd=SaisiePiece.Show(Reference='Ref""1')

Important :

Pour les programmes externes excuts depuis les applications Sage 100, lorsque la valeur dun paramtre de la ligne darguments contient le caractre escape, ce caractre doit tre doubl afin quil soit correctement interprt.

Exemple douverture dun fichier Microsoft Excel depuis Sage 100 Comptabilit. Lemplacement de ce fichier est dfini sous :

C:\Documents and Settings\All Users\Documents\Fichiers xls\MonFichier.xls

Dans la ligne darguments, le chemin daccs au fichier Microsoft Excel doit tre dlimit par des caractres quote puisquil contient des caractres espace. De plus, chaque caractre escape doit tre doubl afin que le chemin soit correctement interprt. La ligne darguments doit donc tre la suivante :

"C:\\Documents and Settings\\All Users\\Documents\\Fichiers xls\\MonFichier.xls"


2009 Sage 36

3 Remarque Dans le cas o les caractres escape ne sont pas doubls, Microsoft Excel retourne le message suivant.

3 Remarque De mme, si les caractres quote sont omis, le chemin d'accs au fichier transmis Microsoft Excel ne sera pas correct :

Caractre simple quote

Le caractre simple quote (') est utilis pour dlimiter une valeur de type chane de caractres affecte un paramtre dune action. Dans un exemple prcdent, pour rechercher les critures ayant pour rfrence Ref1, linstruction suivante tait utilise :

-cmd=SaisiePiece.Show(Reference='Ref1')

3 Remarque Les valeurs affectes aux paramtres de type chane de caractres, doivent imprativement tre dlimits par les caractres simple quote. Lorsque ces caractres ne sont pas prciss dans l'instruction, par exemple : -cmd=SaisiePiece.Show(Reference=Ref1)

Lexcution de la commande retourne le message :

Lorsque la valeur recherche contient un caractre simple quote, il convient de faire prcder ce caractre par le caractre escape. Par exemple, pour rechercher la rfrence Ref'1, il faudra employer linstruction suivante :

-cmd=SaisiePiece.Show(Reference='Ref\'1')

3 Remarque Le caractre simple quote dans une valeur doit imprativement tre prcd du caractre escape. Doubler la simple quote comme cela peut tre fait pour -cmd=SaisiePiece.Show(Reference='Ref''1')


2009 Sage 37

Renverra lerreur :

Autorisations daccs

Lorsqu'une fonction est protge et que les droits utilisateurs ne lui permettent pas d'accder une fonction donne, un message d'erreur est affich.

Exemple : si pour un utilisateur donn, les journaux de vente sont protgs, il ne peut pas accder la consultation d'une pice dans un journal de vente.

Fonctions publies

Vous trouverez ci-aprs le dtail des fonctions publies par les applications Sage 100.

Lgende :

Les paramtres entre crochets [ ] sont des paramtres facultatifs. Correspondance de la colonne Type :

N : paramtre de type numrique T : paramtre de type chane de caractres D : paramtre de type date E : paramtre de type numrateur

Mthodes

Les diffrents types de mthodes disponibles sont les suivants : Execute : Excution dun traitement Show : Affichage dune fentre Create : Cration dun lment List : Affichage dune liste Modify : Modification d'lments

Syntaxe :

-cmd=[Commande].[Mthode]([Liste paramtres])

Exemple :

-cmd=Tiers.Create(Tiers='CARAT', Type = Client)


2009 Sage 38

Remarque :

[Mthode] est facultatif. Sil nest pas prcis, cest la mthode Execute qui est excute.

De la mme manire, les parenthses ouvrante et fermante ne sont pas obligatoires si aucun paramtre nest attendu.

Par exemple, la commande

-cmd=Lettrage.Execute()

Peut scrire de la manire suivante :

-cmd=Lettrage

Paramtres

Les paramtres dpendent de la mthode implmente. Ils peuvent tre de diffrents types :

Chane de caractres : les valeurs doivent tre dlimites par le caractre simple

quote.

Exemple : Tiers='CARAT'

Enumrateur : les valeurs ne possdent pas de dlimiteurs.

Exemple : Type=Client

Numrique Long : les valeurs ne contiennent pas de dcimales

Exemple : 105

Numrique Double : le sparateur de dcimale est le caractre point (.). Ce

format gre 4 dcimales maximum.

Exemple : 120.1234

Date : plusieurs formats sont supports

#aaaa-mm-jj# (Date XML ISO 8601) #aaaa-mm-jjThh:mm:ss# (Date XML ISO 8601) #jjmmaaaa# #jjmmaa# #jj-mm-aaaa# #jj-mm-aa# #jj/mm/aaaa# #jj/mm/aa#

Exemple : #25/11/2008#

Exemple de commande :

-cmd=Document.Show(Type=Devis, Date=#01/01/2008#,Piece='DE00001')

3 Remarque Cette instruction permet d'afficher un document commercial et prend en paramtres Un numrateur : Type=Devis Une date au format #jj/mm/aaaa# : Date=#01:01:2009# Une chane de caractres : Pice='DE00001'


2009 Sage 39

Autre exemple de commande permettant daccder la fentre de saisie dun journal. Cette instruction prend en paramtres une date (Date au format #jjmmaa#) et une chane de caractres (Journal) :

-cmd=SaisieJournal.Show(Date=#010308#, Journal='VTE')

Liste des fonctions par application

Dans ce paragraphe vous retrouverez par application, la liste des fonctions quil est possible dexcuter depuis une ligne de commande.


Cration / Visualisation dun Tiers Affichage de la fentre de compte tiers en mode cration ou Visualisation selon laction excute.

VISUALISATION / MODIFICATION DUN TIERS

Commande Action Paramtre Type Description

Tiers Show Tiers T Numro de compte tiers

Exemple :

Tiers.Show(Tiers='CARAT')

CREATION DUN TIERS


Tiers T Numro de compte tiers Tiers Create

Type E Type de tiers (cf. Enumrateur)

Exemple :

Tiers.Create(Tiers='CARAT', Type=Client)

ENUMERATEUR : TYPE

Enumrateur Description

Client Tiers de type client

Fournisseur Tiers de type fournisseur

Autre Tiers de type autre

Salarie Tiers de type salari


2009 Sage 40

Saisie / Visualisation dune pice

Affichage de la fentre Saisie par pice en mode Saisie ou Visualisation selon laction excute.

VISUALISATION / MODIFICATION DUNE PIECE


[Piece] T Numro de pice

[Facture] T Numro de facture

[Date] D Date dcriture

SaisiePiece Show

[Reference] T Rfrence de lcriture

Exemple :

SaisiePiece.Show(Facture='FA00001', Date=#280308#)

SAISIE D'UNE ECRITURE


SaisiePiece Create - - Saisie dune pice

Exemple :

SaisiePiece.Create()

Saisie des journaux

Accs aux journaux de saisie en fonction des paramtres.


[Piece] T Numro de pice

[Facture] T Numro de facture


[Journal] T Journal

SaisieJournal Show

[Reference] T Rfrence de lcriture

Exemple :

SaisieJournal.Show(Date=#010308#, Journal='VTE')

Interrogation tiers

Affiche la liste des critures pour le tiers pass en paramtre.


InterroTiers Show [Tiers] T Numro de compte tiers

Exemple :

InterroTiers.Show(Tiers='CARAT')


2009 Sage 41

Interrogation gnrale

Affiche la liste des critures pour le compte gnral pass en paramtre.


InterroGene Show [Numero] T Numro de compte gnral

Exemple :

InterroGenes.Show(Numero='4110000')

Interrogation analytique

Affiche la liste des critures pour le plan analytique et la section passs en paramtres.


Plan N Numro du plan analytique InterroAna Show

Section T Section analytique

Exemple :

InterroAna.Show(Plan=1, Section='921SY1')

Rappel / relev

Affiche la fentre de la liste des rappels, ou la fentre de slection si aucun paramtre nest renseign.


[Date] D Date de rappel Rappel Show

[Tiers] T Numro de compte tiers

Exemple :

Rappel.Show(Date=#280308#1, Tiers='CARAT')

Recherche des critures

Affiche la liste des critures, ou la fentre de slection si aucun paramtre nest renseign.




RechercheEcriture Modify

[Montant] N Montant de lcriture

Exemple :

RechercheEcriture.Modify (Date=#280308#1, Tiers='CARAT', Montant=150.80)

3 Remarque Le sparateur de dcimales pour le paramtre montant est le point (.)


2009 Sage 42

Import au format Sage 30 et 100

Importation du fichier pass en paramtre.


ImportSage Execute Fichier T Nom et emplacement du fichier importer

Exemple :

ImportSage.Execute (Fichier='C:\Tmp\Import.txt')

Import au format paramtrable

Importation du fichier pass en paramtre en utilisant le format dimportation galement pass en paramtre.


Fichier T Nom et emplacement du fichier importer

ImportParam Execute

Format T Nom et emplacement du format dimportation

Exemple :

ImportParam.Execute (Fichier='C:\Tmp\Import.txt', Format='C:\Tmp\Import.ema')

Lettrage

Excution de la fonction Lettrage automatique avec les paramtres par dfaut de Sage 100 Comptabilit. Cette fonction peut par exemple tre chane avec la fonction dimportation.


Lettrage Execute - - Lettrage automatique

Exemple :

Lettrage.Execute()

Intgration des extraits de compte

Permet d'intgrer les extraits de compte avec Direct, Telbac ou sans protocole.


[Protocole] E Permet dintgrer les extraits selon la session paramtre, avec Direct, Telbac ou sans protocole (cf. Enumrateur)

IncorporeExtrait Execute

[Session] T Permet de paramtrer la session excuter. La prsence d'une session force le paramtre Avec Telbac Oui

Exemple :

IncorporeExtrait.Execute(Protocole=Aucun, Session='Extraits')


2009 Sage 43

ENUMERATEUR : PROTOCOLE


Aucun Aucun protocole. Valeur par dfaut.

Direct Avec Direct.

Telbac Avec Telbac.

Sage 100 Gestion commerciale

Cration / Visualisation dun Tiers

Affichage de la fentre de compte tiers en mode cration ou Visualisation selon laction excute.

VISUALISATION / MODIFICATION DUN TIERS


Tiers Show Tiers T Numro de compte tiers

Exemple :

Tiers.Show(Tiers='CARAT')

CREATION DUN TIERS


Tiers T Numro de compte tiers Tiers Create

Type E Type de tiers (cf. Enumrateur)

Exemple :

Tiers.Create(Tiers='CARAT', Type=Client)

ENUMERATEUR : TYPE


Client Tiers de type client

Fournisseur Tiers de type fournisseur

Visualisation dun Document (Achat, vente, stock ou interne)

Affichage dun document en fonction des paramtres.


Type E Type de document (cf. Enumrateur)

Piece T Numro de pice

Document Show

Souche T Souche de la pice

Exemple :

Document.Show(Type=FactureClient,Piece='FA00002')


2009 Sage 44

ENUMERATEUR : TYPE


Devis Devis

BonCommandeClient Bon de commande client

PreparationLivraison Prparation de livraison

BonLivraisonClient Bon de livraison client

BonRetourClient Bon de retour client

BonAvoirClient Bon davoir client

FactureClient Facture client

FactureComptaClient Facture comptabilise client

PreparationCommande Prparation de commande

BonCommandeFournisseur Bon de commande fournisseur

BonLivraisonFournisseur Bon de livraison fournisseur

BonRetourFournisseur Bon de retour fournisseur

BonAvoirFournisseur Bon davoir fournisseur

FactureFournisseur Facture fournisseur

FactureComptaFournisseur Facture comptabilise fournisseur

MouvementEntree Mouvement dentre

MouvementSortie Mouvement de sortie

DepreciationStock Dprciation de stock

MouvementTransfert Mouvement de transfert

PreparationFabrication Prparation de fabrication

OrdreFabrication Ordre de fabrication

BonFabrication Bon de fabrication

Type1 Document interne Type1






Documents de vente

Affichage ou cration dun document de vente.

AFFICHAGE DUN DOCUMENT OU DUNE LISTE DE DOCUMENTS


[Type] E Type de document (cf. Enumrateur)

DocumentVente List


Exemple :

DocumentVente.List(Type=FactureClient,Tiers='CARAT')


2009 Sage 45

CREATION DUN DOCUMENT


DocumentVente Create Type E Type de document (cf. Enumrateur)

Exemple :

DocumentVente.Create(Type=FactureClient)

ENUMERATEUR : TYPE


Devis Devis

BonCommandeClient Bon de commande client

PreparationLivraison Prparation de livraison

BonLivraisonClient Bon de livraison client

BonRetourClient Bon de retour client

BonAvoirClient Bon davoir client

FactureClient Facture client

FactureComptaClient Facture comptabilise client

Documents dachat

Affichage ou cration dun document dachat.




DocumentAchat List


Exemple :

DocumentAchat.List(Type= FactureFournisseur,Tiers='ECLAT')



DocumentAchat Create Type E Type de document (cf. Enumrateur)

Exemple :

DocumentAchat.Create(Type=FactureFournisseur)


2009 Sage 46

ENUMERATEUR : TYPE


PreparationCommande Prparation de commande

BonCommandeFournisseur Bon de commande fournisseur

BonLivraisonFournisseur Bon de livraison fournisseur

BonRetourFournisseur Bon de retour fournisseur

BonAvoirFournisseur Bon davoir fournisseur

FactureFournisseur Facture fournisseur

FactureComptaFournisseur Facture comptabilise fournisseur

Documents de stock

Affichage ou cration dun document de stock.




DocumentStock List

[Depot] T Numro de compte tiers

Exemple :

DocumentStock.List(Type= MouvementEntree,Depot='Bijou SA')



DocumentStock Create Type E Type de document (cf. Enumrateur)

Exemple :

DocumentStock.Create(Type= MouvementEntree)

ENUMERATEUR : TYPE


Devis Devis

MouvementEntree Mouvement dentre

MouvementSortie Mouvement de sortie

DepreciationStock Dprciation de stock

MouvementTransfert Mouvement de transfert

PreparationFabrication Prparation de fabrication

OrdreFabrication Ordre de fabrication

BonFabrication Bon de fabrication


2009 Sage 47

Documents internes

Affichage ou cration dun document interne.




DocumentInterne List


Exemple :

DocumentInterne.List(Type=Type1,Tiers='CARAT')



DocumentInterne Create Type E Type de document (cf. Enumrateur)

Exemple :

DocumentInterne.Create(Type=Type1)

ENUMERATEUR : TYPE








Rapprovisionnement Affichage de la fentre de slection des paramtres de la fonction Rapprovisionnement.


Reappro Show - - Affichage de la fentre de slection

Exemple :

Reappro.Show()

Interrogation de compte client ou fournisseur Affichage de la fentre dinterrogation de compte client ou fournisseur.


[Masque] E Masque de slection (cf. Enumrateur)

InterroTiers Show



2009 Sage 48

Exemple :

InterroTiers.Show(Masque=Comptable,Tiers='CARAT')

ENUMERATEUR : MASQUE


Comptable Interrogation Comptable

Commercial Interrogation Commerciale

Interrogation de compte article Affichage de la fentre dinterrogation de compte article.



InterroArticle Show

[Article] T Rfrence article

Exemple :

InterroArticle.Show(Masque=Stocks,Article='BAAR01')



Tarifs Interrogation des tarifs

Stocks Interrogation de stock

StocksPrevisionnels Interrogation de stock prvisionnel

Historiques Interrogation des historiques

Interrogation de compte affaire Affichage de la fentre dinterrogation de compte affaire.



InterroAffaire Show

[Numero] T Code affaire

Exemple :

InterroAffaire.Show(Masque=Comptable,Numero='921SY1')



Commercial Interrogation commerciale

Documents Interrogation des documents

StatDomaine Statistique par domaine

StatFamille Statistique par famille

Comptable Interrogation comptable


2009 Sage 49

Interrogation de compte collaborateur Affichage de la fentre dinterrogation de compte collaborateur.



[Nom] T Nom du collaborateur

InterroColl Show

[Prenom] T Prnom du collaborateur

Exemple :

InterroColl.Show(Masque=Commercial,Nom='GENDRON', Prenom='Bernard')



Commercial Interrogation commerciale

Documents Interrogation des documents

Inventaire Affichage de la fentre de slection des paramtres de linventaire.


Inventaire Show - - Affichage de la fentre des paramtres de slection

Exemple :

Inventaire.Show()

Contrle qualit Affichage de la fentre de slection des paramtres de la fonction de contrle qualit.


ControleQualite Show - - Affichage de la fentre des paramtres de slection

Exemple :

ControleQualite.Show()

Picking Affichage des paramtres de la fonction Prparation des livraisons clients ou visualisation des commandes prparer.

AFFICHAGE DES PARAMETRES DE LA FONCTION PREPARATION DES LIVRAISONS

Commande Action Paramtre T