Neues Projekt installieren (aus Vorlage)
Eine der wichtigsten Funktionen des agorum core template managers ist es, ein neues Projekt aus einer Vorlage anzulegen (Konfigurationsprojekt). Dank dieser Funktion steht es Ihnen als Entwickler frei, eigene Konfigurationen zu erstellen und diese von einem Testsystem in ein produktives System zu überführen.
- Öffnen Sie links in der Seitenleiste Explorer.
- Klicken Sie in der mittleren Ansicht mit der rechten Maustaste auf eine freie Fläche.
- Wählen Sie im Kontextmenü: agorum core template manager > Neues Projekt installieren (aus Vorlage) (siehe Neues Projekt installieren (aus Vorlage)).
- Wählen Sie, für wen das Projekt ist.
agorum - Projekt
Diese Projektart wird vom agorum-Entwicklungsteam verwendet. Mit dieser Einstellung entwickeln wir etwa alle Plugins, auf die Sie im agorum core plugin manager Zugriff haben.
Kunden - Projekt
Ein Kundenprojekt verwenden Sie, wenn Sie als agorum core-Kunde ein Projekt für sich selbst erstellen. Auch Partner oder das agorum-Entwicklungsteam erstellen über diese Option Konfigurationen, die für Kunden gedacht sind. Sie können ein allgemeines Kundenprojekt anlegen (zu Anfang empfehlenswert) oder, wenn Sie bereits mehr Erfahrung in der Erstellung eigener Konfigurationen haben, Unterprojekte, die sich etwa auf einen Posteingang beziehen. Dadurch werden vor allem große Konfigurationen etwas übersichtlicher gestaltet. Ein solches Unterprojekt kann in weitere Unterprojekte unterteilt werden, etwa, wenn Sie einen Posteingang für die Buchhaltung erstellen möchten und hierfür eine eigene Ordnerstruktur wünschen.
Partner - Projekt
Ein Partnerprojekt verwenden Sie, sobald Konfigurationen für Partner erstellt werden. Dabei wird im ersten Schritt ein allgemeines Projekt angelegt, unabhängig davon, für welchen Kunden. Dieses kann im späteren Verlauf dupliziert und weiter angepasst werden (siehe undefined>Template.tpl). Sie können ein allgemeines Partnerprojekt anlegen (zu Anfang empfehlenswert) oder, wenn Sie bereits mehr Erfahrung in der Erstellung eigener Konfigurationen haben, Unterprojekte, die sich etwa auf einen Posteingang beziehen. Dadurch werden vor allem große Konfigurationen etwas übersichtlicher gestaltet. Ein solches Unterprojekt kann in weitere Unterprojekte unterteilt werden, etwa, wenn Sie einen Posteingang für die Buchhaltung erstellen möchten und hierfür eine eigene Ordnerstruktur wünschen.
Hinweis: Der Unterschied dieser Projektarten macht sich nur in deren Namensgebung und Aufbau der nachfolgend angezeigten Dialoge bemerkbar.
- Wählen Sie ein Start Projekt Template.
agorum core Start Project DropArea Template
Enthält Ordnerstrukturen und Skripte, um eine DropArea-Fläche zu konfigurieren und dazu passend einen neuen Filter in der Suche zu konfigurieren. Dieses Template stellt eine Erweiterung der Vorlage agorum core Start Project minimal Template dar.
agorum core Start Project minimal Template
Eine Ordnerstruktur, in der alle relevanten Konfigurationsdateien vorliegen.
agorum core Project Template
Diese Vorlage stellt eine Erweiterung der Vorlage agorum core Start Project minimal Template dar und wurde um eine Filterkonfiguration in der Suche erweitert.
Ergebnis: Das System erstellt unter den eigenen Dateien des Super-Administrators roi folgende Ordnerstruktur: Eigene Dateien/Administration/customers/<Name Ihrer Konfiguration>
Für eine Erklärung zu den erstellten Ordnern siehe Einstieg in den agorum core template manager
Neues Projekt installieren (aus Vorlage)
Projekte werden mit einem vorgegebenen Namensschema angelegt. Diese Namensgebung wirkt sich auf den Dialog für ein neues Projekt aus.
Eingaberegeln
- Die Felder Namen, Beschreibung sowie Präfix werden automatisch gefüllt, sobald Sie Informationen in den Feldern Kundenname und Kundenkürzel eingetragen haben.
- Die Schaltfläche Anlegen wird erst aktiv, wenn Sie alle Pflichtfelder ausgefüllt haben.
- Sonderzeichen, etwa §,$,% oder &, sind nicht gestattet.
Feld |
Beschreibung |
Beispiel |
Name |
Definiert den internen Namen des Projekts. Der Name wird als Ordnerbezeichnung verwendet. |
Eigene Dateien/Administration/customers/<Name> |
Beschreibung |
Wird verwendet, um die Überschrift in der Projektbeschreibung zu erstellen. |
Eigene Dateien/Administration/customers/<Partnername|Projekt-Name|Kundenname>/doc/project-description.html |
Präfix |
Definiert das Präfix der in dem Projekt erstellten Metadaten über die Datei metadata.yml. |
Eigene Dateien/Administration/customers/<Partnername|Projekt-Name|Kundenname>/yml/metadata.yml |
Eigene Vorlage erstellen
Sie können aus eigenen Projekten Vorlagen erstellen und dadurch Konfigurationen duplizieren und individuell anpassen (siehe undefined>Template.tpl und In Start Project Template konvertieren).