Add-on Packager#

Die Idee des Add-on Packagers ist es, dem Anwender die Möglichkeit zu eröffnen, eigene vollwertige i-doit Add-ons zu bauen. Dabei wird der Add-on Packager komplett über die grafische Benutzeroberfläche von i-doit bedient und es werden keine Programmierkenntnisse benötigt.

Es können die Strukturen, die der Anwender beispielsweise über Datenstruktur bearbeiten oder den Report Manager erstellen kann, als Add-on paketiert und weitergeben werden.

Allgemeine Hinweise#

Bitte installieren und nutzen Sie den Add-on Packager nicht auf einer Produktionsumgebung!

Das Paketieren von Add-ons ist ein Entwicklungsprozess. Produktions- und Entwicklunsgumgebungen sollten immer getrennt werden. Unter anderem, um Produktionsdaten vor Beschädigung oder leichtfertiger Veränderung zu schützen. Weiterhin müssen sind Produktionsdaten hinsichtlich des Datenschutzes besonders schützenswert. Werden Add-ons auf Produktionsumgebungen gepackt, besteht die Gefahr der versehentlichen Weitergabe von internen oder persönlichen Daten. Gehen sie dieses Risiko nicht ein. Nutzen Sie entweder eine dedizierte Installation oder erstellen Sie eine Kopie Ihrer Produktionsumgebung, wenn Sie Daten von dort paketieren möchten. Nutzen sie mindestens einen dedizierten Mandanten für ihre Entwicklungen.

Im Rahmen der Entwicklungspartnerschaft wird eine kostenfreie Entwicklungslizenz bereitgestellt. Diese kann für die Entwicklung von Add-ons genutzt werden.

Installation und Lizenz#

Der Add-on Packager wird wie jedes Add-on über das Admin Center installiert. Der Add-on Packager ist nicht lizenzpflichtig. Er kann allerdings nur mit der pro-Variante genutzt werden.

Welche Strukturen können in ein Add-on gepackt werden?#

Derzeit können folgende Strukturen mit dem Add-on Packager in ein Add-on eingebunden werden:

• Objekttypgruppen
• Objekttypen
• Benutzerdefinierte Kategorien
• Reports
• Dialog-Felder
• Beziehungsarten

Erstellen einer Add-on Strukturvorlage#

Den Add-on Packager erreicht man wie nahezu alle Add-ons über das Extras-Menü.

Anschließend navigiert man auf den Bereich Add-ons und erstellt dort über den Button "Neu" eine neue Strukturvorlage.

Basis Informationen#

In den Basis Informationen können mehrere Metadaten zu dem Add-on angegeben werden.

Eingebundene Ressourcen#

Im Ressourcen Bereich der Strukturvorlage können die verfügbaren Strukturen ausgewählt werden. Diese sind im folgenden aufgeschlüsselt.

Über Datenstruktur bearbeiten können Objekttyp Gruppen und Objekttypen angelegt und zugewiesen werden.

Objekttypgruppen#

Objekttypgruppen sind die in der Hauptnavigation verankerten Gruppierungen.

Wird eine Objekttypgruppe ausgewählt, so wird auch ausschließlich die Gruppe und die Zuordnung der Objekttypen zur Objekttypgruppe mit übernommen. Es werden nicht die Objekttypen als solche mit übernommen, diese müssen explizit im nächsten Punkt ausgewählt werden.

Objekttypen#

Die Objekttypen sind die logische Typisierung der Objekte. Standardmäßig werden eine Menge Objekttypen ausgeliefert (Server, Clients, …).

Hier können nur die eigens erstellten Objekttypen ausgewählt werden. Mit den ausgewählten Objekttypen wird auch die Zuordnung der Kategorien in das Add-on übernommen, allerdings nicht die Kategorien als solche. Diese müssen explizit im nächsten Punkt ausgewählt werden.

Kategorien#

Kategorien sind logischen Klammern um die einzelnen Attribute.

Eigene Kategorien können über die Verwaltung im Bereich "Benutzerdefinierte Kategorien" angelegt werden.

Es können nur benutzerdefinierte Kategorien ausgewählt werden.

Reports#

Hier können Reporte aus dem Report Manager ausgewählt werden.

Dialog+-Felder#

Dialog+ Felder sind solche Felder, die dem Anwender ein Drop-Down mit festen Werten anbieten, aber die Möglichkeit geben, eigene Inhalte zu ergänzen.

Habe ich in einem Dialog+ Feld eigene Werte angelegt, so kann ich hier das Feld auswählen, damit die Werte mit dem Add-on ausgeliefert werden..

Beziehungsarten#

Beziehungsarten können über die Verwaltung angelegt oder bearbeitet werden.

An dieser Stelle können die Beziehungsarten als solches samt ihren Eigenschaften ausgewählt werden, um sie mit dem Add-on auszuliefern.

Erstellen der fertigen Add-on ZIP-Datei#

Im unteren Bereich kann nun das Add-on als ZIP-Datei erstellt werden.

Hier muss eine Release-Version angegeben werden, die auf Semantic Versioning (bspw. 1.2.5) basieren muss.

Ebenfalls zu jeder Version gibt es einen Changelog Eintrag, der ergänzt wird sowie ein Releasedatum. Wird das Paket erstellt, landet man automatisch auf der Paketseite des Add-ons.

Pakete#

Die Pakete sind die fertigen ZIP Dateien der Add-ons. Jede Version jedes Add-ons bekommt eine eigene Paketseite, auf der das Add-on als ZIP Datei heruntergeladen werden kann.

Releases#