Configuration de l'importation de Word dans Modern Requirements4DevOps
Cet article a pour objectif de présenter les règles standard de configuration du mappage des éléments de travail prises en charge dans la dernière version de Modern Requirements4DevOps. En définissant la configuration du mappage dans un fichier de règles, l'utilisateur peut importer un document Microsoft Word dans Smart Docs sous la forme d'éléments de travail Azure DevOps. Un fichier de règles peut être créé soit manuellement (au format XML), soit via l'interface utilisateur à l'aide du Ruleset Designer.
TABLE DES MATIÈRES
- Points clés :
- Concepteur de règles (interface utilisateur)
- Fichier XML (Manuel)
- Interface utilisateur du concepteur de règles
- Configuration du mappage des éléments de travail [Prise en charge à la fois via XML (manuelle) et via le concepteur de règles (interface utilisateur)]
- Configuration du mappage des éléments de travail pour les « titres » dans Microsoft Word
- Configuration du mappage des éléments de travail pour les « tableaux » dans Microsoft Word
- Configuration du mappage des éléments de travail [Prise en charge uniquement via XML (manuelle)]
- Annexe
Points clés : Concepteur de règles (interface utilisateur)
- Les utilisateurs doivent parcourir le document Word qu'ils prévoient d'importer et s'assurer de savoir quels contenus doivent être gérés comme éléments de travail ou champs dans Smart Docs après l'importation.
- Les utilisateurs ont la possibilité d'importer des documents Word à l'aide de nos fichiers de règles créés via le concepteur de règles, accessible depuis la fenêtre de l'assistant d'importation Word > onglet « Import Ruleset » > fichier de règles (menu déroulant)
- Les éléments suivants d'un document Word sont pris en charge depuis l'interface utilisateur :
- Style de titre (H1 – H9)
- Tableau (ligne, cellule)
Points clés : pour les fichiers XML (manuel)
- Les utilisateurs doivent parcourir le document Word qu'ils prévoient d'importer et s'assurer de savoir quels contenus doivent être gérés comme éléments de travail ou champs dans Smart Docs après l'importation.
- Les utilisateurs ont la possibilité d'importer des documents Word à l'aide de nos fichiers de configuration par défaut, accessibles depuis la fenêtre de l'assistant d'importation Word > onglet « Import Ruleset » > fichier de règles (menu déroulant)
- Si les utilisateurs souhaitent définir leur propre configuration personnalisée, ils doivent créer un fichier de règles portant l'extension « .wirule »et le placer à l'emplacement suivant :
Version de dev.azure.com :
i. %public%\Documents\inteGREAT4TFS\My Ruleset\Smart Docs\dev.azure.com\{Account}
Version de visualstudio.com:
i. %public%\Documents\inteGREAT4TFS\My Ruleset\Smart Docs\{Account}.visualstudio.com
Version intégrée :
ii. %public%\Documents\inteGREAT4TFS\My Ruleset\Smart Docs\{Nom du serveur}
iii. %public%\Documents \inteGREAT4TFS\My Ruleset\Smart Docs\{Nom du serveur}\{Nom de la collection}
4. Une fois que vous aurez placé le ou les fichiers de règles personnalisées à l'un des emplacements mentionnés ci-dessus, vous pourrez y accéder depuis la fenêtre de l'assistant d'importation de Word > onglet « Règles d'importation » > « Fichier de règles » (menu déroulant) > « Smart Docs » (nœud)
5. Le contenu suivant du document Word est pris en charge dans le fichier XML (manuel) :
- a. Style de titre (H1 – H9)
- b. Paragraphe
- c. Tableau (ligne, cellule)
6. Pour effectuer le mappage, les utilisateurs doivent utiliser le « nom de champ » de l'élément de travail/du champ tel qu'il est défini dans le modèle de processus TFS.
7. Pour le mappage, les balises/attributs généraux suivants doivent obligatoirement être utilisés dans un ensemble de règles :
- a. witype (en cas de mappage à un type d'élément de travail)
- b. propriété (en cas de mappage vers un champ d'un élément de travail).
- i. Le terme « propriété » peut également être utilisé comme balise pour définir plusieurs propriétés d'un élément de travail.
Notez qu'il est nécessaire de préciser la « valeur » du champ ; celle-ci ne peut être définie que comme étant de type « chaîne » ou « HTML ».
Notez que si le « propertytype » n'est pas défini pour un champ, le système le considérera par défaut comme un champ de type « String ».
Interface utilisateur du concepteur de règles
Pour plus d'informations sur l'accessibilité de l'interface utilisateur du Ruleset Designer, veuillez consulter ce document.
Message d'avertissement lors de l'ouverture d'un fichier de règles existant
Si le message suivant s'affiche lorsque vous sélectionnez et ouvrez un fichier de règles existant, cela signifie que le contenu de ce fichier n'est pas encore pris en charge par l'interface utilisateur du Ruleset Designer.
Configuration du mappage des éléments de travail (prise en charge à la fois via XML (manuellement) et via le concepteur de règles (interface utilisateur))
Configuration du mappage des éléments de travail pour les « titres » dans Microsoft Word
- En tant qu'utilisateur, lors de l'importation d'un document Word, je souhaite associer chaque style de titre à un type d'élément de travail différent. Le nom du titre doit être associé au champ « Titre », tandis que le contenu ou le paragraphe figurant sous le titre doit être associé à n'importe quel champ HTML d'un élément de travail.
- Vous devez sélectionner chaque nœud de titre individuellement (c'est-à-dire Titre 1, Titre 2, etc.) pour les associer à un type différent d'élément de travail. (Reportez-vous aux captures d'écran ci-dessous présentant un exemple de document Word, un fichier XML (manuel) et le concepteur de règles (interface utilisateur))
Exemple de document Word
Exemple de configuration de mappage à partir du Ruleset Designer
Exemple de configuration de mappage dans un fichier XML
2. En tant qu'utilisateur, lors de l'importation du document Word, je souhaite associer chaque style de titre au même type d'élément de travail, par exemple « Exigence ».
- Vous devez utiliser la balise « Headings » pour associer le même type d'élément de travail à toutes les rubriques définies dans le document. (comme le montrent les captures d'écran ci-dessous du document d'exemple, du fichier XML du jeu de règles manuel et du fichier de jeu de règles issu du Designer)
Exemple de document Word
Exemple de configuration de mappage à partir du Ruleset Designer
Exemple de configuration de mappage dans un fichier XML
Une fois que vous avez défini la balise « Headings », cette balise spécifique (H1-H9) ne peut plus être définie ; par conséquent, dans le menu déroulant « Ajouter un sous-élément », seule l'option « Ajouter un tableau » s'affichera.
3. En tant qu'utilisateur, lorsque j'importe un document Word, je souhaite transférer tout le contenu figurant sous chaque rubrique (par exemple, les paragraphes, les images, les listes, etc.) dans le champ HTML de l'élément de travail.
Exemple de document Word
Exemple de configuration de mappage à partir du Ruleset Designer
Exemple de configuration de mappage dans un fichier XML
4. En tant qu'utilisateur, lorsque j'importe un document Word, je souhaite intégrer le tableau situé sous l'en-tête correspondante dans le champ HTML de l'élément de travail.
Exemple de document Word
Exemple de configuration de mappage à partir du Ruleset Designer
Exemple de configuration de mappage dans un fichier XML
4. En tant qu'utilisateur, lorsque j'importe un document Word, je souhaite associer un même titre à deux types de tâches différents, voire plus.
- Vous devez définir la condition permettant de distinguer deux en-têtes identiques (comme le montrent les captures d'écran ci-dessous du document d'exemple, du fichier XML du jeu de règles manuel et du fichier de jeu de règles issu du Designer)
Exemple de document Word
Exemple de configuration de mappage à partir du Ruleset Designer
Exemple de configuration de mappage dans un fichier XML
Configuration du mappage des éléments de travail pour les « tableaux » dans Microsoft Word
1. En tant qu'utilisateur, lorsque j'importe un document Word, je souhaite associer l'intégralité du tableau à un seul élément de travail comportant des champs sous forme de cellules fusionnées.
Exemple de document Word
Exemple de configuration de mappage à partir du Ruleset Designer
Exemple de configuration de mappage dans un fichier XML
2. En tant qu'utilisateur, lorsque j'importe un document Word, je souhaite associer chaque ligne d'un tableau à un type d'élément de travail spécifique et chaque colonne à un champ distinct d'un élément de travail. Je ne souhaite pas associer la ligne d'en-tête.
Exemple de document Word
Exemple de configuration de mappage à partir du Ruleset Designer
Exemple de configuration de mappage dans un fichier XML
Remarque : si vous ne souhaitez pas associer la ligne d'en-tête d'un tableau à un type d'élément de travail, vous devez cocher la case « Ignorer cette ligne » dans la section « Règles de ligne » du panneau de droite du concepteur de jeux de règles (comme illustré dans le fichier de jeu de règles ci-dessous, tiré de l'image de configuration du concepteur)
3. En tant qu'utilisateur, lors de l'importation d'un document Word, je souhaite associer chaque ligne d'un tableau à un type de tâche différent
Exemple de configuration de mappage à partir du Ruleset Designer
Exemple de configuration de mappage dans un fichier XML
Annexe
Message d'avertissement lors de l'ouverture d'un fichier de règles existant
Si le message suivant s'affiche lorsque vous sélectionnez et ouvrez un fichier de règles existant , cela signifie que le contenu de ce fichier n'est pas encore pris en charge par l'interface utilisateur du Ruleset Designer.
