This shows you the differences between two versions of the page.
— |
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}} | ||