Instrukcja obsługi R2płatnik

Tworzenie wydruków jest możliwe tylko z wykorzystaniem serwera R2P, który przyjmuje do wykonania zadania drukowania, a następnie zwraca je w formie HTML.

function CheckServer:boolean;stdcall;

Sprawdza czy jakikolwiek serwer R2P jest dostępny.

Parametry

Brak

Zwracane wartości

Zwraca True jeśli jest dostępny choć jeden serwer R2P.

Uwagi

Aby uruchomić serwer R2P należy uruchomić aplikację R2Płatnik z parametrami: /SERVER /ICON /U:nazwa użytkownika /H:hasło użytkownika (patrz także Serwer R2P)

function CreateJob(Ide:integer; Params:PChar):integer;stdcall;

Tworzy i dodaje nowe zadanie do kolejki serwera R2P

Parametry

• Ide - identyfikator zadania

• Params - lista parametrów oddzielonych średnikami (;)

Zwracane wartości

Jeśli wartość jest niezerowa, zwraca uchwyt zadania, który został nadany przez serwer R2P; w przeciwnym wypadku zadanie nie zostało przyjęte przez serwer.

Uwagi

Brak

function CreatePrintJob(Doc:integer; Rml:PChar; TN1,TN2,TN3,TN4:PChar; Id1,Id2,Id3,Id4:integer; Params:PChar):integer;stdcall;

Tworzy i dodaje nowe zadanie drukowania powiązane z konkretną makietą dokumentu, do kolejki serwera R2P

Parametry

• Doc - numer makiety dokumentu (pole @NrDokumentu w tabeli DOKUMENTY)

• Rml - nazwa makiety dokumentu (pole Makieta w tabeli DOKUMENTY)

• TN1..TN4 - lista nazw tabel

• Id1..Id4 - lista odpowiadającym wyżej tabelom identyfikatorów rekordów, dla których ma zostać wydrukowany dokument

• Params - lista parametrów oddzielonych średnikami (;); powinna być pusta

Zwracane wartości

Jeśli wartość jest niezerowa, zwraca uchwyt zadania, który został nadany przez serwer R2P; w przeciwnym wypadku zadanie nie zostało przyjęte przez serwer.

Uwagi

Przed utworzeniem nowego zadania drukowania, należy odszukać tabele i identyfikatory ich rekordów (pola Ide), dla których dany dokument ma powstać. Jeśli np. chcemy wydrukować wniosek urlopowy podajemy tabele: PRACOWNICY, AKTUALNE ZATRUDNIENIE, oraz KARTA URLOPOWA, i odpowiednio identyfikatory danego pracownika, jego zatrudnienia i odpowiedniego rekordu z karty urlopowej.

function WaitForJob(Handle:integer; TimeOut:integer=5000):boolean;stdcall;

Czeka, aż zadanie zostanie wykonane przez serwer

Parametry

• Handle -uchwyt zadania zwrócony przez jedną z funkcji CreateJob lub CreatePrintJob

• TimeOut - timeout na wykonanie zadania w milisekundach (domyślnie czeka 5s.)