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. Patrz 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
- 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.
- W aplikacji Document Studio
utwórz
szablon dokumentu.
- Zidentyfikuj schemat źródła danych w źródle danych. Można użyć produktu Rational DOORS lub Rational DOORS Web
Access.
W przypadku produktu
Rational DOORS:
- W programie Document Studio kliknij opcję
.
- 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.
- Wybierz widok:
- Widok bazy danych
- Widok projektu
- Kliknij przycisk
Dalej.
- 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.
- W oknie Wybór modułu DOORS wybierz moduł ze struktury
bazy danych produktu
Rational DOORS,
a następnie kliknij przycisk Dalej.
- W oknie Plan bazowy DOORS wybierz
plan bazowy dla modułu. Wybrany plan bazowy określa zestaw
atrybutów, który zostanie użyty.
- 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.
- 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).
- 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.
- Przejrzyj informacje w oknie podsumowania i kliknij przycisk Zakończ.
W przypadku produktu
Rational DOORS Web
Access:
- W programie Document Studio kliknij opcję .
- W polu Typ schematu wybierz z listy opcję Ogólny
XML.
- W polu Plik schematu wklej adres URL określony jako schemat źródła danych.
- W polu Identyfikator źródła danych
wpisz nazwę źródła danych w szablonie. Kliknij przycisk
Dalej.
- Jeśli zasób znajduje się na zabezpieczonym serwerze, podaj nazwę w polu Użytkownik.
- Jeśli zasób znajduje się na zabezpieczonym serwerze, podaj wartość w polu Hasło.
- Wybierz z listy uwierzytelnianie OAuth-OSLC.
- 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 można uzyskać dostęp do listy atrybutów zawartych w module.
- 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.
Uwaga: Elementów kontenera można używać zamiast tabel na potrzeby diagramów produktu
Rational DOORS Analyst, które są zawarte w tabeli 1x1.
- 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.
- Utwórz
tabelę na podstawie danych produktu
Rational DOORS.
Nie ma bezpośredniej obsługi odtworzenia tabeli produktu Rational DOORS dokładnie w taki sam sposób, jak wygląda ona w produkcie Rational DOORS. 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:
TableCellWidth –
Szerokość komórki w pikslach ekranu. Istnieją dwa sposoby wyodrębniania informacji o kolumnach z produktu
Rational DOORS:
- Dodaj
formatowanie
i style do elementów, aby umożliwić sterowanie sposobem ich wyświetlania
w danych wyjściowych.
- 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. Więcej informacji na ten temat zawiera sekcja
Przykład: filtry rodzime produktu Rational DOORS.
- 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.