Data Model URIs

Ce que c'est et pourquoi il existe

Chaque type d'artefact, attribut, type de données et valeur d'énumération d'un projet DOORS Next peut porter un URI. C'est sur ces URI que s'appuient les rapports, les modèles de publication, les intégrations OSLC et les configurations globales pour reconnaître « le même » attribut ou type dans différents projets et flux. Sans eux, chaque projet a ses propres identifiants internes et le travail entre projets ne fonctionne plus.

Définir les URI à la main dans les propriétés du projet implique d'ouvrir chaque définition une par une, de saisir un URI et de garder un nommage cohérent. Pour un vrai modèle de données, cela représente des centaines d'entrées et des heures de travail où les fautes de frappe se glissent. Data Model URIs le fait en une seule étape, avec un seul schéma de nommage pour tout le modèle.

Problèmes résolus

• Des modèles de données sans URI, de sorte que les rapports, intégrations et configurations globales ne peuvent pas faire correspondre les types entre projets.
• Des URI saisis à la main avec une orthographe, des préfixes et des majuscules incohérents.
• Des URI en double qui bloquent le modèle de données ou faussent le reporting.
• Des heures passées dans les propriétés du projet pour une tâche qui suit une règle simple.

Avantages

• Un seul modèle pour tout le modèle de données : votre domaine ou serveur, un préfixe par groupe et un format de nom (camelCase, PascalCase, snake_case ou kebab-case).
• Voir avant de modifier : des exemples en direct pendant que vous définissez le modèle, et un aperçu de chaque URI avec son statut.
• Sûr par conception : les URI existants sont conservés, sauf si vous choisissez de les remplacer, et les conflits ne sont jamais écrits.
• Valeurs d'énumération et types de liens inclus, chaque valeur d'énumération sous l'URI de son type de données.
• Exports Excel de l'aperçu et de ce que chaque exécution a modifié, pour la revue et l'audit.

Utilisation

1. Ouvrez le projet dans un ensemble de modifications (recommandé) ou un flux. Le widget lit son modèle de données.
2. Cliquez sur Change à URI pattern et saisissez votre domaine ou serveur, par exemple https://example.com/ns, puis choisissez un préfixe et un format de nom pour chaque groupe. Les exemples suivent vos choix.
3. Vérifiez l'aperçu : nouveaux URI, URI déjà définis, URI conservés et éventuels conflits. Cochez Replace URIs that are already set si les URI existants doivent changer. Exportez l'aperçu vers Excel si d'autres personnes doivent le vérifier.
4. Cliquez sur Set URIs et confirmez. La progression s'affiche et vous pouvez arrêter à tout moment.
5. Téléchargez le rapport de modifications avec Log dans le bloc de résultat et livrez l'ensemble de modifications lorsque le résultat vous convient.

Bon à savoir

• Nous recommandons de travailler dans un ensemble de modifications, afin que les nouveaux URI puissent être vérifiés et abandonnés avant la livraison. Une ligne de base ne peut pas être modifiée.
• Les noms sont transformés en mots d'URI propres : les accents sont supprimés, et les espaces, tirets et majuscules séparent les mots.
• Utilisations typiques : préparer un modèle de projet, harmoniser des projets avant une configuration globale, et permettre le reporting et les intégrations OSLC.
• Les définitions qui appartiennent à DOORS Next, comme les attributs système, sont affichées en lecture seule et ne sont jamais modifiées. Les états des workflows ne sont pas listés, car DOORS Next ne permet pas d'enregistrer leurs URI de cette façon.