Skip Navigation LinksALVAO 11.0Rozšiřující modulyALVAO Azure DevOps Connector Skip Navigation Links.


Přepnout verzi Alvao
Změnit jazyk

ALVAO Azure DevOps Connector

Tento modul propojuje ALVAO Service Desk a Azure DevOps. Např. uživatel do ALVAO Service Desk podá požadavek na úpravu ERP systému. Po jeho schválení a vypracování podrobnější specifikace úpravy, resp. ihned po vytvoření požadavku, automaticky v Azure DevOps vznikne navázaná pracovní položka (work item) na realizaci dané úpravy. Po realizaci úpravy a uzavření pracovní položky v Azure DevOps původní požadavek v Alvao přejde do definovaného stavu, např. „Kontrola úpravy“.

Technické požadavky

  • Azure DevOps
  • ALVAO Service Desk
  • Modul ALVAO Service Desk Custom Apps
  • Modul ALVAO Service Desk Enterprise API

Aktivace modulu

Modul je nutné aktivovat aktivačním klíčem, který získáte u svého dodavatele systému Alvao. V WebApp - Správa - Licence vyberte příkaz Vložit aktivační klíč a zadejte aktivační klíč.

Instalace

  1. V WebApp – Správa – Service Desk - Služby ve stromu vyberte složku, do které chcete importovat vzorovou službu pro propojení s Azure DevOps, a příkazem Importovat do ní načtěte soubor AzureDevOpsConnectorService.xml, který je obsažen v instalačním balíčku AlvaoAzureDevOpsConnector.zip.
  2. V WebApp – Správa – Aplikace příkazem Importovat načtěte soubor AzureDevOpsConnectorApp.xml.

Azure DevOps Personal Access Token

  1. V Azure DevOps vytvořte Personal Access Token (PAT) s oprávněním Work Items – Read & write.
  2. V WebApp – Správa – Aplikace vyberte aplikaci ALVAO Azure DevOps Connector a do skriptu Settings.cs na místo označené příslušnými komentáři vložte vytvořený PAT.
Poznámka:
Případně můžete používat i více přístupových tokenů, např. pokud do Alvao potřebujete integrovat Azure DevOps různých organizací.

Nastavení Azure DevOps

  1. V Azure DevOps v daném projektu použijte příkaz Project Settings – Service hooks – Create subscription.
  2. Jako typ služby vyberte Web Hooks a stiskněte tlačítko Next.
  3. V položce Trigger on this type of event vyberte volbu Work item updated.
  4. V položce Field vyberte volbu State. Stisněte tlačítko Next.
  5. Do položky URL zapište URL aplikace AlvaoRestApi doplněné o cestu „/Connectors/DevOpsCallback“, např.: https://contoso.alvao.com/AlvaoWebApi/Connectors/DevOpsCallback
  6. V položce Messages to send vyberte None.
  7. V položce Detailed messages to send vyberte také None a stiskněte tlačítko Finish.

Nastavení služby v Alvao

  1. V WebApp – Správa – Service Desk - Služby vyberte službu, kterou chcete propojit s Azure DevOps, a použijte příkaz Upravit - Vlastnosti.
  2. V sekci Ostatní zadejte hodnotu vlastní položky Externí aplikace – nastavení konektoru. Zapisují se následující nastavení v JSON notaci:
    1. ConnectorType – zadejte text AzureDevOps.
    2. URL – zadejte URL projektu v Azure DevOps ve tvaru https://dev.azure.com/{organization}/{project} Příklad: https://dev.azure.com/Alvao/Alvaoproject
    3. AccessToken – zadejte číslo osobního přístupového tokenu (PAT), který jste prve uložili do skriptu Settings.cs.Příklad: 0
    4. AttributeMap – zadejte mapování položek požadavku, formát nastavení viz níže.
    5. BeginState– zadejte název stavu požadavku v Alvao, ve kterém se požadavek přenese do Azure DevOps.
      Příklad: Programování
    6. EndState– nastavte název stavu požadavku, do kterého má požadavek přejít po uzavření odpovídající pracovní položky (work item) v Azure DevOps.
      Příklad: Vyřešeno

    Příklad celého nastavení:

    {
    "ConnectorType": "AzureDevOps",
    "URL": "https://dev.azure.com/Alvao/Alvaoproject",
    "AccessToken": "0",
    "AttributeMap": {"System.Title“:“[$TicketTitle$]“,
    "System.Description“:"[$LatestImportantMessage$]", "System.WorkItemType“:“Task“},
    "BeginState": "Programování",
    "EndState": "Vyřešeno"
    }

Mapa atributů

Mapa atributů pro nastavení AttributeMap je zapsaná v JSON formátu jako seznam vlastností, kde název vlastnosti je název položky v Azure DevOps a hodnota je řetězcová konstanta. V hodnotách lze používat proměnné, viz níže. např.:

{"System.Title“:“[$TicketTitle$]“, "System.Description“:"[$LatestImportantMessage$]",
"System.WorkItemType“:“Task“}

Každé položce v Azure DevOps je přiřazena hodnota, která je zapsaná jako statický text obsahující proměnné. Můžete používat stejné proměnné, jako v šabloně oznámení žadateli o změně stavu, viz Šablona zprávy.

 

Nenašli jste co jste hledali? Zeptejte se našeho týmu technické podpory.