A tout moment, un composant externe créé et généré avec WINDEV, WEBDEV ou WINDEV Mobile peut être modifié. Cette modification peut correspondre :

• soit à l'ajout d'éléments dans le composant,
• soit à la suppression d'éléments du composant,
• soit à la modification des droits sur les éléments du composant,
• soit à la modification d'un des éléments du composant.

• Comment modifier un composant.
• Comment régénérer une nouvelle version du composant en tenant compte de la compatibilité du composant.
• Les différents types de compatibilités (ascendante ou descendante) et les problèmes associés.

Ajouter ou supprimer un élément dans un composant

Pour ajouter ou supprimer un élément dans un composant :

1. Ouvrez le projet du composant : sous le volet "Accueil", dans le groupe "Général", déroulez "Ouvrir" et sélectionnez "Ouvrir un projet".
2. Sous le volet "Projet", dans le groupe "Projet", déroulez "Liste des éléments" et sélectionnez "Liste des composants générés".
3. La fenêtre de description des composants s'affiche. Cette fenêtre permet d'effectuer les modifications suivantes :
   • Modifier un composant (bouton [Modifier]).
     L'assistant de modification d'un composant se lance avec les options du composant sélectionné. Il est possible de modifier les différentes options du composant (ajouter des éléments, modifier la visibilité des éléments, ...).
   • Connaître et modifier les éléments intégrés dans le composant.
   • Rendre visible ou non les éléments intégrés dans le composant.
   • Modifier les droits d'accès du composant sur le projet client.
4. Régénérer le composant.

Modifier d'un élément du composant

Pour modifier d'un élément du composant :

1. Ouvrez le projet du composant : sous le volet "Accueil", dans le groupe "Général", déroulez "Ouvrir" et sélectionnez "Ouvrir un projet".
2. Ouvrez l'élément désiré.
3. Effectuez les modifications nécessaires.
4. Enregistrez ces modifications ().
5. Régénérez le composant : cliquez sur l'icône de génération parmi les boutons d'accès rapide :

Après n'importe quelle modification, le composant doit être régénéré pour prendre en compte les modifications effectuées (changement de l'interface d'une fenêtre par exemple).

1. Lancez la génération du composant :
   • soit en cliquant sur l'icône de génération parmi les boutons d'accès rapide.
   • soit directement par la fenêtre de description des composants (option [Générer]).
2. L'assistant de génération du composant se lance.
3. Dans l'écran "Compatibilité du composant en déploiement", une vérification des modifications apportées est effectuée:
   • Si les modifications rendent le composant incompatible avec les versions antérieures, l'écran s'affiche :
     
     Mettez les numéros de version en phase (bouton ).
     Passez à l'étape suivante pour continuer la génération du composant.
   • Si les modifications détectées ne rendent pas le composant incompatible avec les versions antérieures, aucune action spécifique n'est nécessaire. Cliquez simplement sur "Suivant" pour continuer la génération du composant.

Définition

La gestion de la compatibilité est liée aux versions d'un composant. En effet, si des modifications ont été apportées au composant, les applications qui utilisent le composant en déploiement peuvent rencontrer des problèmes d'exécution si elles ne sont pas en phase avec ce composant.

• La compatibilité descendante : la version du composant utilisée (fichier .WDK) pour compiler les applications utilisant ce composant doit être toujours supérieure ou égale à la version actuellement utilisée en déploiement.
  Cette compatibilité est automatiquement gérée par WINDEV. Si le composant installé avec l'application est d'une version inférieure à celle utilisée par l'application, l'application refusera de fonctionner.
• La compatibilité ascendante : l'utilisation d'une nouvelle version d'un composant avec les projets compilés avec une ancienne version peut être interdite. Il est donc nécessaire de recompiler les projets pour utiliser correctement la nouvelle version du composant.

Compatibilité descendante

Le numéro de version des composants est automatiquement vérifié pour s'assurer que la version du composant utilisée dans l'application en déploiement est supérieure ou égale à celle utilisée lors du développement de l'application.

• Premier cas : Les applications en clientèle utilisent le composant (fichier .WDK) dans une version inférieure à 1.00C. Une erreur surviendra au chargement de ces applications.
  
• Second cas : Les applications en clientèle fonctionneront si elles utilisent le composant dans la version attendue.
  
• Troisième cas : Les applications en clientèle fonctionneront également si le composant est d'une version supérieure à celle attendue (uniquement dans le cas où la nouvelle version n'apporte que des corrections de dysfonctionnement).
  

Compatibilité ascendante

Les incompatibilités entre deux versions d'un même composant sont automatiquement détectées lors de la génération de ce composant. Si des différences sont détectées, vous pouvez modifier le "numéro de la dernière version compatible". Ce numéro est le numéro de version à partir duquel les applications utilisant le composant seront autorisées à fonctionner.

• Premier cas : le composant a été modifié uniquement pour corriger certains dysfonctionnements. Lors de la génération du composant, le "numéro de dernière version compatible" n'a pas été modifié.
  Pour que les applications fonctionnent correctement, il n'est pas nécessaire de recompiler les projets avec la nouvelle version du composant. Le composant (fichier .WDK) peut être directement distribué en clientèle.
  
• Second cas : le composant a été modifié pour ajouter un paramètre à une procédure par exemple. Lors de la génération du composant, le "numéro de dernière version compatible" a été modifié.
  Pour que les applications fonctionnent, il faut nécessairement que les projets soient recompilés avec la nouvelle version du composant. Dans le cas contraire, les applications refuseront de fonctionner pour éviter les problèmes dus aux incompatibilités éventuelles de la nouvelle version du composant.