Używanie obrazów w szablonach dokumentów

Z Planfix
W szablonach dokumentów dozwolone jest używanie obrazów w formatach: BMP, JPG, JPEG i PNG.

W Szablony dokumentów można używać obrazów na dwa sposoby:

  • Statycznie - obrazy są umieszczane bezpośrednio w szablonach dokumentów i w każdym dokumencie wygenerowanym ze szablonu będą wyświetlane dokładnie tak, jak zostały umieszczone w szablonie.
  • Dynamicznie - obrazy są powiązane przez File-owy typ variable, i w każdym dokumencie wygenerowanym ze szablonu zmienna zostaje zastąpiona obrazem odpowiadającym tej zmiennej w danym momencie.

Aby umieścić w szablonie obraz dynamiczny, można użyć zmiennej z dodatkowymi parametrami lub zmiennej powiązanej z obrazem zastępczym (placeholder), który określa rozmiar i położenie obrazu w końcowym dokumencie. Obie opcje opisano poniżej.

Użycie zmiennej z dodatkowymi parametrami

Ogólnie rzecz biorąc, aby wstawić obraz do szablonu dokumentu, wystarczy dodać nazwę zmiennej w żądanym miejscu (wierszu, komórce) szablonu — w każdym utworzonym dokumencie będzie ona zawierać odpowiedni plik obrazu: UchvJJ.png

Do ustawienia rozmiaru i położenia obrazu w pliku wynikowym używane są następujące parametry:

  • Dla szablonów MS Word można jawnie ustawić rozmiar wstawionego obrazu.

Składnia zmiennej:

{{VariableName::SIZE_X_AXISxSIZE_Y_AXIS}}

Przykład użycia zmiennej z tym parametrem:

{{Task.File.Employee picture::200x300}}
  • Dla szablonów MS Word można również jawnie wybrać opcję zawijania tekstu wokół obrazu. W tym celu używa się parametru wrapping zmiennej:
Przykład:
{{System.File::50x50;wrapping=around frame}}
{{System.File::50x50;wrapping=before text}}
{{System.File::50x50;wrapping=up and down}}
Użyty format:
  • nazwa zmiennej jest dodana przed separatorem "::" (dwie dwukropki);
  • 50x50 to szerokość x wysokość obrazu w dokumencie wygenerowanym ze szablonu;
  • wrapping - wybiera opcję zawijania tekstu.
Uwaga: w powyższych przykładach jednocześnie użyto dwóch parametrów, rozdzielonych średnikiem: rozmiaru obrazu oraz zawijania tekstu wokół obrazu.
  • Dla szablonów MS Word dostępne są także atrybuty MaxHeight i MaxWidth. Gdy użyty zostanie jeden z tych atrybutów, drugi zostanie ustawiony proporcjonalnie w pliku wynikowym.
Przykład użycia zmiennej z dodatkowym atrybutem:
{{System.File::MaxWidth=150}}
Rezultat: obraz wstawiony w pliku wynikowym będzie miał szerokość 150 pikseli, a wysokość dostosowaną proporcjonalnie.
  • W szablonach MS Excel obrazy domyślnie "wypełniają" komórkę, która zawiera zmienną, więc rozmiar i proporcje będą determinowane rozmiarem komórki przeznaczonej na obraz. Można używać scalonych komórek.
    • Aby wstawić obraz w jego oryginalnym rozmiarze, użyj atrybutu "original": 
      {{Task.File.Employee picture::original}}
    • Możesz ustawić odstęp (padding) wokół obrazu wewnątrz komórki tabeli. Użyj atrybutu "padding" i liczby określającej, o ile pikseli odsunąć od krawędzi komórki: 
      {{Data Tag.Price list for Quote.Name.Display::padding=1}}

Użycie zmiennej powiązanej z obrazem zastępczym

W tej opcji w szablonie dokumentu wstawiany jest tymczasowy obraz zastępczy, który określa rozmiar i położenie obrazu w pliku wynikowym. Ta metoda nie wymaga żadnych parametrów, ponieważ ustawienia obrazu można skonfigurować "wizualnie", przesuwając obraz zastępczy w szablonie i zmieniając jego rozmiar według potrzeb. Obraz zastępczy można powiązać ze zmienną, ustawiając nazwę zmiennej jako nazwę obrazu w szablonie dokumentu.

Aby skorzystać z tej opcji, należy:

  • Otworzyć szablon dokumentu w LibreOffice
  • Wstawić obraz do pliku i zmienić jego rozmiar/położenie według potrzeb.
  • Kliknąć obraz prawym przyciskiem myszy i wybrać:
    • dla szablonów Excel — Name (zobacz przykład)
    • dla szablonów Word — Properties:

okIS1Y.png

a w otwartym oknie przejść do karty Parameters, gdzie znajduje się pole Descripton. Wprowadź tam nazwę zmiennej odpowiadającej polu zawierającemu obraz:

DHNfCz.png

  • Podczas tworzenia dokumentu ze szablonu zaprojektowanego w ten sposób obraz pojawi się w miejscu, które określiłeś, względem innych elementów szablonu.

Przydatne informacje dla tej metody:

  • Podczas tworzenia dokumentu obraz w szablonie zostaje zastąpiony obrazem przesłanym do pola określonego w nazwie. Dlatego nie ma znaczenia, jaki obraz dodasz do pliku szablonu — jest on jedynie symbolem zastępczym dla obrazu, który zostanie dodany do dokumentu wynikowego.
  • Jeśli nazwa obrazu w pliku szablonu zawiera nazwę nieistniejącego pola, lub jeśli do pola o podanej nazwie nie został wprowadzony żaden obraz, w pliku wynikowym nie pojawi się żaden obraz.
  • Podczas tworzenia dokumentu wstawiany jest obraz o rozmiarze określonym w szablonie. Oznacza to, że jeśli obraz pieczęci w twoim szablonie ma 3"x3", ale rzeczywisty rozmiar obrazu przesłanego do ogólnego pola "Seal" wynosi 2"x2", obraz zostanie rozciągnięty do 3"x3" w pliku wynikowym.

Użycie tego samego obrazu wielokrotnie

Jeśli potrzebujesz wstawić ten sam obraz (na przykład pieczęć lub podpis) wielokrotnie w jednym szablonie dokumentu, użyj zmiennej z dodatkowym parametrem. Na przykład:

{{General.Print::Tag1}}

gdzie parametr Tag1 to dowolny tekst unikalny dla każdego użycia zmiennej w szablonie (na przykład Tag1, Tag2 itp.).

Ten dodatkowy parametr, który jest dodawany po symbolach "::" (dwie dwukropki), może być używany zarówno w zmiennej z dodatkowymi parametrami, jak i w zmiennej powiązanej z obrazem zastępczym.

Przydatne linki


Go To