Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Polish

← Powrót do listy dostępnych hook'ów

Info
Jeśli masz problem ze zrozumieniem jak działają hook'i, sprawdź opis: Mechanizm hook'ów
Panel
titlePodstawowe informacje

Dostępny od: 1.0.0

Panel
titleOpis

Hook pełni funkcję umieszczania znaku wodnego na dokumencie w czasie jego wyświetlania. Jest on zaimplementowany na podstawie definicji hook'a systemowego ReadFileHookAdapter, który umożliwia zmianę strumienia binarnego wyświetlanego dokumentu z archiwum lub w podglądzie w procesie. Konfiguracja hook'a wstawiającego znak wodny jest określana w formacie JSON pod postacią listy i zarządzana jest przez wtyczkę PCM (Plugin Configuration Manager).

Panel
titleParametry konfiguracyjne
Nazwa parametru w konfiguracji JSON Od wersjiOpisTyp parametruUwagi i ograniczenia
documentClass* 1.0.0Klasa Nazwa Klasy dokumentów wskazuje dla których dokumentów ma być uruchamiany mechanizm wstawiania znaku wodnego.Tekstowy

 

watermark*type* 1.0.0Określa jakiego typu jest znak wodnytyp znaku wodnego.
Tekstowy
WartośćZnaczenie
BARCODEZamieszcza znak wodny w koduje wartość parametru text do postaci kodu kreskowego o określonym formacie zdefiniowanym w parametrze format. Znak wodny umieszczany na dokumencie jest kodem kreskowym.
TEXTZamieszcza Wartość parametru text jest nanoszona na dokument jako znak wodny w postaci
format 1.0.0Określa
formie jawnej, niezakodowanej.
 text*1.0.0

Przyjmuje wartość tekstową, która jest wykorzystywana do utworzenia znaku wodnego. W celu skorzystania z wartości indeksów dokumentu należy umieścić nazwę 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: {Numer sprawy}, Data rejestracji: {Data rejestracji}"

->

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

Tekstowy

 

 

 

Warning

Wszystkie wpisane nazwy indeksów w ciągu tekstowym muszą istnieć w klasie dokumentów podanej w parametrze documentClass.

 

 

 

 

 

 positionX%*1.0.0Wskazuje pozycję procentową X (w poziomie) znaku wodnego względem wymiarów strony dokumentu.CałkowityPozycja liczona od lewej krawędzi (0%) do prawej krawędzi strony (100%).
 positionY%*1.0.0Wskazuje pozycję procentową Y (w pionie) znaku wodnego względem wymiarów strony dokumentu.CałkowityPozycja liczona od górnej krawędzi (0%) do dolnej krawędzi strony (100%).
 opacity*1.0.0Określa przezroczystość wstawianego znaku wodnego.ZmiennoprzecinkowyWartość z przedziału 0.0 - 1.0.
 alignment*1.0.0Określa pozycję znaku wodnego względem odpowiedniego rogu znaku wodnego.Tekstowy
WartośćZnaczenie
BOTTOM_LEFT

Pozycja znaku wodnego względem lewego dolnego rogu znaku wodnego.

Image Added

 

 watermarkBarcodeformat1.0.0Określa standard kodów kreskowych w postaci jednowymiarowej (zapis informacji w jednej linii, w formie kresek).Tekstowy
WartośćZnaczenie
CODE_39

Jednowymiarowy kod kreskowy zawierający znaki alfanumeryczne o zmiennej długości, w którym występują paski o dwóch różnych szerokościach. Do kodowania CODE_39 używane są 43 znaki plus dodatkowe znaki, które są ogranicznikami i znakami start/stop. Znak start/stop zawsze występuje jako pierwszy i ostatni znak kodu i jest nim znak '*'. Ten format nie pozwala na zakodowanie małych liter.

ZnakWartośćZnakWartośćZnakWartośćZnakWartość
00B11M22X33
11C12N23Y34
22D13O24Z35
33E14P25-36
44F15Q26.37
55G16R27space38
66H17S28$39
77I18T29/40
88J19U30+41
99K20V31%42
A10L21W32  

 

CODE_93

Jednowymiarowy kod kreskowy będący udoskonaleniem formatu CODE_39. Występują w nim paski o czterech różnych szerokościach. Podobnie jak swój pierwowzór przechowuje 43 znaki alfanumeryczne, ale dodatkowo posiada 4 znaki sterujące (($), (%), (/), (+)), które są używane do kodowania wszystkich 128 znaków ASCII (CODE_93 Extended). Kod przyjmuje wyłącznie wielkie litery, chyba że zostaną użyte znaki sterujące.

ZnakWartośćZnakWartośćZnakWartośćZnakWartość
00C12O24-36
11D13P25.37
22E14Q26space38
33F15R27$39
44G16S28/40
55H17T29+41
66I18U30%42
77J19V31($)43
88K20W32(%)44
99L21X33(/)45
A10M22Y34(+)46
B11N23Z35  

Code 93

 

CODE_128

Kod alfanumeryczny o zmiennej długości i wysokiej gęstości. Potrafi kodować znaki z całego zakresu ASCII.

Code_128B-2009-06-02.svg.pngImage RemovedImage Added

indexId  1.0.0Wskazuje na indeks, z którego jest pobierana wartość do zakodowania w znaku wodnym.CałkowityWartość indeksu musi być typu tekstowego.codeWidth 1.0.0Definiuje szerokość znaku wodnego kodu kreskowego w pikselach.CałkowityParametr nie definiuje maksymalnej szerokości kodu kreskowego - w przypadku, gdy podstawiana wartość okaże się zbyt długa, szerokość automatycznie zostanie zwiększona.
codeHeight  codeHeight1.0.0Definiuje długość znaku wodnego wysokość kodu kreskowego w pikselach.Całkowity 
position watermarkTextsize1.0.0Rozmiar tekstu.Zmiennoprzecinkowy 
 Pozycjonuje znak wodny w odpowiedniej części strony. Do wykorzystania jest 9 predefiniowanych pozycji. color1.0.0Kolor tekstu.Tekstowyopacity 1.0.0Określa przezroczystość wstawianego znaku wodnego na stronach dokumentu
WartośćZnaczenie
TOP_RIGHTGórny prawy róg
TOP_LEFTGórny lewy róg
BOTTOM_RIGHTDolny prawy róg
BOTTOM_LEFTDolny lewy róg
TOPU góry na środku
BOTTOMNa dole na środku
LEFTNa środku po lewej stronie
RIGHTNa środku po prawej stronie
CENTERNa środku
margin 1.0.0Definiuje odstęp znaku wodnego od określonej krawędzi strony w zależności od wartości parametru Umiejscowienie np. gdy wspomniany parametr ma wartość TOP, to margines odnosi się do górnej krawędzi strony dokumentu.
Zmiennoprzecinkowy 
WHITEBiały
LIGHT_GRAYJasnoszary
GRAYSzary
DARK_GRAYCiemnoszary
BLACKCzarny
REDCzerwony
PINKRóżowy
ORANGEPomarańczowy
YELLOWŻółty
GREENZielony
MAGENTAMagenta
CYANCyjan
BLUENiebieski
  fontType1.0.0Rodzaj czcionki tekstu.Tekstowy
WartośćZnaczenie
COURIERCourier
COURIER_BOLDCourier Bold
COURIER_OBLIQUECourier Oblique
COURIER_BOLDOBLIQUECourier Bold Oblique
HELVETICAHelvetica
HELVETICA_BOLDHelvetica Bold
HELVETICA_OBLIQUEHelvetica Oblique
HELVETICA_BOLDOBLIQUEHelvetica Bold Oblique
SYMBOLSymbol
TIMES_ROMANTimes Roman
TIMES_BOLDTimes Bold
TIMES_ITALICTimes Italic
TIMES_BOLDITALICTimes Bold Italic
ZAPFDINGBATSZapf Dingbats
  rotation1.0.0Rotacja znaku wodnego.ZmiennoprzecinkowyWartość z przedziału 0.0 - 1360.0.

permissions

 
groups1.0.0Uprawnienia określające dla jakich zalogowanych użytkowników w systemie przy próbie otwarcia dokumentu zostanie uruchomiony hook. Obiekt Wskazuje na grupy użytkowników systemowych.Tablica wartości tekstowychParametr opcjonalny, gdy nie jest uzupełniony to znak wodny widzą wszyscy.
groups 1.0.0Wskazuje na grupy użytkowników systemowych.Tablica tekstowa 
Panel
titlePrzykładowa konfiguracja

 

Info
titlePrzykładowa konfiguracja JSON
[
  {
   "documentClassId": 2,
   "watermark": {
        "type": "BARCODE",
"format": "CODE_128",
        "indexId": 2,
        "codeWidth": 30,
        "codeHeight": 30,
        "position": "RIGHT",
        "margin": 5.0,
        "opacity": 0.5
    },
   "permissions": {
       "groups": ["Users", "Administrators"]  
    }      
  },
  {
   "documentClassId": 1,
   "watermark": {
        "type": "BARCODE",
"format": "CODE_128",
        "indexId": 2,
        "codeWidth": 60,
        "codeHeight": 60,
        "position": "LEFT",
        "margin": 5.0,
        "opacity": 0.5
    }
  }
]
Panel
titleChange log

1.0.17

  • Dodanie hook'a