Információs szalagcímek hozzáadása és kezelése az Azure Devopsban

  • Cikk

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

Az Azure DevOps-felhasználókkal való kommunikáció gyors és hatékony módja az információs szalagcímek használata. Szalagcímek használatával tömeges e-mailek küldése nélkül figyelmeztetheti a felhasználókat a közelgő változásokra vagy eseményekre.

A transzparensek három típusának egyikét adhatja meg: hiba, információ és figyelmeztetés. Egyszerre csak egy szalagcím jelenik meg, az utolsó hozzáadott vagy frissített szalagcím. A szalagcímek a lejárati dátumukig érvényben maradnak.

Az alábbi képen egy információs üzenet jelenik meg. A felhasználók a Bezárás gombra kattintva mondhatják le az üzenetet.

Information banner

A transzparensek legfeljebb harminc szó hosszúságúak. A transzparenseket szint szerint rangsorolja a rendszer. Ha például figyelmeztető üzenetet és információs üzenetet tett közzé, az információs üzenet csak akkor jelenik meg, ha egy felhasználó bezárja a figyelmeztető üzenetet, vagy törli a figyelmeztető üzenetet.

Előfeltételek

  • Szalagcímek hozzáadásához vagy kezeléséhez a Project Collection Rendszergazda istrators biztonsági csoport tagjának kell lennie. A hozzáadáshoz lásd : Engedélyek módosítása a szervezet vagy a gyűjtemény szintjén.
  • Ahhoz, hogy transzparenseket kezelhesse a Banner Gépház bővítmény használatával, először telepítenie kell. A Szalagcím Gépház és bővítmények telepítése
  • A szalagcímek parancssori használatával történő kezeléséhez telepítenie kell az Azure DevOps CLI-bővítményt az Azure DevOps parancssori felület használatának első lépéseiben leírtak szerint.
    • Jelentkezzen be az Azure DevOpsba a .az login
    • A cikkben szereplő példákhoz állítsa be az alapértelmezett szervezetet a következővel az devops configure --defaults organization=YourOrganizationURL: .

Szalagcímek kezelése a Banner Gépház bővítmény használatával

A Szalagcím Gépház bővítmény a Szervezeti Gépház alatt egy beállításpanelt biztosít a webhelyszintű szalagcímek hozzáadásához és kezeléséhez. A bővítmény a következő funkciókat támogatja:

A Szalagcím Gépház bővítmény a Gyűjtemény Gépház alatt egy beállításpanelt biztosít a webhelyszintű szalagcímek hozzáadásához és kezeléséhez. A bővítmény a következő funkciókat támogatja:

  • Szalagcímek megjelenítése bármely oldalon az Azure DevOpsban
  • Válasszon az üzenetek három szintje közül: Információ, Figyelmeztetés és Hiba
  • Üzenet lejárati dátumának kiválasztása
  • Hivatkozások belefoglalása szalagcímekbe markdown szintaxissal.

Szervezeti beállítások megnyitása

Szalagcím hozzáadásához vagy törléséhez nyissa meg a Szervezeti beállításokat, görgessen le a Bővítmények szakaszhoz, és válassza a Szalagcím lehetőséget.

A szervezeti beállítások az összes projekt erőforrásait konfigurálják a teljes szervezet számára. Az összes szervezeti beállítás áttekintéséhez tekintse meg a Projektgyűjtemény rendszergazdai szerepkörét és a projektgyűjtemények kezelését.

  1. Válassza az Azure DevOps emblémát a Projektek megnyitásához, majd válassza a Szervezeti beállítások lehetőséget.

    Open Organization settings

Rendszergazda beállításainak megnyitása

Szalagcím hozzáadásához vagy törléséhez nyissa meg Rendszergazda beállításait, görgessen le a Bővítmények szakaszhoz, és válassza a Szalagcím lehetőséget.

Rendszergazda beállítások a projektgyűjtemény összes projektje számára konfigurálják az erőforrásokat. Az összes gyűjteménybeállítás áttekintéséhez tekintse meg a Projektgyűjtemény rendszergazdai szerepkörét és a projektek gyűjteményeinek kezelését ismertető témakört.

  1. Válassza az Azure DevOps emblémát a Gyűjtemények megnyitásához, majd válassza Rendszergazda beállításokat.

    Open Admin settings

Szalagcímek hozzáadása és kezelése

  1. Ha nincs definiálva transzparens, válassza az Új szalagcím létrehozása lehetőséget.

    Create first banner, on-premises

    Create first banner, on-premises

  2. Írja be a szalagcím szövegét a szövegmezőbe. Az üzenetszint módosításához és a lejárati dátum beállításához válassza a Továbbiak szerkesztése lehetőséget.

    Add test banner message

  3. A módosítások mentéséhez válassza a Mentés lehetőséget.

Az Azure CLI felügyeleti szalagcímparancsai

Parancs Leírás
az devops admin banner add Adjon hozzá egy új szalagcímet, és azonnal megjelenítse.
az devops admin banner list Szalagcímek listázása.
az devops admin banner remove Szalagcím eltávolítása.
az devops admin banner show Szalagcím részleteinek megjelenítése.
az devops admin banner update Frissítse a szalagcím üzenetét, szintjét vagy lejárati dátumát.

Az alábbi paraméterek nem kötelezőek az összes parancshoz, és nem szerepelnek a cikkben ismertetett példákban.

  • észlelés: Automatikusan észleli a szervezetet. Elfogadott értékek: hamis, igaz. Alapértelmezett érték: true (igaz).
  • org: Azure DevOps-szervezet URL-címe. Az alapértelmezett szervezetet az az devops configure -d organization=ORG_URL használatával konfigurálhatja. Kötelező, ha nincs alapértelmezettként konfigurálva, vagy git-konfiguráción keresztül veszi fel. Példa: --org https://dev.azure.com/MyOrganizationName/.

Szalagcím hozzáadása

Szalagcím hozzáadásához írja be a az devops admin banner add parancsot.

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

Parameters

  • üzenet: Kötelező. A megjelenítendő szalagcímüzenetet meghatározó szöveges sztring. A szöveges sztringek legfeljebb harminc szót tartalmazhatnak.

    Az üzenet HTML formátumú<a href='https://example.org'>Link text</a> () hivatkozásokat tartalmazhat. Az URL-címben ( például a lekérdezési sztringben) szereplő ampereket xml entitásformátumban (&amp;) kell megszűrni.

  • lejárat: Nem kötelező. Az a dátum/idő, amikor a szalagcím már nem jelenik meg a felhasználók számára. Például: "2019-06-10 17:21:00 UTC", "2019-06-10".

  • Azonosító: Nem kötelező. A frissíteni kívánt szalagcím azonosítója. Ez az azonosító az üzenet későbbi módosításához vagy eltávolításához szükséges. A rendszer automatikusan létrehoz egy egyedi azonosítót, ha nincs megadva.

  • Típus: Nem kötelező. Megjelenítendő szalagcím típusa. Érvényes értékek: hiba, információ, figyelmeztetés. Az alapértelmezett érték az információ.

Példa

Az alábbi parancs például hozzáad egy információs szalagcímet, amely 2019. szeptember 4-én lejár. Ha nincs megadva azonosító, a rendszer automatikusan hozzárendel egy egyedi azonosítót.

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"
  }
}

Szalagcímek listázása

A definiált szalagcímek meghatározásához írja be a az devops admin banner list parancsot.

az devops admin banner list

Példa: Alapértelmezett json-kimenet

Ha nem adja meg a kimenetet, a lista json formátumban jelenik meg. További kimeneti formátumbeállításokért tekintse meg az Azure CLI-parancsok kimeneti formátumait.

A következő parancs például azt jelzi, hogy két transzparens van definiálva.

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élda: Táblakimenet

Ha táblázatformátumban szeretné listázni a szalagcímeket, használja a --output table parancsbeállítást.

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.

Szalagcím eltávolítása

Szalagcím törléséhez használja a az devops admin banner remove parancsot. Adja meg a szalagcím azonosítóját, amelyet a szalagcímek listázásával találhat meg.

az devops admin banner remove --id

Parameters

  • Azonosító: Kötelező. Az eltávolítandó szalagcím azonosítója.

Példa

A következő parancs például eltávolítja a szalagcímet a következővel id=e090e7b0-4499-4b8f-a09b-1eddf7fdeb44: A rendszer nem ad vissza választ.

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

Szalagcím részleteinek listázása

Egyetlen szalagcím adatainak listázásához használja a az devops admin banner show parancsot. Adja meg a szalagcím azonosítóját, amelyet a szalagcímek listázásával találhat meg.

az devops admin banner show --id

Parameters

  • Azonosító: Kötelező. A transzparens azonosítója a részletek listázásához.

Példa

Itt felsoroljuk a transzparens részleteit a következővel 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."
  }
}

Szalagcím frissítése

A parancs használatával módosíthatja egy szalagcím üzenetét, típusát és lejáratát az devops admin banner update .

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

Parameters

  • Azonosító: Kötelező. A frissíteni kívánt szalagcím azonosítója.
  • lejárat: Nem kötelező. Az a dátum/idő, amikor a szalagcím már nem jelenik meg a felhasználók számára. A szalagcím lejáratának feloldásához adjon meg egy üres értéket ennek az argumentumnak, például: "2019-06-10 17:21:00 UTC", "2019-06-10".
  • üzenet: A megjelenítendő szalagcímüzenetet meghatározó szöveges sztring.
  • Típus: Nem kötelező. Megjelenítendő szalagcím típusa. Érvényes értékek: hiba, információ, figyelmeztetés. Az alapértelmezett érték az információ.

Példa

Az alábbi parancs például frissíti a szalagcím üzenetsztringét, és az év végéig frissíti a lejárati dátumot.

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.   "
  }
}