Udostępnij za pośrednictwem


Tworzenie widżetu analizy dla usługi Azure DevOps

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Możesz utworzyć własny widżet do analiz, który będzie wyświetlany na desce rozdzielczej w usłudze Azure DevOps. Przykładowy widżet na GitHubie pokazuje:

  • Jak renderować linie trendu skojarzone ze stanami elementów roboczych
  • Jak wykonywać zapytania dotyczące zestawu danych, użytkownik skonfiguruje go za pomocą widoku konfiguracji widżetu
  • Jak skompilować i opublikować widżet w witrynie Azure DevOps Marketplace

Dzięki tym informacjom będziesz mieć możliwość utworzenia własnego widżetu analizy.

#B0 #A1 Podgląd widoku konfiguracji z podglądem widżetu #A2 #C3

Uwaga

Usługa Analytics jest automatycznie włączona i obsługiwana w środowisku produkcyjnym dla wszystkich usług Azure DevOps Services. Integracja usługi Power BI i dostęp do źródła danych OData usługi Analytics są ogólnie dostępne. Zachęcamy do korzystania z niego i przekazywania opinii. Dostępne dane są zależne od wersji. Najnowsza obsługiwana wersja to v2.0, a najnowsza wersja zapoznawcza to v4.0-preview. Aby uzyskać więcej informacji, zobacz Wersjonowanie interfejsu API OData.

Uwaga

Usługa Analytics jest automatycznie instalowana i obsługiwana w środowisku produkcyjnym dla wszystkich nowych kolekcji projektów dla usługi Azure DevOps Server 2020 i nowszych wersji. Integracja usługi Power BI i dostęp do źródła danych OData usługi Analytics są ogólnie dostępne. Zachęcamy do korzystania z niego i przekazywania opinii. W przypadku uaktualnienia z usługi Azure DevOps Server 2019 możesz zainstalować usługę Analytics podczas uaktualniania.

Dostępne dane są zależne od wersji. Najnowsza obsługiwana wersja to v2.0, a najnowsza wersja zapoznawcza to v4.0-preview. Aby uzyskać więcej informacji, zobacz Wersjonowanie interfejsu API OData.

Wymagania wstępne

Kategoria Wymagania
Poziomy dostępu - członek projektu.
— Co najmniej podstawowy dostęp.
uprawnienia Domyślnie członkowie projektu mają uprawnienia do wykonywania zapytań w usłudze Analytics i tworzenia widoków. Aby uzyskać więcej informacji na temat innych wymagań wstępnych dotyczących włączania usługi i funkcji oraz ogólnych działań śledzenia danych, zobacz Uprawnienia i wymagania wstępne dotyczące uzyskiwania dostępu do usługi Analytics.

Przykład w tym artykule zawiera gotowy widżet, który obejmuje podstawowe informacje z tematów na temat pulpitów nawigacyjnych, wykresów i analiz. Poniższe dokumenty zawierają bardziej szczegółowe informacje przedstawione w tym przykładzie:

  1. Stwórz rozszerzenie widżetu usługi Azure DevOps, zapoznaj się z przykładem rozszerzeń widżetu #B0 #C1
  2. Renderuj kontrolkę wykresu usługi Azure DevOps, zobacz sekcję Dodawanie wykresu
  3. Wykonywanie zapytań OData z Analytics

Udostępnianie widoku konfiguracji

  1. Uruchom proste zapytania analityczne wymagane przez kontrolki interfejsu użytkownika służące do konfigurowania widoku.
  2. Zarządzanie stanem interfejsu użytkownika konfiguracji, aktualizowane na podstawie akcji użytkownika oraz nowych danych z zapytań analitycznych.
  3. Renderuj interfejs użytkownika konfiguracji przy użyciu języka TypeScript i React.

Renderowanie danych w ramach widżetu

  1. Uruchom skonfigurowane przez użytkownika zapytanie jako żądanie POST.
  2. Interpretowanie danych analitycznych do wygenerowania wykresu

Następne kroki

Aby uniknąć nadmiernej złożoności w przykładzie, pominięto pewne technologie i praktyki, które z pewnością powinien zawierać widżet produkcyjny. Przykład ui-fabric-react na GitHubie wyróżnia proces kompilacji, który wykorzystuje te szczegóły.

  1. Tworzenie pakietów i minimalizacja zawartości w JavaScript — zestaw małych, luźnych plików skryptów w przykładzie może ładować się znacznie szybciej po połączeniu w jeden plik i zminimalizowaniu.
  2. Kontrolki Fabric UI — Kontrolki Fabric UI zapewniają bogaty zestaw składników konfiguracji interfejsu użytkownika dla platformy React.