X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fdokumentenvorlagen-und-variablen.html;h=4e048dcf0ec7f15eaeb564ea2cb70d44aab1168e;hb=5494f687372570c9d1c5eb5c6aad73767e50820a;hp=d29b73714541e9a0184a27be707068343792d712;hpb=f84763177341da274dd63d6fe8c2f2bf52532c02;p=kivitendo-erp.git diff --git a/doc/dokumentenvorlagen-und-variablen.html b/doc/dokumentenvorlagen-und-variablen.html index d29b73714..4e048dcf0 100644 --- a/doc/dokumentenvorlagen-und-variablen.html +++ b/doc/dokumentenvorlagen-und-variablen.html @@ -112,6 +112,7 @@ td {
  • Angebote und Preisanfragen
  • Auftragsbestätigungen und Lieferantenaufträge
  • Lieferscheine (Verkauf und Einkauf)
  • +
  • Sammelrechnung
  • @@ -119,9 +120,6 @@ td { Blöcke, bedingte Anweisungen und Schleifen
      -
    1. - Der if not-Block
    2. -
    3. Der if-Block
    4. @@ -152,6 +150,15 @@ td { verändern.

      +

      Einige Zahlenwerte werden auch in unformatierter Form zur Verfügung + gestellt (also z.B. 35 statt 35,00 oder 12.3 statt 12,30). Der Dezimaltrenner + ist dabei also immer ein Punkt unabhaengig vom eingestellten Zahlenformat. + Diese Variabelen kann man mit der Erweiterung _nofmt (für no-format) aufrufen + (also z.B. netprice = 12,30 -- netprice_nofmt = 12.3). Variabeln die zusätzlich + unformatiert zur Verfügung stehen sind unten als variable[_nofmt] gelistet. + Die Eckigen Klammern weisen also auf eine optionale Verwändung der Erweiterung hin. +

      +

      Früher wurde hier nur über LaTeX gesprochen. Inzwischen unterstützt Lx-Office aber auch OpenDocument-Vorlagen. Sofern es nicht ausdrücklich eingeschränkt wird, gilt das im @@ -209,7 +216,7 @@ td { äquivalente Beispiel für HTML-Dokumentenvorlagen sieht so aus:

      -

      <!-- config: tag-stye=($ $)>

      +

      <!-- config: tag-style=($ $) -->

      zum Inhaltsverzeichnis
      @@ -243,7 +250,7 @@ td { packing_list.ext - Verpackungsliste + Packliste pick_list.ext @@ -311,7 +318,7 @@ td { bic - Internationaler Bank-Identifikations-Code (BIC) + Bank-Identifikations-Code (Bank Identifier Code, BIC) business @@ -397,6 +404,10 @@ td { homepage Homepage + + iban + Internationale Kontonummer (International Bank Account Number, IBAN) + language Sprache @@ -405,6 +416,10 @@ td { name Firmenname + + payment_description + Name der Zahlart + payment_terms Zahlungskonditionen @@ -476,6 +491,11 @@ td { taxnumber Steuernummer + + ustid + Usatzsteuer-Identifikationsnummer + + vendoremail Email des Lieferanten; nur für Lieferanten @@ -565,7 +585,7 @@ td {

      - Informationen über den Verkäfer (nur bei Verkaufsmasken):

      + Informationen über den Verkäufer (nur bei Verkaufsmasken):

      @@ -677,6 +697,10 @@ td { + + + + @@ -705,6 +729,10 @@ td { + + + + @@ -726,7 +754,7 @@ td { - + @@ -765,11 +793,11 @@ td { - + - + @@ -785,7 +813,7 @@ td { - + @@ -797,15 +825,15 @@ td { - + - + - + @@ -841,7 +869,11 @@ td { - + + + + + @@ -853,13 +885,17 @@ td { - + + + + + @@ -980,6 +1016,10 @@ td { + + + + @@ -1174,6 +1214,10 @@ td {

      globalprojectnumber Projektnummer des ganzen Beleges
      globalprojectdescriptionProjekbeschreibung des ganzen Beleges
      intnotes Interne Bemerkungenordnumber Auftragsnummer, wenn die Rechnung aus einem Auftrag erstellt wurde
      payment_descriptionName der Zahlart
      payment_terms ZahlungskonditionenTransportmittel
      subtotalsubtotal[_nofmt] Zwischensumme aller Posten ohne Steuern
      Artikelbeschreibung
      discountdiscount[_nofmt] Rabatt als Betrag
      discount_subdiscount_sub[_nofmt] Zwischensumme mit Rabatt
      Grafik
      linetotallinetotal[_nofmt] Zeilensumme (Anzahl * Einzelpreis)
      Mikrofilm
      netpricenetprice[_nofmt] Nettopreis
      nodiscount_linetotalnodiscount_linetotal[_nofmt] Zeilensumme ohne Rabatt
      nodiscount_subnodiscount_sub[_nofmt] Zwischensumme ohne Rabatt
      Projektnummer
      qtyprojectdescriptionProjektbeschreibung
      qty[_nofmt] Anzahl
      Position auf der Rechnung (1, 2, 3...)
      sellpricesellprice[_nofmt] Verkaufspreis
      serialnumber Seriennummer
      tax_rateSteuersatz
      transdate_oe Auftragsdatum des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurdedunning_duedate Fälligkeitsdatum für diese Mahhnung
      dunning_idMahnungsnummer
      fee Kummulative Mahngebühren
      + + + + @@ -1185,6 +1229,14 @@ td {
      VariablennameBedeutung
      cusordnumberBestellnummer des Kunden (im Verkauf) bzw. Bestellnummer des Lieferanten (im Einkauf)
      donumber Lieferscheinnummer

      +

      Für jede Position eines Lieferscheines gibt es ein Unterarray mit + den Informationen darüber, von welchem Lager und Lagerplatz aus die + Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen + Lagerplatz sie eingelagert wurden. Diese müssen mittels + einer foreach-Schleife ausgegeben werden. Diese + Variablen sind:

      + +

      Für jede Position eines Lieferscheines gibt es ein Unterarray mit den Informationen darüber, von welchem Lager und Lagerplatz aus die Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen @@ -1203,6 +1255,10 @@ td { si_chargenumber Chargennummer + + si_bestbefore + Mindesthaltbarkeit + si_number Artikelnummer @@ -1226,6 +1282,81 @@ td {

      +

      Sammelrechnung

      + +

      Variablen für Sammelrechnung:

      +

      + + + + + + + + + + + + + + + + + + + + + + +
      VariablennameBedeutung
      c0totalGesamtbetrag aller Rechnungen mit Fälligkeit < 30 Tage
      c30totalGesamtbetrag aller Rechnungen mit Fälligkeit >= 30 und < 60 Tage
      c60totalGesamtbetrag aller Rechnungen mit Fälligkeit >= 60 und < 90 Tage
      c90totalGesamtbetrag aller Rechnungen mit Fälligkeit >= 90 Tage
      totalGesamtbetrag aller Rechnungen
      +

      + +

      Variablen für jede Rechnungsposition in Sammelrechnung:

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      VariablennameBedeutung
      invnumberRechnungsnummer
      invdateRechnungsdatum
      duedateFälligkeitsdatum
      amountSumme der Rechnung
      openNoch offener Betrag der Rechnung
      c0Noch offener Rechnungsbetrag mit Fälligkeit < 30 Tage
      c30Noch offener Rechnungsbetrag mit Fälligkeit >= 30 und < 60 Tage
      c60Noch offener Rechnungsbetrag mit Fälligkeit >= 60 und < 90 Tage
      c90Noch offener Rechnungsbetrag mit Fälligkeit >= 90 Tage
      +

      + + + + zum Inhaltsverzeichnis

      @@ -1233,35 +1364,77 @@ td {

      Blöcke, bedingte Anweisungen und Schleifen

      -

      Der Parser kennt neben den Variablen einige weitere Konstrukte, die - gesondert behandelt werden. Diese sind wie Variablennamen in spezieller - Weise markiert: <%anweisung%>

      - -

      Der if not-Block

      - -

      <%if not variablenname%>
      - ...
      - <%end>

      - -

      Eine normale "if-not-then"-Bedingung. Die Zeilen zwischen dem "if not" und - dem "end" werden nur ausgegeben, wenn die Variable "variablenname" nicht - gesetzt oder gleich 0 ist.

      +

      Der Parser kennt neben den Variablen einige weitere Konstrukte, + die gesondert behandelt werden. Diese sind wie Variablennamen in + spezieller Weise markiert: <%anweisung%> + ... <%end%>

      + +

      Anmerkung zum <%end%>: Der besseren + Verständlichkeit halber kann man nach dem end noch + beliebig weitere Wörter schreiben, um so zu markieren, welche + Anweisung (z.B. if oder foreach) damit + abgeschlossen wird.

      + +

      Beispiel: Lautet der Beginn eines Blockes + z.B. <%if type == + "sales_quotation"%>, so könnte er mit + <%end%> genauso abgeschlossen werden + wie mit + <%end if%> oder auch + <%end type == + "sales_quotation"%>.

      Der if-Block

      <%if variablenname%>
      ...
      - <%end>

      - -

      Eine normale "if-then"-Bedingung. Die Zeilen zwischen dem "if" und dem - "end" werden nur ausgegeben, wenn die Variable "variablenname" gesetzt und - ungleich 0 ist.

      + <%end%>

      + +

      Eine normale "if-then"-Bedingung. Die Zeilen zwischen + dem "if" und dem "end" werden nur ausgegeben, + wenn die Variable "variablenname" gesetzt und ungleich 0 + ist.

      + +

      Die Bedingung kann auch negiert werden, indem das Wort + "not" nach dem "if" verwendet + wird. Beispiel: <%if not + cp_greeting%>

      + +

      Zusätzlich zu dem einfachen Test, ob eine Variable gesetzt ist + oder nicht, bietet dieser Block auch die Möglichkeit, den Inhalt + einer Variablen mit einer festen Zeichenkette oder einer anderen + Variablen zu vergleichen. Ob der Vergleich mit einer Zeichenkette + oder einer anderen Variablen vorgenommen wird, hängt davon ab, ob + die rechte Seite des Vergleichsoperators in Anführungszeichen + gesetzt wird (Vergleich mit Zeichenkette) oder nicht (Vergleich mit + anderer Variablen). Zwei Beispiele, die beide Vergleiche zeigen:

      + +

      <%if var1 == "Wert"%> + testet die Variable "var1" auf Übereinstimmung mit der + Zeichenkette "Wert". Mittels "!=" anstelle von + "==" würde auf Ungleichheit getestet.

      + +

      <%if var1 == var2%> testet die + Variable "var1" auf Übereinstimmung mit der Variablen + "var2". Mittels "!=" anstelle von "==" + würde auf Ungleichheit getestet.

      + +

      Erfahrere Benutzer können neben der Tests auf (Un-)Gleichheit auch + Tests auf Übereinstimmung mit regulären Ausdrücken ohne + Berücksichtung der Groß- und Kleinschreibung durchführen. Dazu dient + dieselbe Syntax wie oben nur mit "=~" und "!~" + als Vergleichsoperatoren.

      + +

      Beispiel für einen Test, ob die Variable "intnotes" + (interne Bemerkungen) das Wort "schwierig" enthält: + <%if intnotes =~ + "schwierig"%>

      Die foreach-Schleife

      <%foreach variablenname%>
      ...
      - <%end>

      + <%end%>

      Fügt die Zeilen zwischen den beiden Anweisungen so oft ein, wie das Perl-Array der Variablen "variablenname" Elemente enthät. Dieses @@ -1279,20 +1452,20 @@ td { Artikelnummer: <%number%>
      Beschreibung: <%description%>
      ...
      - <%end>

      + <%end%>

      Besonderheit in OpenDocument-Vorlagen: Tritt ein - <foreach>-Block innerhalb einer Tabellenzelle + <%foreach%>-Block innerhalb einer Tabellenzelle auf, so wird die komplette Tabellenzeile so oft wiederholt wie notwendig. Tritt er außerhalb auf, so wird nur der Inhalt - zwischen <foreach> und <end> + zwischen <%foreach%> und <%end%> wiederholt, nicht aber die komplette Zeile, in der er steht.

      Der pagebreak-Block

      <%pagebreak ZpZ ZeS ZzS%>
      ...
      - <%end>

      + <%end%>

      Dieser Block existiert nur in LaTeX-Vorlagen.

      @@ -1381,8 +1554,8 @@ td { href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">pagebreak-Block voreingestellten Werte einen Seitenumbruch nach der aktuellen Rechnungsposition. Dementsprechend funktioniert er nur innerhalb von - <foreach...>-Schleifen. Weiterhin benötigt er kein - Endtag.

      + <%foreach...%>-Schleifen. Weiterhin benötigt + er kein Endtag.

      zum Inhaltsverzeichnis