====== PrimusSE.CFG.xml ======
Primus wird über ein Konfigurationsdatei im [[cfg.xml|EXtensible Markup Language]] (XML) Format konfiguriert. Der Name der Datei ist frei wählbar, er hat jedoch die __doppelte__ Dateiendung **.CFG.XML**.
Beispiel: //**PrimusSE.CFG.xml**//
Die Kodierung ist **UCS-2 LE-BOM** und darf nicht geändert werden. Bei der Verwendung eines Texteditors ist darauf zu achten dass dieser die Kodierung unterstützt. Für die tägliche Arbeit hat sich hier [[Notepad++]] mit der Erweiterung **XML-Tools** bewährt. Wenn es zu Problemen beim Verarbeiten der Einstellungen durch Primus kommt, dann liegt dies häufig daran das die Kodierung nicht richtig ist. Das betrifft u.a. auch die [[:primus_lizenzdatei]] (PrimusLicenses.lic), diese wird dann nicht als gültig erkannt.

===== Grundaufbau =====
Der Grundsätzliche Aufbau der Konfiguration hat zwei Pflichtelemente, den **XML-Header** und das **Stammelement**.

==== XML-Header ====

Der Header der XML Dateien sieht folgendermaßen aus.

<code xml>
<?xml version="1.0" encoding="UTF-16"?>

</code>

Das führt allerdings beim Speichern mit [[Notepad++]] immer zu der Fehlermeldung **Document labeld UTF-16 but has UTF-8 content**.

==== Stammelement ====
Jede //.CFG.XML// __muss ein__ und __nur ein__ **Stammelement** enthalten. Dabei handelt es um ein [[Glossar#Tag]], das alle [[Abschnitte]] der Konfiguration enthält. Der Tag-Name lautet **PrimusFolderConfig**, und darf das Attribut **name** enthalten. Ist kein Name angegeben, dann wird in Primus am obersten Projektknoten auch kein Name angezeigt.
=== Beispiel ===
<code xml><PrimusFolderConfig name="Unitec"></code>


===== Abschnitte =====
Die Konfigurationsdatei gliedert sich in verschiedene [[Abschnitte]], von denen einige von Primus benötigt werden, andere wiederum können vom Anwender bei Bedarf erzeugt werden. Einige Abschnitte konfigurieren die [[userman:Benutzeroberfläche]] ([[GUI]]). Alle Abschnitte __**müssen**__ innerhalb des [[PrimusSE.cfg.xml#Stammelement]]s liegen.


===== Primus Framework =====
In [[PRIMUS Framework]] ist Struktur der Primus Installation mit allen Dateien und Verzeichnissen beschrieben.

{{tag>Konfigurations-XML}}