Konfiguration des Word-Imports in Modern Requirements4DevOps
Ziel dieses Artikels ist es, Standardregeln für die Konfiguration der Work-Item-Zuordnung bereitzustellen, die in der neuesten Version von Modern Requirements4DevOps unterstützt werden. Durch die Bereitstellung der Zuordnungskonfiguration in einer Regelsatzdatei kann ein Benutzer ein Microsoft Word-Dokument in Smart Docs in Form von Azure DevOps-Work-Items importieren. Eine Regelsatzdatei kann entweder manuell (XML) oder über die Benutzeroberfläche mithilfe des Regelsatz-Designers erstellt werden.
INHALTSVERZEICHNIS
- Wichtige Punkte:
- Regelsatz-Designer (Benutzeroberfläche)
- XML-Datei (Handbuch)
- Benutzeroberfläche des Regelwerk-Designers
- Konfiguration der Workitem-Zuordnung [Unterstützt sowohl über XML (manuell) als auch über den Ruleset Designer (Benutzeroberfläche)]
- Konfiguration der Workitem-Zuordnung für „Überschriften“ in Microsoft Word
- Konfiguration der Work-Item-Zuordnung für „Tabellen“ in Microsoft Word
- Konfiguration der Work-Item-Zuordnung [Wird nur ĂĽber XML (manuell) unterstĂĽtzt]
- Anhang
Wichtige Punkte: Ruleset Designer (Benutzeroberfläche)
- Die Benutzer sollten das Word-Dokument, das sie importieren möchten, durchsehen und sicherstellen, dass sie wissen, welche Inhalte nach dem Import in Smart Docs als Arbeitselemente oder Felder verwaltet werden sollen.
- Benutzer haben die Möglichkeit, Word-Dokumente mithilfe unserer Regelwerkdateien zu importieren, die über den Regelwerk-Designer erstellt wurden. Diese sind über das Fenster des Word-Import-Assistenten > Registerkarte „Import-Regelwerk“ > „Regelwerkdatei“ (Dropdown-Menü) zugänglich.
- Die folgenden Inhalte von Word-Dokumenten werden über die Benutzeroberfläche unterstützt:
- Überschriftenformat (H1 – H9)
- Tabelle (Zeile, Zelle)
Wichtige Punkte: FĂĽr XML-Dateien (Handbuch)
- Die Benutzer sollten das Word-Dokument, das sie importieren möchten, durchsehen und sicherstellen, dass sie wissen, welche Inhalte nach dem Import in Smart Docs als Arbeitselemente oder Felder verwaltet werden sollen.
- Benutzer haben die Möglichkeit, Word-Dokumente mithilfe unserer Standardkonfigurationsdateien zu importieren, die über das Fenster des Word-Importassistenten > Registerkarte „Importregeln“ > „Regelsatzdatei“ (Dropdown-Menü) aufgerufen werden können.
- Wenn Benutzer eine eigene Konfiguration festlegen möchten, müssen sie eine Regelsatzdatei mit der Erweiterung „.wirule“erstellen und diese an folgendem Speicherort ablegen:
Version von dev.azure.com:
i. %public%\Dokumente\inteGREAT4TFS\Mein Regelsatz\Smart Docs\dev.azure.com\{Account}
visualstudio.com-Version:
i. %public%\Dokumente\inteGREAT4TFS\Mein Regelsatz\Smart Docs\{Account}.visualstudio.com
Einbettungsversion:
ii. %public%\Dokumente\inteGREAT4TFS\Mein Regelsatz\Smart Docs\{Servername}
iii. %public%\Dokumente\inteGREAT4TFS\Mein Regelsatz\Smart Docs\{Servername}\{Sammlungsname}
4. Nachdem Sie die benutzerdefinierte(n) Regelsatzdatei(en) an einem der oben genannten Speicherorte abgelegt haben, können Sie im Fenster des Word-Import-Assistenten > Registerkarte „Regelsatz importieren“ > „Regelsatzdatei“ (Dropdown-Menü) > „Smart Docs“ (Knoten) darauf zugreifen.
5. Der folgende Inhalt des Word-Dokuments wird in der XML-Datei (Handbuch) unterstĂĽtzt:
- a. Überschriftenformat (H1 – H9)
- b. Absatz
- c. Tabelle (Zeile, Zelle)
6. Für die Zuordnung müssen Benutzer den „Feldnamen“ des Workitems/Feldes verwenden, wie er in der TFS-Prozessvorlage definiert ist.
7. FĂĽr die Zuordnung mĂĽssen die folgenden allgemeinen Tags/Attribute in einem Regelsatz verwendet werden:
- a. witype (bei Zuordnung zu einem Workitem-Typ)
- b. Eigenschaft (bei Zuordnung zu einem Feld eines Workitems).
- i. „Eigenschaft“ kann auch als Tag verwendet werden, um mehrere Eigenschaften eines Arbeitselements zu definieren.
Beachten Sie, dass der „Wert“ des Feldes angegeben werden muss; er kann nur auf den Typ „Zeichenkette“ oder „HTML“ gesetzt werden.
Beachten Sie, dass das System ein Feld, für das „propertytype“ nicht definiert ist, standardmäßig als Feld vom Typ „String“ behandelt.
Benutzeroberfläche des Ruleset-Designers
Weitere Informationen zur Barrierefreiheit der Benutzeroberfläche des Ruleset Designers finden Sie in diesem Dokument.
Meldung beim Ă–ffnen einer vorhandenen Regelsatzdatei
Wenn beim Auswählen und Öffnen einer vorhandenen Regelsatzdatei die folgende Meldung angezeigt wird, bedeutet dies, dass der Inhalt der Regelsatzdatei von der Benutzeroberfläche des Regelsatz-Designers noch nicht unterstützt wird.
Konfiguration der Work-Item-Zuordnung (Unterstützt sowohl über XML (manuell) als auch über den Ruleset Designer (Benutzeroberfläche))
Konfiguration der Arbeitselementzuordnung für „Überschriften“ in Microsoft Word
- Als Benutzer möchte ich beim Importieren des Word-Dokuments jede Überschriftenformatvorlage einem anderen Workitem-Typ zuordnen. Dabei soll der Name der Überschrift dem Feld „Titel“ zugeordnet werden, und der unter der Überschrift stehende Text bzw. Absatz soll einem beliebigen HTML-Feld eines Workitems zugeordnet werden.
- Sie müssen jeden Überschriftenknoten einzeln auswählen (d. h. Überschrift 1, Überschrift 2 usw.), um ihn einem anderen Workitem-Typ zuzuordnen. (Siehe die folgenden Screenshots eines Beispiel-Word-Dokuments, einer XML-Datei (Handbuch) und des Regel-Designers (Benutzeroberfläche))
Beispiel-Word-Dokument
Â
Beispiel fĂĽr eine Zuordnungskonfiguration aus dem Ruleset Designer
Beispiel fĂĽr eine Zuordnungskonfiguration in einer XML-Datei
2. Als Benutzer möchte ich beim Importieren des Word-Dokuments jede Überschriftenformatvorlage demselben Workitem-Typ zuordnen, zum Beispiel „Anforderung“.
- Sie müssen das „Headings“-Tag verwenden, um denselben Workitem-Typ allen im Dokument definierten Überschriften zuzuordnen. (wie in den folgenden Screenshots des Beispieldokuments, der manuellen XML-Regelsatzdatei und der Regelsatzdatei aus dem Designer zu sehen ist)
Beispiel-Word-Dokument
Beispiel fĂĽr eine Zuordnungskonfiguration aus dem Ruleset Designer
Beispiel fĂĽr eine Zuordnungskonfiguration in einer XML-Datei
Sobald Sie das „Headings“-Tag definiert haben, kann die jeweilige Überschrift (H1–H9) nicht mehr definiert werden, sodass im Dropdown-Menü unter „Hinzufügen“ nur noch der Wert „Tabelle hinzufügen“ angezeigt wird.
3. Als Benutzer möchte ich beim Importieren des Word-Dokuments alle Inhalte, die unter den jeweiligen Überschriften stehen – beispielsweise Absätze, Bilder, Aufzählungspunkte usw. – in das HTML-Feld des Workitems einfügen.
Beispiel-Word-Dokument
Beispiel fĂĽr eine Zuordnungskonfiguration aus dem Ruleset Designer
Beispiel fĂĽr eine Zuordnungskonfiguration in einer XML-Datei
4. Als Benutzer möchte ich beim Importieren des Word-Dokuments die Tabelle unter der jeweiligen Überschrift dem HTML-Feld des Workitems zuordnen.
Beispiel-Word-Dokument
Beispiel fĂĽr eine Zuordnungskonfiguration aus dem Ruleset Designer
Beispiel fĂĽr eine Zuordnungskonfiguration in einer XML-Datei
4. Als Benutzer möchte ich beim Importieren des Word-Dokuments dieselbe Überschrift zwei oder mehr verschiedenen Workitem-Typen zuordnen.
- Sie mĂĽssen die Bedingung festlegen, um zwischen zwei identischen Ăśberschriften zu unterscheiden (wie in den folgenden Screenshots des Beispieldokuments, der XML-Datei fĂĽr den manuellen Regelsatz und der Regelsatzdatei aus dem Designer zu sehen ist)
Beispiel-Word-Dokument
Beispiel fĂĽr eine Zuordnungskonfiguration aus dem Ruleset Designer
Beispiel fĂĽr eine Zuordnungskonfiguration in einer XML-Datei
Konfiguration der Work-Item-Zuordnung für „Tabellen“ in Microsoft Word
1. Als Benutzer möchte ich beim Importieren des Word-Dokuments die gesamte Tabelle einem einzigen Arbeitselement zuordnen, das Felder in Form von zusammengeführten Zellen enthält.
Beispiel-Word-Dokument
Beispiel fĂĽr eine Zuordnungskonfiguration aus dem Ruleset Designer
Beispiel fĂĽr eine Zuordnungskonfiguration in einer XML-Datei
2. Als Benutzer möchte ich beim Importieren des Word-Dokuments jede Zeile einer Tabelle demselben Workitem-Typ und jede Spalte einem einzelnen Feld eines Workitems zuordnen. Die Kopfzeile möchte ich nicht zuordnen.
Beispiel-Word-Dokument
Beispiel fĂĽr eine Zuordnungskonfiguration aus dem Ruleset Designer
Beispiel fĂĽr eine Zuordnungskonfiguration in einer XML-Datei
Hinweis: Wenn Sie die Kopfzeile einer Tabelle keinem Workitem-Typ zuordnen möchten, müssen Sie im Regel-Designer im rechten Bereich unter „Zeilenregeln“ das Kontrollkästchen „Diese Zeile ignorieren“ aktivieren (wie in der untenstehenden Regel-Datei aus der Designer-Konfigurationsansicht dargestellt).
3. Als Benutzer möchte ich beim Importieren des Word-Dokuments jede Zeile einer Tabelle einem anderen Workitem-Typ zuordnen
Beispiel fĂĽr eine Zuordnungskonfiguration aus dem Ruleset Designer
Beispiel fĂĽr eine Zuordnungskonfiguration in einer XML-Datei
Anhang
Meldung beim Ă–ffnen einer vorhandenen Regelsatzdatei
Wenn beim Auswählen und Ă–ffnen eines vorhandenen Regelsatzes , bedeutet dies, dass die in der Regelsatzdatei enthaltenen Inhalte von der Benutzeroberfläche des Regelsatz-Designers noch nicht unterstĂĽtzt werden.Â
