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.

Deze instructies zijn van toepassing op de modules Jira Cloud en Jira Server.

Voor instructies bij het creëren van een scenario, zie de artikelen onder scenario's creëren: artikelindex.

Voor informatie over modules, zie de artikelen onder Modules: artikelindex.

Toegangsvereisten

Breid uit om de toegangseisen voor de functionaliteit in dit artikel weer te geven.

U moet de volgende toegang hebben om de functionaliteit in dit artikel te kunnen gebruiken:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront-pakket Alle
Adobe Workfront-licentie

Nieuw: Standaard

of

Huidig: Werk of hoger

Adobe Workfront Fusion-licentie**

Huidig: Geen Workfront Fusion-licentievereisten.

of

Verouderd: Workfront Fusion for Work Automation and Integration

Product

Nieuw:

  • Select- of Prime Workfront-pakket: uw organisatie moet Adobe Workfront Fusion aanschaffen.
  • Ultimate Workfront-pakket: Workfront Fusion is inbegrepen.

of

Huidig: Uw organisatie moet Adobe Workfront Fusion aanschaffen.

Voor meer detail over de informatie in deze lijst, zie vereisten van de Toegang in documentatie.

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:

Jira Cloud
Jira Server
apiVersion
2
2
apiVersionAgile
1,0
1,0
API-tag
1.7.29.
1.0.19.

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

  1. Maak een API-token in Jira.

    Voor instructies raden we u aan te zoeken naar "Een API-token maken" in de documentatie van Jira.

  2. Kopieer het token na het maken van het token naar een beveiligde locatie.

    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.

  3. Ga met verder vormen het Jira API teken in Workfront Fusion.

De API-token Jira configureren in Workfront Fusion

  1. Klik in een willekeurige Jira Cloud -module in Workfront Fusion op Add naast het connection -veld.

  2. 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.
  3. 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.

  1. 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 note
      NOTE
      Als u Windows gebruikt, moet u de openbare sleutel mogelijk handmatig in het jira_publickey.pem -bestand opslaan:
      1. In uw terminal, stel het volgende bevel in werking:

        openssl x509 -pubkey -noout -in jira_publickey.cer

      2. Kopieer de einduitvoer, inclusief -------BEGIN PUBLIC KEY-------- en -------END PUBLIC KEY-------- .

      3. Plak de einduitvoer in een bestand met de naam jira_publickey.pem .

  2. Ga aan verder vormen cliëntapp als consument in Jira

De client-app configureren als een consument in Jira

  1. Meld u aan bij uw Jira -instantie.

  2. In het linkernavigatievenster, klik Jira Settings Jira montagespictogram > Applications > Application links.

  3. 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
    
  4. Klik op Create new link. Negeer het foutbericht "Er is geen reactie ontvangen van de URL die u hebt ingevoerd".

  5. Voer in het venster Link applications waarden in de velden Consumer key en Shared secret in.

    U kunt de waarden voor deze velden kiezen.

  6. Kopieer de waarden van de velden Consumer key en Shared secret naar een beveiligde locatie.

    U zult deze waarden later in het configuratieproces vereisen.

  7. 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-token
    Authorization URL <Jira base url>/plugins/servlet/oauth/authorize
    Access Token URL <Jira base url>/plugins/servlet/oauth/access-token
  8. Schakel het selectievakje Create incoming link in.

  9. Klik op Continue.

  10. 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.
  11. Klik op Continue.

  12. 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

NOTE
Gebruik de app Jira Server om verbinding te maken met Jira Server of Jira Data Center .
  1. Klik in een willekeurige Jira Server -module in Workfront Fusion op Add naast het connection -veld.

  2. Vul in het deelvenster Create a connection de volgende velden in:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    Connection name Geef een naam op voor de verbinding
    Environment Selecteer of u een productie- of niet-productieomgeving gebruikt.
    Type Selecteer of u een serviceaccount of een persoonlijke account gebruikt.
    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.pcks8 dossier 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
  3. 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.

Kaart knevel

Triggers

Watch for records

Deze triggermodule start een scenario wanneer een record wordt toegevoegd, bijgewerkt of verwijderd.

Webhook

Selecteer de webhaak die u wilt gebruiken om te controleren op records.

Een nieuwe webhaak toevoegen:

  1. Klikken Add

  2. Voer een naam in voor de webhaak.

  3. Selecteer de verbinding die u voor uw webhaak wilt gebruiken.

    Zie Verbinding maken Jira Software met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Jira Software -account met Workfront Fusion .

  4. Selecteer het recordtype waarop u de software wilt letten:

    • Comment
    • Issue
    • Project
    • Sprint

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.

Connection
Zie Verbinding maken Jira Software met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Jira Software -account met Workfront Fusion .
Sprint ID
Voer de Sprint-id in van de sprint waaraan u een uitgave wilt toevoegen of wijs deze toe.
Issue ID or Keys
Voor elke uitgave of sleutel die u de ervaring wilt zien, klikt u op Add item en voert u de toepassings-id of -sleutel in. U kunt maximaal 50 invoeren in één module.

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.

Connection
Zie Verbinding maken Jira Software met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Jira Software -account met Workfront Fusion .
Record Type

Selecteer het type record dat u wilt maken in de module en vul vervolgens de andere velden in die specifiek zijn voor dat recordtype in de module.

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
  • Worklog

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.

Connection
Zie Verbinding maken Jira Software met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Jira Software -account met Workfront Fusion .
URL
Een pad invoeren ten opzichte van<Instance URL>/rest/api/2/
Method
Headers

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.

Query String

Voeg de query voor de API-aanroep toe als een standaard JSON-object.

Bijvoorbeeld: {"name":"something-urgent"}

Body

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 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.

Connection
Zie Verbinding maken Jira Software met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Jira Software -account met Workfront Fusion .
Record Type

Selecteer het type record dat de module moet verwijderen.

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
ID or Key
Voer de id of sleutel in of wijs deze toe aan de record die u wilt verwijderen.

Download an attachment

Deze actiemodule downloadt een bepaalde bijlage.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Verbinding maken Jira Software met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Jira Software -account met Workfront Fusion .
ID
Voer de id in van de bijlage die u wilt downloaden of wijs deze toe.

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.

Connection
Zie Verbinding maken Jira Software met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Jira Software -account met Workfront Fusion .
Record Type

Selecteer het type Jira record dat u in de module wilt lezen.

  • Attachment
  • Issue
  • Project
  • Sprint
  • User
Outputs
Selecteer de uitvoer die u wilt ontvangen. Uitvoeropties zijn beschikbaar op basis van het type record dat is geselecteerd in het veld "Record Type".
ID
Voer de unieke Jira Software -id in of wijs deze toe aan de record die u wilt lezen in de module.

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.

Connection
Zie Verbinding maken Jira Software met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Jira Software -account met Workfront Fusion .
Record Type

Selecteer het type record dat de module moet bijwerken. Wanneer u een recordtype selecteert, worden andere velden die specifiek zijn voor dat recordtype, weergegeven in de module.

  • Comment
  • Issue
  • Project
  • Sprint
  • Transition issue
ID or Key
Voer de id of sleutel van de record die u wilt bijwerken in of wijs deze toe en vul vervolgens de andere velden in die specifiek zijn voor dat recordtype, die worden weergegeven in de module.

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.

Connection
Zie Verbinding maken Jira Software met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Jira Software -account met Workfront Fusion .
Record Type

Selecteer het type record dat in de module moet worden vermeld. Wanneer u een recordtype selecteert, worden andere velden die specifiek zijn voor dat recordtype, weergegeven in de module.

  • Comment
  • Issue
  • Project
  • Sprint issue
  • Worklog
Max Results
Ga of kaart het maximumaantal verslagen in u de module tijdens elke cyclus van de scenariouitvoering wilt terugwinnen.

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.

Connection
Zie Verbinding maken Jira Software met Workfront Fusion in dit artikel voor instructies over het verbinden van uw Jira Software -account met Workfront Fusion .
Record Type

Selecteer het type record waarnaar de module moet zoeken. Wanneer u een recordtype selecteert, worden andere velden die specifiek zijn voor dat recordtype, weergegeven in de module.

  • Issues

  • Issues by JQL (Jira Query Lanuguage)

    Voor meer informatie over JQL, zie JQLbij de Atlassiaanse hulpplaats.

  • Project

  • Project by issue

  • User

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3