Přeskočit na hlavní obsah

Jira konektor

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ě​

  • Služba ALVAO
  • 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. 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

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 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": "Vyřešeno",
"Probíhá": "Řešeno"
},
"SyncCommunication": true,
"DisplayOpenExternalCommand": true,
"TicketReporter": "Requester",
"CustomHttpHeaders": {
"X-AlvaoHeader": "Header value"
}
}

Legenda:

  • Typ konektoru - zadejte text Jira.

  • URL - zadejte adresu URL systému Jira, např. https://jira.contoso.com.

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

  • AttributeMap - zadejte seznam polí vydání systému Jira a jejich hodnoty. V hodnotách můžete použít stejné proměnné jako u šablony oznámení o změně stavu žadatelům.

  • StatusMap - zadejte mapování stavů požadavku (stav požadavku Jira : stav požadavku Alvao). Při prvním přechodu do stavu v Alvao, který je přítomen v mapování, se v systému Jira vytvoří požadavek. Identifikátor vytvořeného požadavku je uložen ve vlastním poli Externí aplikace - identifikátor požadavku. K synchronizaci stavu dochází při změně stavu v systému Alvao nebo Jira.

  • SyncCommunication - (true | false). Je-li tato funkce povolena, každý záznam o komunikaci s požadavkem (e-mailová zpráva, poznámka atd.) se propaguje jako komentář souvisejícího požadavku Jira a každý komentář k požadavku v systému Jira, který je označen jako veřejný, je zaznamenán v komunikaci s požadavkem Alvao a příjemce požadavku je upozorněn e-mailem nebo MS Teams botem.

  • ShowOpenExternalTicketCommand - (true | false). Je-li tato volba povolena, zobrazí se na stránce Ticket každého synchronizovaného požadavku příkaz Otevřít související požadavek Jira.

  • TicketReporter - vyberte, kdo bude určen jako reportér požadavku Jira:

    • Default - uživatel, jehož PAT je použit v konfiguraci konektoru.
    • Requester - zadavatel požadavku Alvao; Uživatel Alvao je spárován s uživatelem Jira podle uživatelského jména. Pokud není nalezen žádný odpovídající uživatel Jira, použije se volba Default.
    • Konkrétní uživatelské jméno uživatele Jira, např. user@contoso.com.

  • CustomHttpHeaders - volitelně další hlavičky HTTP odesílané do rozhraní Jira REST API.