Data Model URIs

Czym jest i dlaczego powstał

Każdy typ artefaktu, atrybut, typ danych i wartość wyliczenia w projekcie DOORS Next może mieć przypisane URI. To właśnie na tych URI opierają się raporty, szablony publikacji, integracje OSLC i konfiguracje globalne, aby rozpoznać „ten sam” atrybut lub typ w różnych projektach i strumieniach. Bez nich każdy projekt ma własne wewnętrzne identyfikatory, a praca między projektami przestaje działać.

Ręczne ustawianie URI we właściwościach projektu oznacza otwieranie każdej definicji po kolei, wpisywanie URI i pilnowanie spójności nazewnictwa. W rzeczywistym modelu danych to setki pozycji i godziny podatnej na błędy pracy. Data Model URIs robi to w jednym kroku, z jednym schematem nazewnictwa dla całego modelu.

Jakie problemy rozwiązuje

• Modele danych bez URI, przez co raporty, integracje i konfiguracje globalne nie mogą dopasować typów między projektami.
• URI wpisywane ręcznie z niespójną pisownią, prefiksami i wielkością liter.
• Zduplikowane URI, które blokują model danych lub wprowadzają w błąd raportowanie.
• Godziny spędzone we właściwościach projektu nad zadaniem, które sprowadza się do prostej reguły.

Korzyści

• Jeden wzorzec dla całego modelu: własna domena lub serwer, prefiks dla każdej grupy oraz format nazw (camelCase, PascalCase, snake_case lub kebab-case).
• Najpierw podgląd, potem zmiana: przykłady na żywo podczas ustawiania wzorca oraz podgląd każdego URI wraz z jego statusem.
• Bezpieczeństwo w założeniu: istniejące URI są zachowywane, chyba że wybrano ich zastąpienie, a konflikty nigdy nie są zapisywane.
• Również wartości wyliczeń i typy powiązań, każda wartość wyliczenia pod URI swojego typu danych.
• Eksport do Excela podglądu i zmian wprowadzonych w każdym przebiegu, do przeglądu i audytu.

Jak używać

1. Otworzyć projekt w zestawie zmian (zalecane) lub w strumieniu. Widżet odczytuje jego model danych.
2. Kliknąć Change przy URI pattern i wpisać własną domenę lub serwer, np. https://example.com/ns, a następnie wybrać prefiks i format nazw dla każdej grupy. Przykłady aktualizują się zgodnie z wyborem.
3. Przejrzeć podgląd: nowe URI, URI już ustawione, URI zachowane oraz ewentualne konflikty. Zaznaczyć Replace URIs that are already set, jeśli istniejące URI mają zostać zmienione. Jeśli inne osoby mają sprawdzić podgląd, wyeksportować go do Excela.
4. Kliknąć Set URIs i potwierdzić. Postęp jest widoczny, a operację można w każdej chwili zatrzymać.
5. Pobrać raport zmian przyciskiem Log w bloku wyniku i dostarczyć zestaw zmian, gdy wynik jest zadowalający.

Warto wiedzieć

• Zalecamy pracę w zestawie zmian (change set), aby nowe URI można było przejrzeć i ewentualnie odrzucić przed dostarczeniem. Linii bazowej nie można zmienić.
• Nazwy są przekształcane w czyste słowa URI: znaki diakrytyczne są usuwane, a spacje, myślniki i wielkie litery rozdzielają słowa.
• Typowe zastosowania: przygotowanie szablonu projektu, harmonizacja projektów przed wdrożeniem Global Configuration oraz umożliwienie raportowania i integracji OSLC.
• Definicje należące do samego DOORS Next, np. atrybuty systemowe, są pokazane jako tylko do odczytu i nigdy nie są zmieniane. Stany przepływów pracy (workflow) nie są wyświetlane, ponieważ DOORS Next nie pozwala zapisać ich URI w ten sposób.