Přeskočit na hlavní obsah

Azure DevOps Connector

Tento konektor integruje Alvao s Azure DevOps a usnadňuje správu požadavků a komunikaci.

Mezi klíčové funkce patří:

  • Pro bezproblémový pracovní postup vytvořte pracovní položky Azure DevOps přímo z Alvao.
  • Zajistěte konzistentní stavy požadavku s automatickou obousměrnou synchronizací.
  • Synchronizovat zprávy a přílohy mezi oběma platformami pro účinnou spolupráci.
  • Pro rychlou a snadnou navigaci získejte přístup k pracovním položkám Azure DevOps přímo z Alvao.

Ukázkový proces:

Stav Vývoj požadavku je v tomto příkladu namapován na stav pracovní položky K provedení v Azure DevOps. Když požadavek v Alvao přejde do tohoto stavu, pracovní položka definovaného typu se vytvoří v Azure DevOps. Když pracovní položka vstoupí do stavu Vykonává se, požadavek se automaticky přehodí na stav Vývoj pozastaven. Po vyřešení pracovního položky (stav Done) se požadavek v Alvao převede na stav Testing.

Technické požadavky​

SaaS​

  • ALVAO ITSM nebo Service Desk předplatné

Instalace v on-prem prostředí​

  • ALVAO Service Desk
  • Uživatelská autentizace pomocí Microsoft Entra ID
  • Alvao REST API dostupné z internetu

Instalace​

Pro instalaci jsou vyžadována práva správce.

  1. Stáhněte si balíček AzureDevOpsConnector.zip.

  2. Ve Správě - Service Desk - Služby vyberte složku, do které chcete importovat ukázkovou službu k připojení k Azure DevOps, a použijte příkaz Import k načtení souboru AzureDevOpsConnectorServiceEnu.xml, který je obsažen v souboru AzureDevOpsConnector.zip.

  3. Přejděte do Správa – Aplikace, vyberte aplikaci Azure DevOps Connector a povolte ji pomocí příkazu Povolit.

    Manuální stažení: AzureDevOpsConnectorApp.xml

Azure DevOps osobní přístupový token​

  1. V Azure DevOps vytvořte osobní přístupový token (PAT) s oprávněními Pracovní položky - Číst a psát, Uživatel - Profil - Číst, Pracovní položky – Číst a psát.
  2. Přejděte na stránku Administration - Nastavení - Pokročilé. Použijte příkaz Nové nastavení k vytvoření nastavení DevOpsIntegrationToken0. Zadejte PAT token z Azure DevOps jako hodnotu nastavení.
Tip

Pokud například potřebujete do systému Alvao integrovat Azure DevOps z různých organizací, můžete použít více přístupových tokenů. Vytvořte nové nastavení a zvyšte číslo na konci názvu nastavení. Pak použijte toto číslo v položce AccessToken v níže uvedeném nastavení služby.

Nastavení Azure DevOps​

  1. V Azure DevOps v daném projektu použijte Nastavení projektu - Servisní háčky - Vytvořit předplatné.
  2. Vyberte Web Hooks jako typ služby a stiskněte Další.
  3. Pod Spouštěč na tento typ události, vyberte Pracovní položka aktualizována.
  4. V **Pole **, vyberte možnost Stav. Stiskněte tlačítko Další.
  5. Do pole URL zadejte adresu URL aplikace AlvaoRestApi následovanou cestou "/Connectors/DevOpsCallback", např.: https://contoso.alvao.com/AlvaoRestApi/Connectors/DevOpsCallback
  6. V části Zprávy k odeslání vyberte Žádné.
  7. V položce Podrobné zprávy k odeslání také vyberte Žádné a stiskněte Dokončit.

Nastavení služby v Alvao​

  1. Ve Správa - Service Desk - Služby, vyberte službu, kterou chcete připojit k Azure DevOps, a použijte Upravit - Vlastnosti.

  2. V sekci Other najděte vlastní pole Externí aplikace - Nastavení konektoru a upravte jeho hodnotu.

    Výchozí hodnota:

{
    "ConnectorType": "AzureDevOps",
    "URL": "https://dev.azure.com/Alvao/Alvaoproject",
    "AccessToken": "0",
    "AttributeMap": {
        "System.Title": "[$TicketTitle$]",
        "System.Description": "[$LatestImportantMessage$]",
        "System.WorkItemType": "Task"
    },
    "StatusMap": {
        "To Do": "Development",
        "Doing": "Development pending",
        "Done": "Testing"
    },
    "SyncCommunication": true,
    "DisplayOpenExternalCommand": true,
    "TicketReporter": "Requester"
}

Legenda:

  • ConnectorType - zadejte text AzureDevOps.

  • URL - zadejte adresu URL projektu Azure DevOps ve tvaru https://dev.azure.com/\{organization}/\{project}.

    Příklad: https://dev.azure.com/Alvao/Alvaoproject

  • AccessToken - zadejte číslo nastavení osobního přístupového tokenu (PAT), které jste použili v pokročilých nastaveních (obvykle 0).

  • AttributeMap - zadejte seznam polí Azure DevOps work item a jejich hodnoty. Můžete použít stejné proměnné ve hodnotách, jako pro šablonu oznámení o změně stavu žadateli.

  • StatusMap – určete mapování stavů pracovních položek Azure DevOps na stavy požadavků Alvao. Při prvním přechodu na stav v Alvao, který je uveden v mapování, se v Azure DevOps vytvoří pracovní položka. ID vytvořené pracovní položky je uloženo ve vlastním poli External Application – the ticket ID. Synchronizace stavů probíhá při změně stavu buď v Alvao nebo v Azure DevOps.

    Stavy v Alvao jsou ve výchozím jazyce Alvao, zatímco stavy v Azure DevOps jsou ve výchozím jazyce Azure DevOps.

  • SyncCommunication – (true | false). Pokud je povoleno, každý záznam komunikace ticketu (e-mailová zpráva, poznámka atd.) je zaznamenáván jako komentář související pracovní položky Azure DevOps a každý komentář pracovní položky v Azure DevOps je zapsán v komunikaci o požadavku Alvao a přidělený požadavek je upozorněn e-mailem nebo MS Teams botem.

  • ShowOpenExternalTicketCommand – (true | false). Pokud je povoleno nebo není definováno, příkaz Otevřít související požadavek Azure DevOps je zobrazen na stránce Požadavek každého synchronizovaného požadavku.

  • TicketReporter – vyberte, kdo bude určen jako zadavatel pracovních položek v Azure DevOps:

    • Default – uživatel, jehož PAT je použit v konfiguraci konektoru.
    • Žadatel – žadatel o požadavek Alvao; Uživatel Alvao je spárován s uživatelským jménem uživatele Azure DevOps. Pokud není nalezen žádný odpovídající uživatel Azure DevOps, použije se možnost Výchozí.
    • Uživatelské jméno konkrétního uživatele Azure DevOps, např. user@contoso.com.