Tworzenie i edycja spraw

Kliknij na folderze Błędy, aby go otworzyć. Jeśli dopiero utworzyłeś nowy serwer, będzie on pusty, a więc zacznijmy od utworzenia pierwszej sprawy.

Atrybuty sprawy

Wybierz polecenie Dodaj sprawę (jeśli korzystasz z programu Desktop Client, musisz kliknąć na liście spraw, aby polecenie to się pojawiło). Zostanie wyświetlone okno jak poniżej:

Dodawanie sprawy
Rysunek 3.6. Dodawanie sprawy

Nazwa sprawy jest wymaganym polem, wpiszmy więc Moja pierwsza sprawa. Pozostałe pola to atrybuty sprawy. Pola Status i Priorytet są wymagane, ale mają domyślną wartość początkową. W zależności od rodzaju atrybutu, akceptują one różne typy wartości:

Tekst

Jest to najprostszy atrybut, który może mieć dowolną wartość. Może mieć określoną minimalną oraz maksymalną długość. Może również mieć postać pojedynczej linii tekstu albo pola, w którym można wpisać więcej linii tekstu. Przykładem atrybutu tekstowego jest pole Wersja.

Lista wyboru

Ten atrybut może przyjmować jedną z określonych wartości, tak jak pole Status, gdzie do wyboru mamy Aktywny, Rozwiązany i Zamknięty. Istnieje również wariant tego atrybutu, który może przyjmować dowolne wartości, a lista ma jedynie charakter pomocniczy, oraz wariant, w którym możesz podać wiele wartości oddzielonych przecinkami.

Użytkownik

Wartością tego atrybutu może być nazwa dowolnego użytkownika z całego systemu WebIssues lub z określonego projektu. Przykładem jest atrybut Przypisany do. Istnieje rówież wariant pozwalający na wybranie wielu użytkowników oddzielonych przecinkami.

Liczba

Wartościami tego atrybutu mogą być liczby całkowite lub o określonej liczbie miejsc po przecinku. Może mieć określoną wartość minimalną oraz maksymalną. Przykładem atrybutu liczbowego jest Krytyczność, która może przyjmować wartości z przedziału od 1 (najbardziej krytyczny błąd) do 3 (mało istotny błąd).

Data

Wartością tego atrybutu może być dowolna poprawna data, którą można wpisać ręcznie lub wybrać za pomocą kalendarza. Przykładem jest atrybut Termin dla typu spraw Zadania. Istnieje również wersja przyjmująca zarówno datę, jak i godzinę.

Na początek przypisz nowy błąd do siebie i zmień jego krytyczność na 1 — w końcu to pierwszy błąd zarejestrowany w systemie.

Wskazówka

Jeśli nie widzisz jakiegoś użytkownika w liście wyboru, prawdopodobnie oznacza to, że nie został on dodany do listy członków projektu — patrz „Zarządzanie użytkownikami”.

Następnie naciśnij OK. Jeśli wartość któregoś z atrybutów jest niepoprawna, zostanie wyświetlony błąd. W przeciwnym wypadku, nowa sprawa pojawi się na liście, a poniżej zostaną wyświetlone szczegółowe informacje:

Szczegóły utworzonej sprawy
Rysunek 3.7. Szczegóły utworzonej sprawy

Komentarze i edycja

Na razie nie wygląda to zbyt imponująco. System zarejestrował, że utworzyłeś sprawę, nadałeś jej nazwę i zmieniłeś wartość dwóch atrybutów. Napiszmy teraz jakiś komentarz. W tym celu wybierz polecenie Dodaj komentarz (upewnij się, że aktywna jest historia sprawy, jeśli korzystasz z programu Desktop Client).

Nowe okno składa się niemal wyłącznie z pola edycji tekstu. W przypadku programu Desktop Client, możesz zostawić to okno otwarte i wrócić do innego okna, na przykład aby przejrzeć historię sprawy. Korzystając z przeglądarki również możesz dodać nowy komentarz w osobnym oknie, jeśli klikniesz prawym przyciskiem na odnośniku i wybierzesz odpowiednią opcję.

Wracając do naszego okna, wpisz tekst komentarza dotyczącego pierwszej sprawy:

Dodawanie komentarza
Rysunek 3.8. Dodawanie komentarza

Tekst zostanie wyświetlony dokładnie tak, jak został wpisany, z zachowaniem odstępów i podziału na linie. Umożliwia to wklejanie np. fragmentów kodu źródłowego czy logów bez obaw, że staną się one nieczytelne. Długie linie zostaną automatycznie podzielone, w zależności od szerokości okna. Adresy stron internetowych i adresy e-mail zostaną automatycznie zamienione na odnośniki.

Historia sprawy z komentarzem
Rysunek 3.9. Historia sprawy z komentarzem

Wskazówka

Automatyczne rozpoznawanie odnośników działa nie tylko w tekście komentarzy, ale także w nazwach spraw i wartościach atrybutów, a nawet w opisach załączników.

Można również tworzyć odnośniki do innych spraw, a także do komentarzy lub załączników. Aby to zademonstrować, utwórzmy drugą sprawę i nadajmy jej nazwę Druga sprawa, pozostawiając domyślne wartości atrybutów. Załóżmy, że identyfikator pierwszej sprawy to #1, a drugiej #5.

Jeśli dodasz komentarz do pierwszej sprawy i wpiszesz w nim tekst #5, zostanie on zamieniony na odnośnik do drugiej sprawy. Podobnie, jeśli teraz dodasz komentarz do drugiej sprawy, wpisując tekst #1, stanie się on odnośnikiem do pierwszej sprawy. W ten sposób możesz tworzyć powiązania między sprawami, odnosić się do innych komentarzy w swoich komentarzach, itp.

Odnośnik do sprawy
Rysunek 3.10. Odnośnik do sprawy

Notatka

Identyfikatory spraw są unikalne i rosnące, ale niekoniecznie są kolejnymi liczbami. W naszym przykładzie druga sprawa ma identyfikator #5, a nie #2, ponieważ identyfikatory są również przypisane komentarzom, załącznikom i innym zmianom, co ułatwia zarządzanie nimi przez system.

Aby szybko przejść do sprawy, komentarza lub załącznika o podanym identyfikatorze, możesz również skorzystać z polecenia Idź do elementu. W programie Web Client kliknij Narzędzia w prawym górnym rogu okna, a następnie kliknij Idź do elementu. W programie Desktop Client polecenie to jest zawsze dostępne w pasku narzędzi głównego okna, możesz również nacisnąć Ctrl+G.

Przejście do elementu
Rysunek 3.11. Przejście do elementu

Następnie wpisz szukany identyfikator i naciśnij OK. Jeśli istnieje sprawa o tym identyfikatorze, zostanie ona wyświetlona. Jeśli natomiast identyfikator reprezentuje komentarz lub załącznik, zostanie wyświetlona sprawa zawierająca ten element, a historia zostanie ustawiona na szukanym elemencie.

Polecenie Zmień atrybuty umożliwia edycję sprawy, tzn. zmianę wartości poszczególnych atrybutów oraz nazwy sprawy. Zaznacz pierwszą sprawę i wybierz to polecenie. Zostanie wyświetlone takie samo okno, jak w przypadku dodawania nowej sprawy, zawierające aktualne wartości atrybutów. Zmień status sprawy na Rozwiązany, a w polu Powód wybierz wartość Naprawiony. Następnie naciśnij OK, aby zapisać zmiany.

Zmiana atrybutów sprawy
Rysunek 3.12. Zmiana atrybutów sprawy

Zauważ że system WebIssues automatycznie zapamiętał wprowadzone przez ciebie zmiany i wyświetla je w historii sprawy. Umożliwia to śledzenie całego cyklu życia sprawy, zmian statusu i wszystkich operacji wykonywanych na sprawie.

Historia sprawy po zmianie
Rysunek 3.13. Historia sprawy po zmianie

Domyślnie w historii sprawy wyświetlone są wszystkie zmiany, komentarze i załączniki. Jeśli nie chcesz widzieć pełnej historii sprawy, a na przykład tylko komentarze, wybierz jedną z opcji filtrowania dostępnych w prawym górnym rogu widoku historii. Aby wyszukać określony tekst w treści komentarza lub innej zmiany, w programie Desktop Client użyj polecenia Znajdź lub naciśnij klawisze Ctrl+F, aby wyświetlić pasek wyszukiwania. Wpisz szukany fragment tekstu, a następnie użyj klawiszy F3 i Shift+F3 aby znaleźć następne lub poprzednie wystąpienie tekstu. W przypadku programu Web Client możesz użyć funkcji wyszukiwania wbudowanej w przeglądarkę.

Dodawanie załączników

Wiesz już jak dodać komentarz, aby opisać sprawę lub dyskutować na jej temat. Długie fragmenty tekstu (np. logi błędów) lepiej jednak zamieszczać w postaci osobnych załączników. W ten sposób możesz również dołączać do sprawy pliki graficzne, dokumenty i inne typy plików, podobnie jak załączniki w wiadomościach e-mail.

Aby dołączyć plik, wybierz polecenie Dodaj załącznik. Następnie wybierz plik, który chcesz dodać, i opcjonalnie wprowadź krótki opis załącznika.

Dodawanie załącznika
Rysunek 3.14. Dodawanie załącznika

Nowy załącznik jest widoczny w historii sprawy:

Historia sprawy z załącznikiem
Rysunek 3.15. Historia sprawy z załącznikiem

Kliknij odnośnik, aby otworzyć dołączony do sprawy plik lub zapisać go na dysku. Program Desktop Client domyślnie zawsze pyta, czy chcesz otworzyć czy zapisać plik. Możesz również kliknąć prawym przyciskiem, aby wybrać odpowiednią opcję z menu kontekstowego. Zmieniając ustawienia programu możesz wybrać domyślną akcję dla załączników oraz zmienić maksymalną ilość miejsca na dysku przeznaczoną na przechowywanie plików tymczasowych.

W przypadku programu Web Client, w zależności od typu pliku i konfiguracji twojej przeglądarki, kliknięcie na odnośnik spowoduje otwarcie załącznika lub zapisanie go na dysku. Obrazy i pliki tekstowe zwykle zostaną wyświetlone bezpośrednio w przeglądarce. W większości przeglądarek możesz również kliknąć na załączniku prawym przyciskiem, aby wybrać odpowiednią akcję z menu kontekstowego.

Notatka

Maksymalny rozmiar załącznika, jaki możesz dołączyć do sprawy, zależy od konfiguracji systemu WebIssues. Możesz go zmienić w ustawieniach systemu WebIssues (przeczytaj „Ustawienia zaawansowane” aby uzyskać więcej informacji). Przesyłanie dużych załączników wymaga również odpowiedniej konfiguracji serwera WWW oraz PHP. Więcej informacji na ten temat znajdziesz na stronie http://php.net/manual/en/features.file-upload.common-pitfalls.php.

Małe załączniki są domyślnie przechowywane w bazie danych, a duże bezpośrednio w systemie plików. W zależności od potrzeb możesz zmienić wartość progową lub wymusić przechowywanie wszystkich załączników tylko w bazie danych lub w systemie plików, zmieniając ustawienia systemu WebIssues. Sposób przechowywania załączników nie ma znaczenia z punktu widzenia programów klienckich.