• Organiser un projet : vous pouvez créer des composants internes pour regrouper les éléments d'un projet par exemple par fonctionnalité.
• Partager des éléments entre différents projets : Les éléments présents dans un composant interne peuvent être partagés entre plusieurs projets par l'intermédiaire du GDS. Pour plus de détails, consultez Partager un composant interne.

• Un composant interne permet d'intégrer la totalité des éléments du composant dans l'interface du projet contenant le composant interne. Il est possible de manipuler tous les éléments "publics" du composant interne directement sous l'éditeur.
• Lors de l'utilisation d'un composant externe, les éléments "publics" du composant ne peuvent pas être manipulés directement. Il est nécessaire pour modifier le composant externe d'ouvrir le projet correspondant.

Créer un composant interne

1. Sous le volet "Projet", dans le groupe "Configuration de projet", déroulez "Nouvelle configuration" et sélectionnez "Composant Interne". L'assistant de création d'un composant interne se lance. Pour ANDROID/IOS faites un clic droit sur "Composants internes" dans l'explorateur de projet, puis sélectionnez "Nouveau composant interne".
2. Indiquez les caractéristiques du composant interne :
   • son nom. Le nom du composant interne sera utilisé pour le fichier WCI correspondant à la description du composant interne. Ce nom sera également utilisé pour créer un sous-répertoire dans votre projet contenant tous les éléments du composant interne.
   • son libellé.
   • sa description.
3. Passez à l'étape suivante.
4. Indiquez les éléments à intégrer dans le composant interne. Un composant interne peut contenir tous les types d'éléments présents dans un projet : fenêtres, pages, états, modèles, collections de procédures, ...
   Remarque : Si les éléments intégrés dans le composant interne contiennent des liens vers les éléments présents par exemple dans le projet ou dans un autre composant interne, une erreur de compilation apparaît indiquant qu'il n'est pas possible d'accéder à un élément du projet depuis un composant interne.
5. Passez à l'étape suivante.
6. Indiquez les éléments du composant interne qui seront directement accessibles dans le code et dans les actions prédéfinies du projet accueillant le composant interne.
   Remarque : Les éléments du composant interne accessibles (ou "public") seront automatiquement proposés par la complétion. Ils pourront être utilisés par les éléments présents dans le projet ou depuis un autre composant interne. Les éléments non accessibles (ou "privés") pourront être manipulés uniquement par un autre élément du composant interne (la complétion proposera ces éléments "privés" uniquement depuis les éléments d'un composant interne).
7. Passez à l'étape suivante.
8. Indiquez l'analyse utilisée par le composant interne. Trois modes sont disponibles :
   • Utiliser l'analyse du projet ou aucune analyse (partage complet) : Le composant interne accède aux fichiers de données du projet. Le composant interne utilise également les mêmes contextes d'exécution que le projet.
     Ce mode correspond au mode par défaut si le composant interne n'utilise pas d'analyse.
   • Utiliser l'analyse du projet avec contexte d'exécution différent (mode avancé) : Le composant interne accède aux fichiers de données du projet. Le composant interne utilise des contextes d'exécution distincts de ceux du projet.
     Ce mode est à utiliser dans des cas très spécifiques.
   • Utiliser une analyse spécifique : Le composant interne accède à ses propres fichiers de données : il est autonome. Le composant interne utilise des contextes d'exécution distincts de ceux du projet.
     Ce mode correspond au mode par défaut si le composant utilise une analyse.
     Dans ce cas, il est nécessaire d'indiquer l'analyse utilisée par le composant interne et si nécessaire son mot de passe. Il est également possible de créer directement une nouvelle analyse. Cette analyse sera associée au composant interne.
9. Passez à l'étape suivante.
10. Validez la création du composant interne. A tout moment, il sera possible de :
    • Modifier les caractéristiques du composant interne grâce à la fenêtre de description du composant interne.
    • Manipuler le composant interne et ses éléments.

Composant interne : les modifications réalisées lors de la création

• Un sous-répertoire au nom du composant interne est créé dans le projet.
• Les différents éléments affectés au composant interne sont regroupés dans le répertoire du composant interne. Les fichiers correspondant aux éléments du projet sont déplacés physiquement.
• Un fichier WCI est créé dans le répertoire du composant interne. Ce fichier contient la liste des éléments du composant.

• l'analyse du projet,
• l'analyse du ou des composants internes. Cette analyse est définie lors de la création du composant interne. Elle peut être également sélectionnée depuis la fenêtre de description du composant interne.

RAD et composants internes avec analyse

Les pages AWP (et donc le RAD AWP) ne fonctionnent pas dans les composants internes.

• Les composants internes peuvent être partagés uniquement par l'intermédiaire du GDS. Pour plus de détails, consultez Partager des composants internes.
• Un élément du projet ne peut pas être présent dans plusieurs composants internes. Il n'est pas possible de partager une collection de procédures entre plusieurs composants internes.
• Les composants internes ne peuvent pas être imbriqués.
• Gestion des noms des éléments : Il y a unicité des noms entre les éléments du projet et ses composants internes : il n'est pas possible d'utiliser un composant interne ayant un élément dont le nom est déjà présent dans le projet. Si à la mise à jour d'un composant interne, un conflit de nom apparaît, un des deux éléments portant le même nom devra être renommé.
• Gestion des styles : Si un composant interne utilise des styles spécifiques, seul le projet qui possède ces styles pourra les modifier. Dans les autres projets, les styles ne seront pas perdus mais ils ne pourront pas être modifiés.
• Les états présents dans un composant interne ne doivent pas être ouverts avec le logiciel "Etats & Requêtes".
• Il n'est pas possible de mettre un assemblage .NET dans un composant interne.
• Afin d'organiser les éléments d'un composant interne, il est possible de créer des perso-dossiers dans un composant interne. Pour plus de détails, consultez Perso-Dossiers.
• La portée des fonctions d'un webservice SOAP importé dans un composant interne, est limitée aux événements/traitements des éléments inclus dans le composant interne. Les fonctions d'un webservice importé dans un composant interne ne seront pas accessibles dans les événements/traitements du projet hôte.