This shows you the differences between two versions of the page.
offer-cube:howto:pdf-special-img [2020/06/01 17:50] |
offer-cube:howto:pdf-special-img [2023/11/22 10:16] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== offer-cube / PDF Power-User Funktionen: Einfügen von Bildern aus Attachments <img> ====== | ||
+ | |||
+ | Zurück zur [[offer-cube:howto|Anleitungen / HowTos]] | ||
+ | |||
+ | Siehe auch [[offer-cube:howto:pdf-special-font|Schriftstile]] \\ | ||
+ | Siehe auch [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen/Variablen]] \\ | ||
+ | |||
+ | ===== Allgemeines / Zusammenfassung ===== | ||
+ | |||
+ | Die PDF Erweiterungen für Power-User ermöglichen folgende Funktionalitäten (link auf die entsprechenden Dokumente): | ||
+ | * [[offer-cube:howto:pdf-special-font#detailsfett_b_kursiv_i_unterstrichen_u|Schriftstile]]: Fett <b>, Kursiv <i>, Unterstrichen <u> | ||
+ | * [[offer-cube:howto:pdf-special-font#detailslinks_auf_webseiten_a|Links auf Webseiten]] <a> | ||
+ | * [[offer-cube:howto:pdf-special-font#detailsabsaetze_abstaende_p_br|Absätze/Abstände]] <p> / <br> | ||
+ | * [[offer-cube:howto:pdf-special-font#detailsseitenumbruch_bzw_dynamischer_seitenumbruch_pagebreak|Seitenumbruch bzw. dynamischer Seitenumbruch]] <pagebreak> | ||
+ | * [[offer-cube:howto:pdf-special-variables|Objektdaten holen]] und über Variablen in den Text einfügen | ||
+ | | ||
+ | Hier in diesem Dokument werden speziell folgende Funktionalitäten erläutert: | ||
+ | * Einfügen von Bildern aus Attachments <img> | ||
+ | |||
+ | Gesteuert werden diese Funktionen über Funktionsaufrufe, die zwischen jeweils 2 eckigen Klammern aufgerufen werden. | ||
+ | Hier gibt es die Möglichkeit Daten von Objekten (z.B: Gesamtpreis, Rechnungsdatum, Angebotsnummer, etc.) aus dem System zu holen und über Variablen einzufügen. | ||
+ | Oder es gibt eine Funktion um Bilder-Attachments zu holen und als Bilder in das PDF einzufügen. | ||
+ | |||
+ | Diese Erweiterungen lassen sich auf folgende Objekte/Felder anwenden: | ||
+ | * Angebote/Aufträge/Rechnungen: Felder "Überschrift/Titel", "... Beschreibung", "... Appendix" | ||
+ | * Position: Felder "Positions-Bezeichnung", "Positions-Beschreibung" | ||
+ | * Artikel: Feld "Beschreibung" | ||
+ | |||
+ | |||
+ | ===== Details: Einfügen von Bildern aus Attachments <img> ===== | ||
+ | |||
+ | Über das HTML Tag <img src="...."> lassen sich Bilder aus Attachments einfügen sofern die interne Attachment ID bekannt ist. | ||
+ | |||
+ | Zusätzlich kann die Breite oder Höhe des Bildes in mm mittels der Attribute width="..." oder height="..." angegeben werden. | ||
+ | |||
+ | Das Bild wird an der aktuellen Cursor Stelle eingefügt, verändert aber nicht die Positions des Cursors. Das bedeutet, der Text wird direkt im Bild fortgesetzt (Abhilfe mit <p> Absatz - siehe Beispiel darunter). | ||
+ | |||
+ | Die ID kann aus der URL beim Öffnen eines Attachments ausgelesen werden. | ||
+ | |||
+ | {{:offer-cube:howto:pdf-special:offer-cube_pdf-special_05-img1-attachmentid.png|Interne Attachment ID auslesen}} | ||
+ | |||
+ | **Beispiel Attachment ID 2352 mit Höhe 50mm einfügen <img src="attachment:2352" height="50">:** | ||
+ | |||
+ | {{:offer-cube:howto:pdf-special:offer-cube_pdf-special_05-img1-insert.png|Bild mit Attachment ID einfügen}} | ||
+ | |||
+ | Achtung: Anschließend ist ein [[offer-cube:howto:pdf-special-font|Absatz mittels <p height="...">]] mit der exakten Höhe des Bildes einzufügen, damit der nachfolgende Text nicht über das Bild geschrieben wird. | ||
+ | |||
+ | |||
+ | ===== Details: Einfügen von Bildern über die Funktion [[addimg]] ===== | ||
+ | |||
+ | In doppelten eckigen Klammern können bestimmte Funktionen aufgerufen werden. | ||
+ | |||
+ | Die Funktion // <nowiki>[[addimg]]</nowiki> // erlaubt das Einfügen eines Attachments anhand von Suchparameter wie z.B. Dateiname oder über interne IDs, Seriennummern, Code Feldern aus beliebigen Objekten. \\ | ||
+ | Im Gegensatz zum //<img>// Tag kümmert sich // <nowiki>[[addimg]]</nowiki> // um den korrekten Zeilenumbruch und Abstand zum nachfolgenden Text sowie um die korrekte Skalierung des Bildes. | ||
+ | |||
+ | Wir das entsprechende Attachment nicht gefunden, so wird nichts eingefügt (weder ein Bild, noch eine Fehlermeldung, noch ein Zeilenabstand). | ||
+ | |||
+ | ==== Anwendungsmöglichkeiten [[addimg]]: Einfügen eines Attachments aus dem aktuellen Objekt ==== | ||
+ | |||
+ | Der einfachste Fall ist das Einfügen des aktuellen Haupt-Bildes aus dem aktuellen Objekt (Angebot, Auftrag, Rechnung). | ||
+ | |||
+ | Hierzu einfach ein Bild zum Beispiel zum Angebot raufladen. Das erste Bild wird automatisch als Hauptbild verwendet.\\ | ||
+ | Dieses kann dann ganz einfach eingebunden werden: | ||
+ | <code> | ||
+ | [[addimg]] | ||
+ | </code> | ||
+ | |||
+ | {{:offer-cube:howto:pdf-special:offer-cube_pdf-special_06-img3-mainatt1.png|Hauptbild als Attachment einfügen}} | ||
+ | |||
+ | Es kann auch ein Bild mit einem bestimmten Dateinamen eingebunden werden.\\ | ||
+ | Hierzu ist es irrelevant ob das Bild direkt vom Angebot/Auftrag/Rechnung kommt oder aus einer Position oder einem Artikel. Die //<nowiki>[[addimg]]</nowiki>// Methode durchsucht alle Bilder. | ||
+ | |||
+ | Dieses Beispiel fügt das Attachment vom aktuellen Angebot mit dem Dateinamen //"AnsichtB_2.JPG"// und einer Breite von 50mm ein: | ||
+ | <code> | ||
+ | [[addimg filename="AnsichtB_2.JPG" width="50"]] | ||
+ | </code> | ||
+ | |||
+ | {{:offer-cube:howto:pdf-special:offer-cube_pdf-special_06-img3-filename.png|Attachment mit Dateinamen einfügen}} | ||
+ | |||
+ | |||
+ | ==== Anwendungsmöglichkeiten [[addimg]]: Einfügen einer Unterschrift oder eines Personenbildes ==== | ||
+ | |||
+ | Eine sehr gute Anwendung hierfür ist z.B. das Einfügen eines Bildes des Sachbearbeiters oder das Einfügen der Unterschrift des Projektleiters. Hierfür können z.B. Ressourcen verwendet werden. | ||
+ | |||
+ | Zuerst eine Ressource (Objekttyp //resource//) anlegen unter Einstellungen -> Ressource (hier mit Namen "Leo Eibler") und ein Bild hochladen. | ||
+ | |||
+ | {{:offer-cube:howto:pdf-special:offer-cube_pdf-special_06-img2-resource1.png|Ressource anlegen}} | ||
+ | |||
+ | Dann kann im Angebot die entsprechende Ressource gesucht und das Hauptbild mit der Breite 50mm eingefügt werden: | ||
+ | <code> | ||
+ | Ihr Projektleiter Ing. Leo Eibler, CMC: | ||
+ | [[addimg module="resource" by="name" value="Leo Eibler" width="50"]] | ||
+ | </code> | ||
+ | |||
+ | {{:offer-cube:howto:pdf-special:offer-cube_pdf-special_06-img2-resource3.png|Bild aus Resource einfügen mit [[addimg]]}} | ||
+ | |||
+ | Alternativ wäre auch der Zugriff über die Ressourcen ID möglich: | ||
+ | <code> | ||
+ | [[addimg module="resource" by="id" value="2" width="50"]] | ||
+ | </code> | ||
+ | |||
+ | ==== Anwendungsmöglichkeiten [[addimg]]: Einfügen eines Bildes nach Dateinamen ==== | ||
+ | |||
+ | Ergänzend zum vorherigen Beispiel lässt sich neben dem Haupt-Bild auch ein anderes beliebiges Attachment anhand des Dateinamens einfügen. | ||
+ | |||
+ | Zuerst muss ein Bild zu der vorher angelegten //resource// mit dem Namen //"unterschrift_eibler.jpg"// hochgeladen werden. | ||
+ | |||
+ | In diesem Beispiel wieder ein Bild aus der //resource// mit //name// "Leo Eibler" und das Attachment hat den Dateinamen //"unterschrift_eibler.jpg"// | ||
+ | <code> | ||
+ | [[addimg module="resource" by="name" value="Leo Eibler" width="50" filename="unterschrift_eibler.jpg"]] | ||
+ | </code> | ||
+ | |||
+ | {{:offer-cube:howto:pdf-special:offer-cube_pdf-special_06-img2-resource4.png|Bild mit Dateinamen aus Resource einfügen mit [[addimg]]}} | ||
+ | |||
+ | |||