Jira

Overzicht

Software voor bugtracking, issue-tracking en agile projectbeheer. Via Langdock’s integratie kun je Jira rechtstreeks vanuit je gesprekken openen en beheren.

Authenticatie: OAuth Categorie: Ontwikkeling & Issue-tracking Beschikbaarheid: Alle workspace-abonnementen

Beschikbare acties

Issue aanmaken

jira.createIssue

Maakt een issue of, wanneer de optie om subtaken aan te maken in Jira is ingeschakeld, een subtaak aan Vereist bevestiging: Ja Parameters:

parentKey (TEKST, Optioneel): De sleutel van het bovenliggende issue, bijv. sleutel van een epic
assigneeId (TEKST, Optioneel): De Account-ID van de toegewezen gebruiker
beschrijving (MEERREGELIG_TEKST, Optioneel): Een beschrijving van het issue (platte tekst of JSON-geformatteerd Jira-document)
projectKey (TEKST, Vereist): De sleutel van het project waaraan het nieuw aangemaakte issue moet worden toegewezen
summary (TEKST, Vereist): Een korte samenvatting van het issue
issueTypeId (TEKST, Vereist): De ID van het issue-type
customFields (TEKST, Optioneel): Aangepaste veldwaarden bij het aanmaken van een Jira-issue (JSON-object)

Uitvoer: Retourneert het aangemaakte issue met sleutel, ID en alle opgegeven details

Zoek naar Issues

jira.searchforIssues

Zoekt naar issues met behulp van JQL Vereist bevestiging: Nee Parameters:

jql (TEKST, Optioneel): Een JQL-expressie (om prestatie-redenen vereist dit parameter een begrensde query)
fields (TEKST, Optioneel): Een lijst met Jira-issuevelden om op te nemen in de respons, geformatteerd als een JSON-array

Uitvoer: Retourneert een array met issues die overeenkomen met de JQL-query met de opgegeven velden

Haal Issue-typen op voor Project

jira.getIssueTypesforProject

Haalt alle issue-typen op voor een project Vereist bevestiging: Nee Parameters:

projectId (TEKST, Vereist): De ID van het project

Uitvoer: Retourneert een array met issue-typen die beschikbaar zijn voor het project

Haal Alle Issue-typen op voor Gebruiker

jira.getAllIssueTypesforUser

Haalt alle issue-typen op voor een gebruiker Vereist bevestiging: Nee Parameters: Geen Uitvoer: Retourneert een array met alle issue-typen die beschikbaar zijn voor de gebruiker

Haal Recente Projecten op

jira.getRecentProjects

Retourneert een lijst van maximaal 20 projecten die recent door de gebruiker zijn bekeken Vereist bevestiging: Nee Parameters: Geen Uitvoer: Retourneert een array met recente projecten en hun details

Vind Gebruikers

jira.findUsers

Retourneert een lijst met actieve gebruikers die overeenkomen met de zoektekst en eigenschap Vereist bevestiging: Nee Parameters:

query (TEKST, Optioneel): Een zoekstring die wordt vergeleken met gebruikersattributen

Uitvoer: Retourneert een array met gebruikers die overeenkomen met de zoekcriteria

Huidige gebruiker ophalen

jira.getCurrentUser

Haalt details op over de gebruiker van de huidige verbinding Vereist bevestiging: Nee Parameters: Geen Uitvoer: Retourneert details van de huidige gebruiker inclusief ID, e-mail en weergavenaam

Issue ophalen

jira.getIssue

Haalt een issue op via ID of sleutel Vereist bevestiging: Nee Parameters:

issueId (TEKST, Vereist): ID of sleutel van het issue dat moet worden opgehaald

Uitvoer: Retourneert issue-details inclusief alle velden en eigenschappen

Update Issue

jira.updateIssue

Werk een issue bij Vereist bevestiging: Ja Parameters:

issueId (TEKST, Vereist): ID van het issue dat moet worden bijgewerkt
assigneeId (TEKST, Optioneel): De Account-ID van de toegewezen gebruiker
beschrijving (TEKST, Optioneel): Een beschrijving van het issue
projectKey (TEKST, Optioneel): De sleutel van het project waaraan het nieuw aangemaakte issue moet worden toegewezen
summary (TEKST, Optioneel): Een korte samenvatting van het issue
issueTypeId (TEKST, Optioneel): De ID van het issue-type
customFields (TEKST, Optioneel): Aangepaste veldwaarden bij het bijwerken van een Jira-issue

Uitvoer: Retourneert het bijgewerkte issue met nieuwe waarden

Maak Subtaak aan

jira.createSubtask

Maakt een subtaak voor een bestaand issue Vereist bevestiging: Ja Parameters:

parrentissueKey (TEKST, Vereist): De sleutel van het bovenliggende issue
summary (TEKST, Vereist): De titel/samenvatting van de subtaak
projectKey (TEKST, Optioneel): De project sleutel (wordt uit het bovenliggende issue gehaald als deze niet is opgegeven)
subtasktypeId (TEKST, Optioneel): De ID van het subtaak-issue-type (standaard ‘10000’)
beschrijving (TEKST, Optioneel): Een beschrijving van de subtaak
assigneeId (TEKST, Optioneel): De ID van de gebruiker aan wie de subtaak moet worden toegewezen
reporterId (TEKST, Optioneel): De ID van de gebruiker die de subtaak rapporteert
priorityId (TEKST, Optioneel): De ID van het prioriteitsniveau voor de subtaak
customFields (TEKST, Optioneel): Aangepaste veldwaarden bij het aanmaken van een Jira-subtaak

Uitvoer: Retourneert de aangemaakte subtaak met sleutel, ID en ouderrelatie

Verplaats Issue met Transition ID

jira.moveIssuebyTransitionID

Verplaatst een issue door workflowfasen met behulp van een transition ID Vereist bevestiging: Ja Parameters:

issueId (TEKST, Vereist): ID of sleutel van het issue dat verplaatst moet worden
transitionId (TEKST, Vereist): ID van de uit te voeren transition
comment (TEKST, Optioneel): Een opmerking om toe te voegen tijdens de transition

Uitvoer: Retourneert bevestiging van de transition

Haal Transition ID op

jira.getTransitionID

Haalt beschikbare transition IDs op voor een Jira-issue Vereist bevestiging: Nee Parameters:

issueId (TEKST, Vereist): ID of sleutel van het issue waarvoor de transitions moeten worden opgehaald

Uitvoer: Retourneert een array met beschikbare transitions met hun ID’s en namen

Haal Veldmetadata op voor Issue-type

jira.getFieldMetadataforIssueType

Haalt alle beschikbare veldmetadata op voor een issue-type Vereist bevestiging: Nee Parameters:

projectId (TEKST, Vereist): ID of sleutel van het project waarvoor de issue-metadata moet worden opgehaald
issueTypeId (TEKST, Vereist): ID van het issue-type waarvoor de gegevens moeten worden opgehaald

Uitvoer: Retourneert veldmetadata inclusief aangepaste velden en hun configuraties

Project ophalen

jira.getProject

Retourneert de projectdetails voor een project Vereist bevestiging: Nee Parameters:

projectIdOrKey (TEKST, Vereist): De project-ID of project-sleutel
expand (TEKST, Optioneel): Gebruik expand om extra informatie op te nemen in de respons
properties (TEKST, Optioneel): Een lijst met projecteigenschappen om voor het project te retourneren

Uitvoer: Retourneert projectdetails inclusief naam, sleutel, beschrijving en andere eigenschappen

Haal Opmerkingen op

jira.getComments

Retourneert alle opmerkingen voor een issue Vereist bevestiging: Nee Parameters:

issueIdOrKey (TEKST, Vereist): De ID of sleutel van het issue
startAt (TEKST, Optioneel): De index van het eerste item dat moet worden geretourneerd in een pagina met resultaten
maxResults (TEKST, Optioneel): Het maximale aantal items dat per pagina moet worden geretourneerd
orderBy (TEKST, Optioneel): Sorteer de resultaten op een veld
expand (TEKST, Optioneel): Gebruik expand om extra informatie over opmerkingen op te nemen

Uitvoer: Retourneert een array met opmerkingen met hun inhoud, auteur en tijdstempels

Voeg Opmerking Toe

jira.addComment

Voegt een opmerking toe aan een issue Vereist bevestiging: Ja Parameters:

issueIdOrKey (TEKST, Vereist): De ID of sleutel van het issue
comment (MEERREGELIG_TEKST, Vereist): De tekstinhoud van de opmerking
visibilityType (TEKST, Optioneel): Of de zichtbaarheid van de opmerking beperkt is tot een groep of projectrol
visibilityValue (TEKST, Optioneel): De naam van de groep of de naam van de projectrol
visibilityIdentifier (TEKST, Optioneel): De ID van de groep of de naam van de projectrol
expand (TEKST, Optioneel): Gebruik expand om extra informatie over opmerkingen op te nemen
properties (TEKST, Optioneel): Een lijst met opmerkingeigenschappen als JSON

Uitvoer: Retourneert de aangemaakte opmerking met ID en inhoud

Update Opmerking

jira.updateComment

Werkt een opmerking bij Vereist bevestiging: Ja Parameters:

issueIdOrKey (TEKST, Vereist): De ID of sleutel van het issue
commentId (TEKST, Vereist): De ID van de opmerking
comment (MEERREGELIG_TEKST, Vereist): De tekstinhoud van de opmerking
visibilityType (TEKST, Optioneel): Of de zichtbaarheid van de opmerking beperkt is tot een groep of projectrol
visibilityValue (TEKST, Optioneel): De naam van de groep of de naam van de projectrol
visibilityIdentifier (TEKST, Optioneel): De ID van de groep of de naam van de projectrol
notifyUsers (TEKST, Optioneel): Of gebruikers per e-mail worden geïnformeerd
overrideEditableFlag (TEKST, Optioneel): Of schermbeveiliging wordt genegeerd
expand (TEKST, Optioneel): Gebruik expand om extra informatie over opmerkingen op te nemen
properties (TEKST, Optioneel): Een lijst met opmerkingeigenschappen als JSON

Uitvoer: Retourneert de bijgewerkte opmerking met nieuwe inhoud

Haal Projectfasen op

jira.getProjectStages

Haalt de fasen op voor issue-typen van een project Vereist bevestiging: Nee Parameters:

projectId (TEKST, Vereist): ID of sleutel van het project waarvoor de fasen moeten worden opgehaald

Uitvoer: Retourneert een array met projectfasen en hun details

Triggers

Bijgewerkt Issue

jira.updatedIssue

Wordt geactiveerd wanneer een issue is bijgewerkt Vereist bevestiging: Nee Parameters:

projectKey (TEKST, Optioneel): De sleutel van het project die de workflow moet activeren
issueType (TEKST, Optioneel): Het type issue dat de workflow moet activeren

Uitvoer: Retourneert het resultaat van de bewerking

Nieuw Issue

jira.newIssue

Wordt geactiveerd wanneer nieuwe issues worden gemaakt Vereist bevestiging: Nee Parameters: Geen Uitvoer: Retourneert het resultaat van de bewerking

Nieuw Issue (JQL)

jira.newIssueJQL

Wordt geactiveerd wanneer nieuwe issues worden gemaakt (gefilterd met JQL) Vereist bevestiging: Nee Parameters:

jqlQuery (TEKST, Vereist): JQL-query om issues te filteren

Uitvoer: Retourneert het resultaat van de bewerking

(De integratie bevat ook Linear-gerelateerde acties zoals jira.createIssue voor Linear, jira.createComment, jira.updateanIssue, en andere Linear-specifieke getters — parameters en outputs worden in hetzelfde formaat als hierboven voor die acties verstrekt.)

Veelvoorkomende gebruikssituaties

Gegevensbeheer — Beheer en organiseer je Jira-gegevens
Automatisering — Automatiseer workflows met Jira
Rapportage — Genereer inzichten en rapporten
Integratie — Verbind Jira met andere tools

Beste praktijken

Aan de slag

Schakel de Jira-integratie in je workspace-instellingen in, autenticeer met OAuth en test de verbinding met een eenvoudige leesbewerking.

Verken Beschikbare Acties

Bekijk beschikbare acties en identificeer die welke bij jouw use case passen (aanmaken, bijwerken, zoeken, opmerkingen, transitions, enz.).

Veilig Testen

Test bewerkingen eerst in een veilige omgeving (staging-project of beperkte machtigingen) voordat je in productie draait.

Monitor en Optimaliseer

Controleer gebruik op snelheidslimieten en prestaties; pas workflows en machtigingen aan indien nodig.

Belangrijke overwegingen:

Zorg voor de juiste authenticatiegegevens
Respecteer rate limits en API-quotums
Controleer instellingen voor gegevensprivacy

Probleemoplossing

Probleem

Oplossing

Authenticatie mislukt

Controleer uw OAuth-gegevens

Rate limit overschreden

Verminder de frequentie van verzoeken

Gegevens niet gevonden

Controleer machtigingen en beschikbaarheid van gegevens

Verbindingstime-out

Controleer netwerkconnectiviteit

Ondersteuning

Voor extra hulp met de Jira-integratie, neem contact op met [email protected]

VorigeHubSpot VolgendeLinear