User Tools

Site Tools


offer-cube:faq:faq_offer-creator-on-pdf-with-profile-picture-and-name

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

offer-cube:faq:faq_offer-creator-on-pdf-with-profile-picture-and-name [2020/02/02 11:01] (current)
Line 1: Line 1:
 +====== 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}}
  
offer-cube/faq/faq_offer-creator-on-pdf-with-profile-picture-and-name.txt · Last modified: 2020/02/02 11:01 (external edit)