Page de définition de schéma

A propos de cette page

Cette page de formulaire vous permet d'éditer la structure et les propriétés des objets de schéma qui composent la grammaire du schéma édité.

La structure des objets de schéma est éditée dans la section Eléments de point d'extension. Cette section occupe la partie supérieure gauche de la zone de l'éditeur.

Les propriétés des objets de schéma sont éditées dans les sections <objet de schéma> Détails. Ces sections sont activées dans la partie supérieure droite de la zone de l'éditeur, en fonction du type d'élément de schéma sélectionné dans la section Eléments de point d'extension.

Sections de page

Cette page est comprise dans les sections suivantes :

Section Eléments de point d'extension

Cette section vous permet de faire ce qui suit :

Cette section est directement accessible via la page de formulaire Définition de schéma.

Zones de la section Eléments de point d'extension

Utilisez la zone de l'afficheur d'élément de point d'extension pour faire ce qui suit :

Cet afficheur contient les noeuds suivants :

Eléments :

Compositeurs :

Attributs :

Exemple : L'élément extension spécifie qu'une séquence d'un ou plusieurs éléments de raccourci sont autorisés en tant qu'enfants admis. Une référence d'élément est utilisée pour représenter l'élément de raccourci. Un composeur de séquence est utilisé pour représenter une séquence d'éléments.

Eléments de point d'extension - Section 2

Exemple : L'élément de raccourci spécifie qu'un élément de description ou de catégorie est autorisé car il s'agit de son enfant admis. Les références d'élément sont utilisées pour représenter les éléments description et catégorie. Un composeur de choix est utilisé pour représenter une sélection d'éléments.

Eléments de point d'extension - Section 1

Actions de la section Eléments de point d'extension

Cliquez sur le bouton Ajouter un élément pour ajouter une nouvelle déclaration d'élément global à la grammaire du schéma de point d'extension. Cette action est disponible lorsque tout noeud est sélectionné. Remarque : L'ordre de la déclaration d'élément n'est pas important

Cliquez sur le bouton Ajouter un attribut pour ajouter une nouvelle déclaration d'attribut local à la grammaire du schéma de point d'extension. Cette action est disponible pour tous les noeuds élément sélectionnés excepté pour le noeud élément d'extension. Le noeud élément d'extension possède toujours les mêmes attributs : id, nom, point. Remarque : L'ordre de la déclaration d'attribut n'est pas important

Pour supprimer un objet de schéma de la grammaire du schéma de point d'extension, cliquez avec le bouton droit de la souris sur un noeud sélectionné et sélectionnez Supprimer. Cette action est disponible pour tous les noeuds sélectionnés excepté pour le noeud élément d'extension. Pour les schémas non partagés, le noeud élément d'extension est l'élément principal spécial utilisé pour définir le point d'entrée dans la grammaire du schéma édité. Toute extension définie dans l'Editeur de manifeste de plug-in doit utiliser un élément d'extensionparent pour spécifier qu'il s'agit d'un mark-up lié à XML.

Pour spécifier que les enfants d'un élément sont composés d'une séquence de choix ou d'autres éléments dans la grammaire du schéma du point d'extension, procédez comme suit :

  1. Sélectionnez et cliquez avec le bouton droit de la souris sur le noeud élément que vous souhaitez désigner en tant qu'élément parent.
  2. Sélectionnez Nouveau > Composeur > Séquence pour définir une séquence d'éléments. Sélectionnez Nouveau > Composeur > Choix pour définir une sélection d'éléments.
  3. Sélectionnez et cliquez avec le bouton droit de la souris sur le nouveau noeud composeur.
  4. Sélectionnez l'élément dans le sous-menu Nouveau > Référence que vous souhaitez désigner comme un enfant de l'élément parent. Le sous-menu Référence est renseigné avec tous les éléments déclarés globalement dans la grammaire du schéma de point d'extension.
  5. Répétez les étapes (3) et (4) afin de spécifier des éléments enfants supplémentaires. Si un composeur de séquence a été spécifié, cela revient à spécifier des éléments supplémentaires dans la séquence. Si un composeur de choix a été spécifié, cela revient à spécifier des choix d'éléments supplémentaires.

Remarque : Pour spécifier qu'un élément est l'enfant d'un autre élément, un composeur de Séquence ou de Choix intermédiaire doit toujours être utilisé par l'élément parent. Les noeuds composeur sont des noeuds de connecteur, alors que les noeuds référence d'élément sont des noeuds terminaux. C'est pourquoi les noeuds composeur doivent toujours spécifier au moins un noeud référence d'élément enfant.

Remarque : les composeurs Séquence et Choix doivent être imbriqués un certain nombre de fois pour créer des grammaires plus complexes.

Remarque : Une grammaire ne doit pas contenir de cycles auto-référents. La forme la plus basique d'un cycle interdit se produit lorsque l'Elément A exige l'Elément B comme enfant et que l'Elément B exige l'Elément A comme enfant.

Pour spécifier qu'un élément n'a pas d'enfant et permet au texte d'être spécifié dans ses balises XML de fin et de début (contenu de caractères), laissez telle quelle la structure de l'élément : ne lui ajoutez aucun attribut ou composeur ni aucune référence d'élément (contenu élémentaire). Remarque : Un élément ne peut pas spécifier de contenu mixte (contenu de caractère et contenu élémentaire).

Section Description

Cette section vous permet de fournir une brève description de tout élément, attribut ou composeur dans la grammaire du schéma édité.

Cette section est directement accessible via la page de formulaire Définition de schéma.

Section Description

Zones de la section Description

Editez la zone de texte description pour fournir une brève description du noeud élément, attribut ou composeur sélectionné dans la section Eléments du point d'extension. Des mark-ups HTML valides peuvent être utilisés dans cette zone, selon les besoins.

Remarque : La mise à jour d'une description de référence d'élément met également à jour la description de la déclaration d'élément global à laquelle elle fait référence et inversement.

Section Détails de l'élément

Cette section vous permet d'éditer les propriétés d'un élément. Deux types d'éléments existent : élément d'extension et élément de non-extension. Un élément d'extension est la déclaration d'élément principal spécial utilisée afin de définir le point d'entrée dans la grammaire du schéma édité. Un élément de non-extension est une déclaration d'élément global utilisée comme bloc de construction structurelle de base dans la grammaire du schéma édité.

Cette section est activée par la sélection d'un noeud élément d'extension ou noeud élément de non-extension dans la section Eléments du point d'extension.

La section Détails de l'élément pour un élément d'extension.

Détails d'élément - Section 1

La section Détails d'élément pour un élément de non-extension.

Eléments de point d'extension - Section 2

Zones de la section Détails de l'élément

Editez la zone Nom afin de spécifier le nom de l'élément.

Cliquez sur le bouton true ou false de la zone Interne pour indiquer si l'élément est interne ou non. L'éditeur de manifeste de plug-in marquera tout mark-up XML d'extension interne, avec un avertissement (par défaut). Cette zone est analogue à l'attribut x-internal sur les packages exportés.

Cliquez sur le bouton true ou sur le bouton false dans la zone Obsolète pour indiquer si l'élément est obsolète ou non. L'Editeur de manifeste de plug-in marquera tout mark-up XML d'extension qui est obsolète, avec un avertissement (par défaut). Cette zone est analogue à la balise Javadoc @deprecated de Java.

Si un élément d'extension est marqué comme obsolète, éditez la zone Remplacement afin de spécifier le point d'extension non obsolète que l'utilisateur doit utiliser à sa place pour obtenir la même fonctionnalité.

Sélectionnez l'un des attributs définis de l'élément dans la zone Propriété de libellé pour spécifier la valeur d'attribut à utiliser en tant qu'intitulé de l'élément dans l'Editeur de manifeste de plug-in. Par exemple, si une valeur est sélectionné, l'intitulé du noeud de l'élément dans la section Toutes les extensions de la page Extensions dans l'Editeur de manifeste de plug-in sera comme suit : valeur-attribut-sélectionné (nom-élément). Sinon, si aucune valeur n'est sélectionnée, l'intitulé du noeud de l'élément sera comme suit : (nom-élément).

Sélectionnez l'un des attributs de type de ressources définis dans la zone Icône pour spécifier la ressource d'icône à utiliser afin de représenter le noeud de l'élément dans l'Editeur de manifeste de plug-in. Afin que l'icône du noeud de l'élément s'affiche correctement dans la section Toutes les extensions de la page Extensions dans l'Editeur de manifeste de plug-in, les conditions suivantes doivent être satisfaites :

Cliquez sur le bouton true ou sur le bouton false dans la zone traduisible pour indiquer si l'élément est traduisible ou non. Cette zone ne s'applique que pour les éléments qui n'ont pas d'enfants (contenu élémentaire) ou d'attributs spécifiés et qui autorisent la spécification du texte dans ses balises XML de début et de fin (contenu de caractère). Si le contenu de caractère d'un élément est marqué comme traduisible, alors, les outils PDE peuvent être utilisés sur le marqueur XML d'extension apporté afin d'externaliser le contenu dans un fichier de propriétés pour support multi-langage.

Utilisez la zone Approximation DTD en lecture seule pour afficher une estimation de mappage un à un de la grammaire du schéma d'élément avec la grammaire DTD d'élément équivalente. Pour la spécification d'une grammaire formelle d'un document XML, une DTD (Définition de type de document) représente une alternative au schéma XML, plus facile à lire et moins puissante. Pour spécifier une approximation de définition de type de document, la notation suivante est utilisée :

Section Détails du composeur

Cette section vous permet d'éditer les propriétés d'un composeur. Deux types de composeurs existent : le composeur de séquence et le composeur de choix. Un composeur de séquence vous permet de spécifier que les enfants d'un élément se composent d'une séquence d'autres éléments dans la grammaire du schéma édité. Un composeur de choix vous permet de spécifier que les enfants d'un élément se composent d'un choix d'autres éléments dans la grammaire du schéma édité.

Cette section est activée en sélectionnant un noeud Séquence ou Choix dans la section Eléments du point d'extension.

Section détails du composeur

Zones de la section Détails du composeur

Editez la zone Occurrences minimales afin de spécifier le nombre minimal d'occurrences que ce composeur d'autres éléments et/ou composeurs est autorisé à afficher dans le marqueur XML d'extension fourni. La valeur de cette zone est utilisée par PDE afin de valider les contraintes de multiplicité dans l'Editeur de manifeste de plug-in. Si l'Elément A exige exactement un Elément B ou Elément C comme son enfant, et qu'il utilise un composeur de Choix en spécifiant deux occurrences minimum, alors deux instances de l'Elément B en combinaison avec l'Elément C doivent être définies dans le marqueur XML d'extension pour pouvoir être valides.

Editez la zone Occurrences maximales afin de spécifier le nombre maximal d'occurrences que ce composeur d'autres éléments et/ou composeurs est autorisé à afficher dans le marqueur XML d'extension fourni. La valeur de cette zone est utilisée par PDE afin de valider les contraintes de multiplicité dans l'Editeur de manifeste de plug-in. Si l'Elément A exige exactement un Elément B ou Elément C comme son enfant, et qu'il utilise un composeur de Choix en spécifiant deux occurrences maximum, alors un maximum de deux instances de l'Elément B en combinaison avec l'Elément C peut être défini dans le marqueur XML d'extension pour pouvoir rester valide.

Cochez la zone Délié pour spécifier qu'il n'y a pas de contrainte sur le nombre maximal d'occurrences autorisées que ce composeur peut afficher dans le marqueur XML d'extension apporté.

Sélectionnez une valeur dans la zone Type afin de spécifier si ce composeur est une séquence ou un choix.

Utilisez la zone Approximation DTD en lecture seule pour afficher une estimation de mappage un à un de la grammaire du schéma du composeur avec la grammaire DTD d'élément équivalente. La notation utilisée pour spécifier l'approximation de définition de type de document est décrite dans la rubrique Zones de la section Détails d'élément dans ce document.

Section Détails de référence d'élément

Cette section vous permet d'éditer les propriétés d'une référence d'élément. Une référence d'élément est une référence à une déclaration d'élément global dans la grammaire du schéma édité. Les références d'éléments sont utilisées par les composeurs en tant que blocs de construction atomiques pour les déclarations d'élément global.

Cette section est activée par la sélection d'un noeud référence d'élément dans la section Eléments du point d'extension.

Section Détails de référence d'élément

Zones de la section Détails de référence d'élément

Editez la zone Occurrences minimales afin de spécifier le nombre minimal d'occurrences que cet élément est autorisé à afficher dans le marqueur XML d'extension fourni. La valeur de cette zone est utilisée par PDE afin de valider les contraintes de multiplicité dans l'Editeur de manifeste de plug-in. Si l'Elément A spécifie deux occurrences minimum, alors 2 instances de l'Elément A doivent être définies dans le marqueur XML d'extension apporté afin d'être valides.

Editez la zone Occurrences maximales afin de spécifier le nombre maximal d'occurrences que cet élément est autorisé à afficher dans le marqueur XML d'extension fourni. La valeur de cette zone est utilisée par PDE afin de valider les contraintes de multiplicité dans l'Editeur de manifeste de plug-in. Si l'Elément A spécifie deux occurrences maximum, alors un maximum de 2 instances de l'Elément A doit être défini dans le marqueur XML d'extension apporté afin d'être valide.

Cochez la zone Délié pour spécifier qu'il n'y a pas de contrainte sur le nombre maximal d'occurrences autorisées que cet élément peut afficher dans le marqueur XML d'extension apporté.

Utilisez la zone Approximation DTD en lecture seule pour afficher une estimation de mappage un à un de la grammaire du schéma d'élément avec la grammaire DTD d'élément équivalente. La notation utilisée pour spécifier l'approximation de définition de type de document est décrite dans la rubrique Zones de la section Détails d'élément dans ce document.

Section Détails de référence d'élément

Cliquez sur l'hyperlien nom-élément dans la zone Référence pour éditer les propriétés de la déclaration d'élément global auquel cet élément local fait référence. Une fois cette action terminée, le noeud élément référencé est sélectionné dans la section Eléments du point d'extension et la section Détails de l'élément correspondante est activée.

Section Détails de l'attribut

Cette section vous permet d'éditer les propriétés d'un attribut. Les attributs sont utilisés pour fournir des informations supplémentaires sur les éléments.

Cette section est activée par la sélection d'un noeud attribut obligatoire, attribut facultatif, attribut classe ou attribut ressource dans la section Eléments du point d'extension.

La section Détails d'attribut pour un attribut obligatoire du type chaîne qui spécifie une restriction d'énumération.

Détails d'attribut - Section 1

La section Détails d'attribut pour un attribut facultatif du type booléen qui spécifie une valeur par défaut.

Détails d'attribut - Section 2

La section Détails d'attribut pour un attribut classe qui indique que la classe représentée par la valeur de l'attribut peut étendre la classe spécifiée et/ou implémenter l'interface spécifiée.

Détails d'attribut - Section 3

La section Détails d'attribut pour un attribut de ressource.

Détails d'attribut - Section 4

Utilisation de l'attribut d'identificateur de schéma

Les auteurs de points d'extension peuvent définir des attributs qui font référence à d'autres attributs. Pour ce faire, définissez vos attributs de point d'extension comme identificateur de type et choisissez l'attribut référencé. Exemple : le point d'extension org.eclipse.ui.handlers. L'attribut commandId référence des commandes définies dans le point d'extension org.eclipse.ui.commands.

Utilisation de l'identificateur de schéma

Les développeurs d'extensions ajoutant un gestionnaire peuvent ensuite effectuer une sélection parmi tous les identificateurs valides pour l'attribut commandId. Des avertissements sont émis pour les identificateurs qui n'existent pas, afin d'empêcher la saisie courante d'un identificateur mal orthographié.

Zones de la section Détails d'attribut

Editez la zone Nom pour spécifier le nom de l'attribut.

Cliquez sur le bouton true ou sur le bouton false dans la zone Obsolète pour indiquer si l'attribut est obsolète ou non. L'Editeur de manifeste de plug-in marquera tout mark-up XML d'extension qui est obsolète, avec un avertissement (par défaut). Cette zone est analogue à la balise Javadoc @deprecated de Java.

Sélectionnez une valeur dans la zone Utiliser pour indiquer si l'attribut doit être spécifié sur son élément de définition dans le marqueur XML d'extension apporté. Les sélections suivantes sont disponibles :

Editez la zone Valeur par défaut pour spécifier la valeur par défaut à utiliser pour un attribut lorsqu'il n'est pas spécifié dans son élément de définition dans le marqueur XML d'extension apporté. Cette zone n'est applicable que lorsque la valeur par défaut de la zone Utiliser est sélectionnée.

Sélectionnez une valeur dans la zone Type pour spécifier le type de valeur d'attribut. Les sélections suivantes sont disponibles :

Cliquez sur le bouton true ou sur le bouton false dans la zone traduisible pour indiquer si la valeur de l'attribut est traduisible ou non. Cette zone n'est applicable que lorsque la valeur chaîne de la zone Type est sélectionnée. Si une valeur d'attribut est marquée comme traduisible, alors, les outils PDE peuvent être utilisés sur le marqueur XML d'extension apporté afin d'externaliser ces valeurs dans un fichier de propriétés pour support multi-langage.

Utilisez la zone Restrictions pour afficher une liste des valeurs de chaîne que l'attribut ne peut utiliser que comme sa propre valeur. Si la zone ne contient pas de valeurs, alors c'est qu'il n'y a aucune restriction sur la valeur de l'attribut. Cette zone n'est applicable que lorsque la valeur chaîne de la zone Type est sélectionnée. Remarque : Une restriction d'énumération sur le type de base de la chaîne est utilisée dans la grammaire du schéma édité afin d'accomplir cette fonctionnalité.

Editez la zone Etendre afin de spécifier un nom de classe complet dans le chemin d'accès de la plateforme cible (par exemple org.eclipse.ui.part.EditorPart) qui doit être sous-classé par la classe spécifiée comme valeur de l'attribut. PDE validera la valeur d'attribut de classe dans le marqueur XML d'extension apporté afin de s'assurer qu'il étend la superclasse. Cette zone est uniquement applicable lorsque la valeur java de la zone Type est sélectionnée.

Editez la zone Implémenter pour spécifier un nom d'interface complet sur le chemin d'accès de la plateforme cible (par exemple org.eclipse.ui.IEditorPart) qui doit être implémenté par la classe spécifiée comme valeur d'attribut. PDE validera la valeur d'attribut de classe dans le marqueur XML d'extension apporté afin de s'assurer qu'il implémente l'interface. Cette zone est uniquement applicable lorsque la valeur java de la zone Type est sélectionnée.

Actions de la section Détails d'attribut

Cliquez sur le bouton Ajouter... dans la zone Restrictions pour ouvrir la boîte de dialogue Nouvelle restriction afin d'ajouter une nouvelle restriction à la valeur d'attribut. Lorsque vous avez renseigné les zones de la boîte de dialogue, la nouvelle restriction est ajoutée à la liste des valeurs de chaîne que l'attribut ne peut utiliser que comme sa propre valeur. Cette action n'est disponible que lorsque la valeur chaîne de la zone Type est sélectionnée.

Sélectionnez une chaîne de valeur dans la zone Restrictions et cliquez sur le bouton Supprimer pour supprimer une restriction de la liste des valeurs de chaîne que l'attribut ne peut utiliser que comme sa propre valeur. Cette action n'est disponible que lorsque la valeur chaîne de la zone Type est sélectionnée.

Si la valeur spécifiée dans la zone Etendre fait référence à un nom complet sur le chemin d'accès de la plateforme cible, alors, le fait de cliquer sur l'hyperlien Etendre ouvrira cette classe dans un nouvel éditeur de source Java. Sinon, le fait de cliquer sur l'hyperlien Etendre ouvrira l'assistant Nouvelle classe Java vous permettant de créer la nouvelle classe. Cette action n'est disponible que lorsque la valeur java de la zone Type est sélectionnée.

Si la valeur spécifiée dans la zone Implémenter fait référence à un nom d'interface complet sur le chemin d'accès de la plateforme cible, alors, le fait de cliquer sur l'hyperlien Implémenter ouvrira cette interface dans un nouvel éditeur de source Java. Sinon, le fait de cliquer sur l'hyperlien Implémenter ouvrira l'assistant Nouvelle classe Java vous permettant de créer la nouvelle interface. Cette action n'est disponible que lorsque la valeur java de la zone Type est sélectionnée.

Cliquez sur le bouton Parcourir... pour ouvrir la boîte de dialogue Sélectionner un type afin de sélectionner une classe existant sur le chemin d'accès de la plateforme cible qui sera utilisée comme valeur pour la zone Etendre. Cette action n'est disponible que lorsque la valeur java de la zone Type est sélectionnée.

Cliquez sur le bouton Parcourir... pour ouvrir la boîte de dialogue Sélectionner un type afin de sélectionner une interface existant sur le chemin d'accès de la plateforme cible qui sera utilisée comme valeur pour la zone Implémenter. Cette action n'est disponible que lorsque la valeur java de la zone Type est sélectionnée.

Liens correspondants