Inhalt

Allgemein

...

Die Konfiguration erfolgt in der application.yml des Editor-Services (EDT-SVC).
Ausgehend von folgenden Parametern wird ein Musterartikel ("template") gewählt:
- print-template: (optional) Testat "Artikelmuster" oder Name der Cluster-Komponente
- chars: (1-n) Grundtextmenge (Zeichenanzahl)
- publication: (optional) Publikation von Exportkanal übermittelt
Vorgehensweise zum Auffinden des passenden Musterartikels
1. Ist eine Publikation bekannt, werden alle templatesgesucht, die passend zu publication und print-template sind
2. Bei Treffermenge = 0: Ist eine Publikation bekannt, werden alle templates gesucht, die passend zu publication sind und KEIN print-template haben
3. Bei Treffermenge = 0: Es werden alle templates gesucht, die passend zu print-template sind und KEINE publication haben
4. Bei Treffermenge = 0; Es werden alle templates gesucht, die KEIN print-template oder print-template=standard und KEINE publication haben

Ist diese Treffermenge > 1, wird das template ermittelt, welches am besten zur Zeichenanzahl (chars) passt.
Ist die Treffermenge = 0, wird das default-template verwendet
Mit dem template wird das Flächen-Mapping (mappings) ermittelt.

Codeblock

language	yml
theme	DJango
title	Beispiel
collapse	true

templates:
 -
   chars: 3000
   template: 4-44-mit Bild
 -
   chars: 2000
   template: 3-44-mit Bild
 - 
   chars: 1000
   template: 2-24-mit Bild
 -
   chars: 1000
   print-template: comment
   template: Kommentar_2sp
 -
   chars: 1000
   print-template: comment
   publication: OWZ
   template: OWZ_Kommentar_2sp
 -
   chars: 500
   template: 1-18-mit Bild
 -
   chars: 500
   print-template: comment
   template: Kommentar_1sp
 -
   chars: 500
   print-template: comment
   publication: OWZ
   template: OWZ_Kommentar_1sp
 -
   print-template: clusterInfobox
   template: Infobox_1sp

Ist der Arikel in HUP-Print schon vorhanden (es hat zuvor bereits eine Übergabe stattgefunden)
wird dieser geöffnet und geleert
Sonst wird anhand dieses "Musterartikels" ein neuer Artikel angelegt.
Am Artikel wird in einem dynamischen Attribut gespeichert, aus welchem PS.C Artikel er entstanden ist.
Der evtl. vorhandene Grundtext wird entfernt.

Je Musterartikel wird im Bereich "mappings" definiert, welcher Teil einer möglicherweise vorkommenden PS.C Artikelkomponente in welche Fläche des HUP-Print Artikels überführt werden soll.
Die Reihenfolge der Komponenten im PS.C Artikel gibt die Abarbeitungsreihenfolge vor.
In der "Umsetzungstabelle" wird jedem Bestandteil ("item") einer PS.C Artikelkomponente eine Zielfäche ("destination") und optional eine Zielauszeichnung ("style") sowie ein Einfügemodus ("mode") zugeordnet.
Ist keine Zielfläche konfiguriert, wird die Komponente nicht übertragen.
Ist keine Auszeichnung vorhanden, wird das normale Absatz- und Zeichenformat der Zielfläche verwendet.
Ist eine Auszeichnung angegeben, wird der Text mit dieser "Weichen Auszeichnung" eingefügt.
Als Einfügemodus stehen zur Verfügung:
"replace" - Ersetzt den bisherigen Inhalt
"add" - Fügt den neuen Inhalt an in den vorhandenen Absatz ein
"newline" - Fügt den neuen Inhalt in einem neuen Absatz an
"openpara" - Schließt einen vorhandenen Absatz und öffnet einen neuen, der nicht wieder geschlossen wird. (Fettanlauf zB.)
Als Destination kann auch eine Freifläche oder Überlagerung adressiert werden. In diesem Falle ist der Layername dem Flächennamen voran zu stellen zB: "Freifläche1$Bild"
Schläft eine adressierte Zielfläche, wird diese aufgeweckt, sobald ein Inhalt für sie vorhanden ist. Die Vaterfläche (oder gffs. der Layer bei Freiflächen) wird dabei ebenfalls aufgeweckt.
Bilder (Assets) werden der Reihe nach in vorhandene und evtl. schlafende Bildflächen eingefügt.
Der Layer/Vater einer Bildfläche muss nicht zwingend alle weiteren von der Bild-Komponente referenzierten Flächen wie Text und Quelle enthalten. Sie können über "destination: ..." adressiert werden.
Ist am VLExporter in der Logik-Server Konfiguration der Konfigschalter ".parameters:standAloneArticleFromAsset: clusterHeadPicture" gesetzt, werden alle Bild-Assets als Bildartikel mit dem Template clusterHeadPicture ausgeleitet.
Es gibt dann KEINE im Print-Artikel eingebetteten Bilder mehr.

Codeblock

language	yml
theme	DJango
title	Beispiel
collapse	true

mappings:
- 
  # gleiche Konfig für mehrere Musterartikel
  template: 4-44-mit Bild|3-44-mit Bild|2-24-mit Bild|1-18-mit Bild|Kommentar_1sp|Kommentar_2sp
  parameters:
  - 
    # bei einer headline Komponente wird zunächst der normale Text versucht zu übernehmen, erzeugt dieser Übersatz, wird automatisch die short-Form der Komponente benutzt, sofern vorhanden
	component: headline
	item: text
	destination: Titel
	mode: replace
  - 
	component: headline
	item: short
	destination: Titel
	mode: replace
  - 
	component: printHeadline
	item: text
	destination: Titel
	mode: replace
  - 
	component: text
	item: text
	destination: Text
	mode: newline
  - 
	component: subtitle
	item: text
	destination: Text
	mode: newline
	style: Zwischenzeile
  - 
	component: leader
	item: text
	destination: Vorspann
	mode: replace
  - 
	component: picture
	item: text
	destination: Bild1$Text
	mode: replace
  - 
	component: picture
	item: source
	destination: Bild1$Text
	mode: add
  - 
	component: picture
	item: assetID
	destination: Bild1$Bild
	mode: replace
  -

...

Jede Cluster-Komponente, die application.yml des Logik-Servers im Konfigurationseintrag "createStandAloneArticles" (als Parameters des "exportPoint" zum VL-System) aufgeführt ist, wird als Teilartikel bei der Ausleitung an HUP-Print behandelt.
Ihr Name geht als "printTemplate" in die Suche nach einem Musterartikel ein.
Die in ihr enthaltenen Komponenten entsprechen in der Konfiguration des EDT-SVC einer ganz normalen Artikelkomponente. (Kein Präfix)
Alle Cluster-Komponenten, die nicht im Konfigurationseintrag "createStandAloneArticles" aufgeführt sind, werden als Bestandteil des Grundartikels verarbeitet.
Ihr Name wird mit dem Namen der Cluster-Komponente als Präfix erweitert. (zB. clusterInfobox.headline)

...

Textersetzungen von PS.Content nach HUP-Print

...

Über den EDT-SVC wird aus dem Print-Arikel (und seinen Teilartikeln) ein temporärer PS.C Artikel erstellt.

Dieser Artikel wird durch umgekehrtes Auswerten der "PS.C nach HUP Print" Konfiguration des EDT-SVC erstellt. (vgl. oben)
Es werden alle nicht schlafenden Print-Flächen ausgewertet und in entsprechende Komponenten übersetzt.
Im Grundtext wird jeder Textteil, der nicht Bestandteil einer "Weichen Auszeichnung" ist, als Komponente vom Typ "text" mit dem Namen text übertragen
Zu jedem Textteil, der Bestandteil einer "Weichen Auszeichnung" ist, wird nach dem Regelwerk die Zielkomponente ermittelt
zB: Style = Zwischenzeile → Komponente vom Typ "text" mit Name = subtitle
Kann keine Zielkomponente ermittelt werden → Wird eine neue Komponente vom Typ "text" mit dem Namen text erzeugt

...

Konfiguration unter hup.one.content.article.importSources; z.B.

...

language	yml
theme	DJango

...

Anker
Textreplacement
Textreplacement

Für jeden Exportkanal können Textersetzungen definiert werden, die in der Editorservice-Schnittstelle ausgewertet werden. Das sind i.A. Zeichen, die im Printsystem anders aussehen (z.B. Anführungszeichen etc.) oder Steuerzeichen sind (z.B. Tabulator, Absatzmarken etc.).

Folgende Zeichen können definiert und ersetzt werden:

PS.C Zeichen	Ersetzungszeichen	HUP-Print Entsprechung
⎵	HR oder <HR/>	Absatzlinie
↔	HFILL oder <HFILL/>	Zeilenspaltung
‗	<HFILLLINE/>	Auffüllline
→	TAB oder <TAB/>	Tabulator
█	QUAD1 oder <QUAD TYPE=1/>	Vollgeviert
▌	QUAD2 oder <QUAD TYPE=2/>	Halbgeviert
▍	QUAD3 oder <QUAD TYPE=3/>	Drittelgeviert
▎	QUAD4 oder <QUAD TYPE=4/>	Viertelgeviert
▏	QUAD8 oder <QUAD TYPE=8/>	Achtelgeviert
ǁ	QUAD9 oder <QUAD TYPE=9/>	Zifferngeviert
‑	<WBR/>	Trennvorgabe
« oder »	"	Französische in Editor-spezifische Anführungszeichen umwandeln
„ oder “	"	Typographische in Editor-spezifische Anführungszeichen umwandeln
‒	–	Bindestrich
┐	<BR/>	Zeilenwechsel (Ausrichtung Umlaufzeile)
┘	<BR ALIGN=END/>	Zeilenwechsel (Ausrichtung Absatzendezeile)
	NSP	Geschütztes Leerzeichen ( )
	SPACE	Leerzeichen ( )

Unicode-Zeichen aus PS.Content werden mit der entspr. Codierung &#[Codenummer]; nach HUP-Print übernommen.

Die Textersetzungen gelten auch in umgekehrte Richtung.

Codeblock

language	yml
theme	DJango
title	Beispiel für Textersetzung nach HUP-Print
collapse	true

export-steps:
-
  export-points:
  -
    name: Print
    parameters:
      text-replacements: "⎵=<HR/>,↔=HFILL,→=TAB,█=QUAD1,▌=QUAD2,▎=QUAD4,▍=QUAD3,▏=QUAD8,ǁ=QUAD9,‑=<WBR>,«=\",»=\",„=\",“=\",‒=–,┐=<BR/>,┘=<BR ALIGN=END/>"

Übergabe HUP-Print nach PS.C

Wird der PS.C Artikel aus HUP Print heraus neu angelegt, wird initial ein Abgleich ausgeführt.
Ist der Artikel bereits vorhanden, muss der Abgleich durch Anklicken des Eintrags "Externe Änderungen importieren" ausgelöst werden.
Über den EDT-SVC wird aus dem Print-Arikel (und seinen Teilartikeln) ein temporärer PS.C Artikel erstellt.
- Dieser Artikel wird durch umgekehrtes Auswerten der "PS.C nach HUP Print" Konfiguration des EDT-SVC erstellt. (vgl. oben)
- Es werden alle nicht schlafenden Print-Flächen ausgewertet und in entsprechende Komponenten übersetzt.
- Im Grundtext wird jeder Textteil, der nicht Bestandteil einer "Weichen Auszeichnung" ist, als Komponente vom Typ "text" mit dem Namen text übertragen
- Zu jedem Textteil, der Bestandteil einer "Weichen Auszeichnung" ist, wird nach dem Regelwerk die Zielkomponente ermittelt
  zB: Style = Zwischenzeile → Komponente vom Typ "text" mit Name = subtitle
  Kann keine Zielkomponente ermittelt werden → Wird eine neue Komponente vom Typ "text" mit dem Namen text erzeugt
Handelt es sich um einen neuen PS.C Artikel, werden alle bekannten Komponenten 1:1 übernommen. Je Bildfläche wird ein Asset angelegt.

Handelt es sich um einen bereits vorhandenen PS.C Artikel, werden die Komponenten des temporären Artikels mit den vorhandenen abgeglichen:
Der Abgleich kann (nur für den Hauptartikel, nicht für Cluster-Komponenten) in der application.yml des UI-Servers konfiguriert werden:
Konfiguration unter hup.one.content.article.importSources; z.B.
Codeblock
language yml
theme DJango
- name: 'VL' parameters: delete: - text - subtitle ignore: - leader - teaser - audio - picture - video parametersreplace: delete headline: printHeadline subheadline: - text - subtitle ignore: - leader subtitle

Der Eintrag "delete" definiert, welche Komponenten des PS.C-Artikels beim Abgleich entfernt (nicht übernommen) werden sollen. (z.B. "text", "subtitle")
Der Eintrag "replace" definiert, welche Komponenten aus dem Print Artikel in eine neue / andere Komponente des PS.C Artikels übertragen werden sollen. (z.B.: "headline" → "printHeadline")
Der Eintrag "ignore" definiert, welche Komponenten aus dem PS.C-Artikel unverändert übernommen werden sollen. (z.B.: "leader")
Der Eintrag "name" muss mit dem in der Konfiguration des Logik-Servers hinterlegten übereinstimmen (hup.one.content.article.import.externalSources)
Codeblock
language yml
theme DJango
- teaser name: 'VL' - audio - picture moduleClassname: de.hup.one.content.logic.imports.article.ArticleVLImportModule parameters: - video # replace:url: http://wrapperred14:8080/service/edt/article/xml headline: printHeadline url: http://localhost:8180/service/edt/article/xml subheadline: subtitle
Der Eintrag "delete" definiert, welche Komponenten des PS.C-Artikels beim Abgleich entfernt (nicht übernommen) werden sollen. (z.B. "text", "subtitle")
Der Eintrag "replace" definiert, welche Komponenten aus dem Print Artikel in eine neue / andere Komponente des PS.C Artikels übertragen werden sollen. (z.B.: "headline" → "printHeadline")
Der Eintrag "ignore" definiert, welche Komponenten aus dem PS.C-Artikel unverändert übernommen werden sollen. (z.B.: "leader")
Der Eintrag "name" muss mit dem in der Konfiguration des Logik-Servers hinterlegten übereinstimmen (hup.one.content.article.import.externalSources)
Codeblock
language yml
theme DJango
- name: 'VL' moduleClassname: de.hup.one.content.logic.imports.article.ArticleVLImportModule parameters: # url: http://wrapperred14:8080/service/edt/article/xml url: http://localhost:8180/service/edt/article/xml exportAttrib: vlExport.articles

...

          exportAttrib: vlExport.articles

ACHTUNG: Asset-Komponenten werden bei wiederhohlten Rückübermittlung aus Print ignoriert. Es wird weder das Asset noch der Bildtext abgeglichen! Auch die Position des Assets in Relation zum Grundtext geht verloren. Das wird ggfs. später korrigiert.

Textersetzungen von HUP-Print nach PS.Content

An der Importschnittstelle für HUP-Print (VL) in PS.Content können Textersetzungen definiert werden.

Dabei handelt es sich um die gleichen Ersetzungsmöglichkeiten wie in umgekehrter Richtung - siehe Tabelle Textersetzungen

Codeblock

language	yml
theme	DJango
title	Beispiel für Textersetzung von Print nach PS.Content
collapse	true

import:
  external-sources:
  -
    name: 'VL'
    parameters:
      text-replacements: "<HR/>=⎵,<HFILLLINE/>=‗,<HFILL/>=↔,<TAB/>=→,<QUAD TYPE=1/>=█,<QUAD TYPE=2/>=▌,<QUAD TYPE=4/>=▎,<QUAD TYPE=3/>=▍,<QUAD TYPE=8/>=▏,<QUAD TYPE=9/>=ǁ,<WBR/>=‑,‒=–,<BR/>=┐,<BR ALIGN=END/>=┘"

Mehrfache Print-Artikel zu einem PS.C-Artikel (publikationsspezifische Ausleitungskanäle)

...

Version	Alte Version 28	Neue Version 29
Änderungen wurden vorgenommen von	Rene Bretschneider	Markus Gemeinhardt
Gespeichert am	Sept. 19, 2019	Nov. 25, 2019

Versionen im Vergleich

Schlüssel

Inhalt

Allgemein

Textersetzungen von PS.Content nach HUP-Print

Anker
Textreplacement
Textreplacement

Übergabe HUP-Print nach PS.C

Textersetzungen von HUP-Print nach PS.Content

Mehrfache Print-Artikel zu einem PS.C-Artikel (publikationsspezifische Ausleitungskanäle)

Seitenvergleich

Versionen im Vergleich

Schlüssel

Allgemein

Textersetzungen von PS.Content nach HUP-Print

AnkerTextreplacementTextreplacement

Übergabe HUP-Print nach PS.C

Textersetzungen von HUP-Print nach PS.Content

Mehrfache Print-Artikel zu einem PS.C-Artikel (publikationsspezifische Ausleitungskanäle)

Anker
Textreplacement
Textreplacement