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

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

Rychlý a efektivní způsob komunikace s uživateli Azure DevOps je prostřednictvím informačních bannerů. Pomocí bannerů můžete uživatelům upozorňovat na nadcházející změny nebo události bez odesílání hromadných e-mailů.

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

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

Nápisy jsou omezeny na délku třiceti slov. Bannery mají prioritu podle úrovně. Pokud jste například publikovali zprávu s upozorněním a informační zprávu, zobrazí se informační zpráva pouze po zavření zprávy upozornění uživatelem nebo odstranění zprávy upozornění.

Požadavky

• Pokud chcete přidat nebo spravovat bannery, musíte být členem skupiny zabezpečení Kolekce projektů Správa istrators. Pokud chcete přidat, přečtěte si téma Změna oprávnění na úrovni organizace nebo kolekce.
• Pokud chcete spravovat bannery pomocí rozšíření Banner Nastavení, musíte ho nejdřív nainstalovat. Viz Banner Nastavení a instalace rozšíření
• Pokud chcete spravovat bannery pomocí příkazového řádku, musíte nainstalovat rozšíření Azure DevOps CLI, jak je popsáno v tématu Začínáme s 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í Banner Nastavení

Rozšíření Banner Nastavení 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
• Do bannerů můžete zahrnout hypertextové odkazy 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ů

1. Pokud nejsou definovány žádné bannery, zvolte Vytvořit nový banner.

   

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

   

3. Zvolte Uložit a uložte provedené změny.

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 na maximálně třicet 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": "2019-09-04T07:00:00+00:00",
    "level": "info",
    "message": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce ac lectus eget erat porttitor dapibus vulputate in ipsum. Etiam id faucibus nisi, at ornare tellus. Curabitur faucibus pharetra orci, id finibus leo iaculis et. Morbi nec felis facilisis, ultricies magna nec, convallis sem. Sed pharetra porta mi eu venenatis. Cras consectetur et dui a accumsan. Maecenas non dolor eu lacus mollis pulvinar. Fusce gravida id lacus sed consequat. Cras tempus ante tincidunt purus rhoncus, at consectetur tellus sollicitudin. Proin sed tellus vel libero maximus ornare. Nullam facilisis, nibh sit amet faucibus rutrum, diam massa ullamcorper purus, sed tempor est erat in sapien. Sed sit amet lectus vel massa facilisis interdum id sit amet nisi. Vestibulum eu purus et mi ultricies consequat. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum fermentum mattis rutrum. Nulla hendrerit nibh ut sapien viverra faucibus."
  }
}

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. Etiam id faucibus nisi, at ornare tellus. Curabitur faucibus pharetra orci, id finibus leo iaculis et. Morbi nec felis facilisis, ultricies magna nec, convallis sem. Sed pharetra porta mi eu venenatis. Cras consectetur et dui a accumsan. Maecenas non dolor eu lacus mollis pulvinar. Fusce gravida id lacus sed consequat. Cras tempus ante tincidunt purus rhoncus, at consectetur tellus sollicitudin. Proin sed tellus vel libero maximus ornare. Nullam facilisis, nibh sit amet faucibus rutrum, diam massa ullamcorper purus, sed tempor est erat in sapien. Sed sit amet lectus vel massa facilisis interdum id sit amet nisi. Vestibulum eu purus et mi ultricies consequat. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum fermentum mattis rutrum. Nulla hendrerit nibh ut sapien viverra faucibus.   " --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. Fusce ac lectus eget erat porttitor dapibus vulputate in ipsum. Etiam id faucibus nisi, at ornare tellus. Curabitur faucibus pharetra orci, id finibus leo iaculis et. Morbi nec felis facilisis, ultricies magna nec, convallis sem. Sed pharetra porta mi eu venenatis. Cras consectetur et dui a accumsan. Maecenas non dolor eu lacus mollis pulvinar. Fusce gravida id lacus sed consequat. Cras tempus ante tincidunt purus rhoncus, at consectetur tellus sollicitudin. Proin sed tellus vel libero maximus ornare. Nullam facilisis, nibh sit amet faucibus rutrum, diam massa ullamcorper purus, sed tempor est erat in sapien. Sed sit amet lectus vel massa facilisis interdum id sit amet nisi. Vestibulum eu purus et mi ultricies consequat. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum fermentum mattis rutrum. Nulla hendrerit nibh ut sapien viverra faucibus.   "
  }
}

Související články

• Začínáme se správou organizace nebo kolekce projektů
• O projektech a škálování organizace
• Začínáme s Azure DevOps CLI
• az devops admin banner commands