export

Mit diesem Konfigurationselement in der instanzspezifischen Datei config/export.xml wird der Export von Dateien durch den Content Management Server definiert. Die Unterelemente haben die folgende Bedeutung:

abortOnError: Mit diesem Schlüssel (Wert false oder true) legen Sie fest, ob der Export abgebrochen wird, wenn ein Fehler auftritt (wenn beispielsweise mit NPSOBJ auf nicht existierende Felder zugegriffen wird).
absoluteFsPathPrefix: Diese Option ist nur wirksam, wenn Links mit absoluten Pfaden exportiert werden (Untereintrag exportAbsolutePaths). absoluteFsPathPrefix legt die Zeichenkette fest, die allen Dateipfaden in Links vorangestellt wird. Durch diese Anpassungsmöglichkeit lassen sich die exportierten Dateien in Verzeichnisse unterhalb des Document-Root-Verzeichnisses platzieren.
absoluteUrlPrefix: Wie absoluteFsPathPrefix, jedoch für die Pfade in URLs
charset: Die Zeichenkodierung der exportierten Dokumente. Der Wert kann einer der Elementnamen im Untereintrag charsetMap sein.
charsetMap: Dictionary der verfügbaren Zeichenkodierungen. Der Elementname entspricht jeweils der Zeichensatz-Bezeichnung in Tcl, während der Inhalt des Elements die in HTML und XML übliche Bezeichnung ist. Einer der hier aufgeführten Elementnamen kann als Wert des Untereintrags charset angegeben werden. Wenn charsetMap nicht definiert wurde, wird <utf-8>UTF-8</utf-8> verwendet.
convertNpspm: Der Wert dieses Eintrags steuert, wie das CMS beim Export mit npspm-Elementen umgeht. Das Element hat die folgenden Unterelemente:
- isActive: Legt mit dem Wert true oder false fest, dass npspm-Tags (mit denen sich NPS-Portal-Manager-Funktionen in exportierte Dokumente einbinden lassen), in die Velocity-Template-Sprache umgewandelt bzw. nicht umgewandelt werden.
- hideForbiddenLinks: Steuert mit dem Wert true oder false, ob Links auf Dokumente, die unter Zugriffsschutz stehen, selbst dann anklickbar sind (nein = true), wenn der Website-Besucher auf das Zieldokument nicht zugreifen darf. Wenn ja, wird die betreffende Fehlerseite angezeigt, die in der Datei web.xml im instanzenspezifischen Verzeichnis webapps/PM/WEB-INF als Wert eines error-page-Elements konfiguriert ist (siehe die Beispiele dort). Dadurch kann in diesem Fall der Website-Besucher beispielsweise auf eine Anmeldeseite gelenkt werden.
- mapping: Steuert die Zuordnung von Dateinamenserweiterungen zu der Sprache, in die npspm-Tags in den exportierten Seiten übersetzt werden. Beispiel:
```
<mapping>
  <htm>velocity</htm>
  <html>velocity</html>
  <jsp>jsp</jsp>
</mapping>
```
defaultDocType: Der Wert dieses Eintrags kann HTML oder XML sein, je nachdem, ob die vom CMS erzeugten Tags HTML- oder XML-konform sein sollen.
exportAbsolutePaths: Legt fest, ob Links auf Dateien mit absoluten (true) oder relativen (false) Pfaden exportiert werden sollen. Diese Option muss eingeschaltet werden, wenn Dateien, die mit der NPSOBJ-insertvalue-dynamiclink-Anweisung inkludiert werden, wiederum Links auf Dateien enthalten. Relative Links in den inkludierten Dateien würden hier aufgrund der nicht vorherbestimmbaren Position der ursprünglich exportierten Dateien nicht funktionieren.
exportBaseDir: Legt das Verzeichnis fest, in dem die Template Engine die exportierten Dateien ablegt und gegebenenfalls Unterverzeichnisse anlegt. Der voreingestellte Wert ist export.
guiUrl: Der Wert dieses Eintrags legt die URL bis zur Web-Applikation des GUI fest. Er wird von dem mitgelieferten systemExecute-Kommando editLink verwendet. Ferner bestimmt der HTML-Editor (edit on pro) mit Hilfe dieser URL die URL von Vorschaubildern, die im WYSIWYG-Modus angezeigt werdern sollen. Deshalb muss als guiUrl eine URL eingetragen werden, die von außen auflösbar ist. Beispiel:
```
<guiUrl>https://localhost:8080/NPS</guiUrl>
```
incrementalUpdate: legt fest, ob der Content Management Server Daten für den inkrementellen Export zur Template Engine senden soll und wie die Template Engine erreicht werden kann.
- isActive: aktiviert (true) oder deaktiviert (false) das inkrementelle Update.
- login: Benutzername, unter dem sich der Content Management Server bei der Template Engine anmelden kann.
- password: Das Passwort für die Anmeldung.
referenceAttributes: Unter diesem Eintrag kann man eine Liste von Versionsfeldern angeben, bei denen eine Abhängigkeit vom Typ Referenz anstelle des Typs Content-Änderung erzeugt werden soll. Dadurch werden Dateien, bei deren Export ein solches Feld abgefragt wird, nicht mehr zwangsläufig invalidiert, wenn sich der Wert eines solchen Feldes ändert. Nehmen Sie ein Feld in diese Liste auf, wenn es ausschließlich dazu verwendet wird, um Links auf die betreffenden Dateien zu generieren, beispielsweise in automatisch erzeugten Navigationen. Geben Sie hier keine Felder vom Typ Linkliste an. Beispiel:
```
<export>
  ...
  <referenceAttributes type="list">
    <referenceAttribute>showInNav</referenceAttribute>
    <referenceAttribute>hideInNav</referenceAttribute>
  </referenceAttributes>
</export>
```
tclDynamicLinkFormatterCommands: Dieses Dictionary definiert die Aliasnamen der Formatierungsprozeduren, die bei der Auswertung von NPSOBJ-insertvalue-dynamiclink-Anweisungen aufgerufen werden können. Die dazu gehörenden formatter-Routinen sind im Verzeichnis script/cm/serverCmds unterhalb des Instanzenverzeichnisses (also beispielsweise unterhalb von instance/default) in der Datei dynamicLinkFormatters.tcl abgelegt. Dieses Verzeichnis wird auch von der Template Engine benutzt. Bitte beachten Sie, dass die Webseiten auf dem Live-Server neu exportiert werden müssen, wenn Sie Tcl-Prozeduren ändern, die sich auf das Exportergebnis auswirken. Dies ist mit dem Tcl-Befehl obj touchAll möglich. Beispiel:
```
<tclDynamicLinkFormatterCommands>
  <phpInclude>formatter:phpInclude</phpInclude>
  <phpIncludeOnce>formatter:phpIncludeOnce</phpIncludeOnce>
  <phpRequire>formatter:phpRequire</phpRequire>
  <phpRequireOnce>formatter:phpRequireOnce</phpRequireOnce>
  <include>formatter:include</include>
</tclDynamicLinkFormatterCommands>
```
tclFormatterCommands: Das Dictionary enthält Prozedur-Alias-Namen, die als Werte des formatter-Attributs von NPSOBJ-insertvalue-var-Anweisungen verwendet werden können. Den Alias-Namen werden hier die Namen der Prozeduren zugewiesen, die aufgerufen werden sollen, wenn die NPSOBJ-Anweisungen ausgewertet werden. Beispiel:
```
<tclFormatterCommands>
  <phpVardef>phpVardef</phpVardef>
</tclFormatterCommands>
```
tclSystemExecuteCommands: Dieses Dictionary definiert die in Layouts verwendbaren NPSOBJ-systemExecute-Befehle. Die Befehle müssen als Server-Kommandos (wie bei tclDynamicLinkFormatterCommands) zur Verfügung stehen. Beispiel:
```
<export>
  ...
  <tclSystemExecuteCommands>
    <procedureAliasName>trueProcedureName</procedureAliasName>
  </tclSystemExecuteCommands>
</export>
```
toclistSortLanguage: Gibt die Länderspracheinstellung an, die für die alphabetische Sortierung von Dateilisten (npsobj list="toclist") verwendet wird. Die Spracheinstellung besteht aus zwei Kleinbuchstaben für die Sprache, gefolgt von einem Unterstrich und zwei Großbuchstaben für das Land (beispielsweise für Deutsch: de_DE). Ist dieser Systemkonfigurationseintrag nicht vorhanden, wird die Betriebssystemeinstellung verwendet (Umgebungsvariable LC_COLLATE).

validDateTimeOutputFormats: In diesem Dictionary sind die gültigen Datumsformate als Unterelemente abgelegt. Diese Formate kann man in NPSOBJ-Elementen als Wert des Attributs format angeben, um Datumsangaben zu formatieren. Beispiel:

<validDateTimeOutputFormats>
  <dayMonthYear>%d/%m/%Y</dayMonthYear>
</validDateTimeOutputFormats>

Datums- und Zeitformate, wie sie in diesem Systemkonfigurationseintrag definiert werden können, sind Zeichenketten. In diesen Zeichenketten können Sie folgende Platzhalter für aktuelle Bestandteile der Systemzeit verwenden:

Platzhalter	Bedeutung
`%d`	Tag als zweistellige Zahl
`%m`	Monat als zweistellige Zahl
`%y`	Jahr als zweistellige Zahl
`%Y`	Jahr als 4-stellige Zahl (mit Jahrhundert)
`%j`	Tag des Jahres als 3-stellige Zahl (001-366)
`%H`	Stunde als zweistellige Zahl (24-h-Format)
`%I`	Stunde als zweistellige Zahl (12-h-Format)
`%M`	Die Minute als zweistellige Zahl
`%S`	Die Sekunde als zweistellige Zahl
`%p`	am/pm
`%Z`	Der Zeitzonenname
`%z`	Zeitzonenunterschied zu GMT (±HHMM)
`%w`	Wochentag als 2-stellige Zahl (0=Sonntag)
`%%`	Ein Prozentzeichen

wantLinkCallback: Aktiviert oder deaktiviert Link-Funktionen (true oder false), mit denen Links beim Export und bei der Vorschau modifiziert werden können.
writeLiveServerReadPerms: Legt fest, ob die Live-Server-Leserechte (Gruppennamen, die den Dateien zugewiesen wurden) beim Content-Update zur Template Engine übertragen werden sollen (true) oder nicht (false).