====== offer-cube FAQ / Persönlicher Betreuer/Angebotsleger auf Angebot PDF andrucken ======

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

Siehe auch [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]] \\
Siehe auch [[offer-cube:howto:pdf-special-img|PDF Power User Funktion Bild einfügen]] 

Siehe auch [[offer-cube:howto:resource|Ressourcen]]

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

Diese Kurzanleitung zeigt anhand eines Beispiels wie man den Ersteller des Angebots auf dem Angebots-PDF andruckt. \\
Hierbei wird der Name des Benutzers als auch auf Wunsch Foto und Unterschrift eingeblendet. \\
Kann der Benutzer nicht ermittelt werden, so wird stattdessen der Firmenname verwendet.

Ziel ist, dass für den Kunden der das Angebot erhält sichtbar wird, wer das Angebot erstellt hat - sozusagen der //persönliche Betreuer// des Kunden.

In dieser Anleitung werden 2 Varianten gezeigt:

   * Variante 1: **Nur Vorname, Nachname und Benutzername (=Login Email Adresse)** des Bearbeiters im PDF andrucken: siehe [[offer-cube:faq:faq_offer-creator-on-pdf-with-profile-picture-and-name#persoenlicher_betreuer_nur_vorname_und_nachname|Persönlicher Betreuer nur Vorname und Nachname]]
   * Variante 2: **Frei definierbarer Name inkl. Foto und Unterschrift** des Bearbeiters im PDF andrucken: siehe [[offer-cube:faq:faq_offer-creator-on-pdf-with-profile-picture-and-name#persoenlicher_betreuer_mit_foto_und_unterschrift|Persönlicher Betreuer mit Foto und Unterschrift]]


Hierbei werden [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]] verwendet. \\
In Kombination mit [[offer-cube:howto:pdf-special-img|PDF Power User Funktion Bild einfügen]] kann auch ein Foto, eine Unterschrift etc. angedruckt werden.

===== Persönlicher Betreuer nur Vorname und Nachname =====

Es ist mit sehr einfachen Mitteln unter Verwendung der [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]] möglich, \\
den Vornamen und Nachnamen des persönlichen Betreuers (=offer-cube Benutzer, der das Angebot angelegt hat) automatisch einzublenden.

==== Vorbereitung ====

Jeder Benutzer in offer-cube hat das Feld Vorname und Nachname. \\
Dieses ist korrekt zu befüllen:

   * vom Administrator unter //Einstellungen// --> //Benutzer//
   * oder vom Benutzer selbst unter //Einstellungen// --> //Eigenes Profil//

{{offer-cube:faq:faq_offer-creator-on-pdf-with-profile-picture-and-name:offer-cube-faq-offer-creator-on-pdf-11-user-management.png|Benutzer Vorname und Nachname}}


==== Einfügen der Variablen ====

Es gibt in jedem Objekt (//$obj//) 2 Felder, in denen der Benutzer gespeichert wird:

   * **//$obj.created_user//** = Benutzer der das Objekt (z.B. Angebot) **angelegt** hat.
   * **//$obj.modified_user//** = Benutzer der das Objekt (z.B. Angebot) **zuletzt geändert** hat.

Das Benutzer Objekt besitzt die Felder Vorname //firstname//, Nachname //lastname// und Benutzername (=Loginname) //username//:

| //<nowiki> $obj.created_user__firstname </nowiki>// | **Vorname** (//firstname//) des Benutzers, der das Objekt (z.B. Angebot) **angelegt** hat. |
| //<nowiki> $obj.created_user__lastname </nowiki>// | **Nachname** (//lastname//) des Benutzers, der das Objekt (z.B. Angebot) **angelegt** hat. |
| //<nowiki> $obj.created_user__username </nowiki>// | **Benutzername** (//username//) des Benutzers, der das Objekt (z.B. Angebot) **angelegt** hat. |
| //<nowiki> $obj.modified_user__firstname </nowiki>// | **Vorname** (//firstname//) des Benutzers, der das Objekt (z.B. Angebot) **zuletzt geändert** hat. |
| //<nowiki> $obj.modified_user__lastname </nowiki>// | **Nachname** (//lastname//) des Benutzers, der das Objekt (z.B. Angebot) **zuletzt geändert** hat. |
| //<nowiki> $obj.modified_user__username </nowiki>// | **Benutzername** (//username//) des Benutzers, der das Objekt (z.B. Angebot) **zuletzt geändert** hat. |

<code>
[[if $obj.modified_user__username == ""]]
Für Rückfragen stehen wir Ihnen jederzeit unter <b>[[$CONFIGURATION.ownTelephone]]</b> bzw. per Email unter <b>[[$CONFIGURATION.ownMail]]</b> zur Verfügung.
[[else]]
Für Rückfragen steht Ihnen der Projektleiter <b>[[$obj.modified_user__firstname]] [[$obj.modified_user__lastname]]</b> jederzeit unter <b>[[$CONFIGURATION.ownTelephone]]</b> 
bzw. per Email unter <b>[[$obj.modified_user__username]]</b> zur Verfügung.
[[/if]]
</code>


**Hinweis:** Eine genauere **Erklärung** der einzelnen Variablen finden Sie [[offer-cube:faq:faq_offer-creator-on-pdf-with-profile-picture-and-name#einfuegen_in_standard_angebotstext|weiter unten]] bzw. allgemeine Details finden Sie unter [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]].

==== Details: Resultat Vorname, Nachname im PDF ====

{{offer-cube:faq:faq_offer-creator-on-pdf-with-profile-picture-and-name:offer-cube-faq-offer-creator-on-pdf-15-result-pdf-username.png|Benutzer Vorname, Nachname und Benutzername im PDF}}


===== Persönlicher Betreuer mit Foto und Unterschrift =====

==== Vorbereitung ====

=== Vorbereitung: Anlegen einer Ressource für die Benutzer ===

Um Fotos/Bilder, Namen, etc. im System zentral zu verwalten können [[offer-cube:howto:resource|Ressourcen]] verwendet werden. \\
Alternativ wäre es auch möglich mit [[offer-cube:howto:contact|Kontakte/Ansprechpersonen]] zu arbeiten.

**Wichtig:** Im Feld **//code//** der Ressource muss der **//Benutzername//** (=offer-cube Login des Benutzers) eingetragen sein!

{{offer-cube:faq:faq_offer-creator-on-pdf-with-profile-picture-and-name:offer-cube-faq-offer-creator-on-pdf-01-new-ressource.png|Einstellungen - Neue Ressource}}

Nachdem die Ressource mit **Code = Benutzername** angelegt wurde müssen die Bilder hochgeladen werden:

   * als erstes Bild wird das Foto hochgeladen. Dieses wird automatisch als **"Hauptbild"** markiert. Siehe auch [[offer-cube:howto:pdf-special-img#anwendungsmoeglichkeiten_addimgeinfuegen_eines_attachments_aus_dem_aktuellen_objekt|Anwendungsmöglichkeiten addimg: Einfügen eines Attachments aus dem aktuellen Objekt]]
   * als zweites Bild wird die Unterschrift hochgeladen - **hierbei ist der Dateiname der Unterschrift wichtig** - dieser wird später verwendet **ACHTUNG: Groß/Kleinschreibung**

**Dies ist nun für alle Benutzer zu wiederholen**

{{offer-cube:faq:faq_offer-creator-on-pdf-with-profile-picture-and-name:offer-cube-faq-offer-creator-on-pdf-02-upload-pictures.png|Ressource Bilder hochladen}}

=== Vorbereitung: Anlegen einer Fallback-Ressource falls Benutzer nicht bekannt ===

Falls der Benutzername nicht bekannt ist, sollte ein sogenannter //Fallback// angelegt werden. \\
D.h. es wird dann z.B. das Firmenlogo statt dem Foto eingeblendet.

In diesem Beispiel wird als //"code"// **unbekannt** verwendet.

Dies ist dann der Fall, wenn man beispielsweise auf der Rechnung den persönlichen Betreuer ebenfalls angeben möchte, die Rechnung aber über einen [[offer-cube:howto:order-recurring|Dauerauftrag]] automatisch angelegt wurde (siehe [[offer-cube:howto:order-recurring|FAQ: Dauerauftrag anlegen]]).

Oder es gibt einen neuen Mitarbeiter für den noch keine Ressource angelegt wurde - dann wird ebenfall dieser Fallback verwendet.

{{offer-cube:faq:faq_offer-creator-on-pdf-with-profile-picture-and-name:offer-cube-faq-offer-creator-on-pdf-03-fallback-resource.png|Fallback Ressource falls der Benutzer nicht bekannt ist}}

==== Einfügen in Standard Angebotstext ====

Nun kann folgender Text in den Standard Angebotstext (//Einstellungen// --> //Druck Einstellungen// --> //Standard Texte// --> //Text auf Angebot//) eingefügt werden:

<code>
[[getobject module="resource" by="code" code=$obj.modified_user__username assign="projectmgr"]]
[[if $obj.modified_user__username == "" || $projectmgr.id == 0]]
[[addimg module="resource" by="code" value="unbekannt" width="60mm"]]
<b>[[$CONFIGURATION.ownCompany]]</b> | [[$CONFIGURATION.ownTelephone]] | [[$CONFIGURATION.ownMail]]
[[else]]
[[addimg module="resource" by="code" value=$projectmgr.code width="75mm"]]
[[$projectmgr.name]] | [[$CONFIGURATION.ownCompany]]

[[addimg module="resource" by="code" value=$projectmgr.code filename="leo_eibler_unterschrift.jpg"]]
Für Rückfragen steht Ihnen der Projektleiter <b>[[$projectmgr.name]]</b> gerne jederzeit unter <b>[[$CONFIGURATION.ownTelephone]]</b> 
bzw. per Email unter <b>[[$CONFIGURATION.ownMail]]</b> zur Verfügung.
[[/if]]
</code>

Analog zum //Text auf Angebot// kann dies natürlich im //zusätzl. Text auf Rechnung//, etc. angegeben werden.

=== Detail Erklärung der Variablen ===

Eine kurze Erklärung zu den verwendeten [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]]:

<code>[[getobject module="resource" by="code" code=$obj.modified_user__username assign="projectmgr"]]</code>
Holt die [[offer-cube:howto:resource|Ressource]] anhand des Feldes **//code//**. \\
Der Benutzername wird anhand des Benutzers ermittelt, der das Objekt zuletzt bearbeitet hat **//$obj.modified_user _ _ username//**. \\
Dieser Benutzername (=Login für offer-cube) muss genauso im Feld //Code// der Ressource eingetragen sein. \\
Die gefundene Ressource wird in **//$projectmgr//** zwischengespeichert.

<code>[[if $obj.modified_user__username == "" || $projectmgr.id == 0]]</code>
Prüft ob die Ressource gefunden wurde oder der Benutzername eventuell leer ist (wenn das Objekt z.B. Rechnung über einen [[offer-cube:howto:order-recurring|Dauerauftrag]] automatisch angelegt wurde). \\

<code>[[addimg module="resource" by="code" value="unbekannt" width="60mm"]]</code>
Ist der Benutzername leer oder wurde die Benutzerressource nicht gefunden, so wird das //Hauptbild// der Fallback Ressource mit dem Code **//unbekannt//** eingefügt.
Die Breite des Bildes entspricht 60mm - die Höhe wird automatisch berechnet.

<code>[[addimg module="resource" by="code" value=$projectmgr.code width="75mm"]]</code>
Wurde die Ressource mit dem Benutzernamen gefunden (im //else// Zweig) so wird das //Hauptbild// der bereits geladenen //$projectmgr// Ressource mit der Breite 75mm eingefügt.

<code>[[$projectmgr.name]]</code>
Gibt den Namen der gefundenen Ressource des Benutzers aus (hier kann z.B. dann der Titel, etc. angegeben werden).

<code>[addimg module="resource" by="code" value=$projectmgr.code filename="leo_eibler_unterschrift.jpg"]]</code>
Gibt das Bild der Unterschrift mit dem Dateinamen "//**leo_eibler_unterschrift.jpg**//" der gefundenen Ressource des Benutzers aus (Achtung: Groß/Kleinschreibung und File-Extension (hier .jpg) beachten!)

<code>[[$CONFIGURATION.ownCompany]]</code>
Gibt aus den Firmendaten den Firmennamen aus

<code>[[$CONFIGURATION.ownTelephone]]</code>
Gibt aus den Firmendaten die Firmentelefonnummer aus

Siehe auch [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]]

==== Details: Resultat Foto im PDF ====

Wird nun das PDF angezeigt, sieht das ganze so aus:

=== PDF mit Foto und Unterschrift aus Ressource ===

{{offer-cube:faq:faq_offer-creator-on-pdf-with-profile-picture-and-name:offer-cube-faq-offer-creator-on-pdf-21-result-pdf-resource-found.png|Ergebnis im PDF mit Foto und Unterschrift aus Ressource}}

=== PDF mit Foto und Unterschrift aus Ressource ===

{{offer-cube:faq:faq_offer-creator-on-pdf-with-profile-picture-and-name:offer-cube-faq-offer-creator-on-pdf-22-result-pdf-fallback.png|Ergebnis im PDF mit Fallback Ressource}}