Skip to content

Lieferumfang

Workflow-Aktivitäten

Add Jira Attachments

Fügt ein Attachment, z. B. ein Bild, zu einem Jira-Issue hinzu.

Diese Aktivität ermöglicht es, einem bestehenden Jira-Issue eine oder mehrere Dateien als Anhang hinzuzufügen. Die Anhänge können entweder direkt als Binärdaten (Binary Data) oder über Dateipfade und Dateinamen (Attachment Names und Attachment File Paths) bereitgestellt werden. Dadurch können beispielsweise Screenshots, Logdateien oder andere relevante Dokumente automatisiert an ein Ticket angehängt werden.

Eingabe-Argumente

Info

Um einen Anhang zu einer Jira-Issue hinzuzufügen, gibt es zwei Möglichkeiten: - Entweder wird das Argument Binary Data verwendet, um die Datei(en) direkt als Binärdaten zu übergeben, - oder es müssen sowohl Attachment Names (Dateinamen) als auch Attachment File Paths (Dateipfade) angegeben werden, damit die Dateien anhand ihres Pfads und Namens gefunden und angehängt werden können.

Mindestens eine der beiden Varianten muss vollständig ausgefüllt sein, damit die Aktivität erfolgreich ausgeführt werden kann.

Name Typ Erforderlich Beschreibung Beispiel
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue, zu der der Anhang hinzugefügt werden soll. "DEMO-1234"
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Binary Data JiraFile[] ✖ Liste von Dateien, die als Binärdaten bereitgestellt werden. new JiraFile(fileName, data)
Attachment Names String[] ✔ Liste von Dateinamen. Muss in Kombination mit Attachment File Paths verwendet werden. {"A Blue Cat", "A Red Cat"}
Attachment File Paths String[] ✔ Pfade zu den Dateien. Muss in Kombination mit Attachment Names verwendet werden. {"C:/blue-cat.png", "C:/red-cat.png"}

Add Jira Comment

Fügt einen Kommentar zu einer Jira-Issue hinzu.

Info

Falls im Comment Body Bilder im HTML enthalten sind, werden diese automatisch als Anhang dem entsprechenden Jira-Ticket hinzugefügt – dies funktioniert jedoch nur, wenn Convert from Html to Markdown auf true gesetzt ist.

Info

Ab Jira Activities 1.1.10 werden Texte in die Jira-eigene Jira Markup Language umgewandelt, wenn die Flag Convert html to markdown aktiv ist. Zusätzlich kannst du IssueCustomFields jetzt auch in Markdown konvertieren. Sieh dir die Dokumentation an.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue, zu der der Kommentar hinzugefügt werden soll. "DEMO-4132"
Comment Body String ✔ Der eigentliche Text des Kommentars, der zu der Jira-Issue hinzugefügt werden soll. "Das ist ein <b>Beispiel</b> Kommentar."
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Convert from Html to Markdown Boolean ✔ Gibt an, ob der Kommentartext von HTML in Jira Markup umgewandelt werden soll. Ist dies aktiviert (true), werden eingebettete Bilder automatisch als Anhang hinzugefügt.
Standard: True		 True
Passthrough Unknown Tags Boolean ✔ Bestimmt, ob unbekannte HTML-Tags beim Konvertieren beibehalten (true) oder entfernt (false) werden.
Standard: False		 False
Allow Remote Images Boolean ✔ Legt fest, ob Bilder mit einer externen Quelle (http, https) geladen werden dürfen. Ist diese Option deaktiviert (False), werden solche Bilder nicht geladen und entfernt.
Standard: False

Add Jira Worklog

Ein Jira-Worklog ist ein Zeiteintrag, der dokumentiert, wie viel Zeit für eine bestimmte Aufgabe oder ein Jira-Issue aufgewendet wurde. Worklogs werden verwendet, um den Arbeitsaufwand zu erfassen, die Zeiterfassung zu erleichtern und die Nachverfolgung von Projektzeiten zu ermöglichen.

Diese Aktivität ermöglicht es, einem bestehenden Jira-Issue einen neuen Worklog-Eintrag hinzuzufügen. Dabei können Informationen wie die aufgewendete Zeit, das Startdatum, ein Kommentar sowie der Benutzer, der den Worklog erstellt, angegeben werden. So kann automatisiert dokumentiert werden, wann und wie lange an einem Ticket gearbeitet wurde.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue, zu der der Worklog hinzugefügt werden soll. "DEMO-1234"
Author String ✔ Name des Benutzers, der die Arbeit erbracht hat "ExampleUser"
Comment String ✔ Kommentar zum Worklog "Beispiel Kommentar"
Start Date DateTime ✔ Startzeit des Worklogs Date.Now
Time Spent String ✔ Gearbeitete Zeit "2h 30m"
Worklog Strategy WorklogStrategy ✔ Strategie für das Hinzufügen des Worklogs WorklogStrategy.AutoAdjustRemainingEstimate
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")

Assign User To Jira Issue

Mit dieser Aktivität kannst du einem bestehenden Jira-Issue gezielt einen Benutzer als Bearbeiter (Assignee) zuweisen.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Assignee String ✔ Name des Benutzers, dem die Issue zugeordnet werden soll "ExampleUser"
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue, zu der der Bearbeiter zugewiesen werden soll. "DEMO-1234"

Create Jira Issue

Diese Aktivität erstellt eine neue Jira-Issue. Eine Jira-Issue ist ein einzelnes Arbeitselement in Jira, das verwendet wird, um Aufgaben, Fehler, Anforderungen oder andere Vorgänge innerhalb eines Projekts zu erfassen und zu verfolgen. Sie enthält Informationen wie Zusammenfassung, Beschreibung, Typ, Priorität, Status und kann Benutzern zugewiesen werden.

Info

Ab Jira Activities 1.1.10 werden Texte in die Jira-eigene Jira Markup Language umgewandelt, wenn die Flag Convert html to markdown aktiv ist. Zusätzlich kannst du IssueCustomFields jetzt auch in Markdown konvertieren. Sieh dir die Dokumentation an.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Convert Description HTML to Markdown Boolean ✔ Wenn True, wird HTML in Jira Markup konvertiert und somit in Jira formatiert angezeigt.
Standard: False		 False
Passthrough Unknown Tags Boolean ✔ Gibt an, ob unbekannte HTML-Tags beim Konvertieren von HTML nach Markdown beibehalten (True) oder entfernt (False) werden sollen. Ist diese Option aktiviert und Convert Description HTML to Markdown ebenfalls aktiv, bleiben nicht unterstützte HTML-Tags im Text erhalten. Andernfalls werden sie entfernt.
Standard: False
Allow Remote Images Boolean ✔ Legt fest, ob Bilder mit einer externen Quelle (http, https) geladen werden dürfen. Ist diese Option deaktiviert (False), werden solche Bilder nicht geladen und entfernt.
Standard: False
Project Key String ✔ Der Projektschlüssel zum Identifizieren des Projekts. FAQ: Wo finde ich den Projektschlüssel "DEMO"
Summary String ✔ Die Zusammenfassung der Issue "Drucker A-101 ist defekt"
Type String ✔ ID des Issue-Typs (Bug, Task, Story, ...). FAQ: Wo finde ich die Typ-ID "10012"
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Assignee Key String ✖ Name des Benutzers, dem die Issue zugeordnet werden soll "ExampleUser"
Description String ✖ Eine Beschreibung der Jira-Issue "Der Drucker zeigt die Fehlermeldung <b>Papierstau</b>"
Priority String ✖ ID der Priorität des Jira-Tasks FAQ: Wo finde ich die Prioritäts-ID "3"
Parent Issue ID String ✖ Die ID der Parent-Issue. Eine Parent-Issue ist ein übergeordnetes Ticket, zu dem das aktuelle Issue als Unteraufgabe (Sub-Task) gehört. "DEMO-1234"
Security String ✖ ID der Sicherheitsebene. Atlassian
Search by project Boolean ✖ Wenn True, werden Issue-Typen ausschließlich im angegebenen Projekt gesucht.
Standard: False		 False
Custom Fields IssueCustomFieldCollection ✖ Eine Kollektion von CustomFields. Wird verwendet, um benutzerdefinierten Feldern einen Wert zuzuweisen. New IssueCustomFieldCollection()

Ausgabe-Argumente

Name Typ Beschreibung Beispiel
Issue ID String Die Issue-ID der erstellten Issue "DEMO-4242"

Delete Jira Comment

Löscht einen Kommentar einer Jira-Issue.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue, in der der Kommentar ist. "DEMO-1234"
Comment ID String ✔ Die eindeutige Kennung des Jira-Kommentars "123456"

Delete Jira Issue

Löscht eine Jira-Issue.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue "DEMO-1234"

Delete Jira Worklog

Diese Aktivität löscht einen Worklog-Eintrag von einer Jira-Issue.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue, in der der Worklog ist. "DEMO-1234"
Worklog ID String ✔ Die eindeutige Kennung des Jira-Worklogs "123456"

Download Jira Attachment

Lädt einen Jira-Anhang herunter und speichert ihn in einem angegebenen Pfad.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue, in der der Anhang ist. "DEMO-1234"
Attachment ID String ✔ Die eindeutige Kennung des Jira-Anhangs "12212"
TargetDirectory String ✔ Der Pfad, in dem der Anhang gespeichert werden soll "C:/Users/Matrix/Downloads/"

Get Jira Attachments

Gibt eine Liste von Anhängen zurück.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue, in der der Anhang ist. "DEMO-1234"

Ausgabe-Argumente

Name Typ Beschreibung
Attachments Attachment[] Eine Liste von Anhängen

Get Jira Boards

Gibt eine Liste der berechtigten Jira-Boards zurück.

Eingabe Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")

Ausgabe Argumente

Name Typ Beschreibung
Jira Boards Board[] Eine Liste der Jira-Boards

Get Jira Comments

Holt alle Kommentare einer Issue.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue. "DEMO-1234"

Ausgabe-Argumente

Name Typ Beschreibung
Comments Comment[] Eine Liste von Kommentaren

Get Jira Issue

Holt eine Issue anhand einer ID.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue. "DEMO-1234"

Ausgabe-Argumente

Name Typ Beschreibung
Issue Issue Die Jira-Issue

Get Jira Issue Worklog

Holt einen Worklog-Eintrag anhand einer ID.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue, welche den Worklog-Eintrag beinhaltet. "DEMO-1234"
Worklog ID String ✔ Die eindeutige Kennung des Worklog-Eintrags. "12345"

Ausgabe-Argumente

Name Typ Beschreibung
Worklog Worklog Der Worklog-Eintrag

Get Jira Issue Worklogs

Holt alle Worklog-Einträge einer Issue.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue, welche die Worklog-Einträge beinhaltet. "DEMO-1234"

Ausgabe-Argumente

Name Typ Beschreibung
Worklogs Worklog[] Eine Liste von Worklog-Einträgen

Get Jira Issues

Holt eine Liste von JiraIssues.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Jql Query String ✔ Query, um nach Jira-Issues zu filtern. Atlassian "priority = High"
Limit String ✖ Gibt ein Limit an Issues an, die geholt werden sollen. Setze -1 für kein Limit.
Standard: -1		 50

Ausgabe-Argumente

Name Typ Beschreibung
Issues JiraIssue[] Eine Liste von Jira-Issues

Get Jira Sprints

Diese Aktivität ruft eine Liste von Jira-Sprints im Kontext eines oder mehrerer Boards ab.

Eingabe Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Jira Boards String[] ✔ Eine Liste der Jira-Board-IDs. {"DEMO", "YAY", "LTG"}

Ausgabe Argumente

Name Typ Beschreibung
Sprints Jira Sprints[] Eine Liste von Jira-Sprints.

Get Jira User by Key

Rufe einen Jira-Benutzer anhand seines Keys ab.

Eingabe Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Jira user Key String ✔ Der Key des Benutzers. userkey-12345

Ausgabe Argumente

Name Typ Beschreibung
Jira user JiraUser Der Jira-Benutzer mit dem angegebenen Key.

Get Jira User by Mail

Rufe einen Jira-Benutzer anhand seiner E-Mail-Adresse ab.

Eingabe Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Jira User Mail String ✔ Die E-Mail-Adresse des Benutzers. alice@example.com

Ausgabe Argumente

Name Typ Beschreibung
Jira user JiraUser Der Jira-Benutzer mit der angegebenen E-Mail-Adresse.

Remove Jira Attachment

Entfernt Jira-Anhänge von einer Issue.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue, welche den Anhang beinhaltet. "DEMO-1234"
Attachment ID String ✔ Die eindeutige Kennung des Anhangs. "12345"

Start Jira Workflow Transition

Führt eine definierte Workflow-Transition für eine Jira-Issue aus, um deren Status im Arbeitsablauf zu ändern (z. B. von "Offen" zu "Erledigt"). Diese Aktivität wird verwendet, um den Status einer bestehenden Issue gezielt zu aktualisieren und so den nächsten Schritt im Jira-Workflow einzuleiten.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue, für die die Workflow-Transition ausgeführt werden soll. "DEMO-1234"
Resolution Resolution ✔ Gibt den Ziel-Status (Resolution) an, in den die Issue überführt werden soll, z. B. "Done" für abgeschlossen. Resolution.Done

Update Jira Comment

Aktualisiert einen bestehenden Kommentar in einer Jira-Issue. Mit dieser Aktivität kann ein vorhandener Kommentar durch einen neuen ersetzt werden. Die zugehörige Serviceverbindung, die Ziel-Issue und der neue Kommentar werden dabei fest vorgegeben.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Ist dieses Feld leer, wird automatisch die Standard-Serviceverbindung genutzt. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Issue ID String ✔ Die eindeutige Kennung der Jira-Issue, zu der der Kommentar gehört. "DEMO-1234"
Comment Comment ✔ Der neue Kommentar, der den bestehenden Kommentar vollständig ersetzt.

Update Jira Issue

Aktualisiert ein bestehendes Jira-Issue mit neuen oder geänderten Werten für Felder wie Titel, Beschreibung, Priorität, Custom Fields, Autor, Bearbeiter und mehr. Die Aktivität ermöglicht es, gezielt einzelne Eigenschaften eines Jira-Issues zu aktualisieren, einschließlich benutzerdefinierter Felder und der Konvertierung von HTML-Beschreibungen in Markdown. Optional kann die Serviceverbindung angegeben werden, ansonsten wird die Standardverbindung verwendet.

Info

Ab Jira Activities 1.1.10 werden Texte in die Jira-eigene Jira Markup Language umgewandelt, wenn die Flag Convert html to markdown aktiv ist. Zusätzlich kannst du IssueCustomFields jetzt auch in Markdown konvertieren. Sieh dir die Dokumentation an.

Eingabe-Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Leer lassen, um die Standardverbindung zu nutzen. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Issue ID String ✔ Die eindeutige Kennung des Jira-Issues, das aktualisiert werden soll. "DEMO-1234"
Summary String ✖ Der neue Titel (Zusammenfassung) des Issues. "Neuer Titel"
Custom Fields IssueCustomFieldCollection ✖ Sammlung benutzerdefinierter Felder, die aktualisiert werden sollen. New IssueCustomFieldCollection()
Priority String ✖ Die neue Priorität des Issues. "High"
Author String ✖ Der Autor der Änderung. "max.mustermann"
Assignee Key String ✖ Der Benutzername/Key des neuen Bearbeiters. "jira.user"
Description String ✖ Die neue Beschreibung des Issues. "Neue Beschreibung"
Passthrough Unknown Tags Boolean ✔ Bestimmt, ob unbekannte HTML-Tags beim Konvertieren beibehalten (true) oder entfernt (false) werden.
Standard: False		 False
Convert html to markdown Boolean ✔ Gibt an, ob die Beschreibung von HTML in Jira Markup umgewandelt werden soll.
Standard: False		 False
Allow Remote Images Boolean ✔ Legt fest, ob Bilder mit einer externen Quelle (http, https) geladen werden dürfen. Ist diese Option deaktiviert (False), werden solche Bilder nicht geladen und entfernt.
Standard: False
Custom Field is a multi value picker Boolean ✖ Dieses Argument ist veraltet und wird nicht mehr verwendet. Deprecated

Add Jira User To Project Role Activity

Diese Aktivität fügt einen Jira-Benutzer zu einer Projektrolle hinzu.

Tip

Den User kannst du am besten über Get Jira User by Mail oder Get Jira User by Key erhalten.

Eingabe Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Leer lassen, um die Standardverbindung zu nutzen. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Project Key String ✔ Key of the project, where you want to add the user to. "DEMO"
Project Role Id Integer ✔ The project role id. 1000
Project User JiraUser ✔ User to be added to the project role. MyUserVariable

Remove Jira User From Project Role Activity

Diese Aktivität entfernt einen Jira-Benutzer von einer Projektrolle.

Tip

Den User kannst du am besten über Get Jira User by Mail oder Get Jira User by Key erhalten.

Eingabe Argumente

Name Typ Erforderlich Beschreibung Beispiel
Service Connection Guid ✖ Die Fragment-ID der zu verwendenden Serviceverbindung. Leer lassen, um die Standardverbindung zu nutzen. Guid.Parse("9d57b6c9-a9cc-c101-51b8-08db0e9f8ec1")
Project Key String ✔ Key of the project, where you want to add the user to. "DEMO"
Project Role Id Integer ✔ The project role id. 1000
Project User JiraUser ✔ User to be removed from the project role. MyUserVariable

Workflows

Jira Custom Fields DEMO

Kopiere den Workflow zum Anpassen

Wenn du Anpassungen an diesem Workflow vornehmen möchtest, kopiere ihn zunächst und bearbeite dann die Kopie.

Ein exemplarischer Workflow, der Schritt für Schritt zeigt, wie benutzerdefinierte Felder (Custom Fields) in der Create Jira Issue Activity verwendet werden können.

Labtagon Jira Issue Synchronization

Kopiere den Workflow zum Anpassen

Wenn du Anpassungen an diesem Workflow vornehmen möchtest, kopiere ihn zunächst und bearbeite dann die Kopie.

Dieser Workflow wird durch die Labtagon Jira Issue Update Engine Activation ausgelöst. Er ruft alle Jira-Issues mit dem Status "To Do" oder "Done" ab und sucht anhand des Custom Fields Matrix42TicketNumber nach dem zugehörigen Matrix-Incident. Anschließend werden die relevanten Daten aus dem Incident in das entsprechende Jira-Issue zurückübertragen und dort aktualisiert.

Labtagon Jira Create and Update Issue DEMO

Kopiere den Workflow zum Anpassen

Wenn du Anpassungen an diesem Workflow vornehmen möchtest, kopiere ihn zunächst und bearbeite dann die Kopie.

Erstellt ein exemplarisches Jira-Ticket, aktualisiert dieses mit neuen Werten und fügt Anhänge hinzu. Dieser Workflow dient vorrangig dazu, die Verbindung sowie die Funktionalität der Jira-Integration zu validieren und zu testen.

Labtagon Convert Incident to Jira Issue

Kopiere den Workflow zum Anpassen

Wenn du Anpassungen an diesem Workflow vornehmen möchtest, kopiere ihn zunächst und bearbeite dann die Kopie.

Info

Eine Beschreibung zur erstmaligen Konfiguration findest du im Abschnitt Getting Started.

Dieser Workflow wird von der Konformitätsregel LABTAGONIncidentToJiraIssue aufgerufen und erstellt anhand eines Incidents ein Jira-Ticket.

Konformitätsregeln

LABTAGONIncidentToJiraIssue

Beschreibung

Die Konformitätsregel dient dazu, nach der Konfiguration beim Anlegen eines Incidents automatisch einen Jira-Issue zu erstellen.

Warning

Damit die Konformitätsregel funktioniert, muss in Jira das Custom Field Matrix42TicketNumber vom Typ string existieren!

Eigenschaften

Eigenschaft Wert bei Auslieferung
Aktiviert Nein
Gebunden an Störung (SPSActivityTypeIncident)

Engine Activations

Labtagon Jira Issue Update

Diese Engine Activation dient bei Nutzung des Demo-Contents für dein System dazu, die von dir erstellten Jira-Issues mit Kommentaren zu aktualisieren.

Eigenschaft Wert bei Auslieferung
Gesperrt Ja

Webservices

GetDefaultServiceConnectionId

HTTP Method: GET
Endpunkt: /api/services/Jira/GetDefaultServiceConnectionId

Die Methode GetDefaultServiceConnectionId gibt die eindeutige ID (GUID) der aktuell als Standard definierten Jira-Service-Connection zurück. Sie ermöglicht es anderen Systemkomponenten oder Workflows, automatisiert auf die konfigurierte Standardverbindung zuzugreifen, ohne dass eine manuelle Auswahl oder Konfiguration der Verbindungs-ID erforderlich ist. Die Rückgabe erfolgt als String im GUID-Format.

GetServiceConnection

HTTP Method: GET
Endpunkt: /api/services/Jira/GetServiceConnection

Der Endpunkt GetServiceConnection ermöglicht es, eine spezifische Service-Connection anhand ihrer eindeutigen ID (GUID) abzufragen. Als Antwort liefert der Endpunkt die vollständigen Verbindungsinformationen zur angegebenen Service-Connection zurück. Dies ist insbesondere dann hilfreich, wenn Workflows oder andere Systemkomponenten gezielt auf eine bestimmte, bereits konfigurierte Verbindung zugreifen müssen.

Data Contracts

Data Contracts sind strukturierte Datenobjekte, die den Austausch von Informationen zwischen verschiedenen Aktivitäten, Workflows oder Systemen standardisieren. Sie definieren, welche Felder und Datentypen für die Übertragung benötigt werden, und sorgen so für eine klare Schnittstelle und Kompatibilität zwischen den beteiligten Komponenten.

JiraFile

Typdefinition: Labtagon.M42.JiraConnector.Contracts.JiraFile

Beschreibung

Ein JiraFile repräsentiert eine Datei, die an einen Jira-Issue angehängt werden kann. Typischerweise handelt es sich dabei um Anhänge wie Bilder, Dokumente oder andere Dateitypen, die im Rahmen eines Workflows an Jira übertragen werden sollen. Das Objekt enthält den Namen der Datei sowie die binären Daten der Datei selbst.

Beispiele

{
    "Name": string, // Dateiname, z. B. cat.png
    "Data": byte[] // Binäre Bilddaten
}

New JiraFile(fileName, data)

WorklogStrategy

Typdefinition: Labtagon.M42.JiraConnector.Contracts.WorklogStrategy

Beschreibung

Die WorklogStrategy ist ein Enum, welches beschreibt, wie Arbeitszeiten in Jira erfasst und protokolliert werden sollen. Sie legt fest, ob beispielsweise für jeden Workflow-Schritt ein separater Worklog-Eintrag erstellt wird, wie die Zeit auf Issues verteilt wird oder ob bestimmte Felder (z. B. Kommentar, Sichtbarkeit) automatisch gesetzt werden. Die Strategie sorgt dafür, dass die Zeiterfassung konsistent und den jeweiligen Anforderungen entsprechend erfolgt.

Beispiele

// Enum
{
    // Die verbleibende Schätzung wird automatisch anhand der erfassten Arbeitszeit angepasst.
    AutoAdjustRemainingEstimate, 

    // Die verbleibende Schätzung bleibt unverändert, unabhängig von der erfassten Arbeitszeit.
    RetainRemainingEstimate,

    // Eine neue verbleibende Schätzung wird explizit gesetzt.
    NewRemainingEstimate
}

WorklogStrategy.AutoAdjustRemainingEstimate

IssueCustomFieldCollection

Typdefinition: Labtagon.M42.JiraConnector.Contracts.IssueCustomFieldCollection

Beschreibung

Ein Wrapper für eine Kollektion aus IssueCustomFields

Beispiele

Mit der Create Collection-Aktivität musst du zuerst eine Collection initiieren.

Anschließend kann mit der Add To Collection-Aktivität ein Element hinzugefügt werden. Dazu trage folgenden Ausdruck in das Feld item ein.

' Custom Field mit einem Wert
New IssueCustomField("MyField", "MyValue")

' Wert zu Markdown Konvertieren (ab Jira Aktivities 1.1.10)
New IssueCustomField("MyField", "<b>MyValue</b>", convertToMarkdown:=True)

' Custom Field mit mehreren Werten
New IssueCustomField("MyMultiField", New String() {"Value 1", "Value 2"}, isMultiValue:=True)

IssueCustomField

Typdefinition: Labtagon.M42.JiraConnector.Contracts.IssueCustomField

Beschreibung

IssueCustomField repräsentiert ein benutzerdefiniertes Jira-Feld und ermöglicht das Setzen eines oder mehrerer Werte für dieses Feld.

Beispiele

{
    "Name": string,
    "Values": string[],
    "IsMultiValue": boolean
    "ConvertToMarkdown": boolean
}

' Custom Field mit einem Wert
New IssueCustomField("MyField", "MyValue")

' Wert zu Markdown Konvertieren (ab Jira Aktivities 1.1.10)
New IssueCustomField("MyField", "<b>MyValue</b>", convertToMarkdown:=True)

' Custom Field mit mehreren Werten
New IssueCustomField("MyMultiField", {"Value 1", "Value 2"}, isMultiValue:=True)

Attachment

Typdefinition: Labtagon.M42.JiraConnector.Contracts.Attachment

Beschreibung

Ein Anhangelement

Beispiele

{
    "Id": string,
    "AuthorUser": string,
    "CreatedDate": DateTime,
    "FileName": string,
    "MimeType": string,
    "FileSize": long
}

Comment

Typdefinition: Labtagon.M42.JiraConnector.Contracts.Comment

Beschreibung

Hier beschreibst du, wofür Comment gedacht ist.

Beispiele

{
    "Body": string,
    "Author": JiraUser,
    "AuthorName": string,
    "CreatedTime": DateTime,
}

Issue

Typdefinition: Labtagon.M42.JiraConnector.Contracts.Issue

Beschreibung

Eine Jira-Issue ist das zentrale Element in Jira zur Nachverfolgung von Aufgaben, Fehlern, Anforderungen oder anderen Arbeitseinheiten. Sie enthält alle relevanten Informationen wie Titel, Beschreibung, Status, Priorität, zugewiesene Benutzer, Kommentare, Anhänge und benutzerdefinierte Felder. Jede Issue besitzt eine eindeutige Kennung (z. B. "DEMO-1234") und kann im Lebenszyklus verschiedene Status durchlaufen, um den Fortschritt transparent zu machen. Jira-Issues werden genutzt, um Arbeitsprozesse zu strukturieren, zu dokumentieren und die Zusammenarbeit im Team zu unterstützen.

Beispiele

{
    "ID": string,
    "Summary": string,
    "Description": string,
    "Assignee": string,
    "Status": string,
    "PriorityName": string,
    "PriorityDescription": string,
    "ReportingUser": string,
    "ProjectKey": string,
    "Resolution": Resolution,
    "AssigneeUser": JiraUser,
    "CreatedDate": DateTime,
    "DueDate": DateTime,
    "Type": IssueType,
    "Updated": DateTime,
    "CustomFields": IssueCustomField[],
}

Resolution

Typdefinition: Labtagon.M42.JiraConnector.Contracts.Resolution

Beschreibung

Resolution beschreibt den aktuellen Status der Issue.

Beispiele

// Enum
{
    Todo,
    InProgress,
    Done
}

Resolution.InProgress

Worklog

Typdefinition: Labtagon.M42.JiraConnector.Contracts.Worklog

Beschreibung

Ein Worklog-Eintrag in Jira dokumentiert die aufgewendete Arbeitszeit zu einer bestimmten Issue. Er enthält Informationen darüber, wer wann wie lange an einer Aufgabe gearbeitet hat, sowie optionale Kommentare zur geleisteten Arbeit.

Beispiele

{
    "Id": string,
    "Author": string,
    "Comment": string,
    "TimeSpent": string,
    "AuthorUser": JiraUser,
    "StartDate": DateTime,
    "CreateDate": DateTime,
    "UpdateDate": DateTime,
}

JiraUser

Typdefinition: Labtagon.M42.JiraConnector.Contracts.JiraUser

Beschreibung

Ein Jira-Benutzer repräsentiert eine Person oder ein Konto in deinem Jira-System. In den bereitgestellten Daten siehst du nur die Felder, auf die der verwendete API-User tatsächlich Zugriffsrechte hat.

Beispiel: Wenn du nur Leserechte für den Anzeigenamen und die E-Mail-Adresse hast, werden nur diese Informationen im Feld JiraUser angezeigt.

Warning

Je nachdem, ob Jira-Cloud oder Jira-Datacenter verwendet wird, unterscheidet sich die Response leicht.

Tip

Ein Benutzer kann seine E-Mail auch für alle sichtbar machen. Mehr dazu findest du im FAQ.

Beispiele

{
    "Key": string,
    "AccountId": string, // Nur bei Jira-Cloud
    "Username": string, // Nur bei Data-Center
    "DisplayName": string,
    "Email": string,
    "Active": boolean
}

Board

Typdefinition: Labtagon.M42.JiraConnector.Contracts.Board

Beschreibung

Eine Minimale Darstellung eines Jira Boards.

Beispiele

{
    "Id": int,
    "Self": string,
    "Name": string
}

New Board()

Sprint

Typdefinition: Labtagon.M42.JiraConnector.Contracts.Sprint

Beschreibung

Informationen zu einem Jira Sprint.

Beispiele

{
    "Id": number,
    "Self": string,
    "State": string,
    "Name": string,
    "StartDate": Date,
    "EndDate": Date,
    "CompleteDate": Date,
    "ActivatedDate": Date,
    "OriginBoardId": number,
    "Goal": string,
    "Synced": boolean,
    "AutoStartStop": boolean
}

New Sprint()