Confluence Cloud Dokumentation

Inhalt nach Stichwort Makro einfügen



Das Makro Inhalt nach Stichwort wird verwendet, um Listen von Seiten, Blog-Einträgen oder Anhängen anzuzeigen, die bestimmte Stichwörter haben.  Es eignet sich hervorragend, um zugehörige Seiten zusammenzufassen und Inhalte herauszufiltern, die du nicht sehen willst.

Du könntest dieses Makro zum Beispiel verwenden, um eine Liste aller Seiten anzuzeigen, die das Stichwort "Design" und das Wort "Blaupausen" enthalten, oder um alle Seiten mit dem Stichwort "meeting-notes" aufzulisten, in denen du erwähnt wurdest.

So sieht das Makro auf deiner Seite aus:



Verwende das Inhalt nach Stichwort Makro

So fügst du das Inhalt nach Stichwort 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.


Du kannst auch / auf der Seite eintippen, um die gleiche Liste aufzurufen, die du auch bei der Auswahl in der Symbolleiste siehst. Tippe weiter den Namen des Makros ein, um die Liste zu filtern.

So bearbeitest du das Inhalt nach Stichwort 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 auch die Symbole Zurück zur Mitte, Verbreitern und Volle Breite auswählen, um die Breite einiger Makros anzupassen. Wähle das Mülleimersymbol aus, um das Makro zu entfernen.


CQL-Filter

CQL (Confluence Query Language) ist eine für Confluence entwickelte Abfragesprache, die du in einigen Makros und in der Confluence Suche verwenden kannst. In der Confluence Suche und den CQL-gestützten Makros kannst du Filter hinzufügen, um eine Suchabfrage zu erstellen. Um einen Filter zu deiner Abfrage hinzuzufügen, wähle den Link Filter hinzufügen.

Du kannst die folgenden CQL-Filter verwenden:


Filter

Beschreibung

Operatoren

Stichwort*


Gibt Seiten, Blog-Einträge oder Anhänge mit diesen Stichwörtern zurück.

OR (mehrere Werte im selben Filter)

AND (mehrere Stichwörter als Filter)

Mit Vorgänger

Gibt die Seiten zurück, die im hierarchischen Verzeichnis unter dieser Seite liegen.

So kannst du das Makro auf ein einzelnes hierarchisches Verzeichnis beschränken.

OR (mehrere Werte im selben Filter)

Beitragender**

Gibt Seiten oder Blog-Einträge zurück, die von diesen Personen erstellt oder bearbeitet wurden.

OR (mehrere Werte im selben Filter)

Ersteller

Gibt Artikel zurück, die von diesen Personen erstellt wurden.

OR (mehrere Werte im selben Filter)

Erwähnt Benutzer

Gibt Seiten und Blog-Einträge zurück, die diese Personen mit @ erwähnen.

OR (mehrere Werte im selben Filter)

Mit übergeordnetem Element

Gibt nur direkte Unterseiten dieser Seite zurück (weitere Unterseiten werden nicht berücksichtigt)

EQUALS (nur eine Seite)

Bereich(e)**

Gibt Artikel aus diesen Bereichen zurück.

OR (mehrere Werte im selben Filter)

Einschließlich Text**

Gibt Artikel zurück, die diesen Text enthalten.

CONTAINS (einzelnes Wort oder Satz)

Mit Titel

Gibt Artikel zurück, die diesen Text im Titel enthalten.

CONTAINS (einzelnes Wort oder Satz)

vom Typ**

Gibt nur Seiten, Blogs oder Anhänge zurück.

OR (mehrere Werte im selben Filter)

AND-, OR- und NOT-Operatoren


  • Für eine ODER-Suche (OR) gibst du mehrere Werte in dasselbe Feld ein.
    Wenn du also Seiten mit den Stichworten "stichwort-a", "stichwort-b" oder beidem anzeigen willst, gibst du "stichwort-a" und "stichwort-b" in dasselbe Stichwörter-Feld ein, etwa so:
  • Für eine UND-Suche (AND) fügst du mehr als einen Filter hinzu und gibst in jedem einen einzelnen Wert an.
    Wenn du nur Seiten mit Stichwörtern a und b anzeigen willst, gibst du "stichwort-a" in ein Stichwörterfeld ein, fügst dem Makro ein zweites Stichwörterfeld hinzu und gibst "stichwort-b" in das zweite Stichwörterfeld ein, etwa so:


Einfach ausgedrückt: ODER-Werte (OR) werden in denselben Filter eingegeben, UND-Werte (AND) in einen anderen Filter. 
Nur einige Filter unterstützen UND (AND). Wenn der Filter den Operator UND (AND) nicht unterstützt, kannst du diesen Filter nur einmal hinzufügen.


  • Für eine NICHT-Suche (NOT) gibst du ein Minuszeichen (-) vor den Stichwörtern ein. Das schließt alles aus, was dieses Stichwort enthält.




* Dieses Feld ist in CQL-gesteuerten Makros erforderlich.

** Du kannst diese Filter in CQL-gesteuerten Makros hinzufügen, aber in der Suche sind sie Teil der Standard-Suchfilter, sodass sie nicht im Menü Filter hinzufügen erscheinen.


Makro-Anzeigeoptionen

Diese Optionen bestimmen, wie das Makro auf deiner Seite erscheint.


Parameter

Standard

Beschreibung

Sortieren nach

letzte Änderung

Sortiere die Liste nach dem Titel, dem Erstellungsdatum oder dem Datum der letzten Änderung. Wenn du keine Option auswählst, wird die CQL-Standardsortierung nach Relevanz verwendet.

Umgekehrte Sortierung

Falsch

Sortiere die Liste absteigend statt aufsteigend (Z - A, früheste - späteste)

Maximale Anzahl von Seiten

15

Begrenze die Anzahl der Elemente, die in die Liste aufgenommen werden sollen. Dies kann ein beliebiger Wert bis zu 500 Seiten sein.

Liste Titel

Leer

Füge eine optionale Überschrift für das Makro ein

Stichwörter für jede Seite anzeigen

Wahr

Die Stichwörter für die einzelnen Artikel ein- oder ausblenden

Anzeige des Bereichnamens für jede Seite

Wahr

Den Namen des Bereichs für jedes Element ein- oder ausblenden

Auszüge anzeigen

Falsch

Damit kannst du einen kurzen Auszug unter jeder Seite in der Liste einschließen. Wähle zwischen:

  • None → es wird kein Auszug angezeigt.
  • Simple → zeigt die erste Zeile des Textes an, der in einem Auszug Makro auf einer der zurückgegebenen Seiten enthalten ist. Befindet sich kein Auszug Makro auf der Seite, wird nichts angezeigt.
  • Rich content → zeigt den Inhalt eines Auszug Makros oder, wenn sich kein Auszugs Makro auf der Seite befindet, den ersten Teil des Seiteninhalts als formatierten Text an, einschließlich Bilder und einiger Makros.





Zurück zum Hauptmenü   Nächstes Thema  







Confluence

Diese Seite wurde zuletzt am 06.03.2023 geändert.