====== offer-cube / Dokument und Vorlagen / Texte ======

Zurück zur [[offer-cube:howto|Anleitungen / HowTos]]

Siehe auch [[offer-cube:howto:offer|Angebote]] \\
Siehe auch [[offer-cube:howto:order|Auftrag und Lieferschein]] \\
Siehe auch [[offer-cube:howto:pdf-special-font|PDF Power User Funktionen Schriftstile]] \\
Siehe auch [[offer-cube:howto:pdf-special-img|PDF Power User Funktion Bild einfügen]] \\
Siehe auch [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]] \\

Siehe auch [[offer-cube:howto:docmeta-email|Dokument Vorlagen für Emails]] \\
Siehe auch [[offer-cube:howto:docmeta-export-template|Vorlagen Excel/CSV Export]] \\
Siehe auch [[offer-cube:howto:ooi-textblocks|Überschrift, Texte und Textblöcke in Angebot, Auftrag, Rechnung bearbeiten]]

===== Allgemeines / Zusammenfassung =====

Im Modul "//Dokument Vorlagen//" (//docmeta//) finden sich Vorlagen für Form-App (digitale Formulare), Textbausteine für [[offer-cube:howto:offer|Angebote]]/[[offer-cube:howto:order|Auftrag]]/Rechnungen sowie Vorlagen für Emails.

Die Dokument Vorlagen finden sich unter //**Einstellungen**// --> //**Dokument Vorlagen**//

{{offer-cube:howto:docmeta:offer-cube_howto-docmeta-01-settings-dokumente.png|Einstellungen -> Dokument Vorlagen}}

Die Vorlagen werden in unterschiedliche Typen eingeteilt:

	* //**Formular Vorlagen**// sind die Vorlagen für die FormCube digitalen Formulare der Formular-App (kostenpflichtiges Addon)
	* //**PDF Vorlage**// sind Vorlagen für PDF / Dokument Generierung z.B. für die PDFs der automatischen Mahnungen
	* //**[[offer-cube:howto:docmeta-email|Mail-Vorlage]]**// sind Vorlagen für versendete Emails z.B. bei Versendung automatischer Emails durch "//Hooks//" oder zur manuellen Auswahl bei Versand eines Angebots/Auftrags oder Rechnung
	* //**[[offer-cube:howto:docmeta|Textblöcke]]**// sind einzelne Textblock Vorlagen, die direkt in die Texte eines Angebots, Auftrags oder einer Rechnung als Beschreibung oder Appendix übernommen werden können
	* //**Email-Textblöcke**// sind einzelne Textblock Vorlagen, die direkt in die Texte zum Versand einer Email für Angebote/Aufträge oder Rechnung verwendet werden können
	* //**[[offer-cube:howto:docmeta-export-template|Export-Liste Vorlagen für Excel/CSV Export]]**// sind Vorlagen, welche Felder/Spalten in einem Excel/CSV Export vorhanden sein sollen. Hierbei können mit den [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen/Variablen]] auch die Werte transformiert werden (z.B. Berechnungen durchgeführt werden, etc.)

{{offer-cube:howto:docmeta:offer-cube_howto-docmeta-02-docmeta-list.png|Dokument Vorlagen Liste}}


===== Textblöcke: Vorlagen für Texte / Textbausteine in Angebot/Auftrag/Rechnung =====

Die Textblöcke können direkt verwendet werden, um in eine Beschreibungen oder einen Appendix eines Angebots/Auftrags oder einer Rechnung eingefügt zu werden.

{{offer-cube:howto:docmeta:offer-cube_howto-docmeta-11-docmeta-textblock-list.png|Dokument Vorlage Textblock Liste}}

Über //**+ Neuer Textblock**// kann ein neuer Textblock eingefügt werden.

Im Feld //**Bezeichnung**// wird eine für den Benutzer sichtbare und sinnvolle Bezeichnung eintragen. \\
Diese Bezeichnung wird dann z.B. im Angebot zur Auswahl dem Benutzer angezeigt.

Im Feld **großen Textfeld darunter** wird dann der eigentlich einzufügende Textblock bearbeitet.

**HINWEIS:** Im Textfeld können [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]] verwendet werden.

Unter **Dokument Ziel(e)** können die Module eingeschränkt werden, für die diese Textblöcke gelten:
	* Die Standardeinstellung **//|invoice|offer|order|supplierorder|//** bedeutet, dass die Textblock Vorlagen für die Module //invoice// (Rechnung), //offer// (Angebot), //order// (Auftrag), //supplierorder// (Lieferantenbestellung) gelten.
	* Sollten Textblöcke nur für Angebote gelten (also in einem Angebot zur Auswahl angezeigt werden), so kann ein neues Dokument (Docmeta) vom Typ //Textblöcke Angebot/Auftrag/Rechnung// angelegt werden und als Dokument Ziel //|offer|// eingetragen werden.
	* **HINWEIS:** Die Dokument Ziele müssen alphabetisch aufsteigend eingetragen werden und sie müssen jeweils mit einem Pipe Zeichen | beginnen und enden - daher auch //**|**offer**|**// als Beispiel darüber

{{offer-cube:howto:docmeta:offer-cube_howto-docmeta-12-docmeta-textblock-details.png|Dokument Vorlage Textblock bearbeiten}}

Die definierten Textblöcke können in einem Angebot (oder Auftrag, Rechnung oder Lieferantenbestellung) ausgewählt werden.

Hierzu z.B. im Angebot auf //Angebotsbeschreibung ändern// klicken und im Dialogfeld dann den gewünschten Textblock auswählen.

Der Textblock wird dann in das Beschreibungsfeld übertragen und kann dort weiter verändert werden.

**ACHTUNG: Steht bereits ein Text im Beschreibungsfeld so wird dieser bei Auswahl eines Textblocks überschrieben. Solange jedoch nicht speichern gedrückt wird, kann dies noch mit Abbrechen rückgängig gemacht werden!**

{{offer-cube:howto:docmeta:offer-cube_howto-docmeta-13-docmeta-use-textblock-in-offer.png|Beispiel Dokument Vorlage Textblock in Angebot verwenden}}

{{offer-cube:howto:docmeta:offer-cube_howto-docmeta-14-docmeta-textblock-in-beschreibung-uebernommen.png|Beispiel Dokument Vorlage Textblock in Beschreibung und PDF übernommen}}



===== E-Mail Textblöcke: Vorbereitete E-Mail Textblöcke Angebot/Auftrag/Rechnung =====

Die //E-Mail Textblöcke// können direkt verwendet werden, um beim Versand eines Angebots/Auftrags oder einer Rechnung als E-Mail Text eingefügt zu werden.

{{offer-cube:howto:docmeta:offer-cube_howto-docmeta-21-docmeta-emailtextblock-list.png|Dokument Vorlage E-Mail Textblock Liste}}

Über //**+ Neuer Textblock**// kann ein neuer Textblock eingefügt werden.

Im Feld //**Bezeichnung**// wird eine für den Benutzer sichtbare und sinnvolle Bezeichnung eintragen. \\
Diese Bezeichnung wird dann z.B. im Angebot zur Auswahl dem Benutzer angezeigt.

Im Feld **großen Textfeld darunter** wird dann der eigentlich einzufügende Textblock bearbeitet.

**HINWEIS:** Im Textfeld können [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]] verwendet werden.

Unter **Dokument Ziel(e)** können die Module eingeschränkt werden, für die diese Textblöcke gelten:
	* Die Standardeinstellung **//|invoice|offer|order|supplierorder|//** bedeutet, dass die Textblock Vorlagen für die Module //invoice// (Rechnung), //offer// (Angebot), //order// (Auftrag), //supplierorder// (Lieferantenbestellung) gelten.
	* Sollten Textblöcke nur für Angebote gelten (also in einem Angebot zur Auswahl angezeigt werden), so kann ein neues Dokument (Docmeta) vom Typ //Textblöcke Angebot/Auftrag/Rechnung// angelegt werden und als Dokument Ziel //|offer|// eingetragen werden.
	* **HINWEIS:** Die Dokument Ziele müssen alphabetisch aufsteigend eingetragen werden und sie müssen jeweils mit einem Pipe Zeichen | beginnen und enden - daher auch //**|**offer**|**// als Beispiel darüber

{{offer-cube:howto:docmeta:offer-cube_howto-docmeta-22-docmeta-emailtextblock-details.png|Dokument Vorlage E-Mail Textblock bearbeiten}}

Die definierten Textblöcke können in einem Angebot (oder Auftrag, Rechnung oder Lieferantenbestellung) **beim Versand einer Email** ausgewählt werden.

Hierzu z.B. im Angebot auf //Senden// klicken und im Dialogfeld dann den gewünschten Textblock auswählen.

Der Textblock wird dann in das Feld übertragen und kann dort weiter verändert werden.

**ACHTUNG: Steht bereits ein Text im Beschreibungsfeld so wird dieser bei Auswahl eines Textblocks überschrieben. Solange jedoch nicht speichern gedrückt wird, kann dies noch mit Abbrechen rückgängig gemacht werden!**

{{offer-cube:howto:docmeta:offer-cube_howto-docmeta-22-docmeta-emailtextblock-send-offer.png|Beispiel Dokument Vorlage E-Mail Textblock beim Angebot versenden verwenden}}