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ží letenku 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í tiketu 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í tiket 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

Montáž​

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

  1. Stáhněte si AzureDevOpsConnector.zip balíček.
  2. Ve stromu Administrace - Service Desk - Services vyberte složku, kde chcete importovat ukázkovou službu pro připojení k Azure DevOps, a použijte příkaz Import pro načtení AzureDevOpsConnectorServiceEnu. ml soubor, který je obsažen v 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 osobní přístupový tok (PAT) s Pracovní předměty - Číst a zápis oprávněním.
  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

Můžete použít více přístupových tokenů, pokud například potřebujete integrovat Azure DevOps z různých organizací do Alvao. 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, po níž následuje cesta "/Connectors/DevOpsCallback", např.: https://contoso.alvao.com/AlvaoRestApi/Connectors/DevOpsCallback
  6. Vyberte Žádné pod Zprávy k odeslání.
  7. V podrobných zprávách také vyberte Žádné a stiskněte Dokonč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": "Synchronization to DevOps",
"EndState": "Return from DevOps",
"WorkItemEndState": "Closed"
}

Legend:

  • ConnectorType - enter the text AzureDevOps.

  • URL - enter the URL of the Azure DevOps project in the form https://dev.azure.com/\{organization}/\{project}

    Example: https://dev.azure.com/Alvao/Alvaoproject

  • AccessToken - enter the Personal Access Token (PAT) setting number that you used in advanced settings (typically 0).

  • AttributeMap - specify the list of Azure DevOps work item fields and their values. You can use the same variables in the values, as for the status change notification template to requesters.

  • BeginState - specify the name of the ticket status in Alvao in which the ticket will be transferred to Azure DevOps.

    Example: Synchronization to DevOps

  • EndState - specify the name of the ticket status to which the ticket should transition when the corresponding work item is closed in Azure DevOps.

    Example: Return from DevOps

  • WorkItemEndState – specify the name of the status in Azure DevOps in which should the ticket change its status in Alvao.

    Example: Closed