X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fdokumentenvorlagen-und-variablen.html;h=ba8a1d16d07fbc3232a95c7637f8eec58d309f64;hb=e6ffa928b78feb3cf0fa2c38da388144543a76dd;hp=697ef18907c70efafa1d1ddd015610c0d4c12102;hpb=f76e11660bfa01aae805f00300014bcb5d2985b6;p=kivitendo-erp.git diff --git a/doc/dokumentenvorlagen-und-variablen.html b/doc/dokumentenvorlagen-und-variablen.html index 697ef1890..ba8a1d16d 100644 --- a/doc/dokumentenvorlagen-und-variablen.html +++ b/doc/dokumentenvorlagen-und-variablen.html @@ -82,7 +82,7 @@ td {
  • Variablen für die Zahlungseingänge
  • -
  • +
  • Benutzerdefinierte Kunden- und Lieferantenvariablen
  • @@ -106,15 +106,19 @@ td {
  • - Variablen in anderen Vorlagen
  • + Variablen in anderen Vorlagen + +
      +
    1. Angebote und Preisanfragen
    2. +
    3. Auftragsbestätigungen und Lieferantenaufträge
    4. +
    5. Lieferscheine (Verkauf und Einkauf)
    6. +
    +
  • Blöcke, bedingte Anweisungen und Schleifen
      -
    1. - Der if not-Block
    2. -
    3. Der if-Block
    4. @@ -216,17 +220,66 @@ td { geeignet zu ersetzen: ".tex" fü LaTeX-Vorlagen und ".odt" für OpenDocument-Vorlagen.

      - +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      DateinameBedeutung
      bin_list.extLagerliste
      check.ext?
      invoice.extRechnung
      packing_list.extPackliste
      pick_list.extSammelliste
      purchase_delivery_order.extLieferschein (Einkauf)
      purcharse_order.extBestellung an Lieferanten
      request_quotation.extAnfrage an Lieferanten
      sales_delivery_order.extLieferschein (Verkauf)
      sales_order.extBestellung
      sales_quotation.extAngebot an Kunden
      zahlungserinnerung.extMahnung (Dateiname im Programm konfigurierbar)
      zahlungserinnerung_invoice.extRechnung über Mahngebühren (Dateiname im Programm konfigurierbar)
      +

      zum Inhaltsverzeichnis
      @@ -253,6 +306,10 @@ td { bank_code Bankleitzahl + + bic + Bank-Identifikations-Code (Bank Identifier Code, BIC) + business Kunden-/Lieferantentyp @@ -337,6 +394,10 @@ td { homepage Homepage + + iban + Internationale Kontonummer (International Bank Account Number, IBAN) + language Sprache @@ -505,7 +566,7 @@ td {

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

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

      @@ -617,6 +678,10 @@ td { + + + + @@ -696,10 +761,6 @@ td {

      globalprojectnumber Projektnummer des ganzen Beleges
      globalprojectdescriptionProjekbeschreibung des ganzen Beleges
      intnotes Interne Bemerkungen
      - - - - @@ -712,14 +773,46 @@ td { + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -752,6 +845,10 @@ td { + + + + @@ -780,6 +877,30 @@ td { + + + + +
      VariablennameBedeutung
      assemblyErzeugnis
      bin Stellagediscount Rabatt als Betrag
      discount_subZwischensumme mit Rabatt
      drawingZeichnung
      eanEAN-Code
      imageGrafik
      linetotal Zeilensumme (Anzahl * Einzelpreis)
      longdescriptionLangtext
      microficheMikrofilm
      netprice Nettopreis
      nodiscount_linetotalZeilensumme ohne Rabatt
      nodiscount_subZwischensumme ohne Rabatt
      number Artikelnummerprojectnumber Projektnummer
      projectdescriptionProjektbeschreibung
      qty Anzahlunit Einheit
      weightGewicht
      +

      + +

      Für jeden Posten gibt es ein Unterarray mit den Informationen über + Lieferanten und Lieferantenartikelnummer. Diese müssen mit + einer foreach-Schleife ausgegeben werden, da für jeden + Artikel mehrere Lieferanteninformationen hinterlegt sein können. Die + Variablen dafür lauten:

      + +

      + + + + + + + + + +
      VariablennameBedeutung
      makeLieferant
      modelLieferantenartikelnummer

      @@ -812,7 +933,7 @@ td {

      -

      +

      Benutzerdefinierte Kunden- und Lieferantenvariablen:

      @@ -868,6 +989,10 @@ td { dunning_duedate Fälligkeitsdatum für diese Mahhnung + + dunning_id + Mahnungsnummer + fee Kummulative Mahngebühren @@ -1014,6 +1139,114 @@ td { Variablen, die vom Geschäftsablauf her in der entsprechenden Vorlage keine Bedeutung haben oder noch nicht belegt sein können.

      +

      Im Folgenden werden nur wichtige Unterschiede zu den Variablen in + Rechnungen aufgeführt.

      + +

      Angebote und Preisanfragen

      + +

      + + + + + + + + + + + + + + +
      VariablennameBedeutung
      quonumberAngebots- bzw. Anfragenummer
      reqdateGültigkeitsdatum (bei Angeboten) bzw. Lieferdatum (bei Preisanfragen)
      transdateAngebots- bzw. Anfragedatum
      +

      + +

      Auftragsbestätigungen und Lieferantenaufträge

      + +

      + + + + + + + + + + + + + + +
      VariablennameBedeutung
      ordnumberAuftragsnummer
      reqdateLieferdatum
      transdateAuftragsdatum
      +

      + +

      Lieferscheine (Verkauf und Einkauf)

      + +

      + + + + + + + + + + + + + + +
      VariablennameBedeutung
      cusordnumberBestellnummer des Kunden (im Verkauf) bzw. Bestellnummer des Lieferanten (im Einkauf)
      donumberLieferscheinnummer
      transdateLieferscheindatum
      +

      + +

      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:

      + +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      VariablennameBedeutung
      si_binLagerplatz
      si_chargenumberChargennummer
      si_bestbeforeMindesthaltbarkeit
      si_numberArtikelnummer
      si_qtyAnzahl bzw. Menge
      si_runningnumberPositionsnummer (1, 2, 3 etc)
      si_unitEinheit
      si_warehouseLager
      +

      + zum Inhaltsverzeichnis

      @@ -1021,35 +1254,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 @@ -1067,20 +1342,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.

      @@ -1169,8 +1444,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