Le composant est une entité qui regroupe un même sujet de gestion (données et traitements). Chaque composant possède ses traitements, sa structure de données et ses ressources (écrans, états, etc...). Le composant contient des objets qui vont se charger des tâches propres au composant telles que les impressions et la modification des données…

Le composant peut communiquer avec d’autres composants tout en restant autonome. Sa structure s’appuie sur le principe de la boîte noire. Un composant ne fait jamais appel directement aux données et traitements d’un autre composant. Il doit posséder une partie publique, l’interface, contenant les éléments que l’on souhaite rendre accessibles.  Les méthodes «publiques» sont regroupées dans l’objet INTERFACE qui contient les points d’entrée du composant. En ce qui concerne les données, une structure d’interface est prévue dans laquelle on définit les champs que l’on souhaite rendre publics. Les communications entre composants passent toujours par l'objet et la structure d'interface.

• L’utilisation d’un composant nécessite seulement de connaître ses éléments publics.
• Une modification effectuée sur la partie privée d’un composant sera automatiquement exploitée par tous les composants.
• A chaque modification, il n’est pas nécessaire de générer tous les composants de l’application, mais seulement le composant en question.
• Le développeur doit uniquement définir les objets INTERFACE, les méthodes publiques, définir ses données et les liens entre les composants. Oxygène se charge des transferts de données, des appels aux méthodes publiques etc....

1 Identifier le composant logiciel

A partir de l’écran à personnaliser, on fait apparaître la fenêtre de propriétés avec ALT+F12. Celle-ci affiche le code du composant logiciel ainsi que ses propriétés. Le code est GCPCLI-GESTION.  Il contient un préfixe GC pour Gestion Commerciale, CLI pour Client, GESTION correspondant à la « gestion » de la fiche client.

2 Modifier la table client

Depuis le tableau de bord de la base de données intégré aux outils du développeur on ajoute un nouveau champ « POINTS » à la table des clients GCPCLI.

3 Créer le projet dans Visual Studio

Le projet est créé dans Visual Studio avec l’assistant de création de projet Oxygène installé avec le SDK.

Dans cet exemple on laisse les deux premiers  onglets avec leurs valeurs par défaut, et on ajoute les dépendances du projet dans les « Modèles et dérivations ». Ces dépendances sont GCPCLI, le composant dont on dérive, et  GCMUTIL qui est un composant utilitaire de la Gestion Commerciale Oxygène utilisé par l’ensemble des composants.

4 Créer l’objet de gestion des clients

En utilisant l’assistant « nouvel élément Source Oxygène» on va créer l’objet associé à l’écran. Cet objet contiendra le code spécifique qui permettra d’adapter le comportement de l’écran. Dans les dérivations Oxygène les objets dérivés portent le même nom que l’objet de base, ici GESTION. Dans l’assistant on met le type de fichier source à « Dérivation d’un objet », la base à « GESCOM » et la table à « GCPCLI » comme dans le composant de base.  

On définit dans l’onglet « Dérivation » le chemin du fichier source de l’objet dont on dérive, ainsi que le chemin des autres dépendances dans l’arborescence du SDK. Le fichier source est ensuite généré dans le projet.

Composant DERCLI

Declaration

  GLOBAL : "DERCLI", "GCPCLI"

  // dépendances du projet

  SRC_MODELE : "..\..\GESCOM\GCPCLI\GESTION"

  SRC_MODELE : "..\..\GESCOM\GCMUTIL\GCMGEST"

FinDeclaration

Objet GCPCLI.GESTION : GESTION

       Declaration

       FinDeclaration

FinObjet

On peut y voir le fichier .l4g contenant le code en langage Oxygène, et l’inclusion des fichiers C++ qui vont être générés par le traducteur de langage Oxygène et compilés avec le projet. On peut voir le nom du composant créé, DERCLI, la liste des dépendances et la déclaration de l’objet. Cette déclaration définit dans le composant DERCLI un objet GESTION dont le prototype est (ou qui dérive de) l’objet GESTION du composant GCPCLI.

5 Personnaliser l’écran

Tous les écrans des logiciels dérivables de l’ERP Oxygène sont fournis avec le SDK. Pour personnaliser un écran il faut donc copier-coller le fichier de l’écran de base  dans le répertoire du projet et l’ajouter au projet sous le dossier « Global » qui contient les ressources du projet.  On va pouvoir ensuite modifier l’écran avec l’éditeur d’écran du SDK Oxygène.

On a ajouté un champ « Points de fidélité ». On l’associe au champ POINTS qu’on a créé dans la table courante GCPCLI. Après compilation du projet, on pourra tester cette dérivation en saisissant le code du composant dérivé dans la table des composants Oxygène. Cette opération, s’effectue manuellement en mode développeur, mais sera effectuée par l’installeur de composants lors du déploiement.

En quelques étapes simples nous avons pu adapter un écran de la Gestion Commerciale Oxygène. Cet exemple volontairement simplifié ne définit pas de code dans l’objet dérivé. Un exemple plus poussé qui définit un contrôle sur la valeur du champ peut être consulté en vidéo sur le site web du forum Oxygène.