DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Composant / Composant Externe
  • Présentation
  • Caractéristiques d'un composant externe
  • De quoi est constitué le composant externe ?
  • Que contient un composant externe ?
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
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 fonctionnalités suivantes :
  • Envoi de fax,
  • Envoi d'emails,
  • ...
Un composant externe peut être redistribué à d'autres développeurs WINDEV, WEBDEV ou WINDEV Mobile (gratuitement ou non). Ces développeurs 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).
Dans le cas d'applications multilingues, un composant externe redistribué peut être traduit à l'aide de WDMSG à partir du projet utilisant le composant.
Remarque : Pour optimiser l'organisation de vos projets, il est possible d'utiliser des composants internes. Les composants internes permettent de regrouper vos ressources selon des thèmes spécifiques.
Caractéristiques d'un composant externe
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.
Attention : Un composant n'est pas un superchamp. En effet, le superchamp ne peut être constitué que de champs alors que le composant est constitué de fenêtres, pages, états, etc. Dans la plupart des cas, le composant attend des informations (paramètres), les traite, et renvoie un résultat à l'application qui l'utilise. De plus, contrairement au superchamp, un composant a une installation spécifique.
WINDEV Remarque : Des composants exemples sont livrés en standard avec WINDEV. Ces composants sont accessibles depuis le volet "Projet" de l'éditeur : sous le volet "Projet", dans le groupe "Projet", déroulez "Importer" et sélectionnez l'option "Un composant Externe .. Composant utilitaire ou exemple". Les projets correspondants peuvent être ouverts depuis la page d'accueil de WINDEV (Ctrl + <).

De quoi est constitué le 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 manipulables par le projet qui importera ce composant.
Le composant externe est constitué de plusieurs fichiers :
<Nom du composant>.WDKFichier composant. Contient tous les éléments du composant externe.
Ce fichier est nécessaire à l'intégration du composant externe dans un projet.
Ce fichier doit également être livré dans la version cliente de l'application utilisant le composant externe.
<Nom du composant>.WDIDescription du composant (uniquement pour le développement d'applications).
Ce fichier est nécessaire à l'intégration du composant externe dans un projet.
Ce fichier ne doit pas être livré dans la version cliente de l'application utilisant le composant externe.
<Nom du composant>.WDZFichier des dépendances du WDK (uniquement pour les composants WEBDEV et WINDEV Mobile)
Fichier contenant les dépendances du fichier WDK. Ces informations sont extraites dans le projet dans lequel le composant est intégré.
  • Dans le cas d'un composant WEBDEV, ce fichier contient par exemple les pages WEBDEV générées, les images, etc.
  • Dans le cas d'un composant Mobile (iOS ou Android), ce fichier contient par exemple les fichiers de génération Android, etc.
<Nom du composant>.WDOFichier optionnel
Fichier au format texte contenant la liste des différents éléments livrés en plus avec le composant externe (fichiers de données, fichiers .INI, etc.). Ce fichier peut être créé manuellement ou généré automatiquement à partir des éléments spécifiés dans le dossier "Autres" du volet "Explorateur de projet". Pour plus de détails, consultez Le fichier WDO.
Que contient un composant externe ?
Un composant externe contient :
  • les différents éléments à redistribuer (fenêtres, états, etc.). Ces éléments peuvent être accessibles ou non lors de l'importation du composant dans un projet WINDEV, WEBDEV ou WINDEV Mobile. Ces éléments ne peuvent pas être modifiés à partir du projet utilisant le composant.
  • une brève description du composant.
  • une aide permettant de réutiliser ce composant. Cette aide est générée à partir des commentaires de code.
Remarque : Par défaut, si un composant externe utilise une analyse et des fichiers de données, les fonctions HFSQL manipuleront ces éléments dans un contexte HFSQL indépendant. Ces paramètres peuvent être modifiés dans les options avancées du composant. Pour plus de détails, consultez Options avancées d'un composant externe.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 31/08/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale