Wenn deine Confluence Site mit einer Jira-Anwendung verbunden ist, kannst du Jira-Issues auf Confluence Seiten erstellen und anzeigen. Du kannst Confluence mit jeder Jira-Anwendung verbinden, einschließlich Jira Software und Jira Service Desk.

Mit dem Jira Makro kannst du:

• Eine Liste von Vorgängen auf deiner Seite anzeigen, basierend auf einer Jira Query Language (JQL) (Englisch)Suche, einem Filter oder einer URL.
• Einen einzelnen Vorgang anzeigen.
• Eine Anzahl von Vorgängen anzeigen.
• Neue Vorgänge erstellen und sie auf deiner Seite anzeigen, ohne Confluence zu verlassen.

So fügst du ein Makro hinzu:

1. Beim Bearbeiten klickst du in der Symbolleiste auf .
2. Finde das Makro mithilfe seines Namens und wähle es aus.
3. Richte es nach Bedarf ein.

So bearbeitest du ein Makro:

1. Wähle den Makroplatzhalter aus.
2. Klicke auf das Symbol Bearbeiten, um das Konfigurationsfenster zu öffnen.
3. Richte die Einstellungen ein. Deine Änderungen werden während der Bearbeitung gespeichert.
4. Setze die Bearbeitung der Seite fort und schließe das Panel.

Du kannst das Makro verwenden, um eine Tabelle mit Vorgängen auf deiner Seite anzuzeigen, die auf den Ergebnissen einer Suche mit der Jira Query Language (JQL) basiert.

JQL ist eine einfache Abfragesprache, die ähnlich wie SQL ist. Eine grundlegende JQL-Abfrage besteht aus einem Feld, gefolgt von einem Operator (z. B. = oder >), gefolgt von einem oder mehreren Werten oder Funktionen.

Beispiele:

• Die folgende Abfrage findet alle Vorgänge im Projekt "TEST":

              project = "TEST"

• Die folgende Abfrage findet alle Vorgänge in der Komponente "Dokumentation" des Projekts "CONF":

              project = CONF and component = documentation

Weitere Informationen zur JQL-Syntax findest du unter Erweiterte Suche (Englisch) in der Jira Software-Dokumentation.

So zeigst du eine Tabelle mit Vorgängen an, die auf einer JQL-Suche basieren:

1. Füge das Jira Makro in deine Confluence Seite ein, wie oben beschrieben.
2. Wähle einen Jira-Server neben der Schaltfläche Suchen.
3. Wenn du dazu aufgefordert wirst, melde dich auf dem Jira-Server an.
4. Gib die JQL-Abfrage in das Suchfeld ein.
5. Klicke auf Suchen.
6. Wenn du die Anzeige anpassen möchtest, wähle Anzeigeoptionen und passe die Spalten und die Anzahl der Probleme an, die in deiner Problemtabelle erscheinen sollen.
7. Klicke auf Einfügen.

Du kannst jede der folgenden Jira-Anwendungs-URLs in das Jira Makro einfügen. Confluence wandelt die URL sofort in eine JQL-Suche um.

• Eine beliebige URL für eine Vorgangssuche oder einen Filter.
• Eine URL für einen einzelnen Vorgang.
• Die URL der XML-Ansicht einer Suche.

Um einen einzelnen Jira Vorgang anzuzeigen, wähle eine der folgenden Methoden aus:

• Füge die URL des Vorgangs direkt auf der Confluence Seite ein. (Du brauchst den Makro-Browser nicht zu verwenden.) Confluence wandelt den Link automatisch in ein Jira Makro um.
• Oder: Füge das Jira Makro wie oben beschrieben zur Seite hinzu und wähle Kürzlich gesehen aus, um die Vorgänge zu sehen, die du kürzlich besucht hast. Wähle ein Vorgang aus und klicke auf Einfügen.
• Oder: Füge das Jira Makro wie oben beschrieben zu der Seite hinzu und füge die URL der Ausgabe in das Suchfeld des Makrobrowsers ein.
• Oder: Füge das Jira Makro zur Seite hinzu, definiere deine Suchkriterien im Makro-Browser über JQL wie zuvor beschrieben und aktiviere dann das Kontrollkästchen neben der Ausgabe in den Suchergebnissen im Makro-Browser.

Du kannst wählen, ob du nur den Vorgangsschlüssel oder den Vorgangsschlüssel und eine Zusammenfassung anzeigen lassen willst. Markiere den Makro-Platzhalter und wähle Zusammenfassung anzeigen oder Zusammenfassung ausblenden aus. 

Um eine Teilmenge der Jira Vorgänge aus deinen Suchergebnissen anzuzeigen:

1. Füge das Jira Makro zu deiner Seite hinzu.
2. Definiere deine Suchkriterien im Makro-Browser über JQL, wie zuvor beschrieben.
3. Aktiviere die Kontrollkästchen neben den gewünschten Vorgängen in den Suchergebnissen im Makro-Browser.

Du kannst dir die Anzahl der von deiner Suche zurückgegebenen Vorgänge anzeigen lassen, anstelle einer Tabelle mit den Vorgängen. Das Jira Makro zeigt die Anzahl der Vorgänge an, die mit der Suche in deiner Jira-Anwendung verknüpft sind.

So zeigst du die Anzahl der Vorgänge an:

1. Füge das Jira Makro zu deiner Seite hinzu.
2. Definiere deine Suchkriterien im Makro-Browser über JQL, wie oben beschrieben.
3. Wähle die Anzeigeoptionen aus und klicke dann neben den Anzeigeoptionen auf Gesamtanzahl Vorgänge.
4. Klicke auf Einfügen.

Während du eine Confluence Seite bearbeitest, kannst du ein Vorgang in Jira erstellen und ihn auf deiner Confluence Seite anzeigen, ohne den Confluence Editor zu verlassen.

So erstellst du ein Vorgang und fügst es zu deiner Seite hinzu:

1. Füge das Jira Makro zur Seite hinzu, wie es oben beschrieben wurde.
2. Klicke auf Neuen Vorgang erstellen.
3. Gib die Informationen zu deinem Jira Server, deinem Projekt und deinem Vorgang ein, wenn du dazu aufgefordert wirst.
4. Klicke auf Einfügen.

Confluence sendet eine Anfrage an deine Jira-Anwendung, um den Vorgang zu erstellen, und zeigt den neu erstellten Vorgang auf deiner Seite an.

Einschränkungen

Das Jira Makro wird dich benachrichtigen, wenn es nicht in der Lage ist, einen Vorgang in dem ausgewählten Projekt zu erstellen. Das kann daran liegen, dass das Projekt ein erforderliches Feld, eine Feldkonfiguration oder eine andere Anpassung hat, die vom Jira Makro nicht unterstützt wird. In diesem Fall musst du den Vorgang direkt in deiner Jira-Anwendung erstellen.

Formatierte Felder aus Jira können in Confluence angezeigt werden, wenn du eine Verknüpfung zwischen Confluence und Jira einrichtest. Andernfalls werden solche formatierten Felder in der Ausgabe des Jira Makros umgangen. Damit soll verhindert werden, dass bösartiger HTML-Code von einem nicht vertrauenswürdigen Jira-Server übermittelt wird. Am wahrscheinlichsten wirst du dies im Beschreibungsfeld bemerken.

Die Funktionalität wird von einem Add-on (Plugin) namens "Jira Macros" bereitgestellt. Um das Makro auf deiner Instanz nicht verfügbar zu machen, kannst du das Add-on deaktivieren. Weitere Informationen findest du unter Deaktivieren und Aktivieren von Apps (Englisch).

Wiki Markup Beispiel

Wiki-Markup ist nützlich, wenn du ein Makro außerhalb des Editors hinzufügen musst, zum Beispiel als benutzerdefinierten Inhalt in der Seitenleiste, der Kopfzeile oder der Fußzeile eines Bereichs.

Makroname: jiraissues

Makrokörper: Keine.

            {jiraissues:anonymous=true|url=https://jira.atlassian.com/issues/?filter=41225}