Přeskočit na hlavní obsah

Azure DevOps Connector

Tento konektor připojuje ALVAO Service Desk a Azure DevOps. Například uživatel předloží požadavek ALVAO Service Desk , aby upravil systém ERP. Poté, co je ticket schválen a je vyvinuta podrobná specifikace úpravy, nebo ihned poté, co je ticket vytvořen, je v Azure DevOps automaticky vytvořen pracovní záznam pro implementaci úpravy. Po provedení úpravy a po provedení práce v Azure DevOps přejde na definovaný stav, původní požadavek ve městě Alvao jde na definovaný stav, e. . "Synchronizace s DevOps".

Viz ukázkový proces:

devops-connector

Technické požadavky​

Svatý Bartoloměj,​

  • ALVAO ITSM nebo Service Desk předplatné

Instalace na místě​

  • 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. Ve Správě - Aplikace, použijte příkaz Import k načtení souboru AzureDevOpsConnectorApp.xml.

Azure DevOps osobní přístupový token​

  1. V Azure DevOps vytvořte Personal Access Token (PAT) s oprávněním Pracovní položky - čtení a zápis.
  2. Přejděte na stránku Správa - 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řit nové nastavení a zvýšit čí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 položky URL zadejte adresu URL aplikace AlvaoRestApi, za kterou následuje cesta "/Connectors/DevOpsCallback", např.: https://contoso.alvao.com/AlvaoRestApi/Connectors/DevOpsCallback 6. V položce Zprávy k odeslání vyberte možnost Žádná.
  6. V části Podrobné zprávy k odeslání vyberte také možnost Žádné a stiskněte tlačítko Ukonč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 Ostatní najděte vlastní položku Externí Aplikace - Nastavení konektoru a upravte její 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"
},
"BeginState": "Synchronization to DevOps",
"EndState": "Return from DevOps",
"WorkItemEndState": "Closed"
}

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 rozšířeném nastavení (obvykle 0).

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

  • BeginState - zadejte název stavu požadavku v Alvao, ve kterém bude požadavek přenesen do Azure DevOps.

    Příklad: Synchronizace s DevOps

  • EndState - zadejte název stavu požadavku, do kterého má požadavek přejít po uzavření příslušné pracovní položky v Azure DevOps.

    Příklad: "Návrat z DevOps

  • WorkItemEndState - zadejte název stavu v Azure DevOps, ve kterém má požadavek změnit svůj stav v Alvao.

    Příklad: Closed