Přeskočit na hlavní obsah

Jira konektor

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

Mezi klíčové funkce patří:

  • Vytvořte jízdenky Jira přímo z Alvao pro bezproblémový pracovní postup.
  • Zajistěte konzistentní stavy tiketu s automatickou obousměrnou synchronizací.
  • Synchronizovat zprávy a přílohy mezi oběma platformami pro účinnou spolupráci.
  • Přístup k jízdenká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ě​

  • Služba ALVAO
  • Alvao REST API dostupné z internetu

Montáž​

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

  1. Stáhněte si JiraConnector.zip balíček.
  2. Ve stromu Administrace - Service Desk - Services vyberte složku, kde chcete importovat ukázkovou službu pro připojení k Jira a použijte příkaz Import pro načtení JiraConnectorServiceEnu. ml soubor, který je obsažen v souboru JiraConnector.zip
  3. V Administraci - Applications použijte příkaz Import k 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 Administrace - Advanced 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

Můžete použít více přístupových tokenů, pokud například potřebujete integrovat Jiru z různých organizací do jediné instance 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í 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í webový háček spouštěný pouze vybranými projekty, např. project = JIRAPROJECT.
    • Události – povolte Komentář – vytvořeno.
  2. Nastavte webový háček 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 Administrace - Pracovní plocha - Services, vyberte službu, kterou chcete připojit k Jirě a použijte Upravit - Vlastnosti.

  2. V sekci Other najděte Externí aplikaci - Nastavení konektoru a upravte 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"
}
}

Legend:

  • ConnectorType - enter the text Jira.

  • URL - enter the URL of the Jira, e.g., https://jira.contoso.com.

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

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

  • StatusMap – specify the mapping of the ticket statuses (Jira ticket status : Alvao ticket status). When first moving to a status in Alvao that is present in the mapping, a request is created in Jira. The created ticket id is stored in the custom field External Application – the ticket ID. Status synchronization occurs when the status changes in either Alvao or Jira.

  • SyncCommunication – (true | false). If enabled each ticket communication record (email message, note, etc.) is propagated as a comment of the related Jira ticket, and every ticket comment in Jira that is marked as public is logged in Alvao ticket communication and the ticket assignee is notified by email or MS Teams bot.

  • ShowOpenExternalTicketCommand – (true | false). If enabled, the command Open related Jira ticket is displayed on the Ticket page of each synchronized ticket.

  • TicketReporter – choose who will be designated as the Jira ticket reporter:

    • Default – the user whose PAT is used in the connector configuration.
    • Requester – the Alvao ticket requester; The Alvao user is paired with Jira user by username. If no matching Jira user is found, the Default option is used.
    • Specific Jira user's username, e.g., user@contoso.com.

  • CustomHttpHeaders – optionally additional HTTP headers sent to Jira REST API.