Entwicklung von Confluence User Macros (DE) - Training / Workshop von Trivadis Holding AG

Im Atlassian Marketplace gibt es für den Confluence Server zahlreiche Apps, mit denen man den Funktionsumfang seines Confluence erweitern kann. Dies ist jedoch nicht immer möglich. Teilweise sind diese Apps sehr kostspielig, man benötigt nur einen Bruchteil der Funktionalität oder es existiert keine passende App für die eigenen Anforderungen.Deshalb gibt es noch einen anderen Weg: die sogenannten User Macros. Diese Benutzermakros können von Confluence Administratoren erstellt werden und erweitern den Funktionsumfang von Confluence.Diese Schulung zeigt dir, wie du auf einfachem Weg kleine Anpassungen in Formatierung oder Funktionalität für Ihr Confluence umsetzen können. Wir beginnen mit einfachen Custom Panels (vordefinierte Status- oder Panel-Macros), erschließen uns anschließend die Velocity Syntax und schauen uns zum Schluss den Einsatz der Java- und REST-API an.

Contents

Confluence Grundlagen

• Begriffserläuterungen
• Confluence Architektur
• Abgrenzung Confluence App und Macros
• Was können Macros?
• Platzhalter, Properties Panel und Macro Browser

Simple Custom Panels

• Überblick über den Macro Editor
• "Hello World"-Macro
• Macro-Konfiguration, -Hauptteil und -Vorlage
• Parameter und Datentypen
• Atlassian XML vs. HTML

Velocity Syntax

• Velocity Objects

• Bedingungen (#if, #else, #ifelse, #end)

• Schleifen (#foreach ... #end)
• Variablen ($!variable)
• Benutzermakro: All-Velocity-Objects

Java

• Standard Java- und Atlassian-API
• Objektinstanziierung und Zugriff auf Java-Klassen
• Listen und Maps
• Übergang von Velocity zu Java
• Manager Objekte

REST- und JavaScript-API

• REST API Browser
• Atlassian JavaScript API ($AJS)
• Labels setzen und Seiten erstellen

Scriptrunner und andere Werkzeuge

• REST API Browser
• Macro Editor App
• Source Code Editor
• Fehler finden (Logging)
• Script Runner
• Macro Dokumentation

RequirementsGrundlegende Kenntnisse in der Funktionsweise und Aufbau von Confluence und Programmierkenntnisse aus einer beliebigen Programmiersprache. Administratoren-Berechtigung im eigenen Confluence, da ansonsten die Erstellung von User Marcos nicht möglich ist.

• Der Kurs zeigt den Leistungsumfang von Benutzermakros
• Du wirst in die Lage versetzt, auf einfachem Weg ihr Confluence zu erweitern, kostengünstig und unabhängig von App-Herstellern

(Fachliche) Confluence Administratoren, Confluence Key bzw. Power User die fehlende Funktionaltäten in Confluence per User Macro erweitern möchten.