# Data Model URIs

> Nadaje każdemu typowi artefaktu, atrybutowi, typowi danych, wartości wyliczenia i typowi powiązania w projekcie spójne URI według jednego wzorca, z pełnym podglądem przed wprowadzeniem zmian.

Source: https://widgets.doorsnext.com/pl/widgets/data-model-uris/

- Dyscyplina: Konfiguracja i nadzór
- Działa w: Moduł IBM DOORS Next
- Obsługiwane produkty: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Zmienia dane
- Keywords: przypisane URI, URI systemu typów, URI modelu danych, URI RDF, URI typu artefaktu, URI atrybutu, URI wyliczenia, OSLC, global configuration, raportowanie, konwencja nazewnictwa, camelCase, assigned URI, IBM DOORS Next
- Wersja: 1.14 (Data wydania 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Otwórz projekt w zestawie zmian → 2. Wpisz domenę, prefiksy i formaty nazw → 3. Pokazuje każde URI i konflikty (W razie potrzeby: Konflikty: zmień prefiks lub format) → 4. Set URIs: zapis w modelu danych → 5. Raport zmian w Excelu

## 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.