HTML - Vorlagen: Unterschied zwischen den Versionen

Aus OrgaMon Wiki
Zur Navigation springen Zur Suche springen
 
(12 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 11: Zeile 11:


* Belege steuern durch das Feld BSTATUS und VORLAGE_PREFIX den Dateinamen der Vorlage, die geladen wird  
* Belege steuern durch das Feld BSTATUS und VORLAGE_PREFIX den Dateinamen der Vorlage, die geladen wird  
* Alle Vorlagen- Dateien werden aus dem OrgaMon-Verzeichnis <code>.\HTML Vorlagen\</code> geladen


=== BSTATUS ===
=== BSTATUS ===
Zeile 159: Zeile 160:
Bei mehrseitigen Dokumenten muss man 4 Typen von Seiten vorbereiten (Für jeden Typ einen BLOCK):  
Bei mehrseitigen Dokumenten muss man 4 Typen von Seiten vorbereiten (Für jeden Typ einen BLOCK):  


* PAGE_SINGLE: Die "erste" Seite für den Fall, dass alles auf einer Seite Platz hat
* PAGE_SINGLE: Die einzige Seite für den Fall, dass alles auf einer Seite Platz hat
* PAGE_FIRST: Die "erste" Seite für den Fall, dass ein mehrseitiges Dokument ensteht
* PAGE_FIRST: Die erste Seite für den Fall, dass ein mehrseitiges Dokument ensteht
* PAGE_NEXT: Bei mehrseitigen Dokumenten, ist es die Seite 2 ff
* PAGE_NEXT: Bei mehrseitigen Dokumenten, ist es die Seite 2 ff
* PAGE_LAST: Bei zumindest 2 seitigen Dokumenten ist es die letzte Seite
* PAGE_LAST: Bei zumindest 2 seitigen Dokumenten ist es die letzte Seite
Zeile 297: Zeile 298:


* Werte aus einer externen Datenquelle auflösen
* Werte aus einer externen Datenquelle auflösen
=== Blocks ===
==== BEGIN ====
==== END ====
==== INSERT ====


== Sofort-Druck ==
== Sofort-Druck ==
Zeile 312: Zeile 307:
window.print();
window.print();
</script>
</script>
== Beispiel ==
=== Rechnung in HTML 5 ===
* In diesem Beispiel wurde die Rechnungsvorlage auf 8 Einzeldateien aufgeteilt
* Dies ermöglicht die Wiederverwendung von z.B. "Anschrift" + "design" in anderen Belegen (Mahnung, Lieferschein, usw.)
[https://github.com/Andreas-Filsinger/OrgaMon/blob/main/OrgaMon/Distribution/HTML%20Vorlagen/Rechnung.html Rechnung.html]
  [https://github.com/Andreas-Filsinger/OrgaMon/blob/main/OrgaMon/Distribution/HTML%20Vorlagen/design.html design.html]
  [https://github.com/Andreas-Filsinger/OrgaMon/blob/main/OrgaMon/Distribution/HTML%20Vorlagen/Anschrift.html Anschrift.html]
  [https://github.com/Andreas-Filsinger/OrgaMon/blob/main/OrgaMon/Distribution/HTML%20Vorlagen/header.html header.html]
  [https://github.com/Andreas-Filsinger/OrgaMon/blob/main/OrgaMon/Distribution/HTML%20Vorlagen/Position.html Position.html]
  [https://github.com/Andreas-Filsinger/OrgaMon/blob/main/OrgaMon/Distribution/HTML%20Vorlagen/Rechnung.html.footer.html Rechnung.html.footer.html]
  [https://github.com/Andreas-Filsinger/OrgaMon/blob/main/OrgaMon/Distribution/HTML%20Vorlagen/Rechnung.html.table.html Rechnung.html.table.html]
  [https://github.com/Andreas-Filsinger/OrgaMon/blob/main/OrgaMon/Distribution/HTML%20Vorlagen/Rechnung.html.tablesumme.html Rechnung.html.tablesumme.html]

Aktuelle Version vom 28. Oktober 2023, 14:54 Uhr

  • Alle Dokumente, die der OrgaMon erzeugt sind .html Dateien
  • Diese werden nicht aus eigener Kraft erstellt, sondern grundsätzlich anhand einer .html Vorlage-Datei "ausbelichtet" (HTMLVorlage)
  • Dabei wird die Vorlage aus dem Verzeichnis ".\HTML Vorlagen\" geladen und alle ~Platzhalter~ durch einen echten Inhalt ersetzt
  • Für die Änderung der Vorlagen empfiehlt sich notepad++
    • Damit können Sie einen rechten Mausklick auf die .html Vorlage machen und "Beabeiten mit notepad++" auswählen
  • Die Vorlage kann aus mehreren Dateien kombiniert werden (Includes), do dass nicht für jede Vorlage immer wieder der Anschrift- Bereich identisch kopiert werden muss
  • Das fertige .html ist aber immer eine Datei, Bilder und Logos sollten immer eine Referenz ins Internet haben, so dass das Dokument auch ausserhalb der Firma funktioniert
  • Verwenden Sie UTF-8 als Zeichenkodierung

Name der Vorlage-Datei

  • Belege steuern durch das Feld BSTATUS und VORLAGE_PREFIX den Dateinamen der Vorlage, die geladen wird
  • Alle Vorlagen- Dateien werden aus dem OrgaMon-Verzeichnis .\HTML Vorlagen\ geladen

BSTATUS

BSTATUS     HTML-Vorlage
A           Angebot.html
G           Garantie.html
Z           Zeitabrechnung.html
ansonsten   Rechnung.html
 
  • Ist "als Lieferschein" angekreuzt heisst die Vorlage Lieferschein.html

VORLAGE_PREFIX

  • Vor den jeweiligen Dateinamen wird noch der VORLAGE_PREFIX gesetzt
  • Besonders bei Verträgen kann im Vorlage-Beleg der Vorlage-Prefix geschickt gesteuert werden um auf der Rechnung das richtig Outfit festzulegen.
  • Man beachte dass allein durch Wahl einer Motivation (bei der Belegneuanlage) auch der Vorlage-Prefix bestimmt werden kann!
    • In der MOTIVATION kann eingeschlossen in eckigen Klammern der Vorlage-Prefix vorbereitet werden (z.B. "USA Besteller [US-]")

BEGIN Blockname

Ein Text-Block ermöglicht es mehrzeilige Tabellen auszugeben. Dabei ist eine Datenzeile in der Ausgabe immer ein gefüllter Block der Vorlage. In der Vorlage markiert man einen Abschnitt als Block:

<!-- BEGIN ARTIKEL -->

Beim Laden der Vorlage wird dieser Block zunächst entfernt. "Braucht" die Ausbelichtung diesen Block wird er an einer INSERT Blockname-Marke eingefügt und ausbelichtet. Gibt es z.B. 3 Zeilen in einer Datenbank-Tabelle, so wird der Block 3 mal hintereinander mit unterschiedlichen Daten ausgegeben. Das Ende eines Blocks wird mit

<!-- END ARTIKEL -->

markiert. Beispiel.

<!-- BEGIN ARTIKEL EVEN -->
   <tr>
    <td align=center height=10 bgcolor="#E8F4F8"><font face="Verdana" size=-1>~ArtNo~</td>
    <td height=10 bgcolor="#E8F4F8"><font face="Verdana" size=-3>~AusgabeArt~~ArtTxt~</font></td>
    <td align=right height=10 bgcolor="#E8F4F8"><font face="Verdana" size=-1>~Menge~ </font></td>
    <td align=right height=10 bgcolor="#E8F4F8"><font face="Verdana" size=-1>~Wert~ </font></td>
    <td align=right height=10 bgcolor="#E8F4F8"><font face="Verdana" size=-1>~Percent~ </font></td>
    <td align=right height=10 bgcolor="#E8F4F8"><font face="Verdana" size=-1>~Anteil~ </font></td>
   </tr>
<!-- END ARTIKEL EVEN -->
<!-- BEGIN ARTIKEL ODD -->
   <tr>
    <td align=center height=10 bgcolor="#E0E0E0"><font face="Verdana" size=-1>~ArtNo~</font></td>
    <td height=10 bgcolor="#E0E0E0"><font face="Verdana" size=-3>~AusgabeArt~~ArtTxt~</font></td>
    <td align=right height=10 bgcolor="#E0E0E0"><font face="Verdana" size=-1>~Menge~ </font></td>
    <td align=right height=10 bgcolor="#E0E0E0"><font face="Verdana" size=-1>~Wert~ </font></td>
    <td align=right height=10 bgcolor="#E0E0E0"><font face="Verdana" size=-1>~Percent~ </font></td>
    <td align=right height=10 bgcolor="#E0E0E0"><font face="Verdana" size=-1>~Anteil~ </font></td>
   </tr>
<!-- END ARTIKEL ODD -->
<!-- INSERT ARTIKEL -->

SET MAXLINES

 <!-- SET MAXLINES -->

SET NUMBER OF COPIES

 <!-- SET NUMBER OF COPIES -->

COMPUTE

 <!-- COMPUTE -->

LET

 <!-- LET -->

ANSI

 <!-- ANSI -->

OHNE ROHDATEN

 <!-- OHNE ROHDATEN -->

SORT

 <!-- SORT -->

START DER ROHDATEN

 <!-- START DER ROHDATEN -->

START DER INCLUDES

 <!-- START DER INCLUDES -->

START DER MELDUNGEN

 <!-- START DER MELDUNGEN -->

Variable

Je nach Context stellt der OrgaMon verschiedenen Variable zur Verfügung, die im Template verwendet werden können. Im Rahmen der Belichtung werden die Variable ersetzt, und es erscheinen anstelle des Variablennamen echte Inhalte. Es gibt vordefinierte Variablen Listen, die bei den meisten Dokumenten verfübgar sind.

Basis

~Datum~    heutiges Datum

Artikel

~Artikel~                TITEL
~No~                     NUMERO
~Komponist~              e_r_MusikerName(KOMPONIST_R)
~KomponistNachname~      e_r_MusikerNurNachName(KOMPONIST_R)
~Arrangeur~              e_r_MusikerName(ARRANGEUR_R)
~ArrangeurNachname~      e_r_MusikerNurNachName(ARRANGEUR_R)
~Verlag~                 e_r_Verlag(VERLAG_R)
~VerlagNo~               VERLAGNO
~Konto~                  b_r_Konto(SORTIMENT_R)
~Lager~                  e_r_LagerPlatzNameFromLAGER_R(LAGER_R)
~GEMA_WN~                GEMA_WN

Personen

~K#~                  NUMMER
~H#~                  HAUPT_NUMMER
~KontoAR~             KONTO_AR
~KontoER~             KONTO_ER
~Anrede~              ANREDE
~Ansprache~           ANSPRACHE
~Vorname~             VORNAME
~Nachname~            NACHNAME
~Name~                VORNAME ' ' NACHNAME
~Fax~                 PERSON
~Telefon~             e_r_telefon(RID)
~Handy~               HANDY
~eMail~               USER_ID
~Versicherungsnummer~ VERSICHERUNGSNUMMER
~Adressat1~           e_r_Adressat(RID)[0]
~Adressat2~           e_r_Adressat(RID)[1]
~Adressat3~           e_r_Adressat(RID)[2]
~Adressat4~           e_r_Adressat(RID)[3]
~Name1~               NAME1
~Name2~               NAME2
~Strasse~             STRASSE
~Ort~                 e_r_Ort(PRIV_ANSCHRIFT_R)

Formatierungen mit "!"

  • Feldinhalte lassen sich noch in ihrem Format verändern, also ~B2~!
  • siehe hier

Mehrseitigkeit

Bei mehrseitigen Dokumenten muss man 4 Typen von Seiten vorbereiten (Für jeden Typ einen BLOCK):

  • PAGE_SINGLE: Die einzige Seite für den Fall, dass alles auf einer Seite Platz hat
  • PAGE_FIRST: Die erste Seite für den Fall, dass ein mehrseitiges Dokument ensteht
  • PAGE_NEXT: Bei mehrseitigen Dokumenten, ist es die Seite 2 ff
  • PAGE_LAST: Bei zumindest 2 seitigen Dokumenten ist es die letzte Seite

Includes

  • Rechnung, Mahnung, Bestellung - sie alle teilen sich oft identische Vorlagen-Anteile, diese können zentral in einer eigenen Datei abgelegt werden, und von den "grossen" Vorlagen einbezogen werden. An die Stelle des Befehles <!-- INCLUDE datei.html --> wird die komplette Datei "datei.html" eingelesen und an diesem Platz eingefügt.
  • Wird "INCLUDE datei.html" z.B. inerhalb der Vorlage Rechnung.html verwendet, so wird zunächst
    • im ersten Rang die Datei Rechnung.html.datei.html gesucht, wird sie nicht gefunden so wird
    • im zweiten Rang die Datei datei.html gesucht
<!-- BEGIN PAGE_SINGLE -->
<!-- SET MAXLINES 28 PunkteText,Text,MW -->
  <br>
  <table width=100% border=0 cellspacing=0 cellpadding=0>
   <tr>
    <td width=5%> </td>
    <td width=95%>
    <font face="Verdana" size=3><b>OrgaMon-App Projektentwicklung Umlagebeleg ~R#~</b><br>
    <br>
<!-- INCLUDE header.html -->
<!-- INCLUDE tablesumme.html -->
<!-- INCLUDE footer.html -->
    </td>
   </tr>
  </table>
<!-- END PAGE_SINGLE -->

Mehrseitige Vorlage

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<HEAD>
<title></title>
<META HTTP-EQUIV="Pragma" content="no-cache">
<META HTTP-EQUIV="Cache-Control" content="no-cache, must-revalidate">
<META HTTP-EQUIV="Expires" content="0">
<STYLE TYPE="text/css">
<!--
P.breakhere {page-break-before: always}
-->
</STYLE>
</HEAD>
<body bgcolor="#ffffff" text="#000000" link="#cc0000" vlink="#999999" alink="#ffcc00">

<!-- BEGIN PAGE_SINGLE -->
<!-- SET MAXLINES 16 ArtTxt -->
<br>
<br>
<br>...
<!-- END PAGE_SINGLE -->

<!-- BEGIN PAGE_FIRST -->
<!-- SET MAXLINES 18 ArtTxt -->
<P class="breakhere"></P>
<!-- END PAGE_FIRST -->

<!-- BEGIN PAGE_NEXT -->
<!-- SET MAXLINES 29 ArtTxt,!MW -->
<P class="breakhere"></P>
<!-- END PAGE_NEXT -->

<!-- BEGIN PAGE_LAST -->
<!-- SET MAXLINES 18 ArtTxt,MW -->
<!-- END PAGE_LAST -->
<!-- INSERT PAGE -->
</body>
</html>

MAXLINES

  • Mit MAXLINES legt man fest wieviele "Consumer" auf eine Seite passen
  • Consumer sind ~Platzhalter~, die im Falle einer Ausbelichtung Platz benötigen
  • "!" sind Nicht-Consumer, die nicht auf eine Seite ausbelichtet werden dürfen
<!-- SET MAXLINES 100 PunkteText,Text,MW -->

Implementierung

 // konstante Daten, die auf jeder Seite gleich sind
 DatenSammlerGlobal: TStringList; //
 // lokale Block-Daten, die wechseln
 DatenSammlerLokal: TStringList; //

Kommandos

local

pagebreak

  • Erzeugt einen Seitenumbruch

save&delete

  • sucht und speichert einen Block intern
  • löscht den Block aus der Vorlage
  • der Block wird später in der Regel mit load an einer definierten insert Stelle in der Vorlage geladen

set

  • setzt eine Systemvariable auf den angegebenen Wert
set Anlagenverzeichnis J:\Fotos\stadtwerke\
set Kontext 2882317
set Referenz 95437997
set Z#$E4hlwerkeAusbauIst 1
set Z#$E4hlwerkeEinbauIst 1
set Referenzquelle J:\xml\Referenz.xml

load FROMBLOCK[{|OTHERBLOCK}][,ASBLOCK]

  • Lädt den definierten BLOCK "FROMBLOCK" und fügt ihn an der Insert-Position bei "ASBLOCK" ein.
  • Ist "ASBLOCK" nicht definiert, so wird der Block an der Insert-Position "FROMBLOCK" eingefügt.
  • Ist "FROMBLOCK" undefiniert wird der Block Namens "ASBLOCK" benutzt, so kann man speziell benannte optionale Blocks definieren, der load gelingt aber dennoch sollte der spezielle Block nicht vorhanden sein
  • ein oder mehrere OTHERBLOCK können zusätzlich angegeben werden
    • von links nach rechts wird dann geprüft, ob es der angegebenen Block existiert und auch Inhalt hat, ist das so, wird er benutzt
    • existiert keiner, so wird ASBLOCK benutzt

write

  • wie load, löscht jedoch die insert Marke

save

  • Block suchen und intern abspeichern

clear

  • Block aus der Vorlage löschen

delete

  • wie clear, jedoch Fehlertolerant, den Block muss es nicht unbedingt geben

dereference

  • Werte aus einer externen Datenquelle auflösen

Sofort-Druck

Automatisches Ansteuern des Druckvorganges


<script language="javascript"> window.print(); </script>

Beispiel

Rechnung in HTML 5

  • In diesem Beispiel wurde die Rechnungsvorlage auf 8 Einzeldateien aufgeteilt
  • Dies ermöglicht die Wiederverwendung von z.B. "Anschrift" + "design" in anderen Belegen (Mahnung, Lieferschein, usw.)
Rechnung.html
  design.html
  Anschrift.html
  header.html
  Position.html
  Rechnung.html.footer.html
  Rechnung.html.table.html
  Rechnung.html.tablesumme.html