Vytvoření widgetu Analytics pro Azure DevOps

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Můžete vytvořit vlastní widget Analytics, který se bude zobrazovat na řídicím panelu v Azure DevOps. Ukázkový widget na GitHubu ukazuje:

  • Jak vykreslit spojnice trendu přidružené ke stavům pracovní položky
  • Dotazování datové sady, pokud uživatel nakonfiguruje zobrazení konfigurace widgetu
  • Postup sestavení a publikování widgetu na marketplace Azure DevOps

Pomocí těchto informací si budete moct vytvořit vlastní widget Analytics.

Zobrazení konfigurace s náhledem widgetu

Poznámka

Služba Analytics je automaticky povolená a podporovaná v produkčním prostředí pro všechny Azure DevOps Services. Integrace Power BI a přístup k datovému kanálu OData ve službě Analytics jsou obecně dostupné. Doporučujeme, abyste ho použili a poskytli nám zpětnou vazbu. Dostupná data závisí na verzi. Nejnovější podporovaná verze je v2.0a nejnovější verze Preview je v4.0-preview. Další informace najdete v tématu Správa verzí rozhraní API OData.

Poznámka

Služba Analytics se automaticky nainstaluje a podporuje v produkčním prostředí pro všechny nové kolekce projektů pro Azure DevOps Server 2020 a novější verze. Integrace Power BI a přístup k datovému kanálu OData ve službě Analytics jsou obecně dostupné. Doporučujeme, abyste ho použili a poskytli nám zpětnou vazbu. Pokud jste upgradovali z Azure DevOps Server 2019, můžete během upgradu nainstalovat službu Analytics.

Dostupná data závisí na verzi. Nejnovější podporovaná verze je v2.0a nejnovější verze Preview je v4.0-preview. Další informace najdete v tématu Správa verzí rozhraní API OData.

Poznámka

Služba Analytics je ve verzi Preview pro Azure DevOps Server 2019. Můžete ho povolit nebo nainstalovat pro kolekci projektů. Integrace Power BI a přístup k datovému kanálu OData ve službě Analytics jsou ve verzi Preview. Doporučujeme, abyste ho použili a poskytli nám zpětnou vazbu.

Dostupná data závisí na verzi. Nejnovější podporovaná verze je v2.0a nejnovější verze Preview je v4.0-preview. Další informace najdete v tématu Správa verzí rozhraní API OData.

Požadavky

Tento příklad obsahuje předdefinovaný widget, který pokrývá základní informace o tématech z řídicích panelů, grafů a analýz. Následující dokumenty poskytují podrobnější informace o podrobnostech uvedených v tomto příkladu:

  1. Vytvoření rozšíření widgetu Azure DevOps, odkaz na ukázku rozšíření widgetu
  2. Vykreslení ovládacího prvku grafu Azure DevOps, referenční informace o přidání grafu
  3. Dotazování OData z Analýzy

Poskytnutí zobrazení konfigurace

  1. Spouštění jednoduchých analytických dotazů vyžadovaných ovládacími prvky uživatelského rozhraní, které slouží ke konfiguraci zobrazení.
  2. Umožňuje spravovat stav uživatelského rozhraní konfigurace s aktualizacemi na základě akcí uživatelů a s novými daty z analytických dotazů.
  3. Vykreslovat uživatelské rozhraní konfigurace pomocí TypeScriptu a React.

Vykreslení dat ve widgetu

  1. Spuštění uživatelem nakonfigurovaného dotazu jako požadavku POST
  2. Interpretace dat z analýz za účelem vykreslení grafu

Další kroky

Abychom se vyhnuli nadměrné složitosti vzorku, vynechali jsme některé technologie a postupy, které by produkční widget měl určitě zahrnovat. Ukázka ui-fabric-react na GitHubu zvýrazňuje proces sestavení, který tyto podrobnosti procvičuje.

  1. Sdružování JavaScriptu a minifikace obsahu – Sada malých, volných skriptových souborů v ukázce se může načíst mnohem rychleji, když se zkombinuje do jednoho souboru a ztěžuje.
  2. Ovládací prvky uživatelského rozhraní prostředků infrastruktury – Ovládací prvky uživatelského rozhraní infrastruktury poskytují bohatou sadu komponent uživatelského rozhraní konfigurace pro React.