Was sind Makros?
Confluence Cloud Dokumentation
Mit Makros erweiterst du die Möglichkeiten deiner Confluence-Seiten und Live Docs, indem du zusätzliche Funktionen oder dynamische Inhalte hinzufügst. Verwende zum Beispiel das Anhänge-Makro, um Dateien aufzulisten, die an einen Inhalt angehängt sind, oder das Widget-Connector-Makro (Englisch), um Dinge wie ein YouTube-Video oder einen Twitter-Feed einzubinden.
Füge ein Makro zu deiner Seite oder deinem Live Doc hinzu
So fügst du ein Makro hinzu:
- Wähle beim Bearbeiten ➕▾ in der Symbolleiste aus
- Suche das Makro nach Namen und wähle es aus
- Konfiguriere es nach Bedarf
Du kannst auf der Seite auch / eingeben, um dieselbe Liste zu öffnen, die du auch über ➕▾ in der Symbolleiste siehst. Tippe weiter den Namen des Makros ein, um die Liste zu filtern.
So bearbeitest du ein Makro:
- Wähle den Makro-Platzhalter aus.
- Wähle das ✏️-Symbol aus, um das Konfigurationsfenster zu öffnen.
- Konfiguriere die Parameter. Deine Änderungen werden automatisch gespeichert.
- Setze die Bearbeitung der Seite fort, dann schließt sich das Fenster.
Du kannst außerdem die Symbole für zentriert, mittelbreit und vollbreit auswählen, um die Breite einiger Makros anzupassen. Wähle das 🗑️-Symbol aus, um das Makro zu entfernen.
Makro-Parameter
Viele Makros verfügen über optionale Parameter, mit denen du die Ausgabe des Makros steuern kannst.
Beim Anhänge-Makro hast du zum Beispiel zwei optionale Parameter, mit denen du Folgendes festlegen kannst:
- Welche Dateiformate der Anhänge angezeigt werden
- Ob alte Versionen der Anhänge angezeigt werden sollen
Makro-Platzhalter
Makro-Platzhalter werden im Editor dort angezeigt, wo du ein Makro zu einer Seite oder einem Doc hinzugefügt hast.
Beim Bearbeiten kannst du:
- Auf einen Makro-Platzhalter doppelklicken (oder den Platzhalter anklicken und Bearbeiten auswählen), um das Makro-Dialogfenster zu öffnen und die Parameter des Makros zu bearbeiten
- Einen Makro-Platzhalter auswählen, um das Makro auszuschneiden, zu kopieren und einzufügen
Konflikte zwischen zwei Makros
Manche Marketplace-Makros bzw. -Apps können nicht gemeinsam installiert werden, weil ihnen dieselbe interne ID zugewiesen wurde. Wenn du versuchst, eine App mit einem Namen zu installieren, der mit einem bereits installierten Makro in Konflikt steht, erhältst du folgende Fehlermeldung:
Installation von <App B> nicht möglich
Deine Instanz enthält bereits <App A> desselben Partners, wodurch die Installation von “App B” aus technischen Gründen nicht möglich ist.
Die schnellste Lösung besteht darin, eine der beiden Apps zu deinstallieren, damit du die andere installieren kannst.
Du kannst dich außerdem über den Atlassian Marketplace an die Entwickler wenden und sie bitten, den Fehler zu beheben.
Im Editor verfügbare Makros
Nachfolgend findest du eine Liste der im Editor verfügbaren Makros.
Wähle einen Makronamen aus, um Details zur Verwendung zu erhalten, einschließlich optionaler Parameter und Beispiele.
- Ankerverknüpfung-Makro
- Anhänge-Makro
- Blog-Einträge-Makro
- Änderungshistorie-Makro
- Diagramm-Makro
- Makro für untergeordnete Elemente (Anzeige) (Englisch)
- Inhalt-nach-Label-Makro (Englisch)
- Inhaltsbericht-Tabellen-Makro
- Beitragende-Makro
- Beitragende-Übersicht-Makro
- Aus-Vorlage-erstellen-Makro
- Auszug-einfügen-Makro
- Auszug-Makro
- Galerie-Makro (Englisch)
- iFrame-Makro
- Inhalt-einbeziehen-Makro
- Microsoft-Office-Makros
- Jira-Diagramm-Makro
- Zeige Jira-Vorgänge in einer Liste an
- Jira-Roadmap-Makro (Englisch)
- Stichwortliste-Makro
- Live-Suche-Makro
- Microsoft-OneDrive-for-Business-Makro (Englisch)
- Netzwerk-Makro (Englisch)
- Seitenindex-Makro
- Inhaltseigenschaften-Makro
- Inhaltseigenschaftsbericht-Makro
- Inhaltshierarchie-Makro
- Seitenhierarchiesuche-Makro
- PDF-Makro (Englisch)
- Populäre Stichwörter-Makro
- Profilbild-Makro
- Dashboard für zuletzt aktualisierte Inhalte
- Aktuelle Updates-Makro
- Verwandte Stichwörter-Makro
- Roadmap-Planer-Makro
- Bereichsliste-Makro
- Inhaltsverzeichnis-Makro
- Verzeichnisbereich-Makro
- Aufgabenbericht-Makro
- Benutzerliste-Makro
- Benutzerprofil-Makro
- Widget-Connector-Makro
Makros aus dem Marketplace
Im Atlassian Marketplace findest du viele weitere Makros.
Blockierte Makros
Wenn du zu einer Seite oder einem Live Doc in Confluence navigierst, werden manche Makros möglicherweise mit einem Hinweis angezeigt, dass ein Administrator diese App blockiert hat:
Wenn du Makros verwendest, die Apps aus dem Atlassian Marketplace nutzen, kann dein Organisationsadministrator den Zugriff einer App auf deine Daten über eine Datensicherheitsrichtlinie (Englisch) mit einer App-Zugriffsregel (Englisch) blockieren. Wenn diese Regel angewendet wird, kannst du Makros von Apps, die im von deiner Organisation ausgewählten Bereich blockiert wurden, nicht mehr verwenden.
Wende dich an deinen Confluence-Administrator, um die verfügbaren Optionen zu besprechen.
Was passiert mit App-Daten, die einem blockierten Makro zugeordnet sind?
Daten, die von einem blockierten Makro gespeichert werden, unterliegen der Aufbewahrungsrichtlinie des Partners, der das Makro entwickelt hat. Nach Ablauf der Aufbewahrungsfrist können diese Daten gelöscht werden und lassen sich dann möglicherweise nicht wiederherstellen. Wenn dir also fehlende Daten auffallen, besprich das mit deinem Confluence-Administrator, damit die nötigen Schritte zur Sicherung der Daten unternommen werden können.
Was, wenn ich nicht möchte, dass meine Nutzer die Fehlermeldung “App blockiert” auf der Seite sehen?
Als Workaround kannst du die Meldung über die blockierte App aus dem Inhalt entfernen, indem du das Makro von der Seite oder dem Live Doc entfernst. Dadurch werden auch alle Daten gelöscht, die die App im Makro gespeichert hat — nicht jedoch Daten, die das Makro im App-Speicher abgelegt hat und die der oben genannten Aufbewahrungsrichtlinie des Partners unterliegen.