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 pracovní položky 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.
  • Získejte přístup k pracovním položkám Jira přímo z Alvao pro rychlou a snadnou navigaci.

Ukázkový proces:

Stav požadavku Development je v tomto příkladu mapován na stav pracovního položky ToDo v Jira. Když požadavek v Alvao přejde do tohoto stavu, v Jira se vytvoří pracovní položka definovaného typu. Když pracovní položka vstoupí do stavu In Progress, požadavek automaticky přejde do stavu Development pending. Po vyřešení pracovního položky (stav Done) se požadavek v Alvao převede na stav Testing.

Technické požadavky​

  • Jira Cloud nebo Server

SaaS​

  • Předplatné ALVAO ITSM nebo Service Desk

Instalace v on-prem prostředí​

  • 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. Přejděte do Správa – Aplikace a zapněte aplikaci Jira Connector.

     Manual download: <DownloadLink href="https://alvaowebaddins.azurewebsites.net/api/Applications/Application?uniqueId=657A0214-58D2-4318-A8CB-59908C2D7B38&fileName=JiraConnector.xml">JiraConnector.xml</DownloadLink>

Jira osobní přístupový token​

  1. V Jira vytvořte vyhrazený účet pro tuto integraci, pojmenujte jej "Alvao Connector" a 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 s hodnotou:

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

  3. Ujistěte se, že účet má následující oprávnění:

    • Projektová oprávnění:
      • Browse projects
      • Create issues
      • Create attachments
      • Add comments
      • Transition issues
    • Global permissions
      • Browse users and groups (při použití nastavení TicketReporter=Requester)
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řte nové nastavení a zvyšte čí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": "Development",
        "In Progress": "Development pending",
        "Done": "Testing"
    },
    "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 – určete mapování stavů pracovních položek Jira na stavy požadavků v Alvao. Při prvním přechodu na stav v Alvao, který je uveden v mapování, se v Jira vytvoří pracovní položka. ID vytvořené pracovní položky je uloženo ve vlastním poli External Application – the ticket ID. Synchronizace stavů probíhá při změně stavu buď v Alvao nebo v Jira.

    Stavy v Alvao jsou ve výchozím jazyce Alvao, zatímco stavy v Jira jsou ve výchozím jazyce Jira.

  • SyncCommunication – (true | false). Pokud je povoleno, každý záznam komunikace ticketu (e-mailová zpráva, poznámka atd.) je zaznamenáván jako komentář související pracovní položky Jira a každý komentář pracovní položky v Jira označený jako veřejný je zapsán v komunikaci o požadavku Alvao a přidělený požadavek je upozorněn e-mailem nebo MS Teams botem.

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

  • TicketReporter – vyberte, kdo bude určen jako zadavatel pracovních položek v Jira:

    • Default – uživatel, jehož PAT je použit v konfiguraci konektoru.
    • Žadatel – žadatel požadavku v 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.