Publishing URLs

Czym jest i dlaczego powstał

Specyfikacje, plany testów i dokumenty zgodności są często generowane z DOORS Next za pomocą IBM Engineering Publishing (dawniej Rational Publishing Engine). Każdy szablon wymaga adresów URL źródeł danych wskazujących właściwy projekt, konfigurację, moduł, widok lub artefakty, a także odpowiadających im adresów URL schematów.

Ręczne pisanie tych adresów Reportable REST wymaga znajomości wielu parametrów oraz wewnętrznych identyfikatorów projektów, modułów i konfiguracji. Jeden błąd oznacza pusty lub błędny dokument. Publishing URLs tworzy poprawne adresy URL na podstawie miejsca, w którym użytkownik znajduje się w DOORS Next.

Jakie problemy rozwiązuje

• Ręczne pisanie adresów URL źródeł danych z wewnętrznymi identyfikatorami i wieloma parametrami.
• Dokumenty generowane z niewłaściwej konfiguracji, strumienia lub linii bazowej.
• Czas tracony na szukanie w dokumentacji właściwego parametru.
• Zależność od nielicznych specjalistów znających interfejs Reportable REST.

Korzyści

• Poprawne adresy URL w kilka sekund dla modułu, jego artefaktów, widoku, zaznaczenia lub całego projektu.
• Również adresy URL schematów, których wymaga szablon publikacji.
• Właściwa konfiguracja: strumień, linia bazowa, zestaw zmian lub Global Configuration, pobrane z bieżącego kontekstu.
• Kopiowanie i otwieranie każdego adresu URL jednym kliknięciem lub skopiowanie wszystkich naraz.
• Tylko odczyt i bezpieczeństwo.

Jak używać

1. Otworzyć projekt, konfigurację i moduł, których dotyczy dokument. Zaznaczyć artefakty, jeśli tylko one mają zostać opublikowane, i otworzyć zapisany widok w DOORS Next, jeśli potrzebne są adresy widoku.
2. Sprawdzić sekcję Context, która pokazuje, na podstawie czego tworzone są adresy URL.
3. W Settings kliknąć Change i wybrać konfigurację w Compare with (Diff), atrybuty w Attributes i to, co ma się znaleźć w Include, na przykład Cover page variables.
4. W sekcji Data source URLs otworzyć grupę i skopiować adres źródła danych oraz jego adres schematu do szablonu publikacji. Ikona otwarcia pokazuje najpierw odpowiedź serwera; ikona kopiowania przy nagłówku kopiuje wszystkie adresy naraz.

Warto wiedzieć

• Adresy URL, które nie pasują do bieżącego kontekstu, są wyświetlane wraz z przyczyną, na przykład gdy żaden moduł nie jest otwarty.
• Bardzo długie adresy URL, powstające przy dużych zaznaczeniach, są oznaczane ostrzeżeniem, ponieważ niektóre narzędzia ograniczają długość adresu.