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


Přepnout verzi Alvao
Změnit jazyk

ALVAO Azure DevOps Connector

Tento modul propojuje služby ALVAO Service Desk a Azure DevOps. Uživatel například odešle do ALVAO Service Desk požadavek na úpravu systému ERP. Po schválení požadavku a vypracování podrobné specifikace úpravy nebo ihned po vytvoření požadavku se v Azure DevOps automaticky vytvoří pracovní položka pro realizaci úpravy. Po provedení úpravy a přechodu pracovní položky v Azure DevOps do definovaného stavu přejde původní požadavek v Alvao do definovaného stavu, například "Synchronizace do DevOps".

Technické požadavky

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

Instalace

  1. Ve stromu WebApp - 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 AzureDevOpsConnectorService<Enu/Csy>.xml, který je součástí instalačního balíčku AlvaoAzureDevOpsConnector.zip
  2. V nabídce WebApp - Administration - Applications( Webové aplikace - Správa - Aplikace) načtěte pomocí příkazu Import soubor AzureDevOpsConnectorApp.xml

Osobní přístupový token Azure DevOps

  1. V Azure DevOps vytvořte osobní přístupový token (PAT) s oprávněním Work Items - Read & Write.
  2. V části WebApp - Administration - Applications( Webové aplikace - Správa - Aplikace) vyberte aplikaci ALVAO Azure DevOps Connector a vložte vytvořený PAT do skriptu Settings.cs na místo označené příslušnými komentáři.
Poznámka:
Alternativně můžete použít více přístupových tokenů - jednotlivé hodnoty tokenů oddělte čárkou - např. pokud potřebujete do Alvao integrovat Azure DevOps z různých organizací

Nastavení Azure DevOps

  1. V Azure DevOps v daném projektu použijte Nastavení projektu - Háčky služeb - Vytvořit odběr.
  2. Jako typ služby vyberte Web Hooks a stiskněte tlačítko Next.
  3. V části Trigger on this type of event vyberte možnost Work item updated.
  4. V poli 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říklad: https://contoso.alvao.com/AlvaoWebApi/Connectors/DevOpsCallback
  6. V části Zprávy k odeslání vyberte možnost Žádné.
  7. V části Podrobné zprávy k odeslání vyberte rovněž možnost Žádné a stiskněte tlačítko Dokončit.

Nastavení služby v systému Alvao

  1. Ve WebApp - Administration - Service Desk - Services vyberte službu, kterou chcete připojit k Azure DevOps, a použijte Edit - Properties.
  2. V sekci Ostatní zadejte hodnotu vlastního pole Externí aplikace - Nastavení konektoru. Následující nastavení jsou zapsána v notaci JSON:
    1. ConnectorType - zadejte text AzureDevOps.
    2. URL - zadejte adresu URL projektu Azure DevOps ve tvaru https://dev.azure.com/{organizace}/{projekt}
      Příklad: https: //dev.azure.com/Alvao/Alvaoproject
    3. AccessToken - zadejte číslo osobního přístupového tokenu (PAT) (id tokenu, který jste poprvé uložili ve skriptu Settings.cs ).
      0 je první a výchozí hodnota indexu
    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 bude požadavek přenesen do Azure DevOps.
      Příklad: V případě, že se jedná o aplikaci DevOv, můžete zadat hodnotu, která je v DevOv: Synchronizace do DevOps
    6. 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
    7. WorkItemEndState - zadejte název stavu v Azure DevOps, ve kterém by měl požadavek změnit svůj stav v Alvao.
      Příklad: Uzavř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": "Synchronizace s DevOps",
    "EndState": "Návrat z DevOps",
    "WorkItemEndState": "Closed"
    }

Mapa atributů

Mapa atributů pro nastavení AttributeMap je zapsána ve formátu JSON jako seznam vlastností, kde název vlastnosti je název položky v Azure DevOps a hodnota je řetězcová konstanta. V hodnotách můžete použít 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 zapsána jako statický text obsahující proměnné. Můžete použít stejné proměnné jako v šabloně oznámení o změně stavu žadateli, viz Šablona zprávy

 

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