Projektowanie szablonów z produktem Rational DOORS jako źródłem danych

Projektanci raportów mogą za pomocą aplikacji Document Studio importować schematy źródła danych i budować szablony raportów.

Zanim rozpoczniesz

Wskazówka: Instalacja produktu Rational Publishing Engine obejmuje zestaw przykładowych raportów. Przed przystąpieniem do publikowania dokumentów można przećwiczyć ten przykładowy scenariusz generowania dokumentów. Więcej informacji na ten temat zawiera sekcja Tworzenie przykładowego szablonu produktu Rational DOORS.
Należy sprawdzić moduł produktu Rational DOORS, który ma być używany, oraz jego zawartość. Aby znaleźć Centrum informacyjne danej wersji produktu Rational DOORS, należy zapoznać się z sekcją Informacje o Centrum informacyjnym produktu Rational DOORS.

Można użyć kombinacji właściwości modułu, atrybutów obiektu i widoków, które są przechowywane w modułach. Należy przejrzeć widoki dostępne w module pod kątem kolumn obliczanych, w tym widoki śledzenia, lub kolumn DXL układu. Te widoki nie odpowiadają atrybutom produktu Rational DOORS, ale mogą być uwzględniane w raportach.

Procedura

  1. Zapoznaj się z procesem projektowania szablonu w sekcji Projektowanie szablonów dokumentów. Rozpoczęcie planowania struktury dokumentu i danych, które może on zawierać. Określ na przykład, czy dokument końcowy ma być generowany na podstawie jednego szablonu, czy wielu plików szablonów zawierających fragmenty treści wielokrotnego użytku.
  2. W aplikacji Document Studio utwórz szablon dokumentu.
  3. Zidentyfikuj schemat źródła danych w źródle danych. Istnieją dwa sposoby dodawania źródła danych: za pomocą kreatora wykrywania schematów DOORS lub za pomocą kreatora schematów źródeł danych. Aby dodać źródło danych za pomocą kreatora schematów źródeł danych:
    1. W programie Document Studio kliknij opcję Dane > Dodaj schemat źródła danych.
    2. W polu Predefiniowane wybierz schemat bazy danych Doors.
    3. W polu Typ wybierz typ schematu z listy. W przypadku produktu Rational DOORS należy wybrać opcję DOORS.
    4. Edytuj pole Schemat, jeśli jest to konieczne, lub kliknij przycisk Przeglądaj, aby wybrać ścieżkę dla pliku schematu.
    5. Jeśli zasób znajduje się na zabezpieczonym serwerze, podaj nazwę użytkownika w polu Użytkownik.
    6. Jeśli zasób znajduje się na zabezpieczonym serwerze, podaj hasło w polu Hasło.
    7. Z listy Typ uwierzytelniania wybierz odpowiedni typ. W przypadku produktu Rational DOORS typ uwierzytelniania to OAuth-OSLC. Jeśli typ OAuth-OSLC nie zostanie wybrany, będą testowane wszystkie typy uwierzytelniania do czasu znalezienia poprawnego. Może to wydłużyć czas generowania dokumentu.

    Aby dodać źródło danych za pomocą kreatora wykrywania schematów DOORS:

    1. W programie Document Studio kliknij opcję Dane > Wykrywanie schematu > Wykrywanie schematu DOORS.
    2. Podaj szczegóły połączenia:
      • Aby użyć działającej instancji produktu Rational DOORS, wybierz opcję Użyj działającej instancji DOORS.
      • Aby uruchomić produkt Rational DOORS w tle, wybierz opcję Uruchom nowy proces DOORS działający w tle. Podaj nazwę użytkownika, hasło, bazę danych i ścieżkę do pliku doors.exe.
    3. Wybierz widok:
      • Widok bazy danych
      • Widok projektu
    4. Kliknij przycisk Dalej.
    5. Wybierz typ atrybutu:
      • Aby dodać atrybuty do obiektów głównych (elementy schematu Module/Object), wybierz opcję Atrybuty modułu i obiektu.
      • Aby dodać atrybuty do obiektów łączonych (element schematu Module/Object/Link/Linked), wybierz opcję Atrybuty obiektów łączonych.
    6. W oknie Wybór modułu DOORS wybierz moduł ze struktury bazy danych produktu Rational DOORS, a następnie kliknij przycisk Dalej.
    7. W oknie Plan bazowy DOORS wybierz plan bazowy dla modułu. Wybrany plan bazowy określa zestaw atrybutów, który zostanie użyty.
    8. W oknie Atrybuty produktu DOORS wyświetlane są następujące informacje o atrybutach:
      • Nazwa atrybutu: zawiera listę atrybutów dostępnych w wybranym planie bazowym.
      • Zasięg: wyświetla zasięg atrybutu jako modułu lub obiektu.
      • Nazwa podwyższenia uprawnień: nazwa o podwyższonych uprawnieniach atrybutu to nazwa używana w wyrażeniach skryptu. Poprawna nazwa jest generowana na podstawie nazwy atrybutu produktu Rational DOORS, aby zapobiec wprowadzaniu niepoprawnej wartości. Atrybut z podwyższonymi uprawnieniami umożliwia bezpośredni dostęp do tej wartości atrybutu z kontekstu elementu Module/Object. Wartości atrybutów bez podwyższonych uprawnień są dostępne tylko z kontekstu Module/Object/Attribute.

      Należy zaznaczyć pole wyboru, aby określić atrybut lub wybrać opcję Wybierz wszystko, aby wybrać wszystkie atrybuty. Opcja Anuluj wybór wszystkiego powoduje usunięcie zaznaczenia wszystkich atrybutów. Kliknij przycisk Dalej.

    9. W oknie Widoki i kolumny produktu DOORS wybierz widok. Następnie zaznacz pole wyboru dla nazwy kolumny, aby wybrać kolumnę, lub wybierz opcję Wybierz wszystko, aby wybrać wszystkie nazwy kolumn. Kliknij przycisk Dalej.
      Uwaga: Nazwa podwyższenia uprawnień kolumny jest wyświetlana w kolumnie Nazwa podwyższenia uprawnień. Zwiększenie uprawnień kolumn jest możliwe z dowolnej liczby widoków. Uprawnienia tych atrybutów można podnieść później podczas projektowania szablonu. Atrybuty dodają do elementów informacje deklaratywne wykraczające poza zwykłe predefiniowane słowa kluczowe. Atrybuty produktu Rational DOORS zdefiniowane przez użytkownika są dostępne wyłącznie za pośrednictwem węzłów Attribute w standardowym pliku schematu produktu Rational DOORS. Aby móc korzystać z tych atrybutów, muszą one zostać awansowane jako atrybuty XML za pomocą kreatora wykrywania schematu XML. Atrybut może występować tylko raz, na przykład Module Name (Nazwa modułu) i właściwość Data ostatniej modyfikacji. Atrybuty mogą mieć zastosowanie do obiektu, ale z wieloma wystąpieniami (na przykład Nagłówek obiektu i Tekst obiektu).
    10. W oknie Wybór opcji schematu wprowadź szczegółowe informacje w następujących polach:
      • Wybierz położenie schematu: kliknij przycisk Przeglądaj, aby wybrać położenie w celu zapisania schematu źródła danych.
      • Identyfikator schematu źródła danych: wprowadź identyfikator dla schematu źródła danych.
      • Zaznacz pole wyboru Dodaj schemat źródła danych do bieżącego szablonu, aby dodać ten schemat do otwartego szablonu. Kliknij przycisk Dalej.
      • Zapisz schematy w celu ich ponownego wykorzystania w innych szablonach bez potrzeby ponownego uruchamiania kreatora wykrywania schematów.
    11. Przejrzyj informacje w oknie podsumowania i kliknij przycisk Zakończ.
  4. Pracuj z atrybutami. Istnieje możliwość określenia atrybutów obiektu, które są obecne w module produktu Rational DOORS, a następnie ocenienia, czy muszą one występować w raporcie produktu Rational Publishing Engine. Za pomocą wyboru z menu Edycja > Atrybuty można uzyskać dostęp do listy atrybutów zawartych w module.
  5. Dodaj elementy do szablonu. Produkt Rational Publishing Engine zawiera obszerny zestaw elementów szablonów, których można używać przy określaniu struktury dokumentu. Elementy te można przeciągać do edytora treści szablonu. Na przykład można dodać element kontenera do przechowywania kilku akapitów. Każdy akapit może być sterowany przez warunek testowy, który wiąże go tylko z konkretnymi danymi. Więcej informacji na ten temat zawierają sekcje Elementy szablonu w widoku Paleta i Dodawanie elementów do szablonu.
    Elementy kontenera
    Elementów kontenera można używać zamiast tabel na potrzeby diagramów produktu Rational DOORS Analyst, które są zawarte w tabeli 1x1.
    Elementy obrazu
    Obrazy są wyodrębniane z modułu produktu Rational DOORS z wartościami atrybutu. Nie można wykonywać zapytań wyłącznie o obrazy.
    Aby skonfigurować wielkość wyodrębnianych obrazów, należy określić właściwości image max width (maksymalna szerokość obrazu) i image max height (maksymalna wysokość obrazu). Właściwości te można określić w dwóch miejscach:
    • Informacje o formacie elementu definiują wielkość obrazów znajdujących się w danym elemencie szablonu. Są dostępne tylko w przypadku elementów szablonów tekstowych.
    • Metadane specyfikacji dokumentu definiują wielkość obrazów we wszystkich szablonach. Wartości formatu elementów przesłaniają wartości globalne.
    Elementy tabeli
    Dokładne odtworzenie tabeli produktu Rational DOORS w produkcie Rational Publishing Engine może być niemożliwe. Można użyć dostępnych atrybutów tabeli produktu Rational DOORS i wygenerować nową tabelę.
    Należy użyć kreatora schematu produktu Rational DOORS do wyodrębnienia informacji o tabelach produktu Rational DOORS. Na przykład: TableCellWidthSzerokość komórki w pikslach ekranu. Istnieją dwa sposoby wyodrębniania informacji o kolumnach z produktu Rational DOORS:
    • Przy użyciu wyrażenia module/object/column w celu uzyskania nazw i wartości kolumn w zapytaniu o obiekt. Jest to przydatne, gdy dane produktu Rational DOORS powtarzają się dla poszczególnych obiektów.
    • Przy użyciu wyrażenia module/view/column w celu uzyskania nazw kolumn z widoku produktu Rational DOORS używanego podczas generowania dokumentów. Iteracja według widoków jest przydatna, gdy potrzebne są kolumny zdefiniowane w bieżącym widoku oraz ich właściwości. Do przetestowania tych metod można użyć przykładowych szablonów produktu Rational Publishing Engine.
      Uwaga: Aby uzyskać dostęp do danych kolumny, należy użyć w zapytaniu wyrażenia module/object/column/(@Column Text).

    Jeśli tabele produktu Rational DOORS zawierają komórki rozciągające się na wiele wierszy, produkt Rational Publishing Engine wygeneruje pierwszą komórkę, a pozostałe komórki z zakresu zostaną usunięte.

    Więcej informacji o tabelach zawiera sekcja Dodawanie elementu tabeli.

  6. Użyj zapytań, atrybutów i zmiennych, aby dodać dane do szablonu. Te elementy określają, które fragmenty informacji są generowane w raporcie. Zapytania w produkcie IBM® Rational DOORS rozpoczynają się od elementu głównego (moduł), po którym znajduje się jego element potomny (obiekt), a po nim atrybut potomny obiektu. Na przykład Module/Object/Attribute/Name. Więcej informacji na ten temat zawiera sekcja Schemat produktu Rational DOORS.
  7. Dodaj formatowanie i style do elementów, aby umożliwić sterowanie sposobem ich wyświetlania w danych wyjściowych.
  8. Utwórz filtry, aby zawęzić dane, które są pobierane do raportu. Istnieje możliwość używania filtrów, które są szczegółowymi wersjami ogólnego identyfikatora URI źródła danych. Pozwalają one wskazywać konkretne podzbiory danych, tak aby produkt Rational Publishing Engine nie próbował podczas generowania raportu pobierać informacji ze źródła danych w ilości większej niż konieczna. Te filtry muszą być na tyle ogólne, aby pobrać wszystkie niezbędne dane, do których odwołuje się szablon. W przeciwnym razie wygenerowany raport może nie zawierać kompletnego zbioru danych. Istnieje możliwość zdefiniowania filtrów rodzimych w zapytaniach dotyczących odsyłaczy. Więcej informacji na ten temat zawiera sekcja Przykład: filtry rodzime produktu Rational DOORS.
  9. Utwórz sortowania, aby uporządkować dane w raporcie. Dla produktu Rational DOORS tekst sortowania rodzimego musi mieć format sortowania produktu Rational DOORS. Więcej informacji na ten temat zawiera sekcja Przykład: sortowania rodzime w produkcie Rational DOORS.

Co dalej

W przypadku podglądu danych z poziomu aplikacji Document Studio domyślny plan bazowy i widok są używane do pobierania danych.

Opinia