[Hook] Umieszczanie znaku wodnego w dokumencie

If you have a problem understanding how the hook works, check: Hook's mechanism

Basic information

Available from version: 1.0.0

Description

Hook places a watermark on the document as it is displayed. This hook is implemented based on the definition of the ReadFileHookAdapter system hook, which allows to change the binary stream of the displayed document from archive or in preview in the process. Configuration of the watermark insert hook is defined in JSON format as a list and is managed by the PCM (Plugin Configuration Manager). A watermark is placed on every page of the document and accepts only PDF format.

JSON parameters

   - documentClassId
   - watermark
       - type
       - text
	   - alignment
       - anchor 
	   - positionX%
       - positionY%
       - opacity
       - watermarkBarcode
            - format
            - codeWidth
            - codeHeight
       - watermarkText
            - size
			- fontType
			- color
            - encoding
            - clockwiseAngle
   - permissions
       - groups

Configuration parameters

Parameter name in JSON configuration

From version

Description

Paremeter type

Comments and restrictions

documentClassId*

1.0.0

The document class id indicates for which documents the watermark insertion parameters are to be considered.

Integer

type*

(watermark)

1.0.0

Specifies what type of watermark is.

Text

Value	Meaning
BARCODE	Encodes the value of the text parameter into a barcode with the specified format defined in the 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.

text*

(watermark)

1.0.0

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

Any typed index ids in the text string must exist in the document class specified by the documentClassId 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 "".

alignment*

(watermark)

1.0.0

Specifies relative to which of the four corners of the document page the position of the watermark will be calculated based on the positionX% and positionY% parameters.

Text

Pay attention to the corresponding values of the positionX% 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.

Value	Meaning
TOP_LEFT	The position of the watermark in relation to the top left corner.
TOP_RIGHT	The position of the watermark in relation to the top right corner.
BOTTOM_LEFT	The position of the watermark in relation to the bottom left corner.
BOTTOM_RIGHT	The position of the watermark in relation to the bottom right corner.

anchor*

(watermark)

1.0.0

Specifies the position of the watermark in relation to the corresponding corner of the watermark.

Text

Value

Meaning

BOTTOM_LEFT

The position of the watermark in relation to the lower left corner of the watermark.

positionX%*

(watermark)

1.0.0

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

Value between 0 and 100.

positionY%*

(watermark)

1.0.0

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

Value between 0 and 100.

opacity*

(watermark)

1.0.0

Specifies the transparency of the inserted watermark on the pages of the document.

Float

Value between 0.0 and 1.0.

format*

(watermark.watermarkBarcode)

1.0.0

Specifies standard for one-dimensional barcodes (writing information on one line, in the form of dashes).

Text

Value	Meaning
CODE_39	Also known as "USS Code 39", "Code 3/9", "Code 3 of 9", "USD-3", "Alpha39") - fixed-width alphanumeric single character bar code.
CODE_93	Code 93 was designed as an improvement to the Code 39 encoding. Like its original in the basic version, it is able to store 43 alphanumeric characters. However, compared to its predecessor, it has 4 additional control characters.
CODE_128	High-resolution alphanumeric one-dimensional barcode. It was designed to encode 128 ASCII characters

codeWidth*

(watermark.watermarkBarcode)

1.0.0

Defines the width of the barcode in pixels.

Integer

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.

codeHeight*

(watermark.watermarkBarcode)

1.0.0

Defines the height of the barcode in pixels.

Integer

size*

(watermark.watermarkText)

1.0.0

Text size.

Float

fontType*

(watermark.watermarkText)

1.0.0

Text font type.

Text

Value	Meaning
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*

(watermark.watermarkText)

1.0.0

Color of the text.

Text

Value	Meaning
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

encoding*

(watermark.watermarkText)

1.0.0

Character encoding.

Text

Value	Meaning
CP1250	A code page for the representation of texts in Central European languages using the Latin alphabet, for example Albanian, Croatian, Czech, Polish, Romanian, Slovak, Slovenian, Hungarian.
CP1252	A code page to represent texts in Western European languages.
CP1257	A code page used to represent texts in Estonian, Lithuanian or Latvian. This set is largely compatible with ISO 8859-13, and is suitable for coding the Polish language.
MACROMAN	Character encoding mainly used in classic Mac OS to represent text. It encodes 256 characters, the first 128 of which are identical to ASCII and the remaining characters include math symbols, diacritics, and additional punctuation marks. It is suitable for English and several other Western languages.

clockwiseAngle*

(watermark.watermarkText)

1.0.0

Watermark rotation.

Float

The value between 0.0 and 360.0.

groups

(permissions)

1.0.0

Permissions defining for which users logged in to the system the hook will be run when trying to open a document.

Array of text values

Optional parameter, when is not filled, everyone can see the watermark.

Parameter*- field is required

Barcode formats

Format

Description

Code_39

Barcode with variable-length alphanumeric characters to store 43 different characters. Each sign consists of 9 elements (light and dark bars), 3 of which are significantly wider. This format allows you to encode numbers, capital letters and characters (-, ., (Space), $, /, +,%, *).

Char	Value	Char	Value	Char	Value	Char	Value
0	0	B	11	M	22	X	33
1	1	C	12	N	23	Y	34
2	2	D	13	O	24	Z	35
3	3	E	14	P	25	-	36
4	4	F	15	Q	26	.	37
5	5	G	16	R	27	space	38
6	6	H	17	S	28	$	39
7	7	I	18	T	29	/	40
8	8	J	19	U	30	+	41
9	9	K	20	V	31	%	42
A	10	L	21	W	32

Code_93

The barcode is an improvement of the CODE_39 format. Like its prototype, it stores 43 alphanumeric characters, but additionally has 4 control characters (($), (%), (/), (+)).
The code accepts only uppercase letters.

Char	Value	Char	Value	Char	Value	Char	Value
0	0	C	12	O	24	-	36
1	1	D	13	P	25	.	37
2	2	E	14	Q	26	space	38
3	3	F	15	R	27	$	39
4	4	G	16	S	28	/	40
5	5	H	17	T	29	+	41
6	6	I	18	U	30	%	42
7	7	J	19	V	31	($)	43
8	8	K	20	W	32	(%)	44
9	9	L	21	X	33	(/)	45
A	10	M	22	Y	34	(+)	46
B	11	N	23	Z	35

Code_128

Variable length, high density alphanumeric code. It can encode characters from the entire ASCII range. The coding uses a dash and a gap of four possible widths, which makes it a compact code. Code 128 can be scanned in either direction and there is no limit to the length of the code itself.

Configuration example

[
  {
   "documentClassId": 5,
   "watermark": {
        "type": "TEXT",
        "text": "Case number: {10}, Registration date: {11}",
		"alignment": "TOP_LEFT",
        "anchor": "BOTTOM_LEFT",
		"positionX%": 5,
        "positionY%": 5,
        "opacity": 0.7,
        "watermarkText":{
            "size": 15,
			"fontType": "HELVETICA",
			"color": "LIGHT_GRAY",
            "encoding": "CP1252",
            "rotation": 0
        }
    },
   "permissions": {
       "groups": ["Users", "Administrators"]  
    }
  },
  {
   "documentClassId": 5,
   "watermark": {
        "type": "BARCODE",
        "text": "{10}",
		"alignment": "TOP_LEFT",
        "anchor": "BOTTOM_LEFT",
        "positionX%": 80,
        "positionY%": 10,
        "opacity": 0.5,
        "watermarkBarcode":{
            "format": "CODE_128",       
            "codeWidth": 50,
            "codeHeight": 15
        }
    },
   "permissions": {
       "groups": ["Users", "Administrators"]  
    }
  }
]

Example of use

Example of use for the above JSON configuration.

Original document:

After opening:

Change log

1.0.0

Hook adding