Configuration d’importation de mots dans Modern Requirements4DevOps
Le but de cet article est de fournir des règles standard de configuration de la cartographie des éléments de travail prises en charge dans la dernière version de Modern Requirements4DevOps. En fournissant la configuration de mappage dans un fichier de règles, un utilisateur peut importer un document Microsoft Word dans Smart Docs sous forme d’éléments de travail Azure DevOps. Un fichier de jeu de règles peut être créé manuellement (XML) ou à partir de l’interface utilisateur en utilisant Rules Set Designer.
TABLE DES MATIÈRES
- Points clés :
- Concepteur de règles (UI)
- Fichier XML (Manuel)
- Interface utilisateur du concepteur de règles
- Configuration de la cartographie de l’élément de travail [Pris en charge par les deux; XML (manuel) et Concepteur de règles (UI)
- Configuration de la cartographie des items de travail pour les « titres » dans Microsoft Word
- Configuration de la correspondance des éléments de travail pour les « tables » dans Microsoft Word
- Configuration de la cartographie des objets de travail [Pris en charge uniquement par XML (manuel)]
- Annexe
Points clés : Concepteur de règles (UI)
- Les utilisateurs devraient parcourir le document Word qu’ils prévoient importer et s’assurer qu’ils savent quel contenu doit être géré comme éléments de travail ou champs dans Smart Docs après l’importation.
- Les utilisateurs ont la possibilité d’importer des documents Word en utilisant nos fichiers de règles créés par le concepteur de règles, accessibles via la fenêtre de l’assistant d’importation de mots >onglet Importation de règles > le fichier de règles (menu déroulant)
- Le contenu suivant du document Word est pris en charge par UI :
- Style de tête (H1 – H9)
- Tableau (rangée, cellule)
Points clés : Pour le fichier XML (manuel)
- Les utilisateurs devraient parcourir le document Word qu’ils prévoient importer et s’assurer qu’ils savent quel contenu doit être géré comme éléments de travail ou champs dans Smart Docs après l’importation.
- Les utilisateurs ont la possibilité d’importer des documents Word en utilisant nos fichiers de configuration par défaut, accessibles via la fenêtre de l’assistant d’importation de mots >onglet Importation des règles > fichier des règles (menu déroulant)
- Si les utilisateurs veulent définir leur propre configuration personnalisée, ils doivent créer un fichier de règles utilisant l’extension « .wirule » et le placer à l’emplacement :
dev.azure.com version :
i.%public%\Documents\inteGREAT4TFS\Mon ensemble de règles\Smart Docs\dev.azure.com\{Compte}
visualstudio.com version :
i.%public%\Documents\inteGREAT4TFS\Mon ensemble de règles\Smart Docs\{Compte}.visualstudio.com
Version intégrée :
ii.%public%\Documents\inteGREAT4TFS\Mon ensemble de règles\Smart Docs\{Nom du serveur}
iii.%public%\Documents \inteGREAT4TFS\Mon Ensemble de règles\Smart Docs\{Nom du serveur}\{Nom de la collection}
4. Après avoir placé le(s) fichier(s) du ou des fichiers du jeu de règles personnalisés à l’un des emplacements mentionnés ci-dessus, ces fichiers seront accessibles depuis la fenêtre de l’assistant d’importation de mots > l’onglet Importation des règles > le fichier déroulant des règles > Smart Docs (nœud)
5. Le contenu suivant du document Word est pris en charge dans le fichier XML (manuel) :
- un. Style de tête (H1 – H9)
- b. Paragraphe
- c. Table (rangée, cellule)
6. Pour fournir une cartographie, les utilisateurs doivent utiliser le « nom du champ » de l’élément ou champ de travail tel que défini dans le modèle de processus TFS.
7. Pour le mappage, les balises/attributs généraux suivants doivent être utilisés dans un ensemble de règles :
- a. witype (s’il correspond à un type d’élément de travail)
- b. propriété (Si elle correspond à un champ d’un élément de travail).
- i. « propriété » peut aussi être utilisé comme étiquette pour définir plus d’une propriété d’un élément de travail.
Notez qu’il est nécessaire de spécifier la « valeur » du champ, il ne peut être défini qu’en type « string » ou « html ».
Notez que si « propertytype » n’est pas défini pour un champ, alors le système doit le considérer par défaut comme un champ de type « String ».
Interface utilisateur du concepteur de règles
Consultez ce document pour plus de détails concernant l’accessibilité de l’interface utilisateur de Ruleset Designer.
Message de notification lors de l’ouverture d’un fichier de règles existant
Si vous voyez le message suivant concernant la sélection et l’ouverture d’un fichier de règles existant, cela signifie que le contenu placé dans le fichier de règles n’est pas encore pris en charge par l’interface utilisateur du Concepteur de Règles.
Configuration de la cartographie des éléments de travail (prise en charge à la fois par XML (manuel) et Rules Set Designer (UI))
Configuration de la cartographie des éléments de travail pour les « titres » dans Microsoft Word
- En tant qu’utilisateur, lors de l’importation du document Word, je veux associer chaque style d’en-tête à un type d’élément de travail différent. Et le nom de l’en-tête devrait correspondre au champ « Titre » et le contenu/paragraphe écrit sous le titre devrait correspondre à n’importe quel champ HTML d’un élément d’œuvre.
- Vous devez sélectionner chaque nœud d’en-tête individuellement (c.-à-d. Heading1, Heading2, etc.) pour correspondre à un type différent d’élément de travail. (Voir ci-dessous des captures d’écran d’un document Word, du fichier XML (manuel) et du concepteur de règles (UI))
Exemple de document Word
Exemple de configuration cartographique par Ruleset Designer
Exemple de configuration cartographique dans un fichier XML
2. En tant qu’utilisateur, lors de l’importation du document Word, je veux associer chaque style d’en-tête au même type d’élément de travail, par exemple « Exigence ».
- Vous devez utiliser la balise « Titres » pour associer le même type d’élément de travail à tous les titres définis dans le document. (comme montré dans les captures d’écran ci-dessous d’un document d’exemple, du fichier XML du système de règles manuel et du fichier du concepteur)
Exemple de document Word
Exemple de configuration cartographique par Ruleset Designer
Exemple de configuration cartographique dans un fichier XML
Une fois que vous avez défini la balise « Titres », après ce titre individuel (H1-H9) ne peut plus être défini, donc dans le menu déroulant de la sous-addition, seule la valeur « Ajouter la table » sera affichée.
3. En tant qu’utilisateur, lors de l’importation du document Word, je veux mapper tout le contenu placé sous le titre correspondant, par exemple paragraphes, images, éléments listés, etc., dans le champ HTML de l’élément de travail.
Exemple de document Word
Exemple de configuration cartographique par Ruleset Designer
Exemple de configuration cartographique dans un fichier XML
4. En tant qu’utilisateur, lors de l’importation du document Word, je veux mapper la table placée sous l’en-tête correspondant dans le champ HTML de l’élément de travail.
Exemple de document Word
Exemple de configuration cartographique par Ruleset Designer
Exemple de configuration cartographique dans un fichier XML
4. En tant qu’utilisateur, lors de l’importation du document Word, je veux associer un même titre à deux types de tâches différents ou plus.
- Vous devez définir la condition pour différencier deux titres identiques (comme montré dans les captures d’écran ci-dessous du document d’exemple, du fichier XML du jeu de règles manuel et du fichier du concepteur)
Exemple de document Word
Exemple de configuration cartographique par Ruleset Designer
Exemple de configuration cartographique dans un fichier XML
Configuration de la correspondance des éléments de travail pour les « tables » dans Microsoft Word
1. En tant qu’utilisateur, lors de l’importation du document Word, je veux associer toute la table à un seul élément de travail qui comporte des champs sous forme de cellule fusionnée.
Exemple de document Word
Exemple de configuration cartographique par Ruleset Designer
Exemple de configuration cartographique dans un fichier XML
2. En tant qu’utilisateur, lors de l’importation du document Word, je veux associer chaque ligne d’une table au même type d’élément de travail et chaque colonne correspondre à un champ individuel d’un élément de travail. Je ne veux pas mapper la ligne d’en-tête.
Exemple de document Word
Exemple de configuration cartographique par Ruleset Designer
Exemple de configuration cartographique dans un fichier XML
Note : Si vous ne voulez pas mapper la ligne d’en-tête d’une table à un type d’élément de travail, vous devez cocher la case « Ignorer cette ligne » dans « Règles de ligne » dans le panneau droit du designer de règles (comme montré dans le fichier de règles ci-dessous de l’image de configuration du designer)
3. En tant qu’utilisateur, lors de l’importation du document Word, je veux associer chaque ligne d’un tableau à différents types d’éléments de travail
Exemple de configuration cartographique par Ruleset Designer
Exemple de configuration cartographique dans un fichier XML
Annexe
Message de notification lors de l’ouverture d’un fichier de règles existant
Si vous voyez le message suivant sur la sélection et l’ouverture d’un fichier de règles existant, cela signifie que le contenu placé dans le fichier de règles n’est pas encore pris en charge par l’interface de conception de règles.
