IES-Admin (web) Publikationsbereiche: Unterschied zwischen den Versionen

Aktuelle Version vom 21. September 2022, 08:39 Uhr

Publikationsbereiche dienen zur Publikation von Daten des IES. Die Form der publizierten Daten wird über Templates definiert. Mit Hilfe von IES-Templates und IES-Artikeln werden textuelle Daten generiert, die an einen Publikationsbereich weiter gegeben werden. Je nach Publikationsbereich werden diese Daten weiter verarbeitet. Bei einem FilePublisher werden diese Daten beispielsweise in eine Datei geschrieben. Dem IES stehen folgende Publisher zur Verfügung:

FilePublisher: Schreibt die mit Hilfe der Templates und Artikel generierten Daten in eine Datei. Bei der Publikation eines Mediums wird das Medium in den Publikationsbereich geschrieben. Für den FilePublisher muss ein RootDirectory angegeben werden in das die Dateien geschrieben werden sollen. Verzeichnisstrukturen unterhalb dieses RootDirectories werden über ArtikelPools definiert. Um die in diesen Verzeichnissen abgelegten Dateien zu erreichen wird ein Webserver benötigt, der einen virtuelle Host mit diesem RootDirectory besitzt.Beispielsweise kann hier der Apache-Webserver verwendet werden. Dokumentation zur Konfiguration virtueller Hosts für den Apache-Webserver finden Sie unter http://httpd.apache.org/docs/2.2/vhosts/
HttpPublisher: Schickt die mit Hilfe der Templates und Artikel generierten Daten per HTTP-POST an die konfigurierte URL.
MailPublisher: Mit Hilfe von Templates und Artikeln werden XML-Daten erzeugt, die die Informationen zur Generierung einer oder mehrere E-Mails enthalten. Diese E-Mails werden an den, in den XML-Daten enthaltenen Empfängern, verschickt. Um die E-Mails verschicken zu können, wird empfohlen stets eine lokale Postfix-Installation als Relay zu verwenden. Soll anderer Service angesprochen werden, so ist dieser über ENV-Variablen an den IES zu übergeben. Die Konfiguration erfolgt über die IES_OPS in der Datei:

SITEPARK_HOME/conf/sitepark.conf

Folgender Eintrag kann dort wie folgt angepasst/eingetragen werden:

IES_JAVA_OPTIONS=-Dmail.smtp.host=localhost -Dmail.smtp.port=25 -Dmail.from=no-reply@sitepark.com

DatabasePublisher: Mit Hilfe von Templates und Artikeln werden XML-Daten erzeugt, über die der DatabasePublisher gesteuert wird. Der DatabasePublisher wird mit einer Datenbank verknüpft in der Daten mittels der XML-Daten Datenbankeinträge erzeugt, geändert und gelöscht werden können.

Um in den Publikationsbereich zu wechseln, klicken Sie bitte den Menüpunkt 'Publikationsbereicher' in der Bereichsauswahl an.

Ist der Publikationsbereich ausgewählt, wird in dem Hauptfenster jeweils eine Tabelle pro Publikationsbereiche-Typ dargestellt, in der alle vorhandenen Publikationsbereiche aufgelistet werden. Die Tabellen enthalten folgende gemeinsame Spalten:

Name: Name des Publikationsbereich
Anchor: Anchor, über den auf den Publikationsbereich mittels SPML zugeriffen werden kann.
Sprache: Ausgabesprache des Publikationsbereichs bei mehrsprachigen Templates
Zeichensatz: Ausgabe Zeichensatz der textuellen Daten.
Metadata: Meta-Informationen, die über Templates ausgelesen werden können.

Je nach Publikationsbereich sind noch weitere Spalten vorhanden:

FilePublisher

URL: Basis URL, über die die publizierten Dateien durch einen Webserver erreichbar sind. URL die auf den DocumentRoot verweist.
Document Root: Verzeichnis im Datei System, in das die Dateien abgelegt werden sollen.
Verzeichnis: Zusätzliche Angabe eines Verzeichnisses, welches den Document Root erweitert, um dort die Dateien abzulegen.
Aliases: URLs, die ebenfalls auf den Document-Root verweisen.
Scheme: Zeichenkette, die vor oder hinter jeden Dateinamen angehangen wird. Beispielsweise könnte bei einem deutschsprachigem Publikationsbereich anstatt der Datei index.html die Datei index.de.html erzeugt werden, wenn als Scheme .de angegeben wird. Das macht Sinn, wenn Content Negotiation genutzt werden soll. Weitere Informationen hierzu finden sie unter http://httpd.apache.org/docs/2.2/content-negotiation.html.
Personalization: Sitepark hat ein eigenes Apache-Modul entwickelt, über das Web-Seiten personalisiert werden können. Für diese Personalisierung benötigte Daten müssen vom FilePublisher in eine Datenbank geschrieben werden. Diese Datenbank wird hier angegeben.
Publikationsbereich als Modul verwenden: Der Haken muss gesetzt werden, wenn der Publikationsbereich SPML-Seiten generiert. Ist der Publikationsbereich nicht als Modul aktiviert, können die SPML-Seiten nicht ausgeführt werden.

HttpPublisher

URL: URL, an die die Daten per HTTP-POST gesendet werden sollen.
Content-Tye: Content-Tye der zu sendenden Daten
Header Daten: HTTP-Header Daten

MailPublisher: Keine weiteren Spalten vorhanden
DatabasePublisher: Datenbank die der DatabasePublisher nutzen soll.

Publikationsbereich anlegen

Nach einem Klick auf die 'Neue Publikationsbereich anlegen'-Schaltfläche erscheint ein Menu mit dem der Publikationsbereich-Typ ausgewählt werden kann. Je nach ausgewähltem Typ sind nun Eingabefelder zu sehen, mit denen der Publikationsbereich konfiguriert werden kann. Die Bedeutung der Eingabefelder sind weiter oben bereits beschrieben worden.

Klicken Sie auf die 'speichern'-Schaltfläche, um den Publikationsbereich anzulegen.

Publikationsbereich kopieren

Wählen Sie einen Publikationsbereich in dem Hauptfenster aus und klicken Sie auf die 'Publikationsbereich kopieren'-Schaltfläche. Ein Fenster erscheint, dessen Felder mit den Werten des zu kopierenden Publikationsbereich gefüllt sind. Die Bedeutung der Eingabefelder sind weiter oben bereits beschrieben worden. Passen Sie die Felder wie gewünscht an.

Klicken Sie auf die 'speichern'-Schalftfläche, um den Publikationsbereich anzulegen.

Publikationsbereich bearbeiten

Wählen Sie einen Publikationsbereich in dem Hauptfenster aus und klicken Sie auf die 'Publikationsbereiche bearbeiten'-Schaltfläche. Ein Dialog erscheint, über den der Publikationsbereich konfiguriert werden kann. Die Bedeutung der Eingabefelder sind weiter oben bereits beschrieben worden.

Klicken Sie auf die 'speichern'-Schaltfläche, um die Änderungen an dem Publikationsbereiche zu speichern.

Publikationsbereich löschen

Wählen Sie einen oder mehrere Publikationsbereich in dem Hauptfenster aus und klicken Sie auf die 'Publikationsbereich löschen'-Schaltfläche.

Bestätigen Sie die Sicherheitsabfrage, um den Publisher zu löschen.

@@ Zeile 1: / Zeile 1: @@
+__NOTOC__
 Publikationsbereiche dienen zur Publikation von Daten des IES. Die Form der publizierten Daten wird über Templates definiert. Mit Hilfe von IES-Templates und IES-Artikeln werden textuelle Daten generiert, die an einen Publikationsbereich weiter gegeben werden. Je nach Publikationsbereich werden diese Daten weiter verarbeitet. Bei einem <span class="emphasis">''FilePublisher''</span> werden diese Daten beispielsweise in eine Datei geschrieben. Dem IES stehen folgende Publisher zur Verfügung:
@@ Zeile 6: / Zeile 7: @@
 : Schickt die mit Hilfe der Templates und Artikel generierten Daten per HTTP-POST an die konfigurierte URL.
 ; MailPublisher
-: Mit Hilfe von Templates und Artikeln werden XML-Daten erzeugt, die die Informationen zur Generierung einer oder mehrere E-Mails enthalten. Diese E-Mails werden an den, in den XML-Daten enthaltenen Empfängern, verschickt. Um die E-Mails verschicken zu können, muss noch ein SMTP-Server konfiguriert werden. Die Konfiguration erfolgt in der Datei:
+: Mit Hilfe von Templates und Artikeln werden XML-Daten erzeugt, die die Informationen zur Generierung einer oder mehrere E-Mails enthalten. Diese E-Mails werden an den, in den XML-Daten enthaltenen Empfängern, verschickt. Um die E-Mails verschicken zu können, wird empfohlen stets eine lokale Postfix-Installation als Relay zu verwenden. Soll anderer Service angesprochen werden, so ist dieser über ENV-Variablen an den IES zu übergeben. Die Konfiguration erfolgt über die <code>IES_OPS</code> in der Datei:
-  SITEPARK_HOME/jboss/server/default/deploy/mail-service.xml
+  SITEPARK_HOME/conf/sitepark.conf
-: Folgender Eintrag muss dort angepasst werden:
+: Folgender Eintrag kann dort wie folgt angepasst/eingetragen werden:
 <source lang="xml">
-<property name="mail.smtp.host" value="smtp.nosuchhost.nosuchdomain.com">
+IES_JAVA_OPTIONS=-Dmail.smtp.host=localhost -Dmail.smtp.port=25 -Dmail.from=no-reply@sitepark.com
 </source>
-: Tragen Sie für das Attribut<code>value</code> einen vom IES erreichbaren Host eines SMTP-Servers ein, über den die definierten E-Mails verschickt werden können bzw. dürfen.
 ; <span class="term">DatabasePublisher</span>
 : Mit Hilfe von Templates und Artikeln werden XML-Daten erzeugt, über die der DatabasePublisher gesteuert wird. Der DatabasePublisher wird mit einer Datenbank verknüpft in der Daten mittels der XML-Daten Datenbankeinträge erzeugt, geändert und gelöscht werden können.