Přeskočit na hlavní obsah

Jira Connector

Jira Connector integruje Alvao do Jira, zefektivnění správy požadavku a komunikace.

Mezi klíčové funkce patří:

  • Vytvořte požadavky Jira přímo z Alvao pro bezproblémový pracovní postup.
  • Zajistěte konzistentní stavy požadavku s automatickou obousměrnou synchronizací.
  • Synchronizovat zprávy a přílohy mezi oběma platformami pro účinnou spolupráci.
  • Přístup k požadavkům Jira přímo z Alvao pro rychlou a snadnou navigaci.

Technické požadavky​

  • Jira Cloud nebo Server

Svatý Bartoloměj,​

  • Předplatné ALVAO ITSM nebo Service Desk

Instalace na místě​

  • ALVAO Service Desk
  • Alvao REST API dostupné z internetu

Instalace​

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

  1. Stáhněte si balíček JiraConnector.zip.
  2. V stromu Administration - Service Desk - Services vyberte složku, do které chcete importovat ukázkovou službu pro připojení k Jira, a použijte příkaz Import pro načtení souboru JiraConnectorServiceEnu.xml, který je součástí souboru JiraConnector.zip.
  3. V Administration - Applications, použijte příkaz Import pro načtení souboru JiraConnectorApp.xml.

Jira osobní přístupový token​

  1. V Jirě vytvořte osobní přístupový token (PAT).

  2. Přejděte na stránku Administration - Nastavení - Pokročilé. Použij příkaz Nové nastavení k vytvoření nastavení JiraIntegrationToken0:

    • Pro Jira Cloud (SaaS), zadejte hodnotu ve formátu <username>:<PAT>, např.: james.smith@onmicrosoft.com:T3xGF0T97pYKtidC3mcL5SC_71xB9irVIZozbnHg.

    • Pro Jira server (v prostoru), zadejte PAT.

Tip

Pokud například potřebujete integrovat Jiru z různých organizací do jedné instance Alvao, 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í webhooků v Jira​

  1. V Jira, vytvořte nový webhook a nastavte:
    • Jméno – zadejte Alvao Connector.
    • Stav - Povoleno
    • URL - zadejte adresu URL REŽIMU Alvao, po níž následuje cesta /connectors/jiraCallback/{issue.key}, např.: https://contoso.onalvao.com/AlvaoRestApi/connectors/jiraCallback/{issue.key}.
    • Oblast působnosti – nastaví webhook spouštěný pouze vybranými projekty, např. project = JIRAPROJECT.
    • Události – povolte Komentář – vytvořeno.
  2. Nastavte webhook na být spuštěn přechodem pracovního postupu, který chcete synchronizovat s Alvao (jsou součástí StatusMap).

Nastavení služby v Alvao​

  1. V Administration - Service Desk - Services, vyberte službu, kterou chcete připojit k Jira, a použijte Upravit - Vlastnosti.

  2. V sekci Other najděte vlastní pole Externí aplikace - Nastavení konektoru a upravte jeho hodnotu.

    Výchozí hodnota:

{
    "ConnectorType": "Jira",
    "URL": "https://jira.contoso.com",
    "AccessToken": "0",
    "AttributeMap": {
        "summary": "[$TicketTitle$]",
        "description": "[$OriginalMessage$]",
        "issuetype.name": "Bug",
        "project.key": "JIRAPROJECT",
        "customfield_10123": "[$TicketID$]"
    },
    "StatusMap": {
        "ToDo": "New",
        "Done": "Resolved",
        "In Progress": "Solution"
    },
    "SyncCommunication": true,
    "DisplayOpenExternalCommand": true,
    "TicketReporter": "Requester",
    "CustomHttpHeaders": {
        "X-AlvaoHeader": "Header value"
    }
}

Legenda:

  • ConnectorType - zadejte text Jira.

  • URL - zadejte URL Jira, např. https://jira.contoso.com.

  • AccessToken - zadejte číslo nastavení osobního přístupového tokenu (PAT), které jste použili v pokročilých nastaveních (obvykle 0).

  • AttributeMap - uveďte seznam polí problémů Jira a jejich hodnot. Můžete použít stejné proměnné ve hodnotách, jako pro šablonu oznámení o změně stavu žadateli.

  • StatusMap – uveďte mapování stavů ticketu (stav ticketu Jira : stav ticketu Alvao). Při prvním přechodu na stav v Alvao, který je v mapování, je v Jira vytvořena žádost. Vytvořená ID ticketu je uložena ve vlastním poli Externí aplikace – ID ticketu. Synchronizace stavů probíhá, když se stav změní buď v Alvao nebo v Jira.

  • SyncCommunication – (true | false). Pokud je povoleno, každý záznam komunikace ticketu (e-mailová zpráva, poznámka atd.) je propagováno jako komentář souvisejícího ticketu Jira a každý komentář ticketu v Jira, který je označen jako veřejný, je zaznamenán v komunikaci ticketu Alvao a osoba přiřazená k ticketu je upozorněna e-mailem nebo MS Teams bot.

  • ShowOpenExternalTicketCommand – (true | false). Pokud je povoleno, je na stránce Ticket každého synchronizovaného ticketu zobrazen příkaz Otevřít související ticket Jira.

  • TicketReporter – vyberte, kdo bude určen jako reportér ticketu Jira:

    • Default – uživatel, jehož PAT je použit v konfiguraci konektoru.
    • Requester – žadatel o ticket Alvao; Uživateli Alvao je spárován s uživatelem Jira podle uživatelského jména. Pokud není nalezen odpovídající uživatel Jira, je použita možnost Výchozí.
    • Specifické uživatelské jméno uživatele Jira, např. user@contoso.com.

  • CustomHttpHeaders – volitelně další HTTP záhlaví odesílaná do REST API Jira.