Dokumentation: Publisher-Optionen

Name Inhalt Default Beschreibung

AllowBrowsing true | false true Bestimmt ob Inhaltsdokumente in dieser Datenbank direkt per URL (unter Angabe des Content-Keys) aufgerufen werden können.

AllowCustomQueries true | false true Bestimmt, ob ein TML-Designer auf dieser Datenbank selbst Abfragen formulieren darf. Im negativen Fall ist der TMLDesigner auf die gespeicherten Abfragen in der WGA-Konfiguration beschränkt.

BackgroundDeployment true | false false Wenn "true", läuft das Deployment von TML-Modulen in einem Hintergrund-Task ab. Dadurch werden zwar Änderungen an WebTML-Modulen nicht sofort aktiv, die generelle Arbeitsgeschwindigkeit des Systems bei Datenänderungen wird jedoch leicht erhöht.

CreateNameURLs true | false true Kontrolliert das Verhalten der URL-Generierung von WGA, welches den eindeutigen Namen eines Dokumentes in URLs verwendet falls dieser vorhanden ist. Ist dies nicht erwünscht so können sie dieses Verhalten per Wert "false" deaktivieren.

DefaultItemEncoding none | html | xml | none Bestimmt, ob Items und Metadaten dieser Datenbank defaultmäßig kodiert in WebTML ausgegeben werden sollen. Die Funktionalität entspricht dem TML-Attribut ?encode? und wird auf alle Item-, Metadata- und Input-Tags (im Modus "view") angewendet, die kein explizites encode-Attribut besitzen.

DefaultMediaKey Medienschlüssel html Bestimmt den Standard-Medienkey dieser Datenbank. Dieser wird verwendet, wenn in einer URL kein Medienkey explizit angegeben wurde

DefaultPortPROTOCOL TCP/IP-Port Diese Einstellung bestimmt einen TCP/IP-Port, den WGA verwenden soll wenn es eine URL explizit für ein bestimmtes Protokoll generieren soll. Im Namen der Option sollte anstelle von PROTOCOL der Name des jeweiligen Protokolls in Großbuchstaben verwendet werden (z.B. "DefaultPortHTTP" für das Protokoll "http").

DesignEncoding Zeichenkodierungs-Kürzel Die Standard-Zeichenkodierung der jeweiligen Plattform Diese Einstellung teilt WGA mit, welche Zeichenkodierung textbasierte Ressourcen im WGA Design der aktuellen Datenbank besitzen. Diese Einstellung wird von WGA sowohl benutzt um Textdateien aus Design-Verzeichnissen einzulesen, als auch um Textdateien aus Datei-Containern per HTTP auszuliefern.

DesignUpdated true | false true Steuert, ob Änderungen an WebTML-Modulen automatisch zum Deployment führen. Wenn "false" können TML-Änderungen über die Administrationsseite manuell vorgenommen werden. Dies kann u.U. die Arbeitsgeschwindigkeit des Systems bei Datenänderungen (z.B. im Browser Interface) beschleunigen.
Diese Einstellung kann für die aktuelle WGA-Laufzeit auch auf der Administrationsseite über die Content-Details geändert werden. Nach Neustart kehrt WGA jedoch zu der in dieser Option getroffenen Einstellung zurück.

DirectAccessDefault true | false false Diese Einstellung bestimmt, ob ein WebTML-Modul dieser Datenbank direkt per URL als zu verwendendes Layout gewählt werden darf wenn dies nicht explizit in seinem Metadatenfeld "directAccess" bestimmt wurde. Sie wirkt sich auf WebTML-Module aus, die per Design-Synchronisation eingeladen werden und im Design-Verzeichnis keine Metadaten-Datei besitzen. Achtung: Diese Publisher-Option ist nur effektiv wenn sie in der Konfiguration des Designs selbst (Datei "csconfig.xml" in Datei-Container "system" bzw. per WGA Design Assistant) getroffen wird.

ExpressionDefault native | tmlscript native Bestimmt die Standard-Ausdruckssprache in WebTML-Modulen dieser Datenbank. Diese wird im TML-Code verwendet, wenn keine andere Ausdruckssprache explizit gewählt wird.

FileCacheSize Ganzzahl 10 Größe des internen Hauptspeicher-Caches für Grafikdateien in MB. In diesem Cache werden häufig verwendete Grafiken abgelegt, um Sie möglichst schnell Requests zur Verfügung stellen zu können.

FileCacheThreshold Ganzzahl 10 Maximale Größe in KB für Grafikdateien, die im Hauptspeicher-Cache für Grafikdateien abgelegt werden sollen. Grafikdateien die größer sind, werden nicht zwischengespeichert, sondern immer direkt aus der WGA Datenbank herangezogen..

FileExpirationMinutes Ganzzahl 10 Zeit in Minuten, die ein Internet-Browser minimal warten soll,bevor er überprüft, ob eine heruntergeladene Grafikdatei auf dem WGA-Server aktualisiert wurde. Entspricht dem Inhalt des HTTP-Headers "Expires".

GlobalVars true | false true Bestimmt, ob WebTML-Variablen global (d.h.: Kontextunabhängig) setz- und abfragbar sind. Im negativen Fall sind WebTML-Variablen nur in dem Kontext verfügbar, in dem sie auch gesetzt wurden.

HDBInit Scriptmodul-Name | Java-Klassenname Gibt eine Initialisierungs-Funktionalität für die Datenbank an, wenn diese die hierarchische Datenbank-API verwendet (siehe PublisherOption "isHDB"). Dies kann entweder ein TMLScript-Modul der aktuellen Datenbank oder eine Java-Klasse sein, welche das Interface de.innovationgate.webgate.api.WGHierarchicalDatabaseStartup implementiert. Das Script bzw. die Methode execute() der Java-Klasse wird jedesmal aufgerufen wenn die Datenbank an WGA angebunden wird. Bei dieser Initialisierung kann die Grundstruktur der hierarchischen Datenbank, sowie notwendige Listener-Funktionalitäten angelegt werden.

HDBUseVersioning true | false false Aktiviert die Versionierung für die Hierarchische Datenbank-API. In diesem Modus werden Dokumente als Drafts von der HDB-API erzeugt und müssen im Programmcode publiziert werden. Jede Aktualisierung eines Dokumentes per updateContent() erzeugt eine neue Version dieses Dokumentes so dass alle Stände als archivierte Versionen vorgehalten werden.

HomePage String Partielle URL zur Homepage der Datenbank, relativ zur URL der WGA-Datenbank, z.B.
URL zur DB:
http://server/wga/dbkey

HomePage-Attribut:
html/default/home

HomePage-URL:
http://server/wga/dbkey/html/default/home

HttpLogin true | false false Bestimmt, ob der Loginmechanismus generell über HTTP-Authentifizierung (true) oder über eine Anmeldemaske (false) abgewickelt werden soll. Der Anmeldemasken-Modus ist vorteilhafter, da die Anmeldung nur einmal verarbeitet werden muss und auch nur einmal über das Netzwerk übertragen wird.

isHDB true | false false Aktiviert bei "true" die Unterstützung für die hierarchische Datenbank-API (siehe this.hdb() bzw. ) und bereitet die Datenbank ggf. auf deren Verwendung vor.

IsRemoteContentStore true | false false Bestimmt, ob Inhaltsdokumente in dieser Datenbanken zum Content Sharing zur Verfügung stehen.

LanguageBehaviour default | maincontent | browser default Steuert das Sprachauswahl-Verhalten von WGA für die aktuelle Datenbank, insbesondere das Verhalten bzgl. der "bevorzugten Sprache" welche für Sprachauswahl während eines WebTML-Requests verwendet wird:

default: Standardverhalten. Eine bevorzugte Sprache wird beim ersten Request aus den bevorzugten Sprachen des Browsers ermittelt und beibehalten bis ein Sprachwahl-Link geklickt wird
maincontent: Verhalten von WGA 2. Die bevorzugte Sprache ist immer die Sprache des Hauptkontextes.
browser: Die bevorzugte Sprache wird zu jedem Request neu aus den bevorzugten Sprachen des Browsers ermittelt.

LoginPage String URL zu einer speziellen Anmeldeseite für diese Datenbank. Je nach Syntax wird die hier angegebene URL um automatische Bestandteile ergänzt:
Enthält die URL den Doppelslash, so wird sie als komplette URL gewertet die nicht weiter ergänzt werden muss

Beginnt die URL mit einem Slash, so wird sie als partielle URL, relativ zur WGA-Basis-URLgewertet, z.B.
/logindb/html/login -> http://dns/wga/logindb/html/login

Ansonsten wird die URL als partielle URL, relativ zur Basis-URL der Datenbank gewertet, z.B.
html/login -> http://dns/wga/mydb/html/login

MaxQueryResults Ganzzahl 500 Bestimmt die maximale Ergebnisanzahl bei Datenbankabfragen, wenn explizit keine Maximalanzahl über das "max"-Attribut angegeben wurde. 0 steht für unbegrenze Ergebnismengen.

MultiLanguageContent true | false true Aktiviert/Deaktiviert die Unterstützung für mehrsprachige Inhalte dieser Datenbank in WebTML. Bei Aktivierung greifen die üblichen Sprachauswahl-Strategien. Bei Deaktivierung werden grundsätzlich Inhalte in der Standardsprache geliefert.

PersMode 1 | 2 | 3 Wird diese Publisher-Option angegeben so wird die aktuelle WGA Content Store direkt als Personalisierungsdatenbank für ihre eigenen WebTML-Requests verwendet (anstelle einer eventuell für die Domäne konfigurierten Personalisierungsdatenbank). Dies ist nur möglich bei der WGA Content Store für JDBC und abgeleitete Typen. Zusätzlich ist die Angabe der Option "PersStatMode" notwendig. Der Inhalt dieser Option bestimmt den zu verwendenden Personalisierungs-Modus:

1 - Automatisch / Cookie-basiert
2 - Login-basiert (Ein Benutzerprofil pro Datenbank-Login)
3 - Benutzerdefinert / Durch TMLScript gesteuert
Zu beachten ist in diesem Modus auch die DB-Option "ReaderProfileCreation" (siehe DB-Option für WGA Content Store for JDBC)

PersStatMode 0 | 1 | 2 Wird die Publisher-Option "PersMode" angegeben so bestimmt dieser Publisher-Option den Statistikmodus der Personalisierung:

0 - Kein Statistiken
1 - Sitzungsbasiert
2 - Einzelrequest-basiert

QueryDefault native | hql | fulltext | lucene | ... native Bestimmt die Standard-Abfragesprache, welche verwendet wird, wenn zu einer Abfrage keine Sprache explizit gewählt wird. Verwenden sie hier "native" um die jeweiligeStandard-Abfragesprache des Datenbank-Typen zu wählen oder den Namen eines Abfragetypen, wie er auch im type-Attribut des Query-Tags verwendet wird.

SessionCookie String Bestimmt einen Cookie-Namen, unter welchem eine Session-ID hinterlegt wird. Diese Funktionalität wird für Single- Signon mit anderen Systemen verwendet.

SessionCookieDomain String Bestimmt bei Angabe von "SessionCookie" die Domäne, unter welcher das Cookie im Browser registriert wird.

TitlePathURL.ContentIndexing true | false false Aktiviert die Indizierung von Titelpfad-URLs, welche dafür sorgt dass unterschiedliche Dokumente mit identischen Titelpfaden über unterschiedliche URLs addressierbar sind. Dazu werden diese Dokumente intern nummeriert. Diese Funktion kann die Generierung und Auswertung von Titelpfaden dort erheblich verlangsamen wo sehr viele Dokumente unter dem selben Parent-Dokument abgelegt sind.

UseRemoteContentStores true | false false Bestimmt ob der Inhalt dieser Datenbank per Content Sharing auf Inhalte einer "Remote Content Store" zufgreifen darf.

WebTMLCache.ServeStaleData true | false true Steuert ob der WebTML-Cache veraltete Daten ausgeben darf während der gewünschte Cache-Eintrag von einem anderen Request neu berechnet wird. Wird die Einstellung auf "false" gesetzt so wartet der Cache stattdessen auf die Berechnung des Eintrag, was in Lastsituationen und bei aufwendig berechneten Einträgen dazu führen kann. dass der Server unresponsiv wird oder aufgrund von Ressourcenmangel fehlerhaft arbeitet.

Name	Inhalt	Default	Beschreibung
AllowBrowsing	true \| false	true	Bestimmt ob Inhaltsdokumente in dieser Datenbank direkt per URL (unter Angabe des Content-Keys) aufgerufen werden können.
AllowCustomQueries	true \| false	true	Bestimmt, ob ein TML-Designer auf dieser Datenbank selbst Abfragen formulieren darf. Im negativen Fall ist der TMLDesigner auf die gespeicherten Abfragen in der WGA-Konfiguration beschränkt.
BackgroundDeployment	true \| false	false	Wenn "true", läuft das Deployment von TML-Modulen in einem Hintergrund-Task ab. Dadurch werden zwar Änderungen an WebTML-Modulen nicht sofort aktiv, die generelle Arbeitsgeschwindigkeit des Systems bei Datenänderungen wird jedoch leicht erhöht.
CreateNameURLs	true \| false	true	Kontrolliert das Verhalten der URL-Generierung von WGA, welches den eindeutigen Namen eines Dokumentes in URLs verwendet falls dieser vorhanden ist. Ist dies nicht erwünscht so können sie dieses Verhalten per Wert "false" deaktivieren.
DefaultItemEncoding	none \| html \| xml \|	none	Bestimmt, ob Items und Metadaten dieser Datenbank defaultmäßig kodiert in WebTML ausgegeben werden sollen. Die Funktionalität entspricht dem TML-Attribut ?encode? und wird auf alle Item-, Metadata- und Input-Tags (im Modus "view") angewendet, die kein explizites encode-Attribut besitzen.
DefaultMediaKey	Medienschlüssel	html	Bestimmt den Standard-Medienkey dieser Datenbank. Dieser wird verwendet, wenn in einer URL kein Medienkey explizit angegeben wurde
DefaultPortPROTOCOL	TCP/IP-Port		Diese Einstellung bestimmt einen TCP/IP-Port, den WGA verwenden soll wenn es eine URL explizit für ein bestimmtes Protokoll generieren soll. Im Namen der Option sollte anstelle von PROTOCOL der Name des jeweiligen Protokolls in Großbuchstaben verwendet werden (z.B. "DefaultPortHTTP" für das Protokoll "http").
DesignEncoding	Zeichenkodierungs-Kürzel	Die Standard-Zeichenkodierung der jeweiligen Plattform	Diese Einstellung teilt WGA mit, welche Zeichenkodierung textbasierte Ressourcen im WGA Design der aktuellen Datenbank besitzen. Diese Einstellung wird von WGA sowohl benutzt um Textdateien aus Design-Verzeichnissen einzulesen, als auch um Textdateien aus Datei-Containern per HTTP auszuliefern.
DesignUpdated	true \| false	true	Steuert, ob Änderungen an WebTML-Modulen automatisch zum Deployment führen. Wenn "false" können TML-Änderungen über die Administrationsseite manuell vorgenommen werden. Dies kann u.U. die Arbeitsgeschwindigkeit des Systems bei Datenänderungen (z.B. im Browser Interface) beschleunigen. Diese Einstellung kann für die aktuelle WGA-Laufzeit auch auf der Administrationsseite über die Content-Details geändert werden. Nach Neustart kehrt WGA jedoch zu der in dieser Option getroffenen Einstellung zurück.
DirectAccessDefault	true \| false	false	Diese Einstellung bestimmt, ob ein WebTML-Modul dieser Datenbank direkt per URL als zu verwendendes Layout gewählt werden darf wenn dies nicht explizit in seinem Metadatenfeld "directAccess" bestimmt wurde. Sie wirkt sich auf WebTML-Module aus, die per Design-Synchronisation eingeladen werden und im Design-Verzeichnis keine Metadaten-Datei besitzen. Achtung: Diese Publisher-Option ist nur effektiv wenn sie in der Konfiguration des Designs selbst (Datei "csconfig.xml" in Datei-Container "system" bzw. per WGA Design Assistant) getroffen wird.
ExpressionDefault	native \| tmlscript	native	Bestimmt die Standard-Ausdruckssprache in WebTML-Modulen dieser Datenbank. Diese wird im TML-Code verwendet, wenn keine andere Ausdruckssprache explizit gewählt wird.
FileCacheSize	Ganzzahl	10	Größe des internen Hauptspeicher-Caches für Grafikdateien in MB. In diesem Cache werden häufig verwendete Grafiken abgelegt, um Sie möglichst schnell Requests zur Verfügung stellen zu können.
FileCacheThreshold	Ganzzahl	10	Maximale Größe in KB für Grafikdateien, die im Hauptspeicher-Cache für Grafikdateien abgelegt werden sollen. Grafikdateien die größer sind, werden nicht zwischengespeichert, sondern immer direkt aus der WGA Datenbank herangezogen..
FileExpirationMinutes	Ganzzahl	10	Zeit in Minuten, die ein Internet-Browser minimal warten soll,bevor er überprüft, ob eine heruntergeladene Grafikdatei auf dem WGA-Server aktualisiert wurde. Entspricht dem Inhalt des HTTP-Headers "Expires".
GlobalVars	true \| false	true	Bestimmt, ob WebTML-Variablen global (d.h.: Kontextunabhängig) setz- und abfragbar sind. Im negativen Fall sind WebTML-Variablen nur in dem Kontext verfügbar, in dem sie auch gesetzt wurden.
HDBInit	Scriptmodul-Name \| Java-Klassenname		Gibt eine Initialisierungs-Funktionalität für die Datenbank an, wenn diese die hierarchische Datenbank-API verwendet (siehe PublisherOption "isHDB"). Dies kann entweder ein TMLScript-Modul der aktuellen Datenbank oder eine Java-Klasse sein, welche das Interface de.innovationgate.webgate.api.WGHierarchicalDatabaseStartup implementiert. Das Script bzw. die Methode execute() der Java-Klasse wird jedesmal aufgerufen wenn die Datenbank an WGA angebunden wird. Bei dieser Initialisierung kann die Grundstruktur der hierarchischen Datenbank, sowie notwendige Listener-Funktionalitäten angelegt werden.
HDBUseVersioning	true \| false	false	Aktiviert die Versionierung für die Hierarchische Datenbank-API. In diesem Modus werden Dokumente als Drafts von der HDB-API erzeugt und müssen im Programmcode publiziert werden. Jede Aktualisierung eines Dokumentes per updateContent() erzeugt eine neue Version dieses Dokumentes so dass alle Stände als archivierte Versionen vorgehalten werden.
HomePage	String		Partielle URL zur Homepage der Datenbank, relativ zur URL der WGA-Datenbank, z.B. URL zur DB: http://server/wga/dbkey HomePage-Attribut: html/default/home HomePage-URL: http://server/wga/dbkey/html/default/home
HttpLogin	true \| false	false	Bestimmt, ob der Loginmechanismus generell über HTTP-Authentifizierung (true) oder über eine Anmeldemaske (false) abgewickelt werden soll. Der Anmeldemasken-Modus ist vorteilhafter, da die Anmeldung nur einmal verarbeitet werden muss und auch nur einmal über das Netzwerk übertragen wird.
isHDB	true \| false	false	Aktiviert bei "true" die Unterstützung für die hierarchische Datenbank-API (siehe this.hdb() bzw. ) und bereitet die Datenbank ggf. auf deren Verwendung vor.
IsRemoteContentStore	true \| false	false	Bestimmt, ob Inhaltsdokumente in dieser Datenbanken zum Content Sharing zur Verfügung stehen.
LanguageBehaviour	default \| maincontent \| browser	default	Steuert das Sprachauswahl-Verhalten von WGA für die aktuelle Datenbank, insbesondere das Verhalten bzgl. der "bevorzugten Sprache" welche für Sprachauswahl während eines WebTML-Requests verwendet wird: default: Standardverhalten. Eine bevorzugte Sprache wird beim ersten Request aus den bevorzugten Sprachen des Browsers ermittelt und beibehalten bis ein Sprachwahl-Link geklickt wird maincontent: Verhalten von WGA 2. Die bevorzugte Sprache ist immer die Sprache des Hauptkontextes. browser: Die bevorzugte Sprache wird zu jedem Request neu aus den bevorzugten Sprachen des Browsers ermittelt.
LoginPage	String		URL zu einer speziellen Anmeldeseite für diese Datenbank. Je nach Syntax wird die hier angegebene URL um automatische Bestandteile ergänzt: Enthält die URL den Doppelslash, so wird sie als komplette URL gewertet die nicht weiter ergänzt werden muss Beginnt die URL mit einem Slash, so wird sie als partielle URL, relativ zur WGA-Basis-URLgewertet, z.B. /logindb/html/login -> http://dns/wga/logindb/html/login Ansonsten wird die URL als partielle URL, relativ zur Basis-URL der Datenbank gewertet, z.B. html/login -> http://dns/wga/mydb/html/login
MaxQueryResults	Ganzzahl	500	Bestimmt die maximale Ergebnisanzahl bei Datenbankabfragen, wenn explizit keine Maximalanzahl über das "max"-Attribut angegeben wurde. 0 steht für unbegrenze Ergebnismengen.
MultiLanguageContent	true \| false	true	Aktiviert/Deaktiviert die Unterstützung für mehrsprachige Inhalte dieser Datenbank in WebTML. Bei Aktivierung greifen die üblichen Sprachauswahl-Strategien. Bei Deaktivierung werden grundsätzlich Inhalte in der Standardsprache geliefert.
PersMode	1 \| 2 \| 3		Wird diese Publisher-Option angegeben so wird die aktuelle WGA Content Store direkt als Personalisierungsdatenbank für ihre eigenen WebTML-Requests verwendet (anstelle einer eventuell für die Domäne konfigurierten Personalisierungsdatenbank). Dies ist nur möglich bei der WGA Content Store für JDBC und abgeleitete Typen. Zusätzlich ist die Angabe der Option "PersStatMode" notwendig. Der Inhalt dieser Option bestimmt den zu verwendenden Personalisierungs-Modus: 1 - Automatisch / Cookie-basiert 2 - Login-basiert (Ein Benutzerprofil pro Datenbank-Login) 3 - Benutzerdefinert / Durch TMLScript gesteuert Zu beachten ist in diesem Modus auch die DB-Option "ReaderProfileCreation" (siehe DB-Option für WGA Content Store for JDBC)
PersStatMode	0 \| 1 \| 2		Wird die Publisher-Option "PersMode" angegeben so bestimmt dieser Publisher-Option den Statistikmodus der Personalisierung: 0 - Kein Statistiken 1 - Sitzungsbasiert 2 - Einzelrequest-basiert
QueryDefault	native \| hql \| fulltext \| lucene \| ...	native	Bestimmt die Standard-Abfragesprache, welche verwendet wird, wenn zu einer Abfrage keine Sprache explizit gewählt wird. Verwenden sie hier "native" um die jeweiligeStandard-Abfragesprache des Datenbank-Typen zu wählen oder den Namen eines Abfragetypen, wie er auch im type-Attribut des Query-Tags verwendet wird.
SessionCookie	String		Bestimmt einen Cookie-Namen, unter welchem eine Session-ID hinterlegt wird. Diese Funktionalität wird für Single- Signon mit anderen Systemen verwendet.
SessionCookieDomain	String		Bestimmt bei Angabe von "SessionCookie" die Domäne, unter welcher das Cookie im Browser registriert wird.
TitlePathURL.ContentIndexing	true \| false	false	Aktiviert die Indizierung von Titelpfad-URLs, welche dafür sorgt dass unterschiedliche Dokumente mit identischen Titelpfaden über unterschiedliche URLs addressierbar sind. Dazu werden diese Dokumente intern nummeriert. Diese Funktion kann die Generierung und Auswertung von Titelpfaden dort erheblich verlangsamen wo sehr viele Dokumente unter dem selben Parent-Dokument abgelegt sind.
UseRemoteContentStores	true \| false	false	Bestimmt ob der Inhalt dieser Datenbank per Content Sharing auf Inhalte einer "Remote Content Store" zufgreifen darf.
WebTMLCache.ServeStaleData	true \| false	true	Steuert ob der WebTML-Cache veraltete Daten ausgeben darf während der gewünschte Cache-Eintrag von einem anderen Request neu berechnet wird. Wird die Einstellung auf "false" gesetzt so wartet der Cache stattdessen auf die Berechnung des Eintrag, was in Lastsituationen und bei aufwendig berechneten Einträgen dazu führen kann. dass der Server unresponsiv wird oder aufgrund von Ressourcenmangel fehlerhaft arbeitet.

2. Publisher-Optionen