Inhaltsverzeichnis

Allgemein

PS.Content kann Artikel an das HUP (VL) Printredaktionssystem ausleiten. Der Übergabemechanismus ist bidirektional, ein Abgleich kann also in beide Richtungen erfolgen, auch aus dem Print-System zurück nach PS.Content (PS.C im folgenden).

...

Glossar

• Grundartikel = Ein eigenständiger Print-Artikel, der alle Komponenten aufnimmt, die nicht als eigenständiger Artikel angelegt wurden.
• Teilartikel = Ein eigenständiger Print-Artikel, der aus einem Teil (einer Cluster-Komponente) eines PS.C Artikels entstanden ist. Dies können zB. sein:
  • Infobox = Eine Clusterkomponente bestehend aus den Komponenten"HAZ", "Titel" und "Text"
  • Kommentar = Eine Clusterkomponente bestehend ausden Komponenten "Bild", "HAZ", "Autor", "Autor Kontakt" und "Text"
  • Zitat = Eine Clusterkomponente bestehend aus den Komponenten"Bild", "Autor" und "Text"
  • Aufmacher-Bild = Eine Clusterkomponente bestehend aus den Komponenten "Bild" und "Text"
  • Asset (Typ: Bild) = Eine Assetkomponente mit dem Inhalt: Bild sowie den üblichen Metadaten Titel, Text und Quelle

Ortsmarken und Autorenkürzel

vgl. CON-5111: Ortsmarke nicht unbedingt am Flächenanfang

...

de: 
  hup: 
    vl: 
      edt:   
        article: 
          import:
            default-template: PS_Standard_32
            # Ortsmarke/Autorenkürzel: Zielfläche im VL-Artikel ODER Kombination des Komponenten-Mappings "component+item"
            insert-geo-location: "text+text"


            - 
              template: PS_Umfrage
              #  Ortsmarke/Autorenkürzel: Zielfläche für Musterartikel "PS_Umfrage" bzw. Kombination des Komponenten-Mappings
              insert-geo-location:
              parameters:
              -
                ...

Ausleitung von Assets und Clustern

Prinzipiell kann konfiguriert werden, Assets als separate Artikel auszuleiten. Ebenso ist eine Liste von Cluster-Namen konfiguriert, deren Inhalt als separater Artikel ausgeleitet wird.

...

Es ist auch möglich, das im PS.C-Artikel eingestellte print-template mit einem dynamischen Attribut als Parameter (z.B. "Kategorie") auf ein anderes print-template "umzumappen". Die oben genannte Definition von Ausnahmen (Assets im Grundartikel obwohl prinzipiell separat) erfolgt dann mit diesem "umgemappten" print-template - gleiches gilt für die Musterwahl im Editor-Service.

Asset-Download im Printsystem

vgl. CON-4991: DnD von Assets auf alternative Adresse umleiten

...

PS: Config war bei diesen Tests Redaktion.AutomatischeNamen="1"; und Redaktion.UseImageName4ImageArticle="0";

Pull-Workflow

Zur technischen Realisierung siehe Pull-Workflow. Hier soll es um die prinzipielle Funktion und eine Konfigurations-Übersicht gehen.

...

• Setzen zusätzlicher Testate am PS.C-Artikel beim Platzieren
• Entziehen des Kanals am PS.C-Artikel beim Deplatzieren im Printsystem + in den Papierkorb stellen
• Kein Kanalentzug beim Deplatzieren, Export des Print-Kanals nur bei <Kanalname>.#usedInChannel="true"

Zuordnung von Komponenten aus PS.C zu Flächen im Printsystem, Wahl von Musterartikeln, prinzipielle Kommunikation

Ablauf Übergabe PS.C nach HUP-Print

• 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.
  
  

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"), einen Auszeichnung für den ersten Absatz ("style-of-first-paragraph") 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 ("style") angegeben, wird der Text mit dieser "Weichen Auszeichnung" eingefügt.
    • Als Einfüge-/ Absatzmodus 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.)
      • "closepara" - Schließt einen Absatzattributierung ab
      • "inline" - Fügt einen Text (i.A. mit einem Style), ohne dass ein Absatz eingefügt wird (z.B. Fett- oder Kursiv-Auszeichnung)
    • Ist eine Auszeichnung für den ersten Absatz ("style-of-first-paragraph") konfiguriert, wird dieser vor den einzufügenden Text gestellt, wenn:
      • der Text in der Zielfläche zuvor leer war
      • der vorherige Contentpart für die Zielfläche einen anderen Namen hatte 
        Name: Component-Name + "." + Item-Name [ + #Component-Nummer]
      • vorher kein Inline-Paragraph in der Zielfläche verwendet wurde
    • 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 ggfs. 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.
    • EFW-Parameter (optional):
      • "start" - EFW-Text am Anfang des einzufügenden Textes - z.B. "-&#32;"
      • "end" - EFW-Text am Ende des einzufügenden Textes - z.B. "<HFILL/>"
      • "start-if-mode-before" - Bei Einfügemodus "add" und Absatzmodus des zuvor in die Fläche eingefügten Textes, bei dem der Start-EFW-Text eingefügt werden darf - z.B. "add"
      • "end-if-mode-before" - Bei Einfügemodus "add" und Absatzmodus des zuvor in die Fläche eingefügten Textes, bei dem der End-EFW-Text eingefügt werden darf - z.B. "newline"
      • "pre-format: true" - Formatieren des Artikels vor dem Einfügen des Textes, wenn die Zielfläche aufgeweckt werden soll
• Je Musterartikel kann ein Bereich "actions" definiert werden, die seitens HUP-Print ausgelöst werden können, um Inhalte aus PS.Content zu übernehmen
  • Eine Aktion hat einen eindeutigen Namen
  • Eine Aktion hat eine Bezeichnung - z.B. zur Anzeige im Kontextmenü
  • Eine Aktion hat einen Bereich "mappings" definiert - siehe oben

...

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
  actions:
    - name: short-headline
      label: Kurzüberschrift als UNZ
      parameters:
      - 
        component: headline
        item: short
        destination: UNZ
        mode: replace
    - name: teaser
      label: Teaser als Vorspann
      parameters:
      -
        component: teaser
        item: text
        destination: Vorspann
        mode: add 
    - name: qr-code
      label: QR-Code einfügen
      parameters:
      - 
        component: qrcode
        component-no: 0
        item: text
        destination: Service$Text
        mode: replace
        efw-parameters:
          start: "Scannen Sie den QR-Code mit ihrem Handy oder geben Sie den Link in den Browser ein: "
          end:                 
      - 
        component: qrcode
        component-no: 0
        item: assetID
        destination: Service$Bild
        mode: replace     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: overline
    component-no: 0
    item: text
    destination: DAZ
    mode: replace
    efw-parameters:
      pre-format: true
  - 
	component: text
	item: text
	destination: Text
	mode: newline
    style-of-first-paragraph: Initial3Z
  - 
	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
  - 

Übergabe von Verwaltungsdaten

Mit speziellen Mappings können die PS.C Artikel-Verwaltungsdaten im Print-Artikel als Text übernommen werden.

Über das Schlüsselwort "#article" für component wird festgelegt, dass ein Verwaltungsdatum verwendet werden soll.

Über item wird der Pfad zum Verwaltungsdatum beschrieben: z.B. Author = Autorname; Tags$Tag$Name = ein Stichwort

Bei Listen (z.B. Tags, Locations, Departments, ...) wird über component-no das konkrete Element aus der Liste adressiert: z.B. 0 = erstes Element.

Auch für Verwaltungsdaten gelten die schon oben erwähnten Einfüge- und Absatzmodi sowie die efw-Parameter.

    ###### Artikelverwaltungsdaten Mapping #####
    - # das erste Stichwort übernehmen
      component: "#article"
      component-no: 0
      item: Tags$Tag$Name
      destination: Vorspann
      mode: add
    - # das zweite Stichwort übernehmen
      component: "#article"
      component-no: 1
      item: Tags$Tag$Name
      destination: Vorspann
      mode: add
      efw-parameters:
        start: " / "
        #end: " "
    - # das erste Ressort übernehmen
      component: "#article"
      component-no: 0
      item: Departments$Department$Name
      destination: Vorspann
      mode: newline
    - # Autor übernehmen
      component: "#article"
      component-no: 0
      item: Author
      destination: Vorspann
      mode: newline
    #############

Spezialfall Aufzählungskomponenten

• Für eine Aufzählungskomponente (Enumeration) seht folgendes Mapping zur Verfügung:
  
  

...

mappings:
-
  parameters:
  -
    component: enumeration
    item: numbered
    destination: Text
    mode: newline
    style: ABS_ERGEBNISSE
    efw-parameters:
      start: "<TAB/>0"
      start-if-mode-before: add
      after-number: ".<TAB/>"
      end: "..."
      end-if-mode-before: add
  -
    component: enumeration
    item: normal
    destination: Text
    mode: newline
    style: ABS_ERGEBNISSE
    efw-parameters:
      start: "&#183;<QUAD TYPE=4/>"
  -
    component: enumeration
	item: alphabetic
    destination: Text
    mode: newline
    style: ABS_ERGEBNISSE
    efw-parameters:
      start: "&#8226;<QUAD TYPE=1/>"    

Spezialfall Cluster-Komponenten

• 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

Anker
Textreplacement Textreplacement

vgl. auch HUP OP #7929657: Editor-Service: Textzeichen-Ersetzung unvollständig

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.).

...

HR oder <HR/>

HFILL oder <HFILL/>

‗

<HFILLLINE/>

TAB oder <TAB/>

QUAD1 oder <QUAD TYPE=1/>

QUAD2 oder <QUAD TYPE=2/>

QUAD3 oder <QUAD TYPE=3/>

QUAD4 oder <QUAD TYPE=4/>

QUAD8 oder <QUAD TYPE=8/>

QUAD9 oder <QUAD TYPE=9/>

<WBR/>

<BR/>

<BR ALIGN=END/>

NSP

SPACE

<MASK_Uxxxx>

Die bisher aufgeführten Zeilen zu einfachen und doppelten typografischen Anführungszeichen (auch jeweils die französische Variante) haben keine Wirkung und können deshalb auch weggelassen werden:

...

PS: Bitte im Codebeispiel die Unterschiede zwischen "Komma" und dem einfachen typografischen Anführungszeichen unten sowie "größer/kleiner als" und den einfachen französischen Anführungszeichen beachten.

Übergabe HUP-Print nach PS.C

• Ist der Artikel bereits vorhanden, muss der Abgleich durch Anklicken des Eintrags "Externe Änderungen importieren" ausgelöst werden.
• Wird der PS.C Artikel aus HUP Print heraus neu angelegt, wird initial ein Abgleich ausgeführt.
• Über den EDT-SVC wird aus dem Print-Artikel (und seinen Teilartikeln) ein temporärer PS.C Artikel erstellt. Dies geschieht schon auf VL-Seite in ModuleEfwDataBO.dll. (vgl auch

  Ältere Jira-Version
  server System Jira columnIds issuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 9e1d8ee1-e644-33f7-bad0-2d7ba828cfcb key CON-5822

  )
  • Dieser Artikel wird durch umgekehrtes Auswerten der "PS.C nach HUP Print" Konfiguration des EDT-SVC erstellt (vgl. oben). Der ggf. beim ursprünglichen Export des Artikels nach Print verwendete Musterartikel wird mit übergeben, um den richtigen "Abschnitt" des Mappings zu finden.
  • Es werden alle nicht schlafenden Print-Flächen ausgewertet und in entsprechende Komponenten übersetzt.
  • Beim "ReverseMapping" wird nach einem Eintrag gesucht, dessen "destination" der gerade behandelten Editor-Fläche entspricht und der auch den gleichen "style" hat (bei Text-Abschnitten ohne weiche Auszeichnung nach einem Eintrag ohne "style").
  • ist in der Konfiguration des EDT-SVC ein Eintrag mit "reverse-default: true" gekennzeichnet, wird der entsprechende Text bevorzugt als diese Komponente rückübersetzt (für den Fall, dass es mehrere Mappings gibt, die auf die gleiche Kombination destination/style führen) - sonst wird bei Mehrdeutigkeit in der Rückübersetzung immer die erste passende Komponente verwendet.
  • Kann für die Fläche keine Zielkomponente (ohne "style") ermittelt werden, wird der gesamte Text nicht übernommen - wird nur für einen Abschnitt mit weicher Auszeichnung kein Ziel gefunden, wird der Text wie ohne Auszeichnung übernommen.
  • individuelle Ausnahmen zum globalen "ignore-em-classes" für die Rückübernahme lassen sich mit einem Trick festlegen: Der nicht zu übernehmende Text bekommt im Mapping eine mit "reverse-default: true" gekennzeichnete "Dummy"-Komponente (die in der UI nicht existiert) und landet damit nicht im PS.C-Artikel.

...

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.

...

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)

In Kanal exportieren

vgl.