Tworzenie widżetu analizy dla usługi Azure DevOps

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

Możesz utworzyć własny widżet analizy, który będzie wyświetlany na pulpicie nawigacyjnym w usłudze Azure DevOps. Przykładowy widżet w witrynie GitHub przedstawia następujące elementy:

  • Jak renderować linie trendu skojarzone ze stanami elementów roboczych
  • Jak wykonywać zapytania dotyczące zestawu danych, a 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.

Widok konfiguracji z podglądem widżetu

Uwaga

Usługa Analytics jest automatycznie włączona i obsługiwana w środowisku produkcyjnym dla wszystkich 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 nam 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 Przechowywanie wersji interfejsu API OData.

Uwaga

Usługa Analytics jest automatycznie instalowana i obsługiwana w środowisku produkcyjnym dla wszystkich nowych kolekcji projektów w Azure DevOps Server 2020 r. i nowszych wersjach. 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 nam opinii. W przypadku uaktualnienia z 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 Przechowywanie wersji interfejsu API OData.

Uwaga

Usługa Analytics jest dostępna w wersji zapoznawczej dla Azure DevOps Server 2019 r. Możesz ją włączyć lub zainstalować dla kolekcji projektów. Integracja usługi Power BI i dostęp do źródła danych OData usługi Analytics są dostępne w wersji zapoznawczej. Zachęcamy do korzystania z niego i przekazywania nam 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 Przechowywanie wersji interfejsu API OData.

Wymagania wstępne

Ten przykład zawiera gotowy widżet, który obejmuje podstawy z tematów w pulpitach nawigacyjnych, wykresach i analizach. Poniższe dokumenty zawierają bardziej szczegółowe informacje przedstawione w tym przykładzie:

  1. Tworzenie rozszerzenia widżetu usługi Azure DevOps, odwołanie się do przykładu rozszerzeń widżetów
  2. Renderowanie kontrolki wykresu usługi Azure DevOps, dokumentacja : dodawanie wykresu
  3. Wykonywanie zapytań odata z analizy

Udostępnianie widoku konfiguracji

  1. Uruchamianie prostych zapytań analitycznych wymaganych przez kontrolki interfejsu użytkownika używane do konfigurowania widoku.
  2. Zarządzaj stanem interfejsu użytkownika konfiguracji, aktualizując je na podstawie akcji użytkownika i nowymi danymi z zapytań analitycznych.
  3. Renderowanie interfejsu użytkownika konfiguracji przy użyciu języka Typescript i React.

Renderowanie danych w ramach widżetu

  1. Uruchamianie zapytania skonfigurowanego przez użytkownika jako żądania POST
  2. Interpretowanie danych z analizy w celu renderowania wykresu

Następne kroki

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

  1. Tworzenie pakietów i minimalizowanie zawartości w języku JavaScript — zestaw małych, luźnych plików skryptów w przykładzie może być ładowany znacznie szybciej w połączeniu z pojedynczym plikiem i zmieryfikowany.
  2. Kontrolki interfejsu użytkownika sieci szkieletowej — kontrolki interfejsu użytkownika sieci szkieletowej zapewniają bogaty zestaw składników interfejsu użytkownika konfiguracji dla React.