Utiliser ACE EDITIQUE

Un double-clic sur une propriété de type chemin permet de parcourir l’arborescence du système et de sélectionner le répertoire à utiliser pour la propriété choisie.

Il est également possible de modifier manuellement une propriété via deux clics espacés sur sa valeur.

Ressources : Répertoire dans lequel sont stockés les fichiers de ressources ACE (par défaut Editique\Dictionnaires\Ressources).

Répertoire d’export des dictionnaires : Répertoire dans lequel doivent être générés les dictionnaires StreamServe (par défaut Editique\Dictionnaires\Dic).

Répertoire d’export des Maquettes : Répertoire dans lequel doivent être créées les maquettes d’édition ACE (par défaut Editique\Dictionnaires\Maq).

Répertoire de sauvegarde des projets : Répertoire dans lequel sont enregistrés les projets StreamServe (par défaut Editique\Dictionnaires\Projets).

Répertoire Editique : Répertoire de base d’Editique (par défaut Editique).

Sélection d’un répertoire

Langue choisie : permet d’indiquer la langue à charger lors de l’import d’un nouveau fichier de ressources. Les différents libellés du fichier de ressources seront ainsi chargés dans la langue sélectionnée. Les libellés éventuellement non traduits seront chargés en français.

La langue de travail est définie indépendamment des projets ACE Editique , elle reste valable pour tout nouveau projet, jusqu’à ce qu’une autre langue soit sélectionnée dans l’écran de configuration d’ACE Editique .

Le fait de changer de langue de travail ne modifie en rien un projet déjà créé. En effet, le dictionnaire Editique constitué reste inchangé. En revanche, le fichier de ressources étant rechargé lors de l’ouverture du projet, les libellés affichés seront les libellés traduits dans la nouvelle langue de travail. Tout nouveau champ glissé vers le dictionnaire Editique portera alors le libellé traduit.

A l’heure actuelle, seuls les libellés Français et Anglais sont chargés dans les fichiers de ressources.

La langue de travail modifie également la langue du module ACE Editique dans la mesure du possible.

Cette fonctionnalité vous permet (lorsque la case est cochée) de contrôler les éventuels doublons qu’il peut exister entre les champs d’un même projet. Elle offre en outre un certain confort visuel puisque les champs de même nom sont facilement identifiés et apparaissent dans une couleur différente.

Trucs et astuces Lorsque vous créez un projet assez volumineux, nous vous conseillons d’activer cette option en fin de création. En effet, les temps de réponse peuvent s’en trouver affectés.

Même lorsque l’option de contrôle dynamique des doublons n’est pas active (case non cochée), ACE Editique effectue tout de même un contrôle systématique des doublons lors de la génération du projet StreamServe.

Nom de la configuration : permet d’identifier l’environnement lors des déploiements de projets ou la gestion des lanceurs. Entrez un nom suffisamment clair afin d’éviter tout risque de confusion (par exemple ‘ ACE Production’ pour qualifier l’environnement d’exploitation d’ACE, ou ‘ ACE Recette’ pour qualifier l’environnement de test d’ACE).

Type du serveur ACE : cochez l’un des deux « boutons radio » Windows ou Unix.

Répertoire des maquettes : indiquez l’emplacement des maquettes personnaliséessur le serveur. Il s’agit du répertoire ‘ap$maq_codlan’ défini dans le fichier Generix.ini, où ‘codlan’ dépend de la langue dans laquelle vous désirez développer les maquettes Editique.

• Si le serveur ACE est un serveur Windows, les maquettes seront copiées sur le serveur via un chemin réseau. Le répertoire des maquettes personnalisées d’ACE doit donc être partagé de manière à être accessible en écriture depuis le poste de développement Editique. Indiquez dans la zone ‘Répertoire des maquettes’ le chemin réseau du répertoire (par exemple ‘\\GNXPROD\ACE\langue\fra\maq’).

• Si le serveur ACE est un serveur Unix, les maquettes seront transférées via le protocole FTP. Il faut donc renseigner le nom du serveur ACE, le login à utiliser ainsi que le mot de passe pour la connexion FTP et enfin le répertoire de destination des maquettes (voir exemple ci-dessous à droite). Le login est celui que vous utilisez pour connecter au serveur unix. Le chemin est généralement relatif au répertoire de base associé au login.

Comme pour le serveur ACE, vous devez indiquer si le serveur StreamServe est un serveur Windows ou Unix, puis indiquer l’emplacement du répertoire ‘editique’ sur ce serveur.

Indiquez l’emplacement du répertoire ‘editique’ sur le serveur. Il s’agit du répertoire de base d’ACE Editique (contenant entre autres les répertoires ‘workdir’, ‘drivers’, …).

• Si le serveur StreamServe est un serveur Windows , les fichiers seront copiés sur le serveur via un chemin réseau. Le répertoire ‘editique’ doit donc être partagé de manière à être accessible en écriture depuis le poste de développement Editique. Indiquez dans la zone « Répertoire Editique » le chemin réseau du répertoire.

• Si le serveur StreamServe est un serveur Unix , les fichiers seront transférés via le protocole FTP . Il faut donc renseigner le nom du serveur StreamServe, le login à utiliser ainsi que le mot de passe pour la connexion FTP et enfin le répertoire de base d’ACE Editique. Le login est celui que vous utilisez pour vous connecter au serveur unix. Le chemin est généralement relatif au répertoire de base associé au login. Dans notre exemple, ACE et StreamServe sont installés sur le même serveur unix : SUN.

La connexion à la base de données d’ACE est utilisée par le module de gestion des lanceurs uniquement. Cette connexion est établie au travers d’une « source de données ODBC » pour Oracle.

Pour en savoir plus sur la configuration d’une source de données ODBC, consultez la documentation de référence « Paramétrage d’une connexion ODBC ».

Sélectionnez l’onglet « SGBD » de la configuration en cours.

Source de données : nom de la source de données ODBC que vous avez définie pour cet environnement (ici « SUN_440 » correspond à la source de données définie pour l’environnement de production d’ACE.

Utilisateur : nom d’utilisateur Oracle correspondant à la société physique Oracle à atteindre (SOC1 par défaut), puis le mot de passe associé à ce compte.

Un dictionnaire Editique est nécessairement associé à un moteur d’édition d’ACE , qui permet d’éditer un nombre fini de données. La description de cet ensemble de données est stockée dans un « fichier de ressources » qui servira de base à la construction du dictionnaire Editique.

Les données éditables par les moteurs d’éditions d’ACE sont appelées ‘champs’, et sont regroupées en sous-ensembles sémantiques appelés ‘blocs d’édition’. Par exemple le moteur d’édition des commandes EDEVE, qui est commun à tous les événements commerciaux, gère – entre autres - les blocs d’entête de commande et de poste de commande, contenant respectivement les champs ‘numéro de commande’, ‘date de commande’ et ‘code produit’, ‘quantité’.

Les blocs sont numérotés arbitrairement de 01 à 99 et les champs sont numérotés séquentiellement au sein de chaque bloc.

Les fichiers de ressources contiennent la description en français et en anglais des blocs et des champs éditables par un moteur d’édition donné. La langue qui sera chargée lors de l’importation du fichier de ressources dépend du paramétrage général de l’application (voir « Langue de travail »,).

La première étape nécessaire à la création d’un dictionnaire Editique est l’importation du fichier de ressources à partir duquel il sera construit.

Pour importer un fichier de ressources, activez le menu ‘Outils/Importer Ressources’ (raccourci CTRL+R). Le système ouvre une fenêtre affichant l’ensemble des fichiers situés dans le répertoire des fichiers de ressources (voirRépertoires de travail,). Sélectionnez le fichier de ressources portant le nom du moteur d’édition à utiliser et ouvrez-le via le bouton « Ouvrir ».

Attention Lorsque le fichier de ressources est volumineux (EDEVE.TXT par exemple), un message vous invite à patienter. L’affichage du bloc d’édition en cours de chargement vous permet de savoir à quel stade en est le chargement.

Une fois le fichier de ressources chargé, l’arbre représentant le dictionnaire de l’édition ACE (fenêtre de gauche) est constitué et affiché dans la langue de travail. Les libellés non trouvés dans la langue spécifiée sont affichés en français.

Les libellés des blocs sont précédés de leur numéro interne, tel qu’ils sont référencés dans la documentation standard d’ACE. Les libellés des champs sont précédés de leur numéro au sein du bloc.

La fenêtre de droite contiendra le dictionnaire Editique que vous allez créer.

Trucs et astuces Si souhaitez ouvrir un autre fichier de ressources, vous devez passer par le menu « Projet/Nouveau » pour créer un nouveau projet. Il est en effet impossible d’ouvrir un nouveau fichier de ressources lorsque cela a déjà été fait pour un projet donné.

La première chose à faire lorsque l’on crée un nouveau dictionnaire est de lui donner un nom :

• sélectionnez l’élément « EVENMT » (partie droite de l’écran),
• passez en mode édition (via le menu contextuel « Renommer » ou la touche <F2> ou encore par deux clics espacés d’une seconde environ).

Le nom du dictionnaire correspond au nom de l’événement StreamServe. Ce nom conditionne le nom du fichier maquette ACE ainsi que celui du fichier dictionnaire StreamServe qui seront générés par la suite.

De même, ce nom sera proposé par défaut lorsque vous souhaiterez enregistrer le projet Editique pour la première fois.

Pour toutes ces raisons, ce nom doit respecter les contraintes suivantes :

• Il ne doit pas faire plus de 15 caractères.
• Les espaces ainsi que les caractères accentués ou de ponctuation sont interdits.
• Le nom est converti en majuscules automatiquement.

Nouveau dictionnaire « COMMANDE » basé sur EDEVE

La sélection des champs à utiliser dans Editique se fait via un glisser/déplacer depuis le dictionnaire ACE vers le dictionnaire Editique.

Après avoir été déposés dans le dictionnaire Editique, les champs sont représentés par une icône bleue et un libellé. D’autres propriétés leurs sont associées (voir Propriétés des champs).

Il est possible de sélectionner les champs du fichier de ressources de différentes manières :

• De manière unitaire (un champ à la fois). Sélectionnez un champ du fichier de ressources et glissez-le sur le dictionnaire Editique.

Le champ est placé précisément à l’endroit où il est déposé, juste après l’élément au dessus duquel il est lâché (en première position dans le bloc s’il est lâché sur le nœud du bloc, ou en dernière position s’il est lâché sur le dernier champ du bloc).

• Par l’intermédiaire d’une sélection multiple (plusieurs champs sélectionnés simultanément en maintenant la touche Shift (majuscule) ou la touche Ctrl enfoncée). Les champs sélectionnés doivent provenir du même bloc d’édition ACE.

Tous les champs sélectionnés sont placés consécutivement dans le bloc Editique dans lequel ils sont lâchés.

• Par blocs d’édition (tous les champs du bloc sont sélectionnés). Le glissement d’un bloc ACE vers le dictionnaire Editique crée un bloc dans le dictionnaire Editique ayant le même nom que dans ACE et contenant tous les champs du bloc sélectionné. Si le bloc est lâché sur un bloc déjà existant, alors il constituera un sous bloc de ce dernier.

• Tous les champs du fichier de ressources . Le déplacement de l’arbre complet du dictionnaire ACE vers le dictionnaire Editique permet de sélectionner automatiquement tous les champs de l’édition. Le dictionnaire Editique ainsi créé est une copie conforme du dictionnaire ACE. Cette fonctionnalité est souvent utilisée lorsque l’édition ACE comporte peu de champs, car il est dans ce cas préférable de procéder par élimination des champs inutiles dans le dictionnaire Editique.

En outre, ceci permet de générer une maquette de test comportant tous les champs de l’édition, destinée à faciliter la localisation des données.

Trucs et astuces Le déplacement de l’arbre complet du dictionnaire ACE vers le dictionnaire Editique réinitialise intégralement le dictionnaire Editique. Si ce dernier n’est pas vierge, l’opération doit être confirmée par l’utilisateur.

Dans l’exemple ci-dessous, nous avons sélectionné quelques champs du bloc d’en-tête d’événement (%05) que nous avons placés dans le bloc principal du dictionnaire Editique (c’est à dire directement sous le nœud racine de l’arbre, et non dans un sous-bloc).

Comme le moteur d’édition est le même pour tous les types d’événements commerciaux, il se peut que le nom des champs ne soit pas toujours très explicite. Dans notre exemple, on parle « d’événement » plutôt que de « commande ».

Dans d’autres cas , il s’agira plutôt d’une nuance de vocabulaire entre les termes employés communément et ceux que vous utilisez dans votre propre activité pour désigner la même chose.

Le nom constitue la première des propriétés des champs (les différentes propriétés sont détaillées dans le chapitre suivant).

Il existe deux méthodes permettant de créer un nouveau bloc dans le dictionnaire Editique.

• La première, évoquée dans le chapitre Insertion de champs , consiste à sélectionner un bloc du fichier de ressources et à le glisser sur le dictionnaire Editique. Dans ce cas, le bloc d’édition complet est créé dans le dictionnaire Editique.

Une fois le nouveau bloc créé, il suffit de le renommer à votre convenance et éventuellement d’en supprimer les champs inutiles afin d’alléger le dictionnaire et ainsi d’améliorer les performances.

Trucs et astuces Les champs du bloc d’édition déjà utilisés dans le dictionnaire Editique ne seront pas intégrés au nouveau bloc créé puisque chaque champ ne peut être utilisé qu’une et une seule fois au sein du dictionnaire Editique.

• La seconde méthode consiste à créer un bloc de toutes pièces.

Pour ce faire, sélectionnez le bloc (bloc principal ou sous bloc) sous lequel vous voulez créer un nouveau bloc, et activez le menu contextuel « Nouveau bloc ». Un nouveau bloc nommé ‘Block x’ est créé en dernière position sous le bloc sélectionné. Le curseur est automatiquement positionné en mode édition sur le nom de ce bloc de manière à ce que vous puissiez le renommer.

Vous pouvez désormais sélectionner un ou plusieurs champs d’un bloc d’édition et le(s) déplacer vers le nouveau bloc, puis le(s) renommer si nécessaire.

Dans l’exemple ci-dessous, nous avons créé le bloc « Adresse Commerciale » puis nous y avons inséré et renommé les champs nécessaires à l’édition de l’adresse commerciale du tiers associé à la commande.

Il est parfois intéressant de vouloir faire correspondre plusieurs champs édités par ACE avec plusieurs occurrences d’un même champ pour StreamServe. C’est le cas notamment lorsque l’on souhaite imprimer des lignes de commentaires sans réserver une hauteur fixe dans la page d’édition (PageOut StreamServe).

Par exemple, l’édition des événements d’ACE contient 50 zones de commentaires éditées par le bloc d’entête d’événement (%05). Plutôt que de nommer distinctement chacune de ces zones (« Commentaire Entête 01 » à « Commentaire Entête 50 » par exemple) et d’effectuer un test sur le contenu de chacune d’entre elles dans StreamServe pour savoir s’il faut ou non les imprimer, il est préférable de leur attribuer un nom unique et de les placer dans un bloc StreamServe dédié. De cette manière, chacune des cinquante zones de commentaires sera considérée par StreamServe comme une nouvelle occurrence du bloc dédié. Cette opération est également possible lorsque plusieurs champs liés se retrouvent de manière répétitive dans une édition ACE (voir exemples pages suivantes).

Les occurrences de blocs StreamServe créés à partir de champs différents d’ACE constituent des blocs « virtuels ».

Pour créer un bloc « virtuel », il faut attribuer le même nom à deux champs présents dans un même bloc Editique. Deux champs peuvent posséder le même nom dans le dictionnaire Editique si et seulement si :

• Ils proviennent du même bloc d’édition ACE.
• Ils sont placés dans le même bloc Editique.

Lorsque vous affectez à un champ un nom déjà utilisé par un autre champ dans le même bloc Editique, le système vous demande de confirmer que vous souhaitez réellement créer un bloc virtuel : « Voulez-vous considérer le bloc courant comme un bloc ‘virtuel’ ? ».

Deux champs possédant le même nom dans un dictionnaire Editique possèdent obligatoirement le même alias (lorsque l’on donne un nom déjà existant à un champ, le système récupère l’alias du champ qui portait déjà ce nom).

Outre l’ensemble des champs édités par chaque moteur d’édition, il est possible d’insérer dans les maquettes d’édition ACE des « variables fictives ». Ces variables sont le résultat d’affectations ou de calculs utilisant les valeurs de champs standards ou d’autres variables fictives. Comme pour les champs classiques, les variables fictives sont associées à (éditées par) un bloc d’édition ACE.

Les moteurs d’édition permettent également de faire appel à un certain nombre de fonctions permettant d’effectuer des calculs particuliers ou de rechercher des informations complémentaires non éditées en standard.

Les variables fictives peuvent être utilisées en tant qu’arguments en entrée et en sortie de ces fonctions d’édition. Généralement, seules les variables de sortie - c’est à dire celles contenant le résultat fourni par l’appel de la fonction – sont éditées.

La maquette d’édition ACE étant générée automatiquement, il est indispensable de pouvoir la personnaliser au sein de l’outil de gestion des dictionnaires de manière à intégrer systématiquement les spécificités souhaitées.

Pour plus d’information sur l’utilisation des variables fictives et des fonctions au sein des maquettes d’édition, merci de vous reporter à la documentation générale d’ACE .

Seules les variables à éditer doivent être insérées dans le dictionnaire Editique. En effet, il s’agit ici d’établir la correspondance entre la donnée qui sera éditée et un champ du dictionnaire StreamServe, de manière à pouvoir utiliser cette donnée dans StreamServe.

Pour insérer une variable, activez le menu contextuel « Insérer variable » sur un élément quelconque du dictionnaire Editique. Le système affiche alors la fenêtre de propriétés de la nouvelle variable. Si vous choisissez d’annuler, la variable ne sera pas ajoutée au dictionnaire.

Après avoir complété les différentes propriétés de la variable (voir chapitre suivant), celle-ci est insérée dans le dictionnaire juste après l’élément sélectionné (ou en dernière position du bloc si l’élément est un bloc). Les variables se différencient des champs par la couleur rouge de l’icône qui leur est associée.

Les maquettes d’édition ACE peuvent contenir des lignes qui n’ont aucune correspondance avec le dictionnaire StreamServe car elles n’ont pas d’incidence sur la structure du flux de données résultant de l’édition. Il s’agit par exemple de lignes de commentaires ou de déclaration de variables fictives; ou encore des appels de fonctions.

Pour insérer une ligne de texte, sélectionnez un élément quelconque du dictionnaire et activez le menu contextuel « Insérer zone libre ».

Le système insère un nouvel élément « Ligne de texte » juste après l’élément sélectionné (ou en fin de bloc si l’élément sélectionné est un bloc). Les lignes de texte se distinguent des autres éléments du dictionnaire par la couleur jaune de leur icône.

Le curseur est positionné automatiquement en édition sur cet élément de manière à ce que vous puissiez renseigner la ligne de texte. Validez la saisie via la touche <Entrée> ou en sélectionnant un autre élément à l’aide de la souris.

Pour modifier le contenu d’une ligne de texte, sélectionnez-la puis utilisez la touche de fonction <F2> ou effectuez un second clic espacé d’environ une seconde du précédent.

La longueur maximale d’une ligne de texte est de 259 caractères.

Attention Les lignes de texte sont modifiables sans aucun contrôle. Cependant, si leur contenu n’est pas contrôlé, ces lignes doivent néanmoins respecter les règles de syntaxe imposées par le langage des maquettes d’édition. Pour en savoir plus sur la syntaxe des maquettes d’édition, reportez-vous à la documentation de référence « Créer des maquettes spécifiques ».

1.1.1.1.1.1.1.1. Exemple d’insertion de lignes de texte

Dans cet exemple, nous allons ajouter les lignes de texte nécessaires à la déclaration des variables fictives et à l’appel de la fonction permettant de convertir un montant d’une devise quelconque en une autre devise quelconque.

La fonction de conversion de devises est CDEV(). Dans notre cas, nous devons l’appeler avec les trois arguments suivants (se reporter à la la documentation de référence « Créer des maquettes spécifiques (CDEV) » pour plus de renseignements sur la fonction CDEV) :

• Le montant à convertir,
• La devise du montant à convertir,
• La devise dans laquelle le montant doit être converti.

Rappel : seule la variable 001 sera éditée par la maquette d’édition, c’est pourquoi il a été nécessaire d’y associer une variable fictive dans le dictionnaire Editique.

Une maquette d’édition ACE est un fichier décrivant le contenu (les informations à éditer), et la forme (la mise en page/présentation) du résultat d’une édition.

Les éditions classiques d’ACE s’appuient sur des maquettes portant l’extension ‘.std_codlan’ - ou codlan représente le code langue de la maquette - pour générer des sorties au format ASCII, ou ‘.pcl_codlan’ pour générer des sorties au format PCL.

Dans le cadre d’Editique, les sorties à utiliser différent des sorties classiques en ce sens qu’elles ne comportent aucune mise en forme. Elles permettent simplement de générer un flux de données au format attendu par StreamServe, et correspondant à un événement StreamServe donné. L’extension des maquettes au format Editique est « .str_codlan ».

Les maquettes d’édition standard (livrées avec ACE ) sont installées dans le répertoire logique « ap$std_codlan »

Pour en savoir plus sur les répertoires logiques, consultez la documentation de référence « GENERIX.INI : personnaliser votre environnement de travail ».

Lorsque vous souhaitez personnaliser une maquette standard ou créer une nouvelle maquette, vous devez prendre garde à travailler dans un autre répertoire logique : « ap$maq_codlan ». De cette manière, votre maquette personnalisée ne sera pas écrasée lors de la prochaine mise à jour de version d’ACE, tandis que les maquettes standards seront mises à jour.

Les maquettes générées par le module ACE Editique seront donc installées dans votre répertoire de maquettes personnalisées.

Pour générer la maquette d’édition ACE au format Editique, activez le menu « Outils/Exporter la maquette ».

Le système vous demande si vous souhaitez que les éditions que vous réaliserez via cette maquette soient précédées d’une page d’entête.

• Si vous répondez par l’affirmative, toutes vos éditions réalisées à partir de cette maquette débuteront par une page récapitulant le contexte de lancement (qui a lancé l’édition, dans quelle société ACE, quels sont les critères de sélection, de tri…). Ce choix est particulièrement bien adapté aux éditions de statistiques ou de documents comptables, mais est au contraire inutile pour des documents tels que les commandes ou factures. Vous trouverez page suivante un exemple de page d’entête d’édition.
• Si vous ne souhaitez pas que cette page d’entête apparaisse, choisissez le bouton « Non »
• Si vous annulez, la maquette ne sera pas générée.

La maquette est générée dans le répertoire défini par la propriété « Répertoire d’export des maquettes » de la configuration de l’application (voir Répertoires de travail).

Exemple de page d’entête d’édition

Lorsque la génération est terminée, le système vous propose de transférer la nouvelle maquette sur un environnement ACE , de manière à ce que vous puissiez l’utiliser pour générer un flux de données destiné à tester le projet StreamServe que vous allez développer.

Sélectionnez parmi la liste des environnements disponibles (voir configuration des environnements de déploiement) celui sur lequel vous voulez installer la maquette et validez le transfert.

Le module « Déploiement de projets » permet d’effectuer toutes les opérations nécessaires à la mise en exploitation d’une édition construite à l’aide d’ACE Editique .

Cette option est accessible via l’icône « Déploiement de projets » de l’écran principal.

Le déploiement d’un projet consiste à transférer tous les fichiers nécessaires au traitement d’une édition au format Editique dans un environnement donné (voir « Configuration des environnements de déploiement »), puis à mettre à jour automatiquement le fichier d’arguments du serveur StreamServe afin d’y référencer les nouveaux fichiers à prendre en compte. Les éléments transférés sont d’une part les fichiers nécessaires à StreamServe (export du projet, plate-forme, drivers…), qu’il faut envoyer sur le serveur StreamServe, et d’autre part la maquette d’édition, qui doit être copiée sur le serveur ACE .

Au lancement du module, le système vérifie l’existence des répertoires ‘Editique’ et ‘Maquette’ définis au niveau de la configuration générale de l’application (voir Répertoires de travail).

Si le répertoire Editique n’est pas configuré, la fenêtre de configuration est ouverte automatiquement.

Si le répertoire Editique spécifié dans la configuration de l’application n’existe pas, le système signale l’anomalie et vous invite à corriger la configuration.

Afin de pouvoir sélectionner le ou les projets à exporter, activez le menu « Déploiement de projet’/’Choisir un projet ».

Le système affiche alors une fenêtre permettant de sélectionner les éléments à transférer sur le serveur StreamServe :

• Exports de projets StreamServe,
• Fichiers de fonctions StreamServe,
• Plates-formes StreamServe,
• Drivers StreamServe,
• Polices TrueType.

Le système se positionne automatiquement dans l’arborescence du répertoire « Editique » défini dans la configuration générale et affiche la liste des exports de projets présents (*.dux) ainsi que leur date et heure de génération.

Sélectionnez le ou les projets à déployer en cochant la case associée (soit à l’aide de la souris soit via la barre d’espacement).

Vous pouvez activer ou désactiver le transfert des autres fichiers liés aux projets. Le transfert de certains fichiers peut-être désactivé pour deux raisons :

• Soit parce que certains fichiers ne sont pas encore opérationnels et risquent de nuire au bon fonctionnement du serveur StreamServe sur l’environnement de destination.
• Soit parce que les fichiers ont déjà été transférés sur le serveur, il est donc inutile de les transférer à nouveau. La désactivation de ces transferts permet simplement d’accélérer le déploiement des projets.

Fichiers fonctions : par défaut les fonctions ne sont pas transférées. En effet, il y a un risque de transférer involontairement un fichier de définition de fonctions qui serait en cours de développement (par vous ou une autre personne) et qui pourrait contenir des erreurs entraînant l’impossibilité de redémarrer le serveur StreamServe. Pour cette raison, les fichiers de définition de fonctions à transférer doivent être sélectionnés de manière individuelle.

Overlays : Lorsque cette case à cocher est activée, tous les fichiers du répertoire « editique/Overlays » sont transférés sur le serveur StreamServe. Ce répertoire peut être relativement volumineux, notamment s’il contient des fichiers images en plus des fichiers overlays créés avec Design. Si vous n’avez modifié (ou ajouté) aucun fichier dans ce répertoire depuis le dernier déploiement de projet, vous pouvez décocher la case « Overlays » afin de réduire le temps de transfert.

Plates-Formes : Lorsque cette case à cocher est activée, tous les fichiers du répertoire ‘platforms’ (*.dpp et *.dua) sont transférés sur le serveur StreamServe. Si vous n’avez apporté aucune modification à votre plate-forme StreamServe depuis le dernier déploiement, vous pouvez décocher cette case.

Drivers : Lorsque cette case à cocher est activée, tous les fichiers du répertoire ‘drivers’ sont transférés sur le serveur StreamServe. Les drivers étant associés aux connecteurs de la plate-forme StreamServe, vous pouvez décocher cette case si vous n’avez apporté aucune modification à votre plate-forme StreamServe.

Polices : Cette case à cocher permet de transférer tous les fichiers de police TrueType présents dans le répertoire ‘data/fonts’. Les fichiers TrueType sont automatiquement copiés par StreamServe dans ce répertoire lorsque vous utilisez la fonction ‘Export All’ de Project. Vous pouvez désactiver cette case si vous êtes certain de ne pas avoir utilisé de nouvelles polices (par rapport à celles qui sont déjà présentes sur le serveur) dans les projets StreamServe que vous avez sélectionné précédemment.

Pour passer à l’étape suivante, appuyez sur le bouton « Suivant ».

Trucs et astuces Le simple fait de modifier le format d’affichage d’une information (par exemple la mettre en gras ou en italique ) implique généralement l’utilisation d’un nouveau fichier de police TrueType. Lorsque le serveur StreamServe ne trouve pas le fichier TrueType nécessaire à l’affichage d’une information, celle-ci n’est tout simplement pas restituée. StreamServe signale l’anomalie dans le fichier journal par le message suivant : <(2129) (font, not found in):FontName, DriverName> (Où FontName et DriverName sont respectivement remplacés par le nom de la police absente et le nom du driver utilisé).

Il ne vous reste plus qu’à sélectionner l’environnement dans lequel vous souhaitez déployer le projet et à confirmer votre choix via le bouton « OK ».

Une fois le déploiement terminé, un message vous en avertit.

Il vous suffit de redémarrer le serveur StreamServe pour pouvoir utiliser votre nouvelle édition depuis ACE .

Les critères sont présentés dans la liste dans le même ordre d’apparition que lorsque le lanceur sera utilisé depuis ACE . Pour déplacer un critère vers le haut ou vers le bas de la liste, utilisez les boutons ‘Up’ et ‘Down’ situés sur le côté gauche de la liste.

Il est possible de supprimer des critères associés à un lanceur. Généralement, on supprime les critères ayant peu ou pas d’intérêt pour l’utilisateur de manière à rendre le lanceur plus lisible.

Pour supprimer un critère, sélectionnez-le dans la liste puis utilisez la touche ‘Suppr’ ou le bouton « Supprimer » situé sous la liste, puis confirmez la suppression.

Attention La suppression des critères est définitive pour le lanceur édité. Si un critère a été supprimé à tort, il faut quitter la fenêtre de modification des critères à l’aide du bouton ‘Annuler’ afin de ne pas enregistrer les modifications.

Pour modifier les caractéristiques d’un critère, il faut le sélectionner et utiliser les zones d’édition situées sous la liste.

Les caractéristiques d’un critère sont les suivantes :

• Champ : correspond au code du critère dans le progiciel. Ce code est inchangeable et ne peut être édité. Il n’est pas visible lors de l’utilisation du lanceur depuis ACE .

• Libellé : Le libellé décrit le critère. C’est ce libellé qui est affiché lors de l’utilisation du lanceur depuis ACE . Il est modifiable et comporte 12 caractères au maximum.

• N° Tri : Le numéro de tri indique le rang qu’occupe le critère entre dans la composition du tri qui sera appliqué au résultat de l’édition. Par exemple, pour une édition de commande, il est possible de trier les commandes par code client plutôt que par numéros de commande (cf. exemple ci-après). Les critères dont la zone ‘N° Tri’ est vide n’entrent pas dans la composition du tri appliqué à l’édition. Il ne peut y avoir deux critères ayant le même rang dans l’ordre de tri. Le système refusera tout doublon par le message ‘Ordre de tri non valide’.

• Tri O/N : S’il est à Non (‘N’), cet indicateur permet d’empêcher l’utilisateur de modifier la valeur de tri paramétrée pour le critère édité.

• Saisie Autorisée : Cette colonne peut prendre trois valeurs :

• O : l’utilisateur pourra saisir une ou plusieurs valeurs pour ce critère.
• U : l’utilisateur devra saisir une et une seule valeur pour ce critère (la saisie sera obligatoire).
• N : l’utilisateur n’aura pas accès à la saisie des valeurs pour ce critère.

Dans l’exemple ci-dessus, seuls cinq critères n’ont pas été supprimés :

• Le critère ‘achvte’ (déterminant le code ‘Achat’ ou ‘Vente’ des événements commerciaux) est le premier critère de tri de l’édition. Lors de l’utilisation du lanceur, le rang dans l’ordre de tri de ce critère ainsi que sa valeur (‘V’) ne seront pas modifiables (colonnes ‘Tri O/N’ et ‘Saisie autorisée’ à ‘N’).

• Le critère ‘typeve’ (déterminant le type des événements commerciaux à éditer) est le second dans l’ordre de tru de l’édition. Comme le précédent, ni son rang dans l’ordre de tri ni sa valeur (‘CDE’) ne seront modifiables par l’utilisateur.

• Le critère ‘numeve’ (le numéro d’événement commercial) est le troisième dans l’ordre de tri dans l’édition. Cependant, l’utilisateur pourra modifier son rang dans les critères de tri puisque la colonne ‘Tri O/N’ a pour valeur ‘O’. De plus, l’utilisateur pourra spécifier, un ou plusieurs numéros de commandes à sélectionner s’il le souhaite (cf. paragraphe suivant).

• Le critère ‘sigtie’ (correspondant ici au code client) est quant à lui le quatrième et dernier critère à entrer dans la composition du tri de l’édition. Comme pour le précédent, l’utilisateur pourra modifier son rang parmi les critères de tri et pourra s’il le souhaite saisir un ou plusieurs codes clients à sélectionner.

• Enfin, le dernier critère conservé (‘codeta’) n’entre pas dans la composition du tri à appliquer au résultat de l’édition. Cependant l’utilisateur pourra l’y faire entrer en spécifiant un numéro d’ordre de tri non encore utilisé (c’est à dire obligatoirement supérieur à 2 - puisque les rangs 1 et 2 sont réservés par les deux premiers critères -, et différent des valeurs affectées aux critères ‘numeve’ et ‘sigtie’). De plus, l’utilisateur sera contraint à saisir une et une seule valeur de sélection pour ce critère.

Pour chaque critère, il est possible de saisir des valeurs permettant à ACE d’opérer une sélection sur les éléments à inclure dans le résultat de l’édition.

Par exemple, dans l’exemple précédent, pour sélectionner la commande no 90215 ou toutes les commandes à l’état ‘V’ (Validées) des clients dont le code commence par le chiffre ‘1’ ou pour les clients dont le code est compris entre ‘8%’ et ‘9’ (le caractère ‘%’ représentant une chaîne quelconque de caractères).

• Pour appliquer une première sélection à un critère, utilisez le bouton « Ajouter » situé sous la liste de valeurs, puis renseignez les différentes valeurs dans les zones d’édition ‘Début’, ‘Fin’ et ‘Commence Par’.
• Pour appliquer plusieurs sélections à un critère, il faut saisir les valeurs correspondant à chaque sélection sur des lignes distinctes. Pour ce faire, utilisez le bouton « Ajouter » pour chaque nouvelle sélection à appliquer, et renseignez les valeurs comme précédemment.
• Pour supprimer une ligne dans la liste de valeurs, il faut la sélectionner puis utiliser le bouton « Supprimer » .

Lorsque l’attribut ‘Saisie autorisée’ d’un critère est positionné à ‘U’, seule la zone d’édition ‘Début’ est accessible. Le bouton ‘Ajouter’ est inopérant.

• Les colonnes ‘Valeur Début’ et ‘Valeur Fin’ déterminent respectivement les bornes inférieures et supérieures des fourchettes de sélection à appliquer au critère.

• La colonne ‘Commence par’ contiendra quant à elle la chaîne de caractères par laquelle devront commencer les valeurs des éléments retenus.

Vous disposez de trois options pour quitter la fenêtre de modification des lanceurs.

• Le bouton « OK » permet de retourner à la liste des lanceurs tout en enregistrant les modifications apportées aux critères. Toutes les modifications ou suppressions effectuées sur les critères du lanceur sont sauvegardées.
• Le bouton « Annuler » permet de retourner à la liste des lanceurs sans enregistrer aucune des modifications apportées aux différents critères. Cette option peut se révérer utile lorsque vous avez supprimé un critère par erreur.
• Le bouton « Quitter » permet quant à lui de quitter directement la gestion des lanceurs (retour au menu général de l’application) sans enregistrer les modifications apportées aux critères du lanceur édité.

Rappel : Les drivers ODBC doivent être installés et opérationnels sur le poste de développement Editique.

Attention : Pour se connecter à une base Oracle 8i, il faut impérativement utiliser le MDAC 2.6 de Microsoft (disponible en téléchargement sur le site de Microsoft, et dans le setup de StreamServe Serve – cf Guide d’installation Editique V2.0).

Les sources de données ODBC s’appuient sur le protocole SQL*Net d’ORACLE. Il faut donc paramétrer un alias SQL*Net pour chacune des bases de données ACE que l’on souhaite atteindre avec le module « Gestion des lanceurs ».

La déclaration d’un nouvel alias SQL*Net pointant vers une base ACE est inutile s’il en existe déjà un sur le poste de travail.

Les chapitres suivants décrivent la procédure à suivre respectivement pour un serveur Oracle 7.x et 8i.

Exécutez ces procédures pour chacun des environnements ACE (recette et exploitation par exemple).