Wenn deine Confluence-Instanz mit Jira verbunden ist, kannst du Jira-Vorgänge suchen und als Liste auf Confluence-Seiten und in Live Docs anzeigen. Du kannst die Anzeige anschließend anpassen, indem du Felder hinzufügst, entfernst und neu anordnest.

Passe deine Suche mit Schlüsselwörtern, Filtern oder JQL (Jira Query Language) an.

Jira-Vorgänge einfügen

Bearbeite eine Confluence-Seite oder ein Live Doc, oder erstelle eine neue Seite. Du hast 3 Möglichkeiten, Jira-Vorgänge einzufügen:

Option 1

Wähle ➕▾ in der Symbolleiste aus und wähle Jira-Vorgänge aus

Option 2

Tippe während der Bearbeitung /jira ein und wähle Jira-Vorgänge aus.

Option 3

Du kannst in Jira nach Vorgängen suchen und die Such-Filter-URL in eine Confluence-Seite oder ein Live Doc einfügen.

Nach Vorgängen suchen

Beginne damit, Jira-Vorgänge über eine einfache Schlüsselwortsuche oder per JQL einzufügen.

1. BASIC ist standardmäßig ausgewählt. Mit dieser Option kannst du Filter und Schlüsselwörter verwenden, um nach Vorgängen zu suchen.
2. Wählst du JQL aus, gib deine Abfrage oder Suchbegriffe ein. Zum Beispiel: space = 'TEST'
3. Wähle COUNT VIEW aus, wenn du nur die Anzahl der Vorgänge anzeigen möchtest.
4. Wähle Vorgänge einfügen aus.

Spalten verwalten

Sobald deine Jira-Vorgänge als Liste angezeigt werden, kannst du Spalten per Drag-and-Drop verschieben. Wähle das Spalten-Symbol ▥ aus, um die gewünschten Spalten auszuwählen.

Deine Vorgänge bearbeiten

Wenn du Änderungen an deiner Suchanfrage vornehmen musst, wähle das ✏️-Symbol am unteren Rand der Liste aus.

Passe die Breite der Liste an, indem du das Erweitern-Symbol ⯇⯈ seitlich auswählst.

Vorgänge über eine Jira Query Language (JQL)-Suche anzeigen

Du kannst das Makro verwenden, um eine Liste von Vorgängen auf deiner Seite oder in deinem Doc anzuzeigen, basierend auf den Ergebnissen einer Suche mit Jira Query Language (JQL).

JQL ist eine einfache Abfragesprache, die SQL ähnelt. 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 Bereich ‘TEST’:
  space = "TEST"
• Die folgende Abfrage findet alle Vorgänge in der Komponente ‘documentation’ im Bereich ‘CONF’:
  space = CONF and component = documentation

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

So zeigst du eine Liste von Vorgängen basierend auf einer JQL-Suche an:

1. Füge das Jira-Makro wie oben beschrieben in deine Confluence-Seite oder dein Live Doc ein.
2. Wähle eine Jira-Instanz neben der Schaltfläche Suchen aus.
3. Melde dich bei Aufforderung bei der Jira-Instanz an.
4. Gib die JQL-Abfrage in das Feld Suchen ein.
5. Wähle Suchen aus.
6. Wenn du die Anzeige anpassen möchtest, wähle Anzeigeoptionen aus und passe die Spalten und die Anzahl der Vorgänge an, die in deiner Liste erscheinen sollen.
7. Wähle Einfügen aus.

Vorgänge über eine Jira-URL anzeigen

Du kannst jede der folgenden Jira-Anwendungs-URLs in das Jira-Vorgänge-Makro einfügen. Confluence konvertiert die URL sofort in eine JQL-Suche.

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

Einen einzelnen Vorgang oder ausgewählte Vorgänge anzeigen

So zeigst du einen einzelnen Jira-Vorgang an, wähle eine der folgenden Methoden:

• Füge die URL des Vorgangs direkt in die Confluence-Seite oder das Doc ein. (Der Makro-Browser ist dafür nicht nötig.) Confluence wandelt den Link automatisch in ein Jira-Vorgänge-Makro um.
• Oder: Füge das Jira-Vorgänge-Makro wie oben beschrieben zur Seite oder zum Doc hinzu und wähle Zuletzt angesehen aus, um die zuletzt besuchten Vorgänge zu sehen. Wähle einen Vorgang aus und wähle Einfügen aus.
• Oder: Füge das Jira-Vorgänge-Makro wie oben beschrieben zur Seite oder zum Doc hinzu und füge die Vorgangs-URL in das Suchfeld im Makro-Browser ein.
• Oder: Füge das Jira-Vorgänge-Makro zur Seite oder zum Doc hinzu, definiere deine Suchkriterien im Makro-Browser per JQL wie oben beschrieben und aktiviere dann das Kontrollkästchen neben dem Vorgang in den Suchergebnissen im Makro-Browser.

Du kannst wählen, ob nur der Vorgangsschlüssel oder der Vorgangsschlüssel mit einer Zusammenfassung angezeigt wird. Wähle den Makro-Platzhalter aus und wähle Zusammenfassung anzeigen oder Zusammenfassung ausblenden.

So zeigst du eine Teilmenge von Jira-Vorgängen aus deinen Suchergebnissen an:

1. Füge das Jira-Vorgänge-Makro zur Seite oder zum Live Doc hinzu.
2. Definiere deine Suchkriterien im Makro-Browser per JQL wie oben beschrieben.
3. Aktiviere die Kontrollkästchen neben den gewünschten Vorgängen in den Suchergebnissen im Makro-Browser.

Eine Anzahl von Vorgängen anzeigen

Du kannst wählen, die Anzahl der von deiner Suche gefundenen Vorgänge anzuzeigen, statt einer Liste von Vorgängen. Das Jira-Vorgänge-Makro zeigt dann eine mit der Suche in deiner Jira-Anwendung verknüpfte Anzahl an Vorgängen an.

So zeigst du eine Vorgangsanzahl an:

1. Füge das Jira-Vorgänge-Makro zur Seite oder zum Doc hinzu.
2. Definiere deine Suchkriterien im Makro-Browser per JQL wie oben beschrieben.
3. Wähle Anzeigeoptionen aus und dann Gesamtanzahl der Vorgänge neben “Anzeigeoptionen” im Makro-Browser.
4. Wähle Einfügen aus.

Einen neuen Vorgang erstellen

Während du eine Confluence-Seite oder ein Live Doc bearbeitest, kannst du einen Vorgang in Jira erstellen und anzeigen, ohne den Confluence-Editor zu verlassen.

So erstellst du einen Vorgang und fügst ihn zu deiner Seite oder deinem Live Doc hinzu:

1. Füge das Jira-Vorgänge-Makro wie oben beschrieben zur Seite oder zum Doc hinzu.
2. Wähle Neuen Vorgang erstellen aus.
3. Gib die Informationen zu deiner Jira-Instanz, deinem Bereich und deinem Vorgang wie angefordert an.
4. Wähle Einfügen aus.

Confluence sendet eine Anfrage an deine Jira-Anwendung, um den Vorgang zu erstellen, und zeigt den neu erstellten Vorgang anschließend auf deiner Seite oder in deinem Doc an.