Inhalt nach Stichwort (Content by Label) Makro
Mit dem Inhalt nach Stichwort Makro können Seiten, Blog-Einträge oder Anhänge aufgelistet werden, die bestimmte Stichworte haben. Das ist hilfreich für das Sammeln von Seiten, die zusammengehören und zum Herausfiltern von Inhalten, die Sie nicht sehen wollen.
Als Beispiel können Sie dieses Makro benutzen, um eine Liste aller Seiten anzeigen zu lassen, die das Stichwort "Produkt-verschickt" und das Wort "Vorlage" beinhalten. Sie können auch eine Liste aller Seiten anzeigen, die das Label "Videos", auf denen Sie erwähnt wurden, beinhalten.
So sieht das Makro auf Ihrer Seite aus:
Und so konfigurieren Sie es im Makro-Browser:
Anwendung des Inhalt nach Stichwort Makros
So fügen Sie das Inhalt nach Stichwort Makro auf einer Seite ein:
- Positionieren Sie den Cursor im Bereich-Makro auf der Seite.
- Im Bearbeitungsmodus der Seite klicken Sie oben im Editor Menü auf das
Symbol (Weiteren Inhalt einfügen) und dann auf Andere Makros. - Tippen Sie den Makro Namen oder einen Teil davon ein und suchen Sie das gewünschte Makro aus. Klicken Sie auf das Makro.
- Geben Sie die gewünschte Spaltenbreite in pixel oder % ein und klicken Sie auf Einfügen.
Schneller geht's mit der Autovervollständigung:
Tippen Sie die sich öffnende geschweifte Klammer '{' und den Beginn des Names des Makros, um eine Liste vorgeschlagener Makros zu sehen.
Editieren eines existierenden Makros
Um ein existierendes Makro zu bearbeiten:
Klicken Sie auf den Makro Platzhalter und dann auf Bearbeiten. Dieses öffnet den Dialog der Makro Details und Sie können die Makro Parameter (wenn vorhanden) bearbeiten.
CQL Filter
CQL (Confluence Query Language) ist eine Abfrage-Sprache, die für Confluence entwickelt wurde. Sie kann in einigen Makros und und der Confluence-Suche benutzt werden. In der Confluence-Suche und in CQL-betriebenen Makros können Sie Filter hinzufügen, die eine Suchabfrage einleiten und so viele Filter hinzufügen, wie Sie benötigen, um die Suchergebnisse genug einzuschränken.
Benutzen Sie den Link Filter hinzufügen im Makro-Browser.
Benutzen Sie UND, ODER und NICHT Operatoren:
- Für eine ODER Suche, geben Sie multiple Werte in das gleiche Feld ein.
Um also Seiten mit den Stichworten 'label-a', 'label-b' oder beiden anzuzeigen, geben Sie 'label-a' und 'label-b' in dem gleichen Stichwort-Feld ein, so wie hier gezeigt:
- Bei einer UND Suche, fügen Sie mehr als eine FILTER hinzu und geben jeweils ein Stichwort ein.
Um nur Seiten anzuzeigen, die label-a und label-b haben, geben sie 'label-a' in ein Stichwort-Feld ein, dann fügen Sie ein zweites Stichwort-Feld hinzu und geben 'label-b' im zweiten Feld ein, wie hier gezeigt:
In anderen Worten, ODER Werte werden im gleichen Filter eingegeben und UND Werte in verschiedenen Filtern.
Nicht alle Filter unterstützen die UND Suche. Wenn der jeweilige Filter den UND Operatoren nicht unterstützt, werden Sie es merken, da Sie keinen zweiten Filter eingeben können. - Für eine NOT, NEIN oder negative Suche, geben sie ein Minuszeichen "-" vor dem Stichwort ein. Dieses schließt alles mit diesem Stichwort aus.
Dieses sind die möglichen CQL-Filter für Ihre Suche:
| Filter | Beschreibung | Operatoren |
|---|---|---|
| Stichwort* | Seiten, Blog-Einträge oder Anhänge mit diesem Stichwort hinzufügen. | ODER (multiple Werte im gleichen Filter) UND (multiple Stichwort-Filter) |
| Mit Vorgänger | Unterseiten dieser Seite mit einschließen. Sie können das Makro hiermit auf einen Seitenbaum beschränken. | ODER (multiple Werte im gleichen Filter) |
| Beitragender** | Seiten oder Blog-Einträge auflisten lassen, die von diesen Nutzern erstellt oder editiert wurden. | ODER (multiple Werte im gleichen Filter) |
| Erstellt | Datum, an dem die Seite oder der Blog-Beitrag erstellt wurden. Beliebiges Datum, Letzte 24 Stunden, Letzte Woche, Letzter Monat, Letztes Jahr, Vordefiniert (von-bis). | |
| Ersteller | Items einschließen, die von diesen Nutzern erstellt wurden. | ODER (multiple Werte im gleichen Filter) |
| Letzte Änderung | Datum, an dem der Inhalt zum letzten mal geändert wurde. Beliebiges Datum, Letzte 24 Stunden, Letzte Woche, Letzter Monat, Letztes Jahr, Vordefiniert (von-bis). | |
| Erwähnt Benutzer | Seiten und Blog-Beiträge hinzufügen, auf denen diese Nutzer mit @-Mention erwähnt wurden. | ODER (multiple Werte im gleichen Filter) |
| Mit übergeordnetem Element | Nur direkte untergeordnete Seiten dieser Seite mit einschließen (weitere Unterseiten werden nicht mit berücksichtigt). | GLEICH (nur eine Seite) |
| In Bereich** | Elemente von diesen Bereichen mit einschließen | ODER (multiple Werte im gleichen Filter) |
| Einschließlich Text** | Inhalte einschließen, die diesen Text beinhalten. | BEINHALTET (ein Wort oder ein Satz) |
| Mit Titel | Items, die diesen Text im Titel beinhalten. | CONTAINS (single word or phrase) |
| vom Typ** | Nur Seite, Blog, Kommentar oder Anhang einschließen. | ODER (multiple Werte im gleichen Filter) |
* Dieses Feld wird in CQL-betriebenen Makros benötigt.
** Sie können diese Filter in den CQL-betriebenen Makros hinzufügen, sie sind jedoch bei einer Suche ein Teil der Standard-Suchfilter und erscheinen nicht im "Filter hinzufügen" Menü.
Parameter des Inhalt nach Stichwort Makros
Parameter sind Optionen, die Sie einstellen können, um den Inhalt oder das Format des Makro-Outputs zu bestimmen. Hier wird in Klammern angegeben (Beispiel), wenn der im Confluence Storage-Format oder im Wiki-Markup angegebene Parameter-Name anders ist, als der Name, der im Makro-Browser benutzt wird.
Mit Klick auf Optionen einblenden im Makro-Dialog sehen Sie folgende einstellbare Parameter.
| Parameter | Standard-Einstellung | Beschreibung |
|---|---|---|
| Sortieren nach | Modified | Nach Titel, Erstellungs- und Änderungsdatum sortieren. Wenn Sie hier nichts auswählen, wird die CQL-Standard Ordnung nach Relevanz eingesetzt. |
| Sortierreihenfolge umkehren | Nicht angeklickt | Wird nur zusammen mit dem Parameter 'Sortieren nach' verwendet. Sortiert die Liste absteigend anstatt aufsteigend (Z-A, erst-zuletzt). |
| Maximale Anzahl der Seiten | 15 | Limitiert die Anzahl der Seiten, die in der Liste mit angezeigt werden sollen. Das können maximal 500 Seiten sein. |
| Listentitel | Leer | Optionaler Titel für das Makro. |
| Stichwörter für jede Seite anzeigen | Angeklickt | Die Stichworte für jedes Item anzeigen oder nicht. |
| Bereichsnamen für jede Seite anzeigen | Angeklickt | Den Bereichs-Namen für jedes Item anzeigen oder nicht. |
| Anzeige des Auszugs | Keine | Zeigt einen kleinen Auszug des Inhalts unter jeder Seite der Liste an. Wählen Sie aus unter:
|
Übersicht aller Confluence Makros
Auf dieser Seite finden Sie eine Übersicht aller im Standard von Confluence enthaltenden Makros und allgemeine Informationen über die Anwendung von Makros.