Jira-modules

NOTE
Deze instructies gelden voor de nieuwe versie van de Jira-connector, die alleen Jira heet. Voor instructies over de erfenisJira Cloud en de schakelaars van de Server van Jira, zie Jira softwaremodules.

In een Adobe Workfront Fusion-scenario kunt u workflows automatiseren die gebruikmaken van Jira en deze koppelen aan meerdere toepassingen en services van derden.

De Jira-connector kan worden gebruikt voor zowel Jira Cloud- als Jira Data 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 de vergunningen van de Fusie van Adobe Workfront, zie de Fusie van Adobe Workfront vergunningen.

Vereisten

Als u Jira-modules wilt gebruiken, moet u een Jira-account hebben.

Jira verbinden met Workfront Fusion

Vereiste referenties maken

Voor het maken van verbindingen met Jira hebt u het volgende nodig:

Verbindingstype
Accounttype
Benodigde referenties
OAuth 2
Alle
Client-id en clientgeheim
Basis
Jira Cloud
Jira API-token
Basis
Jira Data Center
Jira Personal Access Token (PAT)

Raadpleeg de documentatie bij Jira voor instructies over het maken van deze bestanden.

Wanneer u deze referenties maakt, hebt u de volgende informatie nodig:

  • Voor OAuth 2:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Fusion-datacenter URL omleiden
    VS https://app.workfrontfusion.com/oauth/cb/workfront-jira2
    EU https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira2
    Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira2
  • Voor Persoonlijke Tokens van de Toegang (PATs):

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Fusion-datacenter URL omleiden
    VS https://app.workfrontfusion.com/oauth/cb/workfront-jira
    EU https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira
    Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira
    note important
    IMPORTANT
    Als u een PAT wilt gebruiken, moet u het volgende inschakelen in de bestanden jira/bin/WEB-INF/classes in het bestand jira-config.properties :
    • jira.rest.auth.allow.basic = true
    • jira.rest.csrf.disabled = true
    Als dit bestand niet bestaat, moet u het maken.

Verbinding maken met Jira in Workfront Fusion

De verbinding maken in Workfront Fusion:

  1. In om het even welke module van Jira, voegt de klik naast het gebied van de Verbinding toe.

  2. Configureer de volgende velden:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto html-authored no-header
    Verbindingstype Selecteer of u een basisverbinding of een OAuth 2-verbinding maakt.
    Verbindingsnaam Voer een naam in voor de nieuwe verbinding.
    Service-URL Voer de URL van uw Jira-instantie in. Dit is de URL die u gebruikt om toegang te krijgen tot Jira.
    Jira-accounttype Selecteer of u verbinding maakt met Jira Cloud of Jira Data Center.
    Client-id Als u een OAuth 2-verbinding maakt, voert u uw Jira Client ID in
    Clientgeheim Als u een OAuth 2-verbinding maakt, voert u uw Jira Client Secret in
    E-mail Voer uw e-mailadres in als u een basisverbinding met Jira Cloud maakt.
    API-token Als u een basisverbinding met Jira Cloud maakt, voert u uw API-token in.
    Persoonlijke toegangstoken Als u een basisverbinding aan het Centrum van Gegevens van Jira creeert, ga uw Persoonlijke Token van de Toegang in.
    API-versie Selecteer de Jira API-versie waarmee u verbinding wilt maken.
  3. Klik op Continue om de verbinding te maken en terug te gaan naar de module.

Jira-modules en hun velden

Wanneer u Jira-modules configureert, geeft Workfront Fusion de onderstaande velden weer. Daarnaast kunnen er aanvullende Jira-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

Controleren op records

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

Webhaak

Selecteer de webhaak die u wilt gebruiken om te controleren op records of maak een nieuwe webhaak.

Een nieuwe webhaak maken:

  1. Klik toevoegen

  2. Voer een naam in voor de webhaak.

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

    Voor instructies over het aansluiten van uw rekening van Jira aan de Fusie van Workfront, zie Verbinding Jira aan de Fusie van Workfrontin dit artikel.

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

    • Probleem
    • Opmerking
    • Worklog
    • Project
    • Sprint
    • Bijlage
  5. Selecteer een of meer gebeurtenistypen die dit scenario activeren.

  6. Voer een Jira Query Language-filter in voor deze module.

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

  7. Klik sparen om webhaak te bewaren.

Handelingen

Uitgave toevoegen aan sprint

Deze actiemodule voegt een of meer uitgaven aan een sprint toe.

Verbinding
Voor instructies over het aansluiten van uw rekening van Jira aan de Fusie van Workfront, zie Verbinding Jira aan de Fusie van Workfrontin dit artikel.
Afdruk-id
Voer de Sprint-id in van de sprint waaraan u een uitgave wilt toevoegen of wijs deze toe.
Uitgave-id of -sleutels
Voor elke kwestie of sleutel die u aan sprint wilt toevoegen, toevoegen punt en gaat uitgeeft identiteitskaart of sleutel in. U kunt maximaal 50 invoeren in één module.

Een record maken

Deze actiemodule maakt een nieuwe record in Jira.

Verbinding
Voor instructies over het aansluiten van uw rekening van Jira aan de Fusie van Workfront, zie Verbinding Jira aan de Fusie van Workfrontin dit artikel.
Recordtype

Selecteer het type record dat de module moet maken.

  • Bijlage
  • Opmerking
  • Probleem
  • Project
  • Sprint
  • Worklog
  • Gebruiker
  • Raad
  • Categorie
  • Filter
Overige velden
Vul de andere velden in. De velden zijn afhankelijk van het geselecteerde recordtype beschikbaar.

Aangepaste API-aanroep

Met deze actiemodule kunt u een aangepaste, geverifieerde aanroep van de Jira API maken.

Selecteer de HTTP- verzoekmethode u de API vraag moet vormen. Voor meer informatie, zie HTTP- verzoekmethodes.

Verbinding
Voor instructies over het aansluiten van uw rekening van Jira aan de Fusie van Workfront, zie Verbinding Jira aan de Fusie van Workfrontin dit artikel.
URL
Een pad invoeren ten opzichte van<Instance URL>/rest/api/2/
Methode
Kopteksten

Voeg de kopteksten van het verzoek toe in de vorm van een standaard JSON-object.

Bijvoorbeeld: {"Content-type":"application/json"}

Workfront Fusion voegt de machtigingsheaders voor u toe.

Tekenreeks query

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

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

Lichaam

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.

Een record verwijderen

Deze actiemodule verwijdert de opgegeven record.

Verbinding
Voor instructies over het aansluiten van uw rekening van Jira aan de Fusie van Workfront, zie Verbinding Jira aan de Fusie van Workfrontin dit artikel.
Recordtype

Selecteer het type record dat de module moet verwijderen.

  • Opmerking
  • Probleem
  • Project
  • Sprint
  • Worklog
  • Bijlage
  • Raad
  • Categorie
  • Filter
(Type record)ID
Voer de id of sleutel in van de record die u wilt verwijderen of wijs deze toe.

Een bijlage downloaden

Deze actiemodule downloadt de opgegeven bijlage.

Verbinding
Voor instructies over het aansluiten van uw rekening van Jira aan de Fusie van Workfront, zie Verbinding Jira aan de Fusie van Workfrontin dit artikel.
ID
Voer de id in van de bijlage die u wilt downloaden of wijs deze toe.

Een record lezen

Deze actiemodule leest gegevens uit de opgegeven record in Jira.

Verbinding
Voor instructies over het aansluiten van uw rekening van Jira aan de Fusie van Workfront, zie Verbinding Jira aan de Fusie van Workfrontin dit artikel.
Recordtype

Selecteer het type Jira-record dat de module moet lezen.

  • Bijlage
  • Opmerking
  • Probleem
  • Project
  • Sprint
  • Worklog
  • Gebruiker
  • Raad
  • Categorie
  • Filter
Uitvoer
Selecteer de uitvoer die u wilt ontvangen. Uitvoeropties zijn beschikbaar op basis van het type record dat is geselecteerd in het veld Recordtype.
(Type record)-id
Voer de unieke Jira-id in of wijs deze toe aan de record die u wilt lezen in de module.

Een record bijwerken

Deze actiemodule werkt een bestaand record bij, zoals een uitgave of project.

Verbinding
Voor instructies over het aansluiten van uw rekening van Jira aan de Fusie van Workfront, zie Verbinding Jira aan de Fusie van Workfrontin dit artikel.
Recordtype

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.

  • Opmerking
  • Probleem
  • Project
  • Sprint
  • Overgangskwestie
  • Categorie
  • Filter
ID of sleutel
Voer de id of sleutel in van de record die u wilt bijwerken.
Overige velden
Vul de andere velden in. De velden zijn afhankelijk van het geselecteerde recordtype beschikbaar.

Zoekopdrachten

Zoeken naar records

Deze zoekmodule zoekt naar records in een object in Jira die overeenkomen 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.

Verbinding
Voor instructies over het aansluiten van uw rekening van Jira aan de Fusie van Workfront, zie Verbinding Jira aan de Fusie van Workfrontin dit artikel.
Recordtype

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.

  • Probleem
  • Project
  • Gebruiker
  • Sprint
  • Raad
  • Worklog
  • Opmerking
  • Overgangsprobleem
  • Categorie
Max. resultaten
Ga of kaart het maximumaantal verslagen in u de module tijdens elke cyclus van de scenariouitvoering wilt terugwinnen.
Verschuiven
Voer de id in of wijs de id toe van het eerste item waarvoor u details wilt ophalen. Dit is een manier om de records te pagineren. Als u het 5000ste punt als compensatie ingaat, zou de module punten 5000-9999 terugkeren.
Overige velden
Vul de andere velden in. De velden zijn afhankelijk van het geselecteerde recordtype beschikbaar.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3