WEBDEV 2025 : Les concepts

106 Partie 3 : Environnement de développement Composant externe en pratique 1 Présentation 1.1 Définition Un composant externe est un ensemble d’éléments WINDEV, WEBDEV ou WINDEV Mobile : fenêtres, pages, états, analyse, etc. Cet ensemble d’éléments effectue une fonctionnalité précise. Par exemple, un composant peut correspondre à une des fonction- nalités suivantes : • Envoi de fax, • Envoi d’emails, • etc. Remarques  : • Pour optimiser l’organisation de vos projets, il est possible d’utiliser des composants internes. Pour plus de détails, consultez Composant interne. • Dans la suite de ce chapitre, le terme "compo- sant" signifie "composant externe". Un composant externe peut être redistribué à d’autres développeurs WINDEV, WEBDEV ou WINDEVMobile (gratuitement ou non). Ces déve- loppeurs pourront ainsi intégrer simplement la fonctionnalité proposée par le composant dans leur application (ou leur site). Le composant sera donc intégré à l’application (ou site), et distribué avec l’application (ou site). Lors de la création du composant externe, l’auteur spécifie : • les éléments du composant visibles ou non par l’utilisateur du composant. Les éléments visibles seront accessibles via le volet "Explorateur de projet" ou par programmation. • le mode d’utilisation du composant (comment utiliser le composant, les paramètres permettant d’accéder aux fonctionnalités du composant, etc.). Une documentation succincte (à compléter) est automatiquement générée et associée au composant. 1.2 De quoi est constitué un composant externe ? Un composant externe peut être : • défini et généré à partir d’un projet WINDEV, WEBDEV ou WINDEV Mobile existant. Une configuration de projet de type "Composant" permettra de sélectionner les éléments du projet existant à intégrer dans le composant. • créé à partir d’un projet de type "Composant externe". Ce projet est constitué par défaut d’une plateforme de type "Composant externe" qui contiendra les éléments nécessaires à la création et à la génération du composant. Ce composant externe peut être ensuite intégré dans d’autres projets WINDEV, WEBDEV, WINDEV Mobile. Tous les éléments du composant sont totalement indépendants du projet dans lequel le composant est intégré. Le composant externe peut avoir sa propre analyse, ses fenêtres, ses états, ses fichiers, etc. Lors de la génération du composant externe, il suffit d’indiquer si ces éléments seront accessibles ou non par le projet intégrant ce composant. Les élé- ments non accessibles ne seront ni visibles ni mani- pulables par le projet qui importera ce composant. Le composant externe est constitué de plusieurs fichiers : • <NomComposant>.WDK Fichier composant . Contient tous les élé- ments du composant. Ce fichier est nécessaire à l’intégration du composant dans un projet. Ce fichier doit également être livré dans la procédure d’installation du site utilisant le composant.