Atlassian Jira Server & Data Center. Programowanie rozwiązań w projektach biznesowych Zelów

By szybciej, sprawniej i skuteczniej zarządzać projektami Znalezienie odpowiedzi na zaprzątające umysł pytania z zakresu automatyzacji zwykle wiąże się ze spędzeniem długich godzin na wertowaniu niespójnej dokumentacji lub przeszukiwaniu forum Atlassian Community, gdzie swoimi problemami (a także autorskimi pomysłami na ich rozwiązanie) dzielą się inni użytkownicy Jiry. To jednak często bezproduktywne działanie, a jedynym skutecznym ... albo i nieskutecznym ... sposobem, by pokonać przeszkodę, jest metoda prób i błędów. W szczególności dotyczy to klas, metod i interfejsów, o których możemy jedynie powiedzieć, że istnieją i przyjmują określone typy parametrów. Książka Jakuba Kalinowskiego ma w zamyśle oszczędzić czytelnikom żmudnego procesu pozyskiwania wiedzy i dać wskazówki, jak rozwiązać konkretne problemy, z którymi mogą się oni zetknąć podczas pracy z Atlassian Jira Server. Znalazło się tu omówienie takich kwestii jak custom fields, workflows, integracje z API, funkcjonalności dostarczane przez pluginy, a także tego, co niesłusznie jest uznawane za terra incognita, czyli tworzenia własnych pluginów. Autor uzupełnił treść o kilka zagadnień związanych z integracją Jiry i Confluence, jak również z bazami Insight - Asset Management, ponieważ obie aplikacje często są obecne w projektach biznesowych, a ich automatyzacja zazwyczaj przysparza wielu problemów. To książka adresowana przede wszystkim do czytelników, którzy mają już doświadczenie w zarządzaniu projektami i instancjami Jira, jednak do tej pory nie zdecydowali się na pisanie skryptów automatyzujących. Spis treści: Od autora Wprowadzenie Część I. PRZYGOTOWANIE ŚRODOWISKA PRACY Rozdział 1. Instalacja własnej instancji Jiry 1.1. Warunki początkowe 1.2. Przygotowanie systemu operacyjnego 1.3. Instalacja bazy danych 1.4. Instalacja Jira Software Server/Data Center 1.5. Pierwsze uruchomienie Jiry Część II. DOKUMENTACJA I NARZĘDZIA DEWELOPERA Rozdział 2. Składnia Groovyego 2.1. Uwagi dla programistów Javy 2.2. Import bibliotek 2.3. Deklaracja i inicjalizacja zmiennych 2.4. Tworzenie funkcji 2.5. Wykorzystanie klas 2.6. Instrukcje sterujące i pętle 2.6.1. Instrukcja if... else... 2.6.2. Pętla for in 2.6.3. Pętle each() i eachWithIndex() 2.6.4. Metody find() i findAll() Rozdział 3. Atlassian Java APIs 3.1. Accessors (akcesory) 3.1.1. ComponentAccessor 3.1.2. PluginAccessor 3.2. Managers (menedżery) 3.2.1. AttachmentManager 3.2.2. ChangeHistoryManager 3.2.3. CommentManager 3.2.4. CustomFieldManager 3.2.5. GroupManager 3.2.6. IssueLinkManager 3.2.7. IssueManager 3.2.8. LabelManager 3.2.9. OptionsManager 3.2.10. PriorityManager 3.2.11. ProjectComponentManager 3.2.12. ProjectManager 3.2.13. ProjectRoleManager 3.2.14. SubTaskManager 3.2.15. UserManager 3.2.16. VersionManager 3.3. Services (serwisy) 3.3.1. IssueService 3.3.2. IssueIndexingService 3.3.3. ProjectService 3.3.4. SearchService 3.3.5. UserService Rozdział 4. Dokumentacja w sieci 4.1. Społeczność 4.2. Biblioteki Javy dla produktów Atlassian 4.3. Ogólne zagadnienia z programowania w Javie i Groovym 4.4. Dokumentacja REST API 4.5. Dokumentacja pluginów 4.6. Pozostałe Rozdział 5. Testowanie zmian 5.1. Logi 5.1.1. Application logs (logi aplikacyjne) 5.1.2. System logs (logi systemowe) 5.2. Loggers (loggery) 5.3. Audit log (analizator dzienników) 5.4. Support zip (plik dla działu wsparcia) 5.5. Testowanie uprawnień użytkowników 5.5.1. Permission helper 5.5.2. Switch to a different user 5.6. Sposoby testowania skryptów Część III. TWORZENIE SKRYPTÓW ZA POMOCĄ PLUGINÓW Rozdział 6. Wybór pluginów 6.1. Określenie aktualnych i przyszłych potrzeb 6.2. Porównanie najpopularniejszych pluginów 6.2.1. ScriptRunner 6.2.2. Jira Misc Workflow Extensions (JMWE) 6.2.3. JSU Automation Suite for Jira Workflows 6.3. Decyzja i jej konsekwencje 6.4. Utrzymanie rozwiązań w pluginach Rozdział 7. Przegląd sposobów automatyzacji 7.1. Post functions (post funkcje) 7.2. Conditions (warunki) 7.3. Validators (walidatory) 7.4. Operacje cykliczne 7.4.1. ScriptRunner 7.4.2. JMWE 7.5. Skrypty wyzwalane przez listenery 7.5.1. ScriptRunner 7.5.2. JMWE 7.6. Behaviours 7.7. Fragments (fragmenty) 7.8. REST Endpoint 7.9. Aktualizacja system fields i custom fields 7.10. Wykonywanie przejść w workflows 7.11. Integracja Jiry i Confluence 7.12. Integracja Jiry z Insight - Asset Management Część IV. TWORZENIE PLUGINÓW ZA POMOCĄ ATLASSIAN SDK Rozdział 8. Instalacja Atlassian SDK 8.1. Środowisko Windows 8.1.1. Weryfikacja JDK 8.1.2. Instalacja JDK 8.1.3. Instalacja Atlassian SDK 8.2. Środowisko Linux 8.2.1. Instalacja JDK 8.2.2. Instalacja Atlassian SDK 8.3. Praca w Eclipse 8.3.1. Konfiguracja projektu w Eclipse 8.3.2. Konfiguracja projektu w Intellij IDEA Rozdział 9. Generowanie szkieletu projektu 9.1. Tworzenie szkieletu pluginu 9.2. Tworzenie modułów pluginu 9.3. Budowanie paczek za pomocą Mavena i ich instalacja Rozdział 10. Przykłady własnych pluginów i modułów 10.1. Uwagi techniczne 10.1.1. Plik pom.xml 10.1.2. Plik konfiguracyjny atlassian-plugin.xml 10.1.3. Zmiana logo pluginu 10.1.4. Wstrzykiwanie zależności 10.2. Dodatkowy element w menu górnym Jiry 10.3. Post functions (post funkcje) 10.3.1. Wymagania biznesowe 10.3.2. Utworzenie klasy obsługującej skrypt post funkcji 10.3.3. Utworzenie serwisu obsługującego parametry post funkcji 10.3.4. Przygotowanie szablonów Velocity 10.4. Conditions (warunki przejścia) 10.4.1. Wymagania biznesowe 10.4.2. Utworzenie klasy obsługującej skrypt warunku przejścia 10.4.3. Utworzenie serwisu obsługującego parametry warunku przejścia 10.4.4. Przygotowanie szablonów Velocity 10.5. Validators (walidatory) 10.5.1. Wymagania biznesowe 10.5.2. Utworzenie klasy obsługującej skrypt walidatora 10.5.3. Utworzenie serwisu obsługującego parametry walidatora 10.5.4. Przygotowanie szablonów Velocity 10.6. REST Endpoint 10.6.1. Wymagania biznesowe 10.6.2. Utworzenie modelu danych JSON 10.6.3. Utworzenie kontrolera dla REST Endpointu Część V. SYSTEM FIELDS I CUSTOM FIELDS Rozdział 11. Praca z polami 11.1. Sposób wykorzystania system fieldów i custom fieldów 11.2. Dobre praktyki stosowania custom fieldów 11.2.1. Nazewnictwo custom fieldów 11.2.2. Stosowanie kontekstów w custom fieldach 11.2.3. Używanie identyfikatorów custom fieldów zamiast nazw 11.2.4. Dobór odpowiedniego typu custom fieldu Rozdział 12. Dane z system fieldów i custom fieldów 12.1. System fields 12.1.1. Warunki początkowe 12.1.2. Pobieranie wartości 12.2. Text fields i number fields 12.2.1. Warunki początkowe 12.2.2. Pobieranie wartości 12.2.3. Przetwarzanie wartości 12.3. Select list (single choice) 12.3.1. Warunki początkowe 12.3.2. Pobieranie wartości 12.3.3. Przetwarzanie wartości 12.3.4. Dodawanie, usuwanie i dezaktywacja opcji 12.4. Select list (multiple choices) 12.4.1. Warunki początkowe 12.4.2. Pobieranie wartości 12.4.3. Przetwarzanie wartości 12.4.4. Dodawanie, usuwanie i dezaktywacja opcji 12.5. Checkboxes, radio buttons 12.6. Date pickers, date time pickers 12.6.1. Warunki początkowe 12.6.2. Pobieranie wartości 12.6.3. Przetwarzanie wartości 12.7. User pickers i group pickers 12.7.1. Warunki początkowe 12.7.2. Pobieranie wartości 12.7.3. Przetwarzanie wartości 12.8. Scripted fields (pola skryptowe) 12.8.1. Definiowanie scripted fieldów 12.8.2. Text field (multi-line) 12.8.3. Data, data time 12.8.4. Number fields 12.8.5. User picker, group picker Część VI. OPERACJE NA ZGŁOSZENIACH I PROJEKTACH Rozdział 13. Aktualizacja i tworzenie zgłoszeń 13.1. Aktualizacja tasków i sub-tasków 13.1.1. Warunki początkowe 13.1.2. Aktualizacja system fieldów 13.1.3. Aktualizacja pojedynczego custom fieldu w zgłoszeniu 13.1.4. Aktualizacja wielu custom fieldów i system fieldów w zgłoszeniu 13.2. Tworzenie tasków (samodzielnych zgłoszeń) 13.2.1. Tworzenie zgłoszenia z podstawowymi parametrami 13.2.2. Tworzenie zgłoszenia z ustawieniem wartości wybranych custom fieldów 13.3. Tworzenie sub-tasków (podzadań) 13.3.1. Warunki początkowe 13.3.2. Wymagania biznesowe 13.3.3. Utworzenie skryptu realizującego wymagania biznesowe 13.4. Walidacja zgłoszeń 13.4.1. Warunki początkowe 13.4.2. Weryfikacja błędów w trakcie walidacji 13.5. Operacje na załącznikach (attachments) 13.5.1. Warunki początkowe 13.5.2. Pobieranie załączników ze zgłoszenia 13.5.3. Tworzenie załączników w zgłoszeniach Rozdział 14. Linked issues (zgłoszenia powiązane) 14.1. Rodzaje linked issues 14.2. Pobieranie danych 14.2.1. Warunki początkowe 14.2.2. Pobranie danych z linków zgłoszenia 14.2.3. Przetwarzanie danych 14.3. Tworzenie linked issues 14.3.1. Warunki początkowe 14.3.2. Wymagania biznesowe 14.3.3. Realizacja wymagań biznesowych 14.4. Powiązania issues in epic 14.5. Struktury hierarchiczne powyżej trzech poziomów Rozdział 15. Praca z danymi projektu 15.1. Components (komponenty) 15.1.1. Warunki początkowe 15.1.2. Pobieranie danych 15.1.3. Tworzenie i edycja komponentów 15.1.4. Dodawanie zgłoszeń do komponentów 15.2. Versions (wersje) 15.2.1. Warunki początkowe 15.2.2. Pobieranie danych 15.2.3. Tworzenie i edycja wersji 15.2.4. Dodawanie zgłoszeń do wersji 15.3. Project category (kategoria projektu) 15.3.1. Warunki początkowe 15.3.2. Dodanie projektu do kategorii 15.3.3. Utworzenie i edycja kategorii projektu 15.4. Projekty 15.4.1. Warunki początkowe 15.4.2. Tworzenie projektu z domyślną konfiguracją 15.4.3. Klonowanie projektów 15.4.4. Pobieranie danych i edycja projektu Rozdział 16. Automatyzacja przejść w workflow 16.1. Zmienna transientVars 16.2. Wykonanie prostego przejścia 16.2.1. Wykonanie przejścia za pomocą WorkflowTransitionUtil 16.2.2. Wykonanie przejścia za pomocą IssueService 16.3. Złożone przejścia 16.3.1. Wykonanie złożonego przejścia za pomocą WorkflowTransitionUtil 16.3.2. Wykonanie złożonego przejścia za pomocą komponentu IssueService 16.4. Ignorowanie walidatorów i warunków 16.4.1. Ignorowanie warunków w przejściach (WorkflowTransitionUtil) 16.4.2. Ignorowanie warunków w przejściach (IssueService) 16.5. Wykorzystanie danych z transientVars Rozdział 17. ScriptRunner Behaviours 17.1. Pobieranie i ustawianie wartości pól formularza 17.2. Ustawianie wartości różnych typów pól 17.2.1. Select lists, radio buttons, checkboxes 17.2.2. Pickers (pikery) 17.2.3. Date i date time pickers 17.3. Pozostałe operacje z wykorzystaniem Behaviours Część VII. KOMUNIKACJA PRZEZ REST API Rozdział 18. Charakterystyka Jira REST API 18.1. URI zapytania 18.2. Uwierzytelnienie i autoryzacja 18.2.1. Basic authentication 18.2.2. OAuth 18.3. Dokumentacja Jira REST API 18.4. Wykorzystanie Jira REST API w projektach biznesowych Rozdział 19. Operacje przez Jira REST API 19.1. Pobieranie danych przez Jira REST API 19.1.1. Plik CSV z listą zgłoszeń 19.1.2. Zestawienie custom fieldów, które nie występują na screenach 19.1.3. Pobranie użytkowników z danej grupy 19.1.4. Zwrócenie listy zarchiwizowanych projektów 19.2. Tworzenie obiektów w Jirze 19.2.1. Tworzenie zgłoszeń z podstawowymi danymi 19.2.2. Tworzenie zgłoszeń z wartościami custom fieldów 19.2.3. Tworzenie projektów 19.3. Edycja zgłoszeń w Jirze Rozdział 20. Własne REST API 20.1. Utworzenie REST Endpoint 20.2. Strony WWW oparte na REST Endpointach 20.3. Wystawienie danych w postaci obiektu JSON 20.4. Przetworzenie żądania POST Rozdział 21. Komunikacja z Jira REST API przez aplikacje zewnętrzne 21.1. Aplikacje Javy 21.2. JavaScript 21.3. PHP 21.4. Python 21.5. Excel/Power Query 21.5.1. Visual Basic for Application (VBA) 21.5.2. Power Query Część VIII. INTERAKCJA JIRY Z CONFLUENCE Rozdział 22. Operacje na przestrzeniach i stronach 22.1. Połączenie instancji Jiry i Confluence 22.2. Pobieranie zawartości strony 22.3. Tworzenie przestrzeni 22.4. Aktualizacja stron w przestrzeni 22.4.1. Utworzenie przestrzeni z modyfikacją strony głównej 22.4.2. Aktualizacja wybranej strony Confluence 22.5. Tworzenie stron i przestrzeni 22.6. Tworzenie podstron 22.7. Dodanie etykiet (labels) do stron i podstron 22.8. Tworzenie stron z szablonu Rozdział 23. Zarządzanie uprawnieniami do przestrzeni Część IX. INTERAKCJA Z INSIGHT - ASSET MANAGEMENT Rozdział 24. Wprowadzenie do baz Insight - Asset Management 24.1. Tworzenie schematów obiektów (object schemas) 24.1.1. Ustawienia statusów 24.1.2. Ustawienia ról 24.2. Tworzenie typów obiektów 24.3. Object attributes (atrybuty obiektów) 24.4. Atrybuty referencyjne Rozdział 25. Pola Insighta w Jirze 25.1. Typy pól Insighta w Jirze 25.1.1. Insight object/s 25.1.2. Insight referenced object/s 25.1.3. Pozostałe typy custom fieldów 25.2. Obiekty Insighta w Javie/Groovym 25.2.1. Poziom pierwszy - ObjectBean 25.2.2. Poziom drugi - ObjectAttributeBean 25.2.3. Poziom trzeci - ObjectAttributeValueBean 25.3. Pobieranie danych z obiektów Insighta 25.3.1. Warunki początkowe 25.3.2. Pobranie atrybutów typu default z obiektów Insighta 25.3.3. Pobieranie atrybutów typu object 25.4. Aktualizacja wartości custom fieldów typu Insight object/s 25.4.1. Obiekty Insighta pobrane przez identyfikator 25.4.2. Obiekty Insighta wybrane przez zapytanie IQL 25.5. Operacje za pomocą ScriptRunner Behaviours Rozdział 26. Operacje na schematach obiektów Insighta 26.1. Zmiana wartości atrybutu typu default 26.2. Zmiana wartości atrybutu typu object 26.3. Tworzenie obiektów Insighta 26.4. Usuwanie obiektów z bazy Insight