Vorlagenverwaltung ​

Um Vorlagen in unserer Software zu erstellen, zu verwalten und zu aktualisieren, lesen Sie bitte diese Anleitung. Vorlagen sind essentiell für die Erstellung verschiedener Kommunikationsarten wie E-Mails, SMS, Druckdokumente und Reparaturberichte. Diese Dokumentation behandelt die verfügbaren Vorlagentypen, die Verwendung von Variablen in Ihren Vorlagen und die Nutzung der Liquid-Templating-Sprache.

Vorlagentypen ​

Unser System unterstützt fünf Vorlagentypen:

1. Mail: HTML-Format für E-Mail-Kommunikation.
2. Print: HTML-Format für druckbare Dokumente.
3. Text: Einfaches Textformat für Klartext-Kommunikation.
4. SMS: Einfaches Textformat für SMS-Nachrichten.
5. Repair Report: HTML-Format für detaillierte Reparaturberichte.

Erstellung und Verwaltung von Vorlagen ​

Erstellen einer neuen Vorlage ​

Navigieren Sie zum Abschnitt Vorlagen in Ihrem Dashboard. 2. Klicken Sie auf Das Grüne + um eine neue Vorlage zu erstellen. 3. Füllen Sie die Vorlagendetails aus:

• Name: Der eindeutige Name der Vorlage.
• Typ: Wählen Sie den Vorlagentyp (Mail, Print, Text, SMS, Repair Report).
• Inhalt: Geben Sie den Inhalt der Vorlage ein. Verwenden Sie HTML für Mail, Print und Repair Report Vorlagen, und einfachen Text für Text und SMS Vorlagen.

4. Fügen Sie bei Bedarf Tags hinzu, um Ihre Vorlage zu kategorisieren.
5. Klicken Sie auf Speichern, um die Vorlage zu erstellen.

Bearbeiten einer vorhandenen Vorlage ​

1. Navigieren Sie zum Abschnitt Vorlagen in Ihrem Dashboard.
2. Wählen Sie die Vorlage, die Sie bearbeiten möchten.
3. Aktualisieren Sie die Vorlagendetails nach Bedarf.
4. Klicken Sie auf Speichern, um Ihre Änderungen anzuwenden.

Duplizieren einer Vorlage ​

Um eine vorhandene Vorlage zu duplizieren:

1. Navigieren Sie zum Abschnitt Vorlagen in Ihrem Dashboard.
2. Wählen Sie die Vorlage, die Sie duplizieren möchten.
3. Klicken Sie auf die Aktionen und dann Duplizieren- .
4. Die duplizierte Vorlage erscheint mit "kopiert" im Namen. Passen Sie sie nach Bedarf an und klicken Sie auf Speichern.

Verwendung von Variablen in Vorlagen ​

Sie können Variablen verwenden, um den Inhalt Ihrer Vorlagen zu personalisieren. Hier sind die verfügbaren Variablen:

{
  "customer": {
    "id": 15,
    "uuid": "han_a47bc1d3",
    "sequence_id": "29",
    "salutation": "Herr",
    "first_name": "Alex",
    "last_name": "Johnson",
    "name": "Alex Johnson",
    "company_name": "FixIt",
    "email": "alex.johnson@gmail.com",
    "phone_number": "0301234567",
    "mobile_number": "017612345678",
    "address": {
      "street_address": "123 Main Street",
      "post_code": "12345",
      "city": "Berlin",
      "country": "DE"
    }
  },
  "merchant": {
    "id": 845,
    "uuid": "han_5b1e9a6f",
    "logo_url": "/path/tologo",
    "salutation": "Frau",
    "first_name": "Emily",
    "last_name": "Smith",
    "name": "Emily Smith",
    "company_name": "Tech Solutions GmbH",
    "email": "service@techsolutions.de",
    "phone_number": "+494512345678",
    "address": {
      "street_address": "456 Another St",
      "post_code": "54321",
      "city": "Hamburg",
      "country": "DE"
    },
    "web_page": "https://www.a-techsolutions.de",
    "bank_name": "Deutsche Bank",
    "iban": "DE68 1234 5678 1112 1122 33",
    "tax_number": "DE987654321",
    "court_in_charge": "Amtsgericht Hamburg",
    "hrb_number": "HRB 123456",
    "ceo_name": "Emily Smith"
  },
  "issue": {
    "id": 54231,
    "uuid": "rep_54231",
    "sequence_id": "8456",
    "created_at": "2024-08-08T13:17:11.433Z",
    "owner_name": "admin_user",
    "has_rabatt": true,
    "total_with_rabatt": 50.0,
    "rabatt": 10.0,
    "tax": "19.0",
    "customer": {
      "id": 15,
      "uuid": "han_a47bc1d3",
      "sequence_id": "29",
      "salutation": "Herr",
      "first_name": "Alex",
      "last_name": "Johnson",
      "name": "Alex Johnson",
      "company_name": "FixIt",
      "email": "alex.johnson@gmail.com",
      "phone_number": "0301234567",
      "mobile_number": "017612345678",
      "address": {
        "street_address": "123 Main Street",
        "post_code": "12345",
        "city": "Berlin",
        "country": "DE"
      }
    },
    "issue_entries": [],
    "device": "Samsung Galaxy S10",
    "device_received": true,
    "device_repaired": false,
    "request_approved": true,
    "repair_report_content": "Battery replaced and software updated",
    "scheduled_repair_at": "2024-08-10T09:00:00Z"
  },
  "device": {
    "name": "Samsung Galaxy S10",
    "imei": "359845123654789",
    "serial_number": "SN123456789",
    "device_manufacturer_name": "Samsung",
    "device_model_name": "Galaxy S10",
    "device_color_name": "Prism White"
  }
}

Beispiel für die Verwendung ​

Um diese Variablen in Ihrer Vorlage zu verwenden, schließen Sie sie in doppelte geschweifte Klammern ein. Zum Beispiel:

• Kundenname:

  {{ customer.first_name }} {{ customer.last_name }}

• Händlerlogo:

  <img src="{{ merchant.logo }}" alt="Merchant Logo">

Verwendung der Liquid-Templating-Sprache ​

Liquid ist eine leistungsstarke Templating-Sprache, die zur dynamischen Generierung von Inhalten verwendet wird. Hier sind einige grundlegende Elemente von Liquid:

Ausgabe ​

Um den Wert einer Variablen anzuzeigen, verwenden Sie doppelte geschweifte Klammern:

{{ customer.first_name }}

Filter ​

Filter ändern die Ausgabe einer Variablen. Zum Beispiel, um einen Namen zu kapitalisieren:

{{ customer.first_name | capitalize }}

Bedingungen ​

Verwenden Sie Bedingungen, um Inhalte basierend auf einer Bedingung anzuzeigen:

{% if customer.company_name %}
  Firma: {{ customer.company_name }}
{% else %}
  Name: {{ customer.first_name }} {{ customer.last_name }}
{% endif %}

Schleifen ​

Verwenden Sie Schleifen, um über eine Liste von Elementen zu iterieren:

{% for item in issue.issue_entries %}
  - {{ item.name }}: {{ item.qty }} x {{ item.price }} = {{ item.total }}
{% endfor %}

Vorlagenvorschau ​

Sie können eine Vorschau Ihrer Vorlage mit realen Daten anzeigen:

1. Navigieren Sie zu der Vorlage, die Sie anzeigen möchten.
2. Klicken Sie auf den Vorschau-Tab.
3. Das System generiert eine Vorschau mit Beispieldaten, damit Sie sehen können, wie die Vorlage aussehen wird.