Variablen im Code Editor

Grundlagen

Wo kann ich Variablen nutzen?

Variablen kannst du in folgenden Bereichen einsetzen:

• Auf der Titelseite
• In Kapiteln
• In Preispositionen
• Im Steuerhinweis
• Im Auftragsformular

Wie funktioniert es?

Zum Beispiel fügt der folgende Code den Titel des Angebots ein, wie du ihn in Grip hinterlegt hast:

Unsere Mission: {{ proposal.title }}

Dabei werden die geschweiften Klammern samt Inhalt durch den in Grip hinterlegten Wert ersetzt.

Wenn Du dem Angebot den Titel “Erhöhen Sie Ihren Umsatz mit einer modernen Website” (1) gegeben hast, wird auf der Titelseite folgendes ausgegeben:

Unsere Mission: Erhöhen Sie Ihren Umsatz mit einer modernen Website

Im folgenden erklären wir, welche Variablen in Grip zur Verfügung stehen und was diese bedeuten.

Daten des Angebots

Angebotsdatum

proposal.date | long_date
Hier wird das Datum mit Hilfe des Filters long_date in das Datumsformat TT. Monat JJJJ (13. April 2016) gebracht.

Logische Prüfung: optionale Preispositionen enthalten?

proposal.has_optional_fees?
Wahr, wenn das Angebot mindestens eine optionale Preisposition enthält.

Optionale Preispositionen ausgeben

proposal.optional_fees
Alle optionalen Preispositionen zur weiteren Verarbeitung in einer for-Schleife. (Siehe Abschnitt Preisposition)

Logische Prüfung: Briefkopf auf der Titelseite ausgeben?

proposal.show_letterhead?
Wahr, wenn die Option 'Briefkopf anzeigen' im Reiter Layout aktiv ist.

Titel des Angebots

proposal.title

Angebotsnummer

proposal.number

Externe Referenz-Nummer (bspw. für Anfrage-/PO-Nummer)

proposal.external_reference

Daten des Autors

E-Mail-Adresse des Autors

proposal.author.email

Name des Autors

proposal.author.name

Vorname des Autors

proposal.author.firstname

Nachname des Autors

proposal.author.lastname

Daten deiner Firma

Ort

proposal.account.city

Postleitzahl und Ort

proposal.account.city_with_zip
Postleitzahl und Ort in der landesspezifischen Form, z.B. 80333 München oder London, W11 2BQ.

E-Mail-Adresse der Firma

proposal.account.email

Faxnummer

proposal.account.fax

Logische Prüfung: Logo vorhanden?

proposal.account.logo?
Wahr, wenn in den Konto-Einstellungen des Grip-Kontos ein Logo hinterlegt wurde.

Firmenname

proposal.account.name

Land

proposal.account.nation

Telefonnummer

proposal.account.phone

Straße

proposal.account.street

URL der Website

proposal.account.website
Beispiel: https://getgrip.de

Website

proposal.account.website_without_protocol
Die Anzeige erfolgt ohne http:// oder https:// zum Beispiel: getgrip.de

Daten des Empfängers

Firmenname

proposal.client.organization

Kundennummer der Firma

proposal.client.customer_number

Name des Kunden inkl. Titel

proposal.client.name
Beispiel: Prof. Dr. Claudia Bachmann

Titel und Nachname des Kunden

proposal.client.full_lastname
Beispiel: Prof. Dr. Bachmann

Vorname des Kunden

proposal.client.firstname

Nachname des Kunden

proposal.client.lastname

Titel des Kunden

proposal.client.prefix

Jobtitel / Berufsbezeichnung des Kunden

proposal.client.job_title

Straße

proposal.client.street

Postleitzahl

proposal.client.zip

Ort

proposal.client.city

Postleitzahl und Ort

proposal.client.city_with_zip
Postleitzahl und Ort in der landesspezifischen Form, z.B. 80333 München oder London, W11 2BQ.

Land

proposal.client.nation

E-Mail-Adresse

proposal.client.email

Telefon

proposal.client.phone

Preispositionen

Im Auftragsformular werden die optionalen Preispositionen eines Angebots ausgegeben. Dafür ist eine for-Schleife notwendig:

{% for fee in proposal.optional_fees %}
  {{ fee.headline  }}
{% endfor %}

Zusätzlich kann geprüft werden, ob das Angebot optionale Positionen enthält:

{% if proposal.has_optional_fees? %}
  ... Überschrift ...
{% endif %}

Das ist nützlich, um z.B. eine Überschrift nur dann anzuzeigen, wenn auch optionale Positionen vorhanden sind.

Folgende Informationen können aus der Preisposition verwendet werden:

Überschrift der Preisposition

fee.headline

Preis als Betrag oder, falls angegeben, Text um den Betrag zu verbergen. Kann auch ein leerer Text sein.

fee.public_amount

Die dem Preis zu Grunde liegende Einheit, z.B. pro Monat. Kann leer sein.

fee.unit

Gesamtpreis

Du kannst auf die Gesamtbeträge der einmaligen, monatlichen, quartalsweisen und jährlichen Leistungen zugreifen.

Der Gesamtbetrag steht entweder als Geldbetrag inkl. Währung (z.B. “2.480,00 €”) oder als reine Zahl (z.B. 2480.0) ausgegeben werden. Letztere haben eine Bezeichnung, die auf _number endet.

Der Gesamtbetrag als Zahl eignet sich für logische Prüfungen oder Berechnungen:

{% if proposal.monthly_total_number > 0 %}
  Ihre monatlichen Kosten belaufen sich auf {{ proposal.monthly_total  }}
{% endif %}

Folgenden Variablen kannst du verwenden:

Gesamtbetrag einmalig mit Währung im Format der Angebotssprache

proposal.onetime_total

Gesamtbetrag einmalig als Zahl zur Weiterverarbeitung

proposal.onetime_total_number

Gesamtbetrag monatlich mit Währung im Format der Angebotssprache

proposal.monthly_total

Gesamtbetrag monatlich als Zahl zur Weiterverarbeitung

proposal.monthly_total_number

Gesamtbetrag quartalsweise mit Währung im Format der Angebotssprache

proposal.quarterly_total

Gesamtbetrag quartalsweise als Zahl zur Weiterverarbeitung

proposal.quarterly_total_number

Gesamtbetrag jährlich mit Währung im Format der Angebotssprache

proposal.yearly_total

Gesamtbetrag jährlich als Zahl zur Weiterverarbeitung

proposal.yearly_total_number

Logo

Logo einfügen

logo
Generiert den HTML Code zur Einbindung des Logos aus den Konto-Einstellungen

Unterschiede zu den anderen ##variablen##

Mit beiden Arten von Variablen lassen sich die wichtigsten Angaben eines Angebots einfügen. Es gibt jedoch einige Unterschiede im Detail.

Die klassischen Rauten-Variablen in Grip-Angeboten bestehen aus deutschen Wörtern wie bspw. ##kundenname##. Dadurch sind sie im Text vielleicht etwas angenehmer zu lesen. Sie ermöglichen außerdem eine typische Brief-Anrede wie z.B. “Sehr geehrte Frau Meier”. Außerdem wird die korrekte Verwendung von Rauten-Variablen überwacht. Wenn beispielsweise ##meinetelefonnr## eingefügt werden soll, diese aber nicht im Konto gespeichert ist, zeigt Grip eine Warnung an.

Auf der anderen Seite bieten Liquid-Variablen wie {{ proposal.date }} etwas mehr Möglichkeiten in Sachen Programmierung. Sie können mit Hilfe der Liquid-Syntax manipuliert und ausgewertet werden. So lässt sich ein Datum in ein anderes Datumsformat umwandeln, man kann mit Zahlen rechnen, Texte anreichern usw. Außerdem bietet Liquid logische Funktionen an, wie Verzeigung und Iteration. Mehr zur Verwendung von Liquid findest du auf liquidmarkup.org.”