Page Comparison

Funktionalitäten von Fließtabellen

• Elemente einer Seite

• Artikel mit komplexer XML-Struktur

Inhaltsverzeichnis

Notwendige Vorkenntnisse

• Makros /& Tags (Aufbau und Verwendung), Makrobibliotheken

• Aufruf von schwimmenden Bildern in Makroshttps://peiq.atlassian.net/wiki/spaces/PPSD/pages/1013481473/Seitenkopf-Logos+als+Schwimmende+Bilder+in+Makros+aufrufen#Wie-k%C3%B6nnen-schwimmende-Bilder-in-Makros-eingef%C3%BCgt-werden%3F

• Tabulatoren setzen und editieren (Tabellenumbruch mit Hilfe von Tabulatoren | comment-1052180617)

Aufbau der zu importierenden XML-Struktur und deren Auswertung in PRINT NGEN

XML-Beginn

<DOC>
	<DTextName>MSU-WN-PeiQFussball-2022-03-25 10:02:16</DTextName>
	<DTextAusgabe>wn-099_mf</DTextAusgabe>
	<DTextRessort>rsp</DTextRessort>
	<DTextErschAm>26.03.2022</DTextErschAm>
	<Mandant></Mandant>
	<Kommentar>Sporttab</Kommentar>

Hier werden grundlegende Informationen übermittelt, die von PRINT NGEN in die Eigenschaften der Text-Artikelvorlage übernommen werden, wie etwa Name, Ausgabe, Ressort, Erscheinungstag, Mandant und Kommentar.

Einleitende Tags

<Titel> Sport </Titel>
<Text> <?TabelleFussball?> <LigaName> 3. Liga Herren </LigaName> <Tabelle>

• <Titel> … </Titel> Tag für evtl. Tabellenüberschrift, diese fließt in PRINT NGEN in den Titelbereich des Artikels.

• <Text> </Text> Tag umklammert den gesamten Textbereich. Alles hier enthaltene fließt in PRINT NGEN in den Textbereich des Artikels.

Innerhalb eines Artikels können auch Tabellen für unterschiedliche Sportarten vorhanden sein. Durch das umfassende Makro kann zur unterschiedlichen Gestaltung der Tabellen in verschiedene Makrobibliotheken gewechselt werden.

• <LigaName> 3. Liga Herren </LigaName> Typographieeinstellungen für die Liga-Überschrift über der Tabelle.

• <Tabelle> </Tabelle> umschließt nun die Tabellen an sich. Tag enthält grundlegende Typographieeinstellungen (Schriftart, Größe, Stil, Weite).

Erste Teiltabelle (Ergebnis-Block)

<Ergebnis>
<Zeile><?Alternierend1?><TeamHeim>Würzburger Kickers</TeamHeim>
<TeamGast>Viktoria Köln</TeamGast>
<ErgebnisHeim>0</ErgebnisHeim>
<ErgebnisGast>1</ErgebnisGast>
<?_Alternierend1?></Zeile>
<Zeile><?Alternierend2?>
<TeamHeim>VfL Osnabrück</TeamHeim>
<TeamGast>Viktoria 89 Berlin</TeamGast>
<ErgebnisHeim>3</ErgebnisHeim>
<ErgebnisGast>1</ErgebnisGast>
<?_Alternierend2?></Zeile>
...
</Ergebnis> 

<Ergebnis></Ergebnis> umschließendes Tag für den Ergebnis-Block. Ruft eigene Makrobibliothek auf (das kann dieselbe Bibliothek sein, wie von <?TabelleFussball?> aufgerufen (s. o.).)

Es folgen die einzelnen Zeilen mit Inhalt, jeweils umschlossen vom Makro <Zeile>.

Alle folgend aufgeführten Tags/Makros müssen in der Makrobibliothek, die durch <Ergebnis> aufgerufen wird, enthalten sein:

• <Zeile> enthält hier nur einen Makrounterbrecher, da in diesem Block nicht mit Tabulatoren gearbeitet werden muss (siehe unter “Rangliste“).

• <?Alternierend1?> bzw. <?Alternierend2?> hier können z. B. alternierende Negativfarben für die Zeilen festgelegt werden, um Zeilen abwechselnd einzufärben. Ist das nicht gewünscht, kann das Makro in der Makrobibliothek weggelassen werden und wird nicht ausgewertet (optional). 

• <TeamHeim> hier wird das verbindende “-” zwischen den beiden Teamnamen aufgerufen. Teamspezifische Typographie wäre hier außerdem möglich.

• <TeamGast> hier wird ein <ZS> (Zeilenspalter) aufgerufen. Dies stellt die nun folgenden Ergebniszahlen ans Ende der Zeile.

• <ErgebnisHeim> hier wird der Doppelpunkt “:” zwischen den Ergebnissen aufgerufen. 

• <ErgebnisGast> ruft <ZA> (Zeile austreiben) auf und legt damit das Ende der Zeile fest.

</Ergebnis> schließt den Ergebnis-Block ab.

Zweite Teiltabelle (Rangliste)

<Rangliste>
<Zeile><?Alternierend1?>
<?Rang1?><Rang>1.</Rang>
<TeamName>1. FC Magdeburg</TeamName>
<SpieleGesamt>31</SpieleGesamt>
<ToreGesamt>65</ToreGesamt><GegenToreGesamt>30</GegenToreGesamt>
<Punkte>66</Punkte>
<?_Rang1?><?_Alternierend1?></Zeile>
</Rangliste>

<Rangliste></Rangliste> umschließendes Tag für die zweite Teiltabelle - eine Rangliste. Ruft eigene Makrobibliothek (WN_SP_Fuba_Rangliste) auf (damit das Umschalten in die neue Makrobibliothek möglich ist, muss in derjenigen Makrobibliothek, die im Augenblick gilt, das umschaltenden Makro vorhanden sein.) 

Alle nun folgenden Makros müssen in der neu aufgerufenen Bibliothek enthalten sein:

• <Zeile> ruft die Werteliste “SP_Tabellen_Tabulatoren” auf, in der die Tabulatorenpositionen festgelegt sind (nicht nötig im Ergebnis/Vorschau-Block, da hier nicht mit Tabulatoren gearbeitet wird, dann enthält das Makro nur einen MAKU)

• <?Alternierend1?> bzw. <?Alternierend2?> (s. o.)

• <?Rang1?> bis <?Rang20?> Makros, die rangspezifische Einstellungen ermöglichen, z. B. farbliche Abhebung der Auf- oder Absteiger im Fußball (optional)

• <Rang> hier wird ein Festwert oder Tab hinterlegt, um Abstand zum folgenden TeamNamen zu schaffen (wie groß die Tabs sind, wird über die Werteliste gesteuert, die das Tag <Zeile> aufruft)

• <TeamName>, <SpieleGesamt>, <ToreGesamt>, <GegenToreGesamt> usw. enthalten jeweils Tabs/Festwerte, die den Abstand zum nächsten Element definieren und evtl. benötigte Zeichen, wie “:”.

</Rangliste> schließt die Teiltabelle ab.

Dritte Teiltabelle (Vorschau)

Die Vorschau wird analog zum Ergebnis-Block aufgebaut und kommt ohne Tabulatorpositionen aus.

<Vorschau>
<Zeile><?Alternierend1?><TeamHeim>VfL Osnabrück</TeamHeim>
<TeamGast>Braunschweig</TeamGast>
<Spieldatum>Sa. 26.03.2022</Spieldatum>
<Spieluhrzeit>14:00</Spieluhrzeit>
<?_Alternierend1?></Zeile>
<Zeile><?Alternierend2?>
<TeamHeim>SC Verl</TeamHeim>
<TeamGast>FSV Zwickau</TeamGast>
<Spieldatum>Di. 29.03.2022</Spieldatum>
<Spieluhrzeit>19:00</Spieluhrzeit>
<?_Alternierend2?></Zeile>
...
</Vorschau>

<Vorschau></Vorschau> umschließendes Tag für die Vorschau. Ruft, wenn nötig, eigene Makrobibliothek auf. Sonst gilt hier ebenfalls die Makrobibliothek, die mit <?TabelleFußball?> (s. o.) aufgerufen wurde.

Alle nun folgenden Makros müssen in der neu aufgerufenen Bibliothek enthalten sein:

• <Zeile> (nur MAKU, s. o.)

• <?Alternierend1?> bzw. <?Alternierend2?> (s. o.)

• <TeamHeim> (s. o.)

• <TeamGast> hier wird ein <ZS> (Zeilenspalter) aufgerufen. Dies stellt die nun folgenden Daten ans Ende der Zeile.

• <Spieldatum> ruft <?Gev?> (Geviert) auf.

• <Spieluhrzeit> ruft <ZA> (Zeile austreiben) auf und legt damit das Ende der Zeile fest.

</Vorschau> schließt die Teiltabelle ab.

Abschluss der XML-Struktur

Weitere Teiltabellen können analog folgen.

Sind alle Teiltabellen abgeschlossen, folgen die schließenden Tags </Tabelle> <?_TabelleFussball?> </Text> (s. o.).

Aufbau der nötigen Makros und der zugehörigen Bibliothekenstruktur

Videos:

https://www.loom.com/share/1af3d71b4e9d4d2bbc47c502bb9d29b7

https://www.loom.com/share/d2ac1d9000444ac5a99e24099668504e

https://www.loom.com/share/d1aab2c58bb145f6bd008945b092beb4

https://www.loom.com/share/81dc5d80b0da4666b3915fb4d42f2438

1. Im folgenden Video wird vorgestellt, welche Werkzeuge und Bibliotheken benötigt werden, um Sporttabellen einzurichten:

https://youtu.be/pcQp-Dz-MCQ

2. Im nächsten Video wird eine Artikelvorlage auf einer Seite eingerichtet:

https://www.loom.com/share/12aaf0f081a143c38100d29ee752a122

3. In diesem Video wird die Struktur der übergebenen XML-Datei vorgestellt:

https://www.loom.com/share/5d7541a390e54c7cb9d2c208e97ae06c

4. Im folgenden Video wird gezeigt, wie eine eigene Makrobibliothek erstellt werden kann:

https://youtu.be/QeXkIFuOqAA

5. In diesem Video geht es um das Makro “LigaName” und den Ergebnis-Block:

https://youtu.be/AJA18l2Qsw0

6. Im folgenden Video wird der Ranglisten-Block vorgestellt:

https://youtu.be/_gJqslcOqR8

7. In diesem Video wird gezeigt, wie Tabulatoren gesetzt werden können:

https://youtu.be/9J7yF4WDnds

8. Im folgenden Video werden die Tabulatoren fertiggestellt und an der Sporttabelle hinterlegt:

https://wwwyoutu.loom.com/share/d2ac1d9000444ac5a99e24099668504ebe/ksVG5OOO_mg

9. Im folgenden Video wird gezeigt, wie Feinheiten optimiert werden:

https://youtu.be/HAQ4vQkH5p8

10. Dieses Video geht auf Anmerkungen und Tipps zur Thematik ein:

https://youtu.be/qvqX_xNbGpk

Werteliste “SP_Tabellen_Tabulatoren”

Die Werteliste “SP_Tabellen_Tabulatoren” wird oben über das Tag <Zeile> aufgerufen:

In der Werteliste wird definiert, unter welchen Bedingungen welche Tabulatoren-Positionen gesetzt werden. Das heißt, je nach aktuell geltender Makrobibliothek und Breite der verwendeten Artikelvorlage, werden die Tabulatoren-Positionen verwendet, die in geschweiften Klammern angegeben sind (beim Import hat die Tabelle als reiner Fließtext noch keine Breite. Sobald aber die Tabelle in einem Artikel platziert wird, greift sie auf die Breite des Textbeins zu).

Die Tabulator-Positionen sollten zuerst auf einer Seite ausprobiert sowie gesetzt werden und können dann per Copy & Paste in diese Abbildung übernommen werden (siehe https://peiq.atlassian.net/wiki/spaces/PPSD/pages/1092550730/Tabellenumbruch+mit+Hilfe+von Tabulatoren | comment-1052180617+Tabulatoren?NO_SSR=1).

Der Import über die komplexe Aktion “IMPORT_Sporttabellen”

Um Sporttabellen zu importieren, müssen die XML-Dateien in das dafür vorgesehene Verzeichnis “Sporttabellen\Programmname” abgelegt werden. PRINT NGEN importiert diese Dateien dann automatisch und sammelt sie in der Mappe “Sporttabellen”.

Hintergrund:

Die Sporttabellen werden über das Verzeichnis “Sporttabellen\Agenturname” über die minütlich-ablaufende Warteschlange “IMPORT_MSU_Sporttabellen” automatisch im Hintergrund importiert. Dabei wird die komplexe Aktion “IMPORT_Sporttabellen” abgearbeitet. Welches Verzeichnis verwendet wird, ist in der Werteliste WA_Pfade festgelegt. -> Import von “@WAP(WA_Pfade;MerkeAktion=sporttabellenimport)\*.xml” nach Tabelle DText, Format NATIVE-Text. Anhand der Ausgabe wird am Element das Objekt gesetzt, Zeilenenden entfernt und das neu importierte Element in die Mappe “Sporttabellen” abgelegt.

Verwendung der Tabellen in PRINT NGEN

Mit Hilfe der Mappensuche unter “Öffnen” -> “Mappen” (s. linke Grafik) kann die Mappe “Sporttabellen” (s. rechte Grafik) aufgerufen werden.

Die importierten Sporttabellen sind dort als Artikel-Element (DText) zu finden. Bei der ersten Verwendung muss die Sporttabelle per Drag & Drop auf eine Layout-Artikelvorlage (auf einer Seite oder als direkt erstellter Artikel) platziert werden. 

Diese Vorlage wird nun in PRINT NGEN mit der “DText-Sporttabelle” verknüpft. Dies ist am Artikel-Icon am Element erkennbar.

Auch das Layout der Sporttabelle wird nun im Inhaltsfenster korrekt dargestellt und die Makros werden entsprechend ausgewertet (ohne verknüpfte Vorlage kann die Darstellung abweichen).

Ab jetzt kann die Sporttabelle dann in weiteren Layout-Artikelvorlagen platziert oder direkt auf Seiten gezogen werden. In diesem Fall greift sie auf die zuvor verknüpfte Artikelvorlage zurück.

Setup & Konfiguration

Geschätzer Aufwand zur Einrichtung und Erweiterung der Tabellentypen auf Kund:innenseite:

Setup Modul

Aufwand

Einrichtung Makros und Bibliotheksstruktur für erste Sportart

4-6 PH

Einrichtung weitere Sportarten

1-2 PH

Mitwirkungspflichten der Kund:innen

• Die Kund:innen müssen beispielhafte XMLs der Tabellentypen anliefern sowie Beispiele für das gewünschte Layout.

• Nach der Ersteinrichtung des Imports mit einem ersten Tabellentyp werden die Kund:innen durch PEIQ befähigt, selbst weitere Tabellentypen anzulegen.

Zu folgenden Sportprogrammen gibt es Schnittstellen zu PRINT NGEN:

• KiSaD

• MSU

• LEO

Verwandte Seiten

^{Nur für PEIQ-Mitarbeiter:}

/wiki/spaces/CORE/pages/844660994