User Tools

Site Tools


offer-cube:howto:pdf-special-img

Differences

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

Link to this comparison view

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]]}}
 +
 +