Vereisten
Als u Jira -modules wilt gebruiken, moet u een Jira -account hebben.
Jira API-informatie
De Jira-connector gebruikt het volgende:
Verbinden Jira Software met Workfront Fusion
De verbindingsmethode is gebaseerd op het feit of u Jira Cloud of Jira Server gebruikt.
Verbinden Jira Cloud met Workfront Fusion
Verbinden Jira Cloud met Workfront Fusion
Als u Jira Software wilt verbinden met Workfront Fusion , moet u een API-token maken en deze samen met de Service URL en de gebruikersnaam invoegen in het veld Create a connection in Workfront Fusion .
Een API-token maken in Jira
-
Maak een API-token in Jira.
Voor instructies raden we u aan te zoeken naar "Een API-token maken" in de documentatie van Jira.
-
Kopieer het token na het maken van het token naar een beveiligde locatie.
IMPORTANT
U kunt het token niet meer weergeven nadat u dit dialoogvenster hebt gesloten.1. Sla het gegenereerde token op een veilige plaats op.
-
Ga met verder vormen het Jira API teken in Workfront Fusion.
De API-token Jira configureren in Workfront Fusion
-
Klik in een willekeurige Jira Cloud -module in Workfront Fusion op Add naast het connection -veld.
-
Geef de volgende informatie op:
- Milieu
- Type
- Service URL: dit is de basis-URL die u gebruikt om toegang te krijgen tot uw Jira-account. Voorbeeld:
yourorganization.atlassian.net
- Username
- API token: dit is het API teken u in creeerde een API teken in Jira sectie van dit artikel.
-
Klik op Continue om de verbinding te maken en terug te keren naar de module.
Verbinden Jira Server met Workfront Fusion
Als u een verbinding tussen Workfront Fusion en Jira Server wilt autoriseren, hebt u uw gebruikersnaam, persoonlijke sleutel en service-URL nodig. Mogelijk moet u contact opnemen met de Jira -beheerder voor deze informatie.
Openbare en persoonlijke sleutels voor uw Jira -verbinding genereren
Als u een persoonlijke sleutel voor uw Workfront Fusion Jira -verbinding wilt verkrijgen, moet u openbare en persoonlijke sleutels genereren. Dit wordt gedaan door de terminal van uw computer. U kunt van uw terminal de plaats bepalen door naar terminal in uw beginmenu of computeronderzoek bar (niet uw browser onderzoeksbar.) te zoeken
-
Voer in uw terminal de volgende
openssl
-opdrachten uit.-
openssl genrsa -out jira_privatekey.pem 1024
Met deze opdracht wordt een persoonlijke sleutel van 1024 bits gegenereerd.
-
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365
Met deze opdracht maakt u een X509-certificaat.
-
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8
Met deze opdracht extraheert u de persoonlijke sleutel (PKCS8-indeling) naar het
jira_privatekey.pcks8
-bestand. -
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem
Met deze opdracht haalt u de openbare sleutel uit het certificaat uit naar het
jira_publickey.pem
-bestand.NOTE
Als u Windows gebruikt, moet u de openbare sleutel mogelijk handmatig in hetjira_publickey.pem
-bestand opslaan:-
In uw terminal, stel het volgende bevel in werking:
openssl x509 -pubkey -noout -in jira_publickey.cer
-
Kopieer de einduitvoer, inclusief
-------BEGIN PUBLIC KEY--------
en-------END PUBLIC KEY--------
. -
Plak de einduitvoer in een bestand met de naam
jira_publickey.pem
.
-
-
De client-app configureren als een consument in Jira
-
Meld u aan bij uw Jira -instantie.
-
In het linkernavigatievenster, klik Jira Settings
-
Typ in het veld Enter the URL of the application you want to link
https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1
-
Klik op Create new link. Negeer het foutbericht "Er is geen reactie ontvangen van de URL die u hebt ingevoerd".
-
Voer in het venster Link applications waarden in de velden Consumer key en Shared secret in.
U kunt de waarden voor deze velden kiezen.
-
Kopieer de waarden van de velden Consumer key en Shared secret naar een beveiligde locatie.
U zult deze waarden later in het configuratieproces vereisen.
-
Vul de URL-velden als volgt in:
Veld Beschrijving Request Token URL <Jira base url>/plugins/servlet/oauth/request-token
Authorization URL <Jira base url>/plugins/servlet/oauth/authorize
Access Token URL <Jira base url>/plugins/servlet/oauth/access-token
-
Schakel het selectievakje Create incoming link in.
-
Klik op Continue.
-
Vul in het venster Link applications de volgende velden in:
-
Klik op Continue.
-
Ga aan voort creeer een verbinding aan Jira Server of Jira Data Center binnen Workfront Fusion
Een verbinding maken met Jira Server of Jira Data Center in Workfront Fusion
-
Klik in een willekeurige Jira Server -module in Workfront Fusion op Add naast het connection -veld.
-
Vul in het deelvenster Create a connection de volgende velden in:
-
Klik op Continue om de verbinding te maken en terug te gaan naar de module.
Jira Software modules en hun velden
Wanneer u Jira Software modules configureert, geeft Workfront Fusion de onderstaande velden weer. Daarnaast kunnen aanvullende Jira Software -velden worden weergegeven, afhankelijk van factoren zoals uw toegangsniveau in de app of service. Een bolde titel in een module wijst op een vereist gebied.
Als u de kaartknoop boven een gebied of een functie ziet, kunt u het gebruiken om variabelen en functies voor dat gebied te plaatsen. Voor meer informatie, zie informatie van de Kaart van één module aan een andere.
Triggers
Watch for records
Deze triggermodule start een scenario wanneer een record wordt toegevoegd, bijgewerkt of verwijderd.
Handelingen
Add issue to sprint
Deze actiemodule voegt een of meer uitgaven aan een sprint toe.
Als u deze module configureert, worden de volgende velden weergegeven.
Create a Record
Deze actiemodule maakt een nieuwe record in Jira.
De module retourneert alle standaardvelden die aan de record zijn gekoppeld, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.
Als u deze module configureert, worden de volgende velden weergegeven.
Custom API Call
Met deze actiemodule kunt u een aangepaste, geverifieerde aanroep van de Jira Software API maken. Gebruik deze module om een automatisering van de gegevensstroom tot stand te brengen die niet door andere Jira Software modules kan worden verwezenlijkt.
Als u deze module configureert, worden de volgende velden weergegeven.
Selecteer de HTTP- verzoekmethode u de API vraag moet vormen. Voor meer informatie, zie HTTP- verzoekmethodes.
Delete a record
Deze actiemodule verwijdert de opgegeven record.
U geeft de id van de record op.
De module retourneert de id van de record en de bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.
Als u deze module configureert, worden de volgende velden weergegeven.
Download an attachment
Deze actiemodule downloadt een bepaalde bijlage.
Als u deze module configureert, worden de volgende velden weergegeven.
Read a record
Deze actiemodule leest gegevens uit één record in Jira Software .
U geeft de id van de record op.
De module retourneert alle standaardvelden die aan de record zijn gekoppeld, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.
Als u deze module configureert, worden de volgende velden weergegeven.
Update a record
Deze actiemodule werkt een bestaand record bij, zoals een uitgave of project.
U geeft de id van de record op.
De module retourneert de id van de record en de bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.
Als u deze module configureert, worden de volgende velden weergegeven.
Zoekopdrachten
List records
Deze zoekmodule haalt alle items van een specifiek type op die overeenkomen met uw zoekopdracht
U kunt deze informatie in verdere modules in het scenario in kaart brengen.
Als u deze module configureert, worden de volgende velden weergegeven.
Search for records
Deze zoekmodule zoekt naar records in een object in Jira Software dat overeenkomt met de zoekquery die u opgeeft.
U kunt deze informatie in verdere modules in het scenario in kaart brengen.
Als u deze module configureert, worden de volgende velden weergegeven.