Jira Software modules
In een Adobe Workfront Fusion -scenario kunt u workflows automatiseren die Jira Software gebruiken en deze koppelen aan meerdere toepassingen en services van derden.
Als u instructies bij het creëren van een scenario nodig hebt, zie een scenario in Adobe Workfront Fusion creëren.
Voor informatie over modules, zie Modules in Adobe Workfront Fusion.
Toegangsvereisten
U moet de volgende toegang hebben om de functionaliteit in dit artikel te kunnen gebruiken:
Neem contact op met de Workfront -beheerder als u wilt weten welk abonnement, licentietype of toegang u hebt.
Voor informatie over Adobe Workfront Fusion vergunningen, zie Adobe Workfront Fusion vergunningen
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
-
Ga naar https://id.atlassian.com/manage/api-tokensen login.
-
Klik op Create API token.
-
Typ een naam voor het teken, zoals de Fusie van Workfront.
-
Kopieer het token met de knop Copy to clipboard .
note important 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
-
Voeg in Workfront Fusion een Jira -module toe aan een scenario om het vak Create a connection te openen.
-
Geef de volgende informatie op:
- 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.
- Service URL: dit is de basis-URL die u gebruikt om toegang te krijgen tot uw Jira-account. Voorbeeld:
-
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.
-
Voer in uw terminal de volgende
openssl-opdrachten uit.-
openssl genrsa -out jira_privatekey.pem 1024Met 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 365Met deze opdracht maakt u een X509-certificaat.
-
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8Met deze opdracht haalt u de persoonlijke sleutel (PKCS8-indeling) uit naar de
jira_privatekey.pcks8
bestand. -
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pemMet deze opdracht haalt u de openbare sleutel uit het certificaat uit naar het
jira_publickey.pem-bestand.note note NOTE Als u Windows gebruikt, moet u de openbare sleutel mogelijk handmatig in het jira_publickey.pem-bestand opslaan:-
In uw terminal, stel het volgende bevel in werking:
openssl x509 -pubkey -noout -in jira_publickey.cer -
Kopieer de terminaluitvoer (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.
-
Klik in het linkernavigatievenster op Jira Settings
-
Typ in het veld Enter the URL of the application you want to link
code language-none 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:
table 0-row-2 1-row-2 2-row-2 3-row-2 Veld Beschrijving Request Token URL <Jira base url>/plugins/servlet/oauth/request-tokenAuthorization URL <Jira base url>/plugins/servlet/oauth/authorizeAccess 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:
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header Consumer Key Plak in de consumentensleutel die u naar een beveiligde locatie hebt gekopieerd. Consumer name Voer een naam van uw keuze in. Deze naam is voor uw eigen referentie. Public key Plak de openbare sleutel uit het jira_publickey.pem-bestand. -
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:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Connection name Geef een naam op voor de verbinding Consumer Key Plak in de sleutel van de consument die u aan een veilige plaats in kopieerde vorm cliënt app als consument in Jira Private Key Plak in de privé sleutel van het jira_privatekey.pcks8dossier u in creeerde produceert Openbare en Privé sleutels voor uw Jira verbinding.Service URL Voer de URL van de Jira -instantie in. Voorbeeld: yourorganization.atlassian.net -
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 in Adobe Workfront Fusion.
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. Op deze manier kunt u een automatisering van de gegevensstroom maken die niet door de andere Jira Software -modules kan worden uitgevoerd.
Als u deze module configureert, worden de volgende velden weergegeven.
Selecteer de HTTP- verzoekmethode u de API vraag moet vormen. Zie HTTP-aanvraagmethoden in Adobe Workfront Fusion voor meer informatie.
<Instance URL>/rest/api/2/Voeg de kopteksten van het verzoek toe in de vorm van een standaard JSON-object.
Bijvoorbeeld: {"Content-type":"application/json"}
Workfront Fusion Hiermee voegt u de machtigingsheaders voor u toe.
Voeg de query voor de API-aanroep toe als een standaard JSON-object.
Bijvoorbeeld: {"name":"something-urgent"}
Voeg de inhoud van de hoofdtekst voor de API-aanroep toe in de vorm van een standaard JSON-object.
Opmerking:
Wanneer u voorwaardelijke instructies gebruikt, zoals if in uw JSON, plaatst u de aanhalingstekens buiten de voorwaardelijke instructie.
Delete a record
Deze actiemodule verwijdert een bepaalde 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.