Pré. | Proc. |
Utilisation des éléments du système d'aide
Cette rubrique explique comment configurer chaque type d'élément d'aide afin qu'il soit généré en tant que composant fonctionnel et utile de la page d'aide.
Il est supposé que vous avez lu la rubrique d'aide Création de système d'aide et que vous savez quels éléments sont disponibles et comment ils s'intègrent dans la structure de la page d'aide.
Configurer la page d'aide
Il existe deux manières rapides de configurer une structure pour une nouvelle rubrique d'aide.
Modèle Motifs
Ouvrez l' Assistant de Modèle ( Page Démarrage , onglet 'Créer à partir de Motif '), cliquez sur l'icône et sélectionnez le Profil d'aide.
Révision les modèles répertoriés dans le panneau de gauche, sélectionnez celui qui convient le mieux à votre page d'aide, puis cliquez sur le bouton Modèle un ou plusieurs modèles.
Faites glisser depuis la page du système d'aide de la boîte à outils Diagramme vers la fenêtre Navigateur
- Sélectionnez le Paquetage /Help Paquetage pour contenir cette rubrique.
- Faites glisser l'icône HelpPackage de la Boîte à outils sur le Paquetage sélectionné dans le Navigateur et, dans la boîte de dialogue 'Nouveau Paquetage ', donnez un nom au nouveau HelpPackage .
- Faites glisser l'icône HelpTopic ou HelpTopicProxy de la Toolbox vers le nouveau HelpPackage dans le Navigateur .
- Faites glisser l' HelpSection , HelpTopic ou autre élément d'aide appropriée de la boîte à outils vers la rubrique d'aide dans le Navigateur . Répétez cette opération aussi souvent que nécessaire.
- Si vous avez ajouté des HelpTables, faites glisser l'icône HelpTableRow de la Boîte à outils vers la HelpTable appropriée dans le Navigateur .
- Enfin, si nécessaire, faites glisser l'icône HelpSectionLearnMore de la Boîte à outils vers la fenêtre du Navigateur et positionnez-la à la fin de l'ensemble d'éléments.
Alors que vous pouvez utiliser la fenêtre Notes seule pour commencer, il est de loin préférable de l'utiliser en conjonction avec le Gestionnaire de Spécification , qui vous permet de voir la structure et le contenu de la page d'aide au fur et à mesure que vous la créez.
Le Gestionnaire de Spécification est également le meilleur outil pour ajouter d'autres éléments d'aide au sujet au fur et à mesure de son développement, en faisant glisser l'icône appropriée de la page du système d'aide de la boîte à outils sur l'élément précédent ou parent dans le Gestionnaire de Spécification . Vous êtes invité à sélectionner si le nouvel élément vient après l'élément existant en tant qu'homologue ou sous l'élément existant en tant qu'enfant.
Création d'éléments d'aide
Chaque élément Help est un élément Class modifié par un stéréotype. S'il vous arrive de faire glisser le mauvais élément d'aide dans une structure d'aide, ou si vous changez d'avis sur la façon de présenter vos informations, vous pouvez modifier le stéréotype de l'élément existant pour en faire le type d'élément correct. Pour faire ça:
- Cliquez sur l'élément puis allez dans la fenêtre Propriétés de l'élément.
- Dans le champ 'Stéréotype', cliquez sur l'icône de et, dans la boîte de dialogue 'Stéréotype pour le nom de l'élément ', faites défiler la liste vers le haut ou vers le bas pour localiser le stéréotype requis et cochez la case correspondante.
- Cliquez sur le bouton OK .
- Cliquez à nouveau sur l'icône de dans le champ "Stéréotype" et décochez la case correspondant au stéréotype incorrect.
- Cliquez sur le bouton OK .
N'oubliez pas que Valeur Étiquetés alloué aux stéréotypes par profils sont répertoriées dans l'onglet 'Élément' de la fenêtre Propriétés , et non dans l'onglet 'Tags' .
HelpPackage |
Chaque rubrique du système d'aide est représentée par un HelpPackage contenant un élément enfant HelpTopic du même nom. Les HelpPackages sont organisés dans une hiérarchie de Paquetages parent et enfant pour développer la structure des pages d'aide dans le système d'aide. Cette hiérarchie paquetage est ensuite reflétée dans les pages Web générées, via un contrôle de fil d'Ariane en haut de la page et un menu comme une liste de liens vers des sujets enfants sur la gauche de la page. Note que les paquets de niveau paquetages dans une hiérarchie d'aide (en fait les nœuds 'Chapitre'; par exemple, dans la propre aide d' Enterprise Architect , ' Modélisation Languages') doivent avoir le drapeau d'ingénierie de code ' Namespace Root' défini. Lors de la génération de l'aide Web, Enterprise Architect crée des sous-dossiers dans le dossier de sortie spécifié, en utilisant les noms des paquetages Namespace Root comme noms de dossier. Chaque fichier de rubrique généré est placé dans le sous-dossier créé à partir de son paquetage parent le plus proche marqué comme racine d'espace de Namespace . Au minimum, un seul paquetage de niveau paquetage doit être marqué comme racine d'espace de Namespace . La racine de l'espace de Namespace peut être définie en cliquant sur un Paquetage puis en sélectionnant l'option de ruban "Développer > Code source > Options > Définir le Paquetage comme racine de l'espace de Namespace ". Le HelpPackage n'est pas directement généré en tant qu'aide, mais agit plutôt comme conteneur pour le HelpTopic et ses propres éléments enfants. Il est important que les éléments Help Paquetage et Help Topic partagent le même nom. |
HelpTopic |
Un élément HelpTopic correspond à une page HTML. Il est important que la propriété HelpTopic 'Alias' soit définie sur le nom de fichier requis pour la rubrique d'aide dans la sortie finale générée. L'alias doit avoir un nom unique dans tout le système d'aide et ne doit pas inclure l'extension. Par exemple, 'requirements_management' (sans les guillemets) est un alias valide et fournira le nom de fichier 'requirements_management.html' lors de sa génération. L'élément HelpTopic contient généralement un texte d'introduction (dans le champ de l'élément ' Notes ') pour expliquer le but du sujet et comment il s'intègre dans toute structure de sujet dont il fait partie. Il ne peut y avoir qu'un seul élément HelpTopic dans un Paquetage . Le HelpTopic peut être le parent de la plupart des autres éléments d'aide, à l'exception de HelpTopicProxy , HelpTableRow et HelpTableRowProxy . |
HelpTopicProxy |
Un élément HelpTopicProxy capture le contenu d'un élément HelpTopic existant et de ses éléments enfants, et les duplique sous un autre HelpPackage . Vous insérez donc l'élément HelpTopicProxy en tant qu'enfant de HelpPackage . Vous donnez à HelpTopicProxy son propre nom de rubrique et son alias approprié. Dans la fenêtre Propriétés de l'élément, pour le 'refTopic' Valeur Étiquetée , vous cliquez sur l'icône de et recherchez et sélectionnez le HelpTopic à dupliquer. Vous n'avez rien d'autre à faire dans les éléments HelpTopicProxy ou HelpPackage . |
HelpSection |
Un élément HelpSection correspond à un ou plusieurs paragraphes connexes au sein d'une page, traitant d'un sujet particulier. Le nom de HelpSection apparaîtra comme titre et les notes d'élément comme contenu. Une HelpSection ne peut être qu'un enfant d'un HelpTopic et ne peut contenir aucun autre élément. Si vous avez plus d'un élément HelpSection sous une rubrique, ils apparaîtront dans la page générée dans l'ordre dans lequel ils apparaissent dans la fenêtre Navigateur et Gestionnaire de Spécification . Vous pouvez intégrer des liens vers des diagrammes et des captures d'écran dans le contenu de la section d' HelpSection , et ceux-ci seront reproduits dans le contenu Web ou PDF selon les besoins. Un élément HelpSection avec le nom « Notes » est généralement placé en avant-dernier dans le HelpTopic (avant la section « En savoir plus », le cas échéant), contenant une liste à puces de points supplémentaires sur le sujet du sujet, comme quel Des autorisations Enterprise Architect ou de SGBD peuvent être requises pour effectuer une tâche. |
HelpSectionProxy |
Semblable à HelpTopicProxy , un HelpSectionProxy duplique le contenu d'un HelpSection existant. Vous insérez HelpSectionProxy en tant qu'enfant de l'élément HelpTopic , à la position appropriée dans la séquence des éléments homologues HelpSection , HelpSectionProxy , HelpTable et HelpTableProxy sous HelpTopic . Le HelpSectionProxy a son propre nom d'élément. Dans la fenêtre Propriétés de l'élément, pour la 'refSection' Valeur Étiquetée , vous cliquez sur l'icône de et recherchez et sélectionnez la HelpSection à dupliquer. |
HelpSectionDiagram |
Un élément HelpSectionDiagram est utilisé comme espace réservé/conteneur pour un diagramme qui apparaîtra dans l'aide sous forme d'image. Le diagramme doit être construit sous l'élément HelpSectionDiagram ; tous les éléments ou constructions qui apparaissent dans le diagramme n'apparaîtront pas dans les documents HTML, Web ou PDF eux-mêmes. Cela permet la création de diagrammes explicatifs sans avoir à insérer chaque élément représenté dans le document d'aide lui-même. Les éléments du diagramme seront cependant listés dans la fenêtre Navigateur et le Gestionnaire de Spécification . Vous pouvez inclure du texte dans cet élément. Comme le diagramme est essentiellement subordonné à l'élément HelpSectionDiagram , le texte appartenant à l'élément s'affichera au-dessus du diagramme . Outre le fait de fournir un nom pour l'élément HelpSectionDiagram , vous n'avez pas besoin de définir de propriétés. Cet élément est généralement utilisé pour les diagrammes autonomes qui illustrent des fonctionnalités ou des concepts généraux. Si un diagramme ou une image est un exemple d'un point expliqué dans un HelpTopic , HelpSection ou HelpTableRow , vous disposez de mécanismes d'hyperlien dans le texte pour créer un lien vers ce diagramme ou cette image conservé ailleurs dans le modèle ou dans le gestionnaire d'images. |
HelpSystemVideo |
Un élément HelpSystemVideo est un conteneur pour un contrôle vidéo, qui lira une vidéo dans le navigateur Web dans lequel l'aide est affichée. Cela permet d'inclure de courtes vidéos "Comment faire" à partir de votre site Web, qui peuvent être lancées à partir de l'aide en ligne. Après avoir donné un nom à l'élément, vous mettez en place cette facilité en complétant cet ensemble de Valeur Étiquetés .
|
HelpSlideshow |
Semblable à l'élément HelpSystemVideo , l'élément HelpSlideshow permet à l'utilisateur de exécuter un diaporama d'écrans statiques décrivant les étapes d'un processus, ou des exemples de sortie, ou d'autres images illustrant le sujet de la rubrique d'aide. Encore une fois, vous fournissez un nom pour l'élément, et complétez ces Valeur Étiquetés :
|
HelpTable |
Les éléments HelpTable sont disponibles dans une variété de formats, selon le stéréotype attribué. Les noms de colonne sont appliqués à l'aide de Valeur Étiquetés dans la fenêtre Propriétés . Dans les tableaux à trois colonnes, la troisième colonne contient des hyperliens vers d'autres rubriques d'aide (définies dans les éléments HelpTableRow ), et son en-tête par défaut est "Voir aussi" dans le générateur d'aide. Note que les colonnes "Voir aussi" ne sont pas reproduites dans la sortie PDF générée à partir de la source d'aide. Un élément HelpTable ne peut être qu'un enfant d'un élément HelpTopic et ne peut contenir que des éléments enfants HelpTableRow ou HelpTableRowProxy . Une liste complète des formats de tableau et de leurs stéréotypes est fournie dans la rubrique Help System Tableaux . |
HelpTableProxy |
Un HelpTableProxy duplique le contenu et la définition d'un HelpTable existant dans une rubrique d'aide différente, de n'importe quel style et format. Cela inclut tous les éléments HelpTableRow et HelpTableRowProxy que la HelpTable existante peut avoir. L'élément HelpTableProxy ne peut être que l'enfant d'un HelpTopic et ne peut pas lui-même avoir d'éléments enfants. Après avoir donné un nom à l'élément, dans la fenêtre Propriétés de l'élément, sélectionnez la 'refTable' Valeur Étiquetée , cliquez sur l'icône de et localisez et sélectionnez la HelpTable que vous souhaitez dupliquer dans la rubrique actuelle. |
HelpTableRow |
Un élément Help Tableau Row représente une seule ligne dans un tableau . Généralement, le nom de l'élément devient le titre de la ligne et le champ Notes devient la description de la ligne. Cependant, l'élément possède différentes Valeur Étiquetés définies dans la fenêtre Propriétés qui prennent en support différents types d'en-tête de ligne et de contenu de colonne. Ceux-ci sont:
|
HelpTableRowProxy |
Un élément HelpTableRowProxy duplique le contenu d'un élément HelpTableRow existant ailleurs dans le modèle. Il n'a pas de contenu propre. Comme pour les autres éléments Proxy, après avoir donné un nom à l'élément, dans la fenêtre Propriétés de l'élément sélectionnez le 'refTableRow' Valeur Étiquetée , cliquez sur l'icône de et localisez et sélectionnez le HelpTableRow que vous souhaitez dupliquer dans le tableau actuel . |
HelpSectionLearnMore |
L'élément HelpSectionLearnMore est utilisé pour fournir une liste d'hyperliens vers des rubriques connexes qui n'ont pas été liées ailleurs dans la rubrique, ni dans la hiérarchie de l'aide affichée à côté de la rubrique d'aide générée. Il est généralement placé en dernier dans le HelpTopic afin de ne pas détourner l'attention du contenu présenté dans le corps du HelpTopic ; cependant, s'il y a beaucoup de contenu, comme de longs tableaux de paramètres, d'attributs ou de méthodes, la section En savoir plus peut être insérée au-dessus de ce matériel, plus près du début de la page d'aide. Dans l'aide Enterprise Architect , la section consiste généralement en une simple liste à puces d'hyperliens vers d'autres rubriques d'aide ou vers des sites Web pertinents. Cependant, vous pouvez ajouter un texte explicatif si nécessaire, ou omettre la section s'il n'y a pas de points de référence autres que ceux déjà liés dans le reste du sujet. Le générateur PDF ignore cet élément, de sorte que la liste des liens ne s'affiche pas dans un document PDF. |
HelpPackage Valeur Étiquetés pour la génération de PDF
Dans la fenêtre Propriétés d'un HelpPackage vous verrez la liste de propriétés suivante :
- ReportAlias
- Auteur du rapport
- ReportCoverImage
- ReportKeywords
- Producteur de rapport
- État du rapport
- ReportSubject
- Résumé du rapport
- Titre du rapport
- Version du rapport
Ces propriétés, ainsi que certaines propriétés d'élément standard, sont collectivement appelées constantes de Rapport . Les constantes Rapport (lorsqu'elles sont présentes) sont utilisées lors de la génération de documents PDF à partir de votre modèle d'aide.
Parmi les propriétés répertoriées ci-dessus, ReportAuthor, ReportCoverImage, ReportKeywords, ReportStatus, ReportSummary, ReportTitle et ReportVersion sont disponibles pour être inclus dans vos documents générés. Ces propriétés, ainsi que plusieurs propriétés d'éléments standard, peuvent être insérées sous forme de champs dans gabarits de votre document. Elles apparaissent sous le menu ' Rapport Constants' lorsque vous cliquez-droit dans l'éditeur gabarit . En règle générale, ils seraient utilisés dans un gabarit CoverPage , ou dans les sections d'en-tête et de pied de page du gabarit principal du document.
Certaines de ces propriétés ont des noms similaires aux propriétés d'élément standard. Ce sont : Nom, Alias, Mots clés, Statut et Version. Si les valeurs de l'une de ces propriétés de stéréotype sont vides, les champs de document utiliseront à leur place les valeurs de propriété d'élément standard correspondantes.
Une deuxième liste de propriétés, légèrement plus petite : ReportAuthor, ReportKeywords, ReportProducer, ReportSubject, ReportTitle, est utilisée pour écrire les métadonnées du fichier PDF généré.
Les valeurs balisées du « paquetage racine » sélectionné pour la génération de PDF seront utilisées pour l'ensemble du document. Si le paquetage sélectionné comprend également une série de paquetages enfants , les valeurs balisées des paquetages enfants ne sont pas utilisées lors du rendu de ces rubriques.