# Pierwsze kroki

> Dodanie widgetu zajmuje niecałą minutę. Ta strona wyjaśnia, gdzie znajdują się widgety, jak je dodać i jak bezpiecznie z nimi pracować.

Source: https://widgets.doorsnext.com/pl/get-started/

## Przed rozpoczęciem
- IBM Engineering Lifecycle Management 7.x z IBM DOORS Next (większość widgetów) lub dowolna aplikacja ELM (User Audit i Advanced Server Diagnostics).
- Nowoczesna przeglądarka: Google Chrome, Microsoft Edge, Mozilla Firefox lub Safari.
- Pliki SmarterWidgets na serwerze WWW dostępnym dla użytkowników oraz katalog SmarterWidgets zarejestrowany na serwerze ELM. Administrator konfiguruje to jednorazowo. Aby uzyskać dostęp, [prosimy o kontakt ze SmarterProcess](https://widgets.doorsnext.com/pl/about/#contact).
- Standardowe uprawnienia w DOORS Next. Widgety mogą wykonać tylko te operacje, do których uprawniony jest sam użytkownik.

## Dodawanie widgetu do modułu DOORS Next
1. Otworzyć moduł w DOORS Next.
2. Otworzyć ELM Mini Dashboard po prawej stronie ekranu (**Show Mini Dashboard**).
3. Kliknąć **Add Widget**, wybrać katalog SmarterWidgets i wskazać potrzebny widget. Katalog wyświetla krótki opis i podgląd każdego widgetu.
4. Widget pojawi się w ELM Mini Dashboard i jest gotowy do użycia. Pozostanie tam również przy kolejnej wizycie.

Bez katalogu nadal można dodać pojedynczy widget: w oknie **Add Widget** należy wybrać **Add OpenSocial Gadget** i wpisać adres widgetu podany przez administratora.

User Audit i Advanced Server Diagnostics nie wymagają DOORS Next, więc można je w ten sam sposób dodać także do ELM Mini Dashboard w innych aplikacjach ELM. Widgety działające na projektach i konfiguracjach, takie jak Baseline Archiver, Compare Data Models czy Change Set Monitor, nie wymagają otwartego modułu. Widgety, które czyszczą lub łączą artefakty, działają także poza modułem, na artefaktach zaznaczonych w widoku folderu lub kolekcji: opcja **Whole module** jest wtedy zablokowana.

## Praca w change secie
> **Zalecamy uruchamianie każdego widgetu zmieniającego dane w zestawie zmian (change set) DOORS Next.** Jeśli uruchomienie wprowadzi niechciane zmiany, wystarczy odrzucić zestaw zmian – nic nie trafi do strumienia. Zestaw zmian należy dostarczyć dopiero po sprawdzeniu wyniku. W tej weryfikacji pomaga raport zmian w formacie Excel. Pobiera się go przyciskiem **Log** w bloku wyniku.

## Budowa każdego widgetu
Wszystkie widgety mają taki sam układ – kto pozna jeden, zna wszystkie:

- **Nagłówek** z nazwą widgetu, a pod nią informacją, na czym widget pracuje, np. otwarty moduł lub **No module open**. Po prawej **How it works** wyjaśnia działanie widgetu w kilku krokach: co zmienia, co warto wiedzieć i jak cofnąć zmiany. Obok znajdują się przyciski do ponownego odczytania kontekstu i zresetowania widgetu.
- **Ustawienia** w postaci szarych bloków, które pokazują bieżące wybory, np. typy linków lub regułę. **Change** otwiera blok, a **Done** go zamyka.
- **Sekcja robocza** z przełącznikiem **Whole module** | **Selection** i kafelkami akcji. Niebieski kafelek zwykle wyszukuje i wyświetla to, na czym widget by pracował, niczego nie zmieniając. Kafelek, który zmienia dane, najpierw prosi o potwierdzenie i podaje, ile artefaktów lub linków zmieni.
- **Karta postępu** w trakcie operacji, z przyciskiem **Stop**. Po zakończeniu jej miejsce zajmuje **blok wyniku**: wynik z liczbami, wszystko, czego nie udało się wykonać (z **Retry all**), oraz **Log**, który pobiera raport zmian w formacie Excel. Po użyciu **Stop** na całym module **Continue from …** wznawia operację od miejsca zatrzymania. Po chwili blok wyniku zwija się do jednego wiersza; kliknięcie otwiera go ponownie.
- **Stopka** z numerem wersji i datą wydania.

## Ustawienia
Każdy widget ma kilka ustawień dostępnych w menu widgetu pod pozycją **Edit**, np. wielkość partii przetwarzanych danych lub to, czy powiadomienia mają pojawiać się nad stroną DOORS Next. Ustawienia są zapamiętywane w przeglądarce. Większość użytkowników nigdy nie musi ich zmieniać. Wyborów dotyczących samej pracy, np. typów linków lub reguł, dokonuje się w samym widgecie, w szarych blokach ustawień.

## Aktualizacje
Gdy dostępna jest nowsza wersja widgetu, w jego nagłówku pojawia się niebieska etykieta **New Version Available**. Po najechaniu na nią kursorem widać listę zmian. Strona każdego widgetu w tej dokumentacji przedstawia zmiany wprowadzone w jego najnowszej wersji.