Přeskočit na hlavní obsah

Rozhraní Azure DevOps

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. Po schválení přepravního dokladu a vypracování podrobné specifikace úpravy, nebo ihned po vytvoření požadavku je dílo automaticky vytvořeno v Azure DevOps pro provedení ú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
  • Ověření uživatele 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 stromu Administration - Service Desk - Services vyberte složku, do které chcete importovat ukázkovou službu pro připojení k Azure DevOps, a pomocí příkazu Import načtěte soubor AzureDevOpsConnectorServiceEnu.xml, který je součástí souboru AzureDevOpsConnector.zip.
  3. V Administrace - Applications 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 Administrace - Advanced 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. V Administrace - Pracovní plocha - Services, vyberte službu, kterou chcete připojit k Azure DevOps a použijte Upravit - Vlastnosti.

  2. V sekci Other najděte Externí aplikaci - Nastavení konektoru a upravte 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": "Synchronizace s DevOps",
"EndState": "Návrat z 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. V hodnotách můžete použít stejné proměnné jako v šabloně oznámení o změně stavu žadatelům.

  • BeginState - zadejte název stavu tiketu v Alvao, ve kterém bude tiket přenesen do Azure DevOps.

    Příklad: Synchronizace s DevOps

  • EndState - zadejte název stavu tiketu, do kterého má tiket 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á tiket změnit svůj stav v Alvao.

    Příklad: Closed