Přidání a správa informačních bannerů v Azure DevOps

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

Pomocí informačních bannerů můžete rychle a efektivně komunikovat s uživateli Azure DevOps. Upozorňování uživatelů na nadcházející změny nebo události bez odesílání hromadných e-mailů

Zadejte jeden ze tří typů bannerů: chybu, informace nebo upozornění. Najednou se zobrazí jenom poslední přidaný nebo aktualizovaný banner. Bannery zůstávají platné až do data vypršení platnosti.

Následující obrázek ukazuje informační zprávu. Uživatelé mohou zprávu zrušit výběrem možnosti Zavřít .

Bannery omezujeme na 30 slov, upřednostňujeme je podle úrovně. Pokud tedy publikujete zprávu s upozorněním a informační zprávu, zobrazí se informační zpráva pouze po zavření uživatele nebo odstranění zprávy upozornění.

Požadavky

• Oprávnění: Být členem skupiny Správci kolekce projektů.
• Úrovně přístupu:
  • Nainstalujte rozšíření Banner Settings marketplace. Další informace naleznete v tématu Instalace rozšíření.
  • Nainstalujte rozšíření Azure DevOps CLI.
    • Přihlaste se k Azure DevOps pomocí az login.
    • V příkladech v tomto článku nastavte výchozí organizaci pomocí az devops configure --defaults organization=YourOrganizationURL.

Správa bannerů pomocí rozšíření Nastavení banneru

Rozšíření Nastavení banneru poskytuje podokno nastavení v části Nastavení organizace pro přidání a správu bannerů pro celou organizaci. Rozšíření podporuje následující funkce:

• Zobrazení bannerů na libovolné stránce v Azure DevOps
• Volba mezi třemi úrovněmi zpráv: Informace, Upozornění a Chyba
• Volba data vypršení platnosti zprávy
• Zahrnutí hypertextových odkazů do bannerů pomocí syntaxe markdownu

Otevřít nastavení organizace

Pokud chcete přidat nebo odstranit banner, otevřete nastavení organizace, posuňte se dolů do oddílu Rozšíření a zvolte Banner.

Nastavení organizace konfiguruje zdroje pro všechny projekty v uvedeném pořadí pro celou organizaci. Přehled všech nastavení organizace najdete v tématu Role správce kolekce Projectu a správa kolekcí projektů.

1. Pokud chcete otevřít projekty, zvolte logo Azure DevOps a pak zvolte Nastavení organizace.

   

Přidání a správa bannerů

Webový portál

1. Pokud nejsou definované žádné bannery, vyberte Vytvořit nový banner. V opačném případě vyberte Upravit další banner a přejděte ke kroku 3.

   

2. Do textového pole zadejte text banneru. Pokud chcete změnit úroveň zprávy a nastavit datum vypršení platnosti, vyberte Upravit více .

   

3. Uloží změny.

4. (Volitelné) Odstraňte všechny bannery nebo výběrem ikony koše odstraňte konkrétní banner.

Azure CLI

Bannerové příkazy správce Azure CLI

Příkaz	Popis
az devops admin banner add	Přidejte nový banner a okamžitě ho zobrazte.
az devops admin banner list	Seznam bannerů
az devops admin banner remove	Odeberte banner.
az devops admin banner show	Zobrazení podrobností pro banner
az devops admin banner update	Aktualizujte zprávu, úroveň nebo datum vypršení platnosti banneru.

Následující parametry jsou volitelné pro všechny příkazy a nejsou uvedené v příkladech uvedených v tomto článku.

• detect: Automaticky rozpozná organizaci. Přijaté hodnoty: false, true. Výchozí hodnota je true.
• org: Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: --org https://dev.azure.com/MyOrganizationName/.

Přidání banneru

Pokud chcete přidat banner, zadejte az devops admin banner add příkaz.

az devops admin banner add --message
                           [--expiration]
                           [--id]
                           [--type {error, info, warning}]

Parametry

• zpráva: Povinné. Textový řetězec, který určuje zprávu banneru, která se má zobrazit. Textové řetězce jsou omezeny maximálně na 30 slov.

  Zpráva může obsahovat odkazy ve formátu HTML (<a href='https://example.org'>Link text</a>). Všechny ampersandy v adrese URL, například v řetězci dotazu, musí být uchvácené ve formátu entity XML (&).

• vypršení platnosti: Volitelné. Datum a čas, kdy by se banner neměl uživatelům zobrazovat. Například "2019-06-10 17:21:00 UTC", "2019-06-10".

• ID: Volitelné. ID banneru, který chcete aktualizovat. Tento identifikátor je potřeba později změnit nebo odebrat zprávu. Jedinečný identifikátor se vytvoří automaticky, pokud není zadaný.

• type: Volitelné. Typ banneru, který se má zobrazit. Platné hodnoty: chyba, informace, upozornění. Výchozí hodnota je informace.

Příklad

Například následující příkaz přidá informační banner, jehož platnost vyprší 4. září 2019. Pokud není zadané ID, automaticky se přiřadí jedinečné ID.

az devops admin banner add --message "INFORMATION: Network domain updates will occur on September 3. <a href='https://example.org?page=network-updates&amp;anchor=september-3-2019'>More information</a>" --expiration  2019-09-04 --type  info
{
  "3d584103-6a94-4f46-8696-f424278da072": {
    "expirationDate": "2019-09-04T00:00:00-07:00",
    "level": "info",
    "message": "INFORMATION: Network domain updates will occur on September 3"
  }
}

Seznam bannerů

Pokud chcete určit, které bannery jsou definované, zadejte az devops admin banner list příkaz.

az devops admin banner list 

Příklad: Výchozí výstup JSON

Pokud nezadáte výstup, zobrazí se seznam ve formátu JSON. Další možnosti výstupního formátu najdete v tématu Formáty výstupu pro příkazy Azure CLI.

Například následující příkaz indikuje, že jsou definovány dva bannery.

az devops admin banner list
{
  "04c4d27f-1fee-4f23-9c44-57ed6a9efef8": {
    "level": "info",
    "message": "BANNER-MESSAGE-BANNER-MESSAGE"
  },
  "27f016aa-be13-4e3b-a1da-8b98d239e074": {
    "level": "warning",
    "message": "WARNING - This is a test warning message."
  }
}

Příklad: Výstup tabulky

Pokud chcete zobrazit seznam bannerů ve formátu tabulky, použijte --output table možnost příkazu.

az devops admin banner list 
ID                                    Message                            Type     Expiration Date
------------------------------------  ---------------------------------  -------  -----------------
04c4d27f-1fee-4f23-9c44-57ed6a9efef8  BANNER-MESSAGE-BANNER-MESSAGE      Info
27f016aa-be13-4e3b-a1da-8b98d239e074  WARNING - This is a test warning message. 

Odebrání banneru

Pokud chcete odstranit banner, použijte příkaz az devops admin banner remove . Zadejte ID banneru, které můžete najít výpisem bannerů.

az devops admin banner remove --id

Parametry

• ID: Povinné. ID banneru, který chcete odebrat.

Příklad

Například následující příkaz odebere banner s id=e090e7b0-4499-4b8f-a09b-1eddf7fdeb44. Nevrátí se žádná odpověď.

az devops admin banner remove --id e090e7b0-4499-4b8f-a09b-1eddf7fdeb44

Podrobnosti banneru seznamu

Pokud chcete zobrazit seznam informací o jednom banneru, použijte az devops admin banner show příkaz. Zadejte ID banneru, které můžete najít výpisem bannerů.

az devops admin banner show --id

Parametry

• ID: Povinné. ID banneru pro zobrazení podrobností seznamu

Příklad

Zde uvádíme podrobnosti pro banner s id=7653f414-3c01-424f-8f84-e51aa99b797c.

az devops admin banner show --id 7653f414-3c01-424f-8f84-e51aa99b797c
{
  "7653f414-3c01-424f-8f84-e51aa99b797c": {
    "expirationDate": "2024-09-04T07:00:00+00:00",
    "level": "info",
    "message": "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
  }
}

Aktualizace banneru

Pomocí příkazu můžete změnit zprávu, typ a vypršení platnosti banneru az devops admin banner update .

az devops admin banner update --id
                              [--expiration]
                              [--message]
                              [--type {error, info, warning}]

Parametry

• ID: Povinné. ID banneru, který chcete aktualizovat.
• vypršení platnosti: Volitelné. Datum a čas, kdy by se banner neměl uživatelům zobrazovat. Pokud chcete zrušit vypršení platnosti banneru, zadejte do tohoto argumentu prázdnou hodnotu, například "2019-06-10 17:21:00 UTC", "2019-06-10".
• message: Textový řetězec, který určuje zprávu banneru, která se má zobrazit.
• type: Volitelné. Typ banneru, který se má zobrazit. Platné hodnoty: chyba, informace, upozornění. Výchozí hodnota je informace.

Příklad

Například následující příkaz aktualizuje řetězec zprávy pro banner a aktualizuje datum vypršení platnosti na konec roku.

az devops admin banner update --id 7653f414-3c01-424f-8f84-e51aa99b797c --message "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce ac lectus eget erat porttitor dapibus vulputate in ipsum.." --expiration  2019-12-31
{
  "7653f414-3c01-424f-8f84-e51aa99b797c": {
    "expirationDate": "2019-12-31T00:00:00-08:00",
    "level": "info",
    "message": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.."
  }
}

Související články

• Začínáme se správou organizace nebo kolekce projektů
• Informace o projektech a škálování organizace
• Začínáme s Azure DevOps CLI
• Použití příkazů banneru az devops admin