Przejdź do głównej zawartości

Źródła

To trzecia zakładka panelu Zarządzanie Organizacją: jedna tabela ze wszystkimi źródłami danych organizacji, niezależnie od tego, do którego projektu są (albo nie są) przypisane.

Lista źródeł

Kolumny: Nazwa, Źródło danych, Projekt, Interwał, Ostatnie skanowanie, Status, Health Metrics, Operacje.

Pochodzenie źródeł na liście​

Repozytoria kodu pojawiają się na tej liście automatycznie, odkryte podczas skanowania przez konektor podłączony do wtyczki. Źródłem są systemy kontroli wersji Git obsługiwane przez Q247, czyli GitLab, GitHub, Bitbucket, Gitea, Gerrit, Azure DevOps oraz repozytoria dodawane jako Generic GIT. Nie da się ich dodać ręcznie z tego panelu.

Okno Dodaj źródła danych z listą typów źródeł

Źródła dokumentacyjne dodaje się przyciskiem Dodaj źródła, który otwiera okno "Dodaj źródła danych". W polu "Wybierz nazwę źródła" wskazujesz typ, a niżej podajesz jego identyfikator: klucz projektu dla Jiry, klucz przestrzeni dla Confluence, prefiks Area Path dla Azure Boards oraz prefiks ścieżki strony dla Azure Wiki. Nazwa źródła powstaje wtedy automatycznie.

To samo źródło można podpiąć od strony projektu, przyciskiem Przypisz źródło w zakładce Źródła w jego szczegółach. Tamten formularz wygląda inaczej: pole typu nazywa się "Wybierz źródło danych", a przy repozytoriach dochodzi drugie pole wyboru konkretnego repozytorium.

Skanowanie​

Przy repozytorium menu "Operacje" ma akcje tylko w statusie Gotowy albo Operacyjny, a przy statusach Nowy, Oczekujący, Nie działa i Zarchiwizowany jest puste. Dostępne akcje to Rozpocznij skanowanie (przy statusie Gotowy), Przypisz do projektu, przełącznik Health Metrics opisany niżej i Zatrzymaj skanowanie (przy statusie Operacyjny). Gdy repozytorium ma już projekt, akcja przypisania nazywa się Przenieś do projektu i przed zapisem pokazuje okno potwierdzenia, opisane w Projektach.

"Rozpocznij skanowanie" otwiera wybór interwału:

  • Co godzinę
  • Codziennie, z wyborem strefy czasowej, w której ma się odbywać skanowanie

Wybór ogranicza się do tych dwóch opcji; harmonogram w stylu cron jest niedostępny. Kolumna "Ostatnie skanowanie" pokazuje datę ostatniego przebiegu, "Nigdy" dla źródeł jeszcze nieskanowanych.

Zalecany interwał: codziennie

Dla docelowej pracy zalecamy interwał Codziennie. Metryki Q247 opisują dni i tygodnie, więc dobowe odświeżenie w pełni wystarcza, a rzadsze skanowanie oszczędza obciążenie zarówno wtyczki, jak i samego repozytorium.

Interwał godzinowy warto ustawić na czas weryfikacji wdrożenia, żeby nie czekać do następnego dnia na potwierdzenie, że dane spływają, i przełączyć na dzienny po pierwszym udanym przebiegu.

Akcje zbiorcze​

Każdy wiersz tabeli ma po lewej stronie pole wyboru, a pole w nagłówku zaznacza wszystkie wiersze pasujące do aktualnego wyszukiwania i filtrów, nie tylko widoczną stronę tabeli. Zaznaczenie co najmniej dwóch źródeł odsłania nad tabelą pasek z akcjami zbiorczymi.

Zestaw akcji na pasku zależy od zaznaczenia. Dla repozytoriów pasek ma do czterech akcji, a każda pojawia się pod własnym warunkiem:

  • Rozpocznij skanowanie, gdy wśród zaznaczonych jest repozytorium ze statusem Gotowy; działa tylko na takich repozytoriach.
  • Przypisz do projektu, a gdy choć jedno zaznaczone repozytorium ma już projekt, Przenieś do projektu.
  • Wyłącz z Health Metrics albo Włącz do Health Metrics, tylko przy jednolitym zaznaczeniu (warunek niżej).
  • Zatrzymaj skanowanie, gdy wśród zaznaczonych jest repozytorium ze statusem Operacyjny; działa tylko na takich repozytoriach.

Akcje na repozytoriach obejmują tylko repozytoria ze statusem Gotowy albo Operacyjny, również przypisanie i przeniesienie do projektu. Zaznaczone repozytoria w pozostałych statusach pasek pomija, a gdy zaznaczone są wyłącznie takie, nie pokazuje żadnej akcji.

Same źródła dokumentacyjne mają na pasku jedną akcję, Usuń. Przy zaznaczeniu mieszanym, z repozytoriami i źródłami dokumentacyjnymi naraz, wspólnych akcji nie ma, a pasek pokazuje komunikat "Dla wybranych typów źródeł nie ma wspólnych akcji."

Akcje na pasku odpowiadają akcjom z menu "Operacje", z trzema różnicami. Akcja Health Metrics wymaga jednolitego zaznaczenia. Źródła dokumentacyjne mają na pasku tylko Usuń, bez edycji dostępnej w menu. Przeniesienie ma jedno wspólne okno dla całego zaznaczenia, opisane niżej. Ustawienia z okna (interwał i strefa czasowa albo projekt docelowy) stosują się jednakowo do wszystkich zaznaczonych źródeł, a Q247 przetwarza je po kolei.

Okno przeniesienia ma w tytule liczbę przenoszonych repozytoriów i nazwę projektu docelowego ("Przenieś 3 repozytoria do projektu …"). Każde przenoszone repozytorium ma w nim własny panel z projektem, z którego odchodzi, liczbą zdarzeń i uczestników. Wiersz "Łącznie" na końcu podaje zdarzenia i uczestników całej operacji. Przyciski działają jak w oknie pojedynczym: Przenieś zapisuje zmianę, Wstecz wraca do formularza wyboru, a krzyżyk zamyka okno bez zapisu.

Okno przeniesienia trzech repozytoriów do projektu z panelami projektów źródłowych, repozytoriami bez zmian i podsumowaniem

Repozytoria bez projektu i te, które już należą do projektu docelowego, okno wymienia osobno, z dopiskiem "Bez projektu, zostanie przypisane bez zmian w historii." albo "Już przypisane do tego projektu, bez zmian."

Skutki są te same co przy pojedynczym przeniesieniu, opisane w Projektach; historia przenosi się razem ze źródłem. Zaznaczaj więc świadomie, bo zaznaczenie całej listy po nieprecyzyjnym wyszukiwaniu obejmie również źródła, których zmiana nie dotyczy.

Źródła dokumentacyjne synchronizują się w innym rytmie, niezależnym od tego ustawienia, więc kolumna Interwał pokazuje dla nich "N/D".

Wykluczanie repozytoriów z Health Metrics​

Kolumna Health Metrics (nazwa w interfejsie pozostaje angielska) pokazuje, czy dane repozytorium wchodzi do metryk kondycji. Repozytorium ma w niej wartość Włączone albo Wyłączone, a źródło dokumentacyjne "N/D". Podpowiedź w nagłówku wyjaśnia działanie kolumny. Domyślnie żadne repozytorium nie jest wykluczone.

Przełącza się ją z menu "Operacje" przy pojedynczym wierszu albo paskiem akcji zbiorczych, po zaznaczeniu kilku źródeł naraz. Na pasku akcja pojawia się tylko przy jednolitym zaznaczeniu: gdy żadne z zaznaczonych repozytoriów nie jest wykluczone, jest to Wyłącz z Health Metrics, a gdy wykluczone są wszystkie, Włącz do Health Metrics. Przy zaznaczeniu mieszanym żadna z tych dwóch akcji się nie pojawia.

Zasięg wykluczenia​

Wyłączone repozytorium nie dostaje żadnego stanu metryki ani stanu węzła, w żadnym oknie czasowym i w żadnym widoku. Jego dane nie wchodzą ani do licznika, ani do mianownika żadnej z pięciu metryk, na poziomie projektu, zespołu i organizacji. Nie liczy się też do podsumowania liczby węzłów.

Wyłączenie części repozytoriów projektu zostawia go w przeglądzie kondycji, ale jego oceny liczą się już wyłącznie z repozytoriów pozostałych. Projekt, którego wyłączono wszystkie repozytoria, znika z sekcji przeglądu kondycji całkowicie.

Wykluczenie działa wyłącznie na metryki kondycji

Te same commity i pull requesty w tym samym okresie pozostają nietknięte wszędzie indziej: na wykresach, w Obciążeniu pracą, w Adopcji AI, w statystykach projektu i uczestnika, w indeksach dynamiki pracy oraz w Retencji. Do ukrycia pracy w pozostałych metrykach służą wykluczenia wzorców plików i próg widoczności przyrostów.

Zmiana wchodzi w życie od najbliższego przeliczenia i nie wymaga ponownego skanowania repozytorium.

Edycja i usuwanie​

Źródła dokumentacyjne można edytować (zmienić identyfikator źródła, przypisany projekt Q247, status Aktywny/Nieaktywny) albo usunąć wprost z menu "Operacje". Repozytoria odkryte automatycznie edytuje się tylko w zakresie przypisania do projektu, samo źródło zarządzane jest po stronie wtyczki.

Zobacz też​