Data Model URIs

Was es ist und warum es existiert

Jeder Artefakttyp, jedes Attribut, jeder Datentyp und jeder Aufzählungswert in einem DOORS Next-Projekt kann einen URI tragen. Über diese URIs erkennen Berichte, Publishing-Vorlagen, OSLC-Integrationen und globale Konfigurationen „dasselbe“ Attribut oder denselben Typ in verschiedenen Projekten und Datenströmen. Ohne sie hat jedes Projekt seine eigenen internen Kennungen, und die projektübergreifende Arbeit gerät ins Stocken.

URIs von Hand in den Projekteigenschaften festzulegen heißt, jede Definition einzeln zu öffnen, einen URI einzutippen und die Benennung einheitlich zu halten. Bei einem echten Datenmodell sind das Hunderte von Einträgen und Stunden Arbeit, in die sich Tippfehler einschleichen. Data Model URIs erledigt das in einem Schritt, mit einem Namensschema für das gesamte Modell.

Gelöste Probleme

• Datenmodelle ohne URIs, sodass Berichte, Integrationen und globale Konfigurationen Typen nicht projektübergreifend zuordnen können.
• Von Hand eingetippte URIs mit uneinheitlicher Schreibweise, Präfixen und Groß-/Kleinschreibung.
• Doppelte URIs, die das Datenmodell blockieren oder das Reporting durcheinanderbringen.
• Stunden in den Projekteigenschaften für eine Aufgabe, die einer einfachen Regel folgt.

Vorteile

• Ein Muster für das gesamte Modell: Ihre Domain oder Ihr Server, ein Präfix pro Gruppe und ein Namensformat (camelCase, PascalCase, snake_case oder kebab-case).
• Erst sehen, dann ändern: Live-Beispiele, während Sie das Muster festlegen, und eine Vorschau jedes URI mit seinem Status.
• Von Grund auf sicher: Vorhandene URIs bleiben erhalten, sofern Sie sie nicht ersetzen möchten, und Konflikte werden nie geschrieben.
• Aufzählungswerte und Linktypen inklusive, jeder Aufzählungswert unter dem URI seines Datentyps.
• Excel-Exporte der Vorschau und der Änderungen jedes Durchlaufs, für Prüfung und Audit.

Verwendung

1. Öffnen Sie das Projekt in einem Änderungsset (empfohlen) oder einem Datenstrom. Das Widget liest dessen Datenmodell.
2. Klicken Sie bei URI pattern auf Change und geben Sie Ihre Domain oder Ihren Server ein, zum Beispiel https://example.com/ns. Wählen Sie dann für jede Gruppe ein Präfix und ein Namensformat. Die Beispiele folgen Ihrer Auswahl.
3. Prüfen Sie die Vorschau: neue URIs, bereits festgelegte URIs, beibehaltene URIs und eventuelle Konflikte. Aktivieren Sie Replace URIs that are already set, wenn vorhandene URIs ersetzt werden sollen. Exportieren Sie die Vorschau nach Excel, wenn andere sie prüfen sollen.
4. Klicken Sie auf Set URIs und bestätigen Sie. Der Fortschritt wird angezeigt, und Sie können jederzeit abbrechen.
5. Laden Sie den Änderungsbericht mit Log im Ergebnisblock herunter und liefern Sie das Änderungsset aus, wenn Sie zufrieden sind.

Gut zu wissen

• Wir empfehlen, in einem Änderungsset zu arbeiten, damit die neuen URIs vor der Auslieferung geprüft und verworfen werden können. Eine Baseline kann nicht geändert werden.
• Namen werden in saubere URI-Wörter umgewandelt: Akzente werden entfernt, und Leerzeichen, Bindestriche und Großbuchstaben trennen Wörter.
• Typische Einsatzfälle: Vorbereiten einer Projektvorlage, Harmonisieren von Projekten vor einer globalen Konfiguration sowie Ermöglichen von Reporting und OSLC-Integrationen.
• Definitionen, die DOORS Next selbst gehören, etwa Systemattribute, werden als schreibgeschützt angezeigt und nie geändert. Die Zustände von Workflows werden nicht aufgelistet, weil DOORS Next ihre URIs auf diesem Weg nicht speichern lässt.