Page History

Polish

Info
Jeśli masz problem ze zrozumieniem jak działa zadanie automatyczne, sprawdź opisy: Zadanie automatyczne, Wykonanie warunkowe, Parametry komponentów

Panel

title	Podstawowe informacje

Kategoria: Watermark

Dostępne od wersji: 1.0.1

Panel

title	Opis

Komponent dodaje znak wodny do podpiętych w procesie dokumentów w formacie PDF określonej klasy dokumentów. Zmieniony plik dokumentu jest dodawany jako nowa wersja dokumentu. Oryginalny dokument (bez znaku wodnego) jest dostępny w najstarszej wersji dokumentu.

Panel

title	Parametry konfiguracyjne

Nazwa parametru

Od wersji

Opis

Typ parametru

Wartość domyślna

Rodzaj pola

Uwagi i ograniczenia

Rodzaj znaku wodnego*

1.0.1

Określa typ znaku wodnego.

Tekstowy

Lista wartości

Wartość wyświetlana	Opis
Kod kreskowy	Koduje wartość parametru Tekst do postaci kodu kreskowego o określonym formacie zdefiniowanym w parametrze Format. Znak wodny umieszczany na dokumencie jest kodem kreskowym.
Tekst	Wartość parametru Tekst jest nanoszona na dokument jako znak wodny w formie jawnej, niezakodowanej.

Klasa dokumentów*

1.0.1

Nazwa klasy dokumentów, której dokumenty będą modyfikowane poprzez wstawienie znaku wodnego.

Tekstowy

Lista wartości

Tekst*

1.0.1

Przyjmuje wartość tekstową, która jest wykorzystywana do utworzenia znaku wodnego. W celu skorzystania z wartości indeksów dokumentu należy umieścić identyfikator indeksu w nawiasach klamrowych {}. Istnieje możliwość wykorzystania więcej niż jednej wartości indeksu w parametrze. Każdy kolejny indeks musi być opatrzony nawiasami klamrowymi.

Przykład.

"Numer sprawy: {8}, Data rejestracji: {9}"

Tekst znaku wodnego ->

Numer sprawy: 433589, Data rejestracji: 13-02-2021

Tekstowy

Pole edytowalne

Warning
Wszystkie wpisane identyfikatory indeksów w ciągu tekstowym muszą istnieć w klasie dokumentów podanej w parametrze Klasa dokumentów. Jeśli przeglądany dokument nie zawiera wartości indeksu (jest pusty), którego identyfikator został podany w tym parametrze w nawiasach klamrowych, to identyfikator zostanie zastąpiony pustym łańcuchem znaków "".

Róg strony*

1.0.1

Określa względem którego z czterech rogów strony dokumentu obliczona zostanie pozycja znaku wodnego na podstawie wartości parametrów Pozycja X% oraz Pozycja Y%.

Więcej informacji...

Tekstowy

Lista wartości

Należy zwrócić uwagę na odpowiednie wartości parametrów Pozycja X% oraz Pozycja Y%, ponieważ w zależności od wartości parametru Róg strony, Kotwica oraz rozmiarów znaku wodnego, znak wodny może wykraczać poza stronę dokumentu, czyli być częściowo lub wcale niewidoczny.

Wartość wyświetlana	Wartość przekazywana
Górny lewy róg dokumentu	TOP_LEFT
Górny prawy róg dokumentu	TOP_RIGHT
Dolny lewy róg dokumentu	BOTTOM_LEFT
Dolny prawy róg dokumentu	BOTTOM_RIGHT

Kotwica*

1.0.1

Określa punkt na obwodzie znaku wodnego lub na jego środku, na podstawie którego określane jest położenie znaku wodnego biorąc pod uwagę wartości parametrów Pozycja X% oraz Pozycja Y%.

Więcej informacji...

Tekstowy

Lista wartości

Wartość wyświetlana	Wartość przekazywana
Górny lewy róg znaku wodnego	TOP_LEFT
Górny środek znaku wodnego	TOP_MIDDLE
Górny prawy róg znaku wodnego	TOP_RIGHT
Lewy środek znaku wodnego	CENTER_LEFT
Środek znaku wodnego	CENTER_MIDDLE
Prawy środek znaku wodnego	CENTER_RIGHT
Dolny lewy róg znaku wodnego	BOTTOM_LEFT
Dolny środek znaku wodnego	BOTTOM_MIDDLE
Dolny prawy róg znaku wodnego	BOTTOM_RIGHT

Pozycja X%*

1.0.1

Wskazuje pozycję procentową X (w poziomie) znaku wodnego względem wymiarów strony dokumentu. Pozycja ustawiana jest na podstawie wybranego rogu strony w parametrze Róg strony.

Całkowity

Pole edytowalne

Wartość z przedziału 0 -100.

Pozycja Y%*

1.0.1

Wskazuje pozycję procentową Y (w pionie) znaku wodnego względem wymiarów strony dokumentu. Pozycja ustawiana jest na podstawie wybranego rogu strony w parametrze Róg strony.

Całkowity

Pole edytowalne

Wartość z przedziału 0 -100.

Nieprzezroczystość*

1.0.1

Określa stopień widoczności wstawianego znaku wodnego.

Zmiennoprzecinkowy

Pole edytowalne

Wartość 0 (lub mniej)

Element jest w pełni przezroczysty (niewidoczny).

Wartość z przedziału (0, 1)

Element jest częściowo przezroczysty.

Wartość 1 (lub więcej)

Element jest w pełni nieprzezroczysty (jednolity).

Rotacja*

1.0.1

Rotacja znaku wodnego zgodnie z kierunkiem ruchu wskazówki zegara.

Zmiennoprzecinkowy

0

Pole edytowalne

Format*

1.0.1

Określa standard kodu kreskowego.

Więcej informacji...

Tekstowy

Lista wartości

Dostępne wartości
AZTEC
CODABAR
CODE_39
CODE_93
CODE_128
DATA_MATRIX
EAN_8
EAN_13
ITF
PDF_417
QR_CODE
UPC_A
UPC_E

Szerokość*

1.0.1

Definiuje szerokość kodu kreskowego w pikselach.

Całkowity

40

Pole edytowalne

Określa minimalną szerokość kodu kreskowego. W przypadku, gdy wartość do zakodowania z parametru Tekst okaże się zbyt długa, szerokość zostanie zwiększona.

Wysokość*

1.0.1

Definiuje wysokość kodu kreskowego w pikselach.

Całkowity

15

Pole edytowalne

Pole jest opcjonalne. W przypadku braku wprowadzenia jakiejkolwiek wartości, pole zostanie uzupełnione oryginalną nazwą pliku.

Wyświetl tekst pod kodem kreskowym*

1.0.1

Określa, czy ma być wyświetlany pod kodem kreskowym tekst (wartość parametru Tekst), który został w nim zakodowany.

Logiczny

Nie

Pole edytowalne

Tekst ma stały rozmiar czcionki 11 i kolor czarny.

Rozmiar czcionki*

1.0.1

Rozmiar tekstu.

Zmiennoprzecinkowy

15

Pole edytowalne

Rodzaj czcionki*

1.0.1

Rodzaj czcionki tekstu.

Tekstowy

HELVETICA

Lista wartości

Wartość	Opis
COURIER	Courier
COURIER_BOLD	Courier Bold
COURIER_OBLIQUE	Courier Oblique
COURIER_BOLDOBLIQUE	Courier Bold Oblique
HELVETICA	Helvetica
HELVETICA_BOLD	Helvetica Bold
HELVETICA_OBLIQUE	Helvetica Oblique
HELVETICA_BOLDOBLIQUE	Helvetica Bold Oblique
SYMBOL	Symbol
TIMES_ROMAN	Times Roman
TIMES_BOLD	Times Bold
TIMES_ITALIC	Times Italic
TIMES_BOLDITALIC	Times Bold Italic
ZAPFDINGBATS	Zapf Dingbats

Kolor*

1.0.1

Kolor tekstu.

Tekstowy

LIGHT_GRAY

Lista wartości

Wartość	Opis
WHITE	Biały
LIGHT_GRAY	Jasnoszary
GRAY	Szary
DARK_GRAY	Ciemnoszary
BLACK	Czarny
RED	Czerwony
PINK	Różowy
ORANGE	Pomarańczowy
YELLOW	Żółty
GREEN	Zielony
MAGENTA	Magenta
CYAN	Cyjan
BLUE	Niebieski

Kodowanie*

1.0.1

Kodowanie znaków.

Więcej informacji...

Tekstowy

CP1250

Lista wartości

Dostępne wartości
CP1250
CP1252
CP1257
MACROMAN

Parametr*- pole wymagane

Panel

title	Przykładowa konfiguracja

Panel

title	Przykład działania

Przykład Przykład działania dla powyższej konfiguracji aplikacji.

Oryginalny dokument:

Po zmianie:

Panel

title	Change log

1.0.1

Dodanie komponentu

Hide If

special	@anonymous

Zadania związane z komponentem

Aktualne

Archiwalne

JIRA
server 192.168.1.52 JIRA
serverId 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
key CUFCMP-470

JIRA

server	192.168.1.52 JIRA
serverId	2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
key	CUFCMP-519

JIRA

server	192.168.1.52 JIRA
serverId	2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
key	CUFCMP-528

JIRA

server	192.168.1.52 JIRA
serverId	2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
key	CUFCMP-486

English

Info
If you have a problem understanding how the action works, check: Automatic tasks, Conditional execution, Components params

Panel

title	Basic information

Category: Attachment

Available from version: 1.0.23

Panel

title	Description

The component downloads documents adds a watermark to documents in PDF format of a specified class of documents attached to the process or from the archive and saves them to the indicated location on the disk. The revised document file is added as a new document version. The original document (without the watermark) is available in the oldest version of the document.

Panel

title	Configuration parameters

Panel

title	Change log

1.0.23

Select document

Parameter name

From version

Description

Paremeter type

Default value

Field type

Comments and restrictions

Files download sourceWatermark type*

1.0.23

Specifies the source from which files should be downloaded. There are 3 options:

Process - documents attached to the process are downloaded.
Archive - documents are downloaded from the archive from a specified class of documents.
File identifiers from the archive - specified files by identifier are downloaded from the archive.

1

Specifies what type of watermark is.

Text

Editable

fieldValues list

Displayed value	Passed value
Process	PROCESS
Archive	ARCHIVE
File identifiers from the archive	FILEIDS

BARCODE	Encodes the value of the Text parameter into a barcode with the specified format defined in Format parameter. The watermark on the document is a barcode.
TEXT	The value of the Text parameter is applied to the document as an explicit, unencoded watermark.

Document class*

1.0.231

Decides whether downloading of documents attached to a process should be narrowed down by selecting a specific class of documents. When the parameter is set to No, all documents will be taken into account, no matter what class of documents they belong to.

Logic

No

Editable field

The parameter is available after selecting the Process option in Files download source parameter.

Document className of the document class whose documents will be modified by inserting a watermark.

Text

Values list

Text*

1.0.1

Takes the text value that is used to create the watermark. In order to use document index values, the index id should be enclosed in curly braces {}. It is possible to use more than one index value in a parameter. Each subsequent index must be followed by curly braces.

Example.

Case number: "{8}, Registration Date {9}"

Watermark text ->

Case number: 433589, Registration Date: 13-02-2021

Text

Editable field

Warning
Any typed index ids in the text string must exist in the document class specified by the Document Class parameter. If the document being viewed does not contain an index value (it is empty) whose id is given in curly braces in this parameter, the id will be replaced with the empty string "".

Page corner*

1.0.23The name 1

Specifies relative to which of the

document class from which documents will be retrieved.

four corners of the document page the position of the watermark will be calculated based on the Position X% and Position Y% parameters.

More information...

Text

Uneditable drop-down list

Index name

Values list

Pay attention to the corresponding values of the Position X% and PositionY % parameters, because depending on the value of the Alignment, Anchor parameter, and the size of the watermark, the watermark may extend beyond the document page, i.e. be partially or completely invisible.

Available values
TOP_LEFT
TOP_RIGHT
BOTTOM_LEFT
BOTTOM_RIGHT

Anchor*

1.0.23

Optional filtering by indexes of the selected document class. This parameter specifies the name of the index.

Text

Uneditable drop-down list / editable field

Index list after selecting a document class from the list. If a variable or function is used in the Document class parameter, this parameter becomes an editable field.

Index value

1.0.23

Optional filtering by indexes of the selected document class. This parameter specifies the value of the index.

Text

Editable field

Download the newest version

1.0.23

Downloads the latest version of the document in case the document has more than one version.

Logic

Yes

Editable field

The parameter is available after selecting File identifiers from the archive option in Files download source parameter.

File identifiers

1.0.23

Document identifiers to download from the archive.

Integer values table

Editable field

Katalog*

1.0.23

The path to save the file on the disk. The parameter indicates the location under which the documents attached to the process or from the archive will be saved.

Text

Editable field

Nazwa pliku

1.0.23

The name of the file saved on the disk. With the help of context variables: File name with extension, File name without extension, File extension, the target file name can be changed.

Function

Editable field

The field is optional. If no value is entered, the field will be completed with the original file name.

Parameter*- mandatory field

Warning
In a situation where several documents with the same name will be saved, they would be saved with consecutive numbers in the name, e.g. file.txt, file (1).txt, file (2).txt. If a file is uploaded to a directory where a file with the same name already exists, it is overwritten.

Panel

title	Context variables

Context variable name	From version	Description	Parameter type
File name with extension	1.0.23	Stores the file name with extension of the currently processed document.	Text
File name without extension	1.0.23	Stores the file name without extension of the currently processed document.	Text
File extension	1.0.23	Stores the file extension of the currently processed document.	Text

Panel

title	Configuration example

Image Removed

1

Specifies a point in the circumference or in the center of the watermark from which the position of the watermark is determined based on the values of parameters Position X% and Position Y%.

More information...

Text

Values list

Available values
TOP_LEFT
TOP_MIDDLE
TOP_RIGHT
CENTER_LEFT
CENTER_MIDDLE
CENTER_RIGHT
BOTTOM_LEFT
BOTTOM_MIDDLE
BOTTOM_RIGHT

Position X%*

1.0.1

Indicates the X (horizontal) position of the watermark in percent relative to the document page dimensions. The position is set based on the selected page corner in the Alignment parameter.

Integer

Editable field

Value between 0 and 100.

PositionY%*

1.0.1

Indicates the Y (vertical) position of the watermark in percent relative to the document page dimensions. The position is set based on the selected page corner in the Alignment parameter.

Integer

Editable field

Value between 0 and 100.

Opacity*

1.0.1

Specifies the degree of visibility of the inserted watermark.

Float

Editable field

Value 0 (or less)

The element is fully transparent (invisible).

Value between (0, 1)

The item is partially transparent.

Value 1 (or more)

The element is fully opaque (uniform).

Clockwise angle*

1.0.1

Watermark rotation.

Float

0

Editable field

Format*

1.0.1

Specifies the barcode format.

More information...

Text

Values list

Available values
AZTEC
CODABAR
CODE_39
CODE_93
CODE_128
DATA_MATRIX
EAN_8
EAN_13
ITF
PDF_417
QR_CODE
UPC_A
UPC_E

Width*

1.0.1

Defines the width of the barcode in pixels.

Integer

40

Editable field

Specifies the minimum width of the barcode. In case the value to be encoded from the text parameter turns out to be too long, the width will be increased.

Height*

1.0.1

Defines the height of the barcode in pixels.

Integer

15

Editable field

Display text below the barcode*

1.0.1

Specifies whether to display the text encoded in the barcode below this barcode.

Boolean

No

Editable field

The text has a fixed font size of 11 and black color.

Font size*

1.0.1

Text size.

Float

15

Editable field

Font type*

1.0.1

Text font type.

Text

HELVETICA

Values list

Value	Description
COURIER	Courier
COURIER_BOLD	Courier Bold
COURIER_OBLIQUE	Courier Oblique
COURIER_BOLDOBLIQUE	Courier Bold Oblique
HELVETICA	Helvetica
HELVETICA_BOLD	Helvetica Bold
HELVETICA_OBLIQUE	Helvetica Oblique
HELVETICA_BOLDOBLIQUE	Helvetica Bold Oblique
SYMBOL	Symbol
TIMES_ROMAN	Times Roman
TIMES_BOLD	Times Bold
TIMES_ITALIC	Times Italic
TIMES_BOLDITALIC	Times Bold Italic
ZAPFDINGBATS	Zapf Dingbats

Color*

1.0.1

Color of the text.

Text

LIGHT_GRAY

Values list

Value	Description
WHITE	White
LIGHT_GRAY	Light gray
GRAY	Gray
DARK_GRAY	Dark gray
BLACK	Black
RED	Red
PINK	Pink
ORANGE	Orange
YELLOW	Yellow
GREEN	Green
MAGENTA	Magenta
CYAN	Cyan
BLUE	Blue

Coding*

1.0.1

Character encoding standard.

More information...

Text

CP1250

Values list

Available values
CP1250
CP1252
CP1257
MACROMAN

Parameter*- mandatory field

Panel

title	Configuration example

Image Added

Panel

title	Example of use

An example of operation for the above application configuration.

Original document:

Image Added

After change:

Image Added

Panel

title	Change log

1.0.1

Component adding

Versions Compared

Old Version 2

New Version 3

Key

Kategoria: Watermark

Dostępne od wersji: 1.0.1

Zadania związane z komponentem

Aktualne

Archiwalne

JIRA
server 192.168.1.52 JIRA
serverId 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
key CUFCMP-470

Category: Attachment

Available from version: 1.0.23

Page History

Versions Compared

Old Version 2

New Version 3

Key

Kategoria: Watermark

Dostępne od wersji: 1.0.1

Zadania związane z komponentem

Aktualne

Archiwalne

JIRAserver192.168.1.52 JIRAserverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1keyCUFCMP-470

Category: Attachment

Available from version: 1.0.23

JIRA
server 192.168.1.52 JIRA
serverId 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
key CUFCMP-470