hMARFA

Documentele sunt descrise pe mai multe nivele:

• Formularele sunt descrise („îngheţate“) în programul hPRINT.
• Parametrii generali de configurare se află în Parametrii programului hPRINT. Parametrii generali de configurare sunt: parametri de punere în pagină, date care sunt aceleaşi pe toate documentele de acelaşi tip, ca datele vânzătorului, logo, watermark, semnătura şi ştampila.
  Pe baza acestor parametri se pot tipări formulare goale.
• Descrierea documentului conţine parametrii efectivi de configurare şi datele care se tipăresc pe document. Pe baza acestei descrieri se pot imprima documentele completate.
  După crearea fişierului de descriere, hMARFA lansează automat utilitarul hPRINT care imprimă documentul.

Utilitarul are mai multe regimuri de funcţionare.

Utilizare:

• HPRINT - această fereastră de ajutor
  HPRINT dbf - această fereastră de ajutor
• HPRINT /i - informaţii imprimante
  HPRINT dbf /i - informaţii imprimante
• HPRINT dbf /p - exportă lista imprimantelor în TMP\lprts_xx.txt, unde xx-codul staţiei
• HPRINT dbf /c - editare parametri generali de configurare
• HPRINT dbf /fFACTURA - tipărire formulare de factură
• HPRINT dbf /fFACTURA_A5 - tipărire formulare de factură format A5
• HPRINT dbf /fFACTURA_CHITANTA - tipărire formulare de factură cu chitanţă
• HPRINT dbf /fFACTURA_FTVA - tipărire formulare de factură fără TVA
• HPRINT dbf /fCHITANTA - tipărire formulare de chitanţă
• HPRINT dbf /fAVIZ - tipărire formulare de aviz

unde dbf este baza de date hPRINT.

Pachetul de instalare conţine 2 pachete:

• PRNT___1… - pachet cu care hPRINT se instalează ca program separat, Care se foloseşte pentru tipărirea formularelor,
• PRNT_M_1… - pachet care se instalează peste mediul hMARFA pentru imprimarea completă a documentelor, caz în care hPRINT devine o componentă cu care se completează hMARFA.

Pentru instrucţiunile de instalare efectivă citiţi fişierele Citeste.txt din pachetele de instalare.

Mediul hPRINT arată astfel:

• DBF\ - bază de date de tip hPRINT/hMARFA,
  • HPRINT\ - subcatalog HPRINT,
    • HPRINT.DBF,DBT - parametrii generali de configurare,
    • LOGO.BMP - opţional. Fişier de tip bitmap conţinând un logo al firmei care emite documentul,
    • TEXT.BMP - opţional. Fişier de tip bitmap conţinând o imagine folosită ca „watermark“ care se tipăreşte pe document în zona în care vor fi tipărite rândurile,
    • SIGN.BMP - opţional. Fişier de tip bitmap conţinând o imagine folosită pentru semnătură şi ştampilă.
      Pe document va fi tipărită în zona rezervată pentru semnătură şi ştampilă.
      Dacă parametrul SIGNATURE este definit, Semnătura şi ştampila se tipăreşte pe toate tipurile de factură, aviz şi nu se tipăreşte pe chitanţe.
• TMP - catalog temporar,
• hPRINT.EXE - utilitarul de imprimare.

După instalare se creează mediul de mai sus, dar acest mediu conţine parametrii generali şi conţine fişierele Logo.bmp, Wm_Oblic.bmp şi Wm_Oriz.bmp care reprezintă fişierele logo şi watermark, dar numai în scopul testării.
Personalizarea şi crearea fişierelor logo şi watermark, cu care se va lucra efectiv se face pe parcursul operaţiei de implementare.

Parametrii generali de configurare trebuie să fie completaţi cu datele societăţii proprietare. Vezi aliniatul Implementare/ Parametri generali de configurare.

Obţinerea unor informaţii despre imprimante

 > hPRINT /i
 > hPRINT dbf /i
 
 Sub Linux_WP lansarea este:
 cd C:\hSTART
 c:\hSTART> hPRINT /i 
 
 Dacă se indică şi dbf, baza de de date HPRINT de regulă este în S:\RW\HPRINT
 c:\hSTART> hPRINT S:\RW\HPRINT /i 

Afişează lista imprimantelor instalate. Permite selectarea uneia dintre imprimante şi afişează capacităţile fizice ale acesteia şi în continuare permite tipărirea unei pagini de test.
Pe baza acestora se pot definitiva modelele documentelor de imprimat.

Dimensiunea formularului imprimabil este dată de:

 Caractere pe orizontală:  xx CPI10,  xx CPI12
 Linii pe verticală:  xx LPI6

Pagina de test conţine:

• parametrii imprimantei,
• un liniar pe orizontală în ţoli pe marginea de sus,
• un liniar pe orizontală în cm şi mm pe marginea de jos,
• un liniar pe verticală în ţoli pe marginea din stânga,
• un liniar pe verticală în cm şi mm pe marginea din dreapta,
• un rând de caractere tipărit cu 10cpi,
• un rând de caractere tipărit cu 12 cpi. 12cpi este utilizat la completarea documentelor şi se poate vedea, câte caractere 12 cpi se pot imprima,
• linii numerotate cu 6lpi. Se vede numărul de linii care se pot imprima pe pagină.

Parametrii generali de configurare - conţine date generale, care apar pe fiecare document, cum ar fi date privind vânzătorul, aşezarea documentului pe pagină, etc.

Parametrii generali de configurare se află în fişierul Parametri din programul hPRINT şi pot fi vizualizaţi/modificaţi cu comanda HPRINT dbf /C.

În fereastra de editare a parametrilor sunt înşiraţi toţi parametrii accesibili, fiecare este însoţit de o scurtă prezentare şi asignat cu valoarea prestabilită.

În regimul tipărire formulare se procesează doar parametrii generali de configurare.

Parametrii generali de configurare se află în fişierul de stare al utilitarului PRINT. Dacă se lucrează în reţea şi este necesar ca definiţiile să difere la nivel de staţie de lucru, fişierul poate fi mutat pe calculatorul local, astfel fiecare staţie poate avea o definiţie proprie.

Prezentăm câteva observaţii legate de parametrii de configurare.

• parametrul IMPRIMANTA defineşte imprimanta pe care se va tipări documentul.
  În mod prestabilit nu este completat, în consecinţă tipărirea documentului va avea loc pe imprimanta implicită selectată în sistemul de operare.

  Dacă se doreşte ca tipărirea să aibă loc pe o altă imprimantă, atunci se completează cu o secvenţă caracteristică din identificatorul imprimantei.
  De Exemplu imprimanta hp LaserJet 1320 PCL 6 poate fi referită simplu prin:
  #IMPRIMANTA = 1320
  1320 este o secvenţă caracteristică din numele imprimantei, neexistând altă imprimantă care să conţină această secvenţă.

• MARGINE_STANGA şi MARGINE_SUS sunt considerate de la marginea neimprimabilă şi sunt exprimate în mm.

  Este indicat, ca pagina să se tipărească cât este posibil spre marginea din dreapta, astfel în stânga rămâne loc pentru îndosariere.
  Formularul poate fi deplasat spre dreapta cu ajutorul parametrului MARGINE_STANGA.
  Studiaţi capacităţile fizice ale imprimantei (lansare cu parametrul /i).

  De exemplu formularul de factură are o lăţime de 89 caractere la 12 CPI. Dacă formularul nu încape pe orizontală, se poate micşora MARGINE_STANGA. Dimensiunea necesară pentru formular se află în parametrii generali de configurare, la secţiunea [FACTURA].

  La tipărire, acelaşi document poate fi tipărit puţin diferit în funcţie de tipul imprimantei. Tipărirea trebuie să fie verificată pentru fiecare imprimantă.

• LUNGIME_FORMULAR şi MARGINE_SUS - determină lungimea formularului exprimat în rânduri de 6LPI. LUNGIME_FORMULAR reprezintă numărul de ordine al ultimului rând din interiorul chenarului, care în mod prestabilit este 65.

  În realitate nu toate imprimantele au capacitatea fizică de a tipări acest formular (fiind relativ lung). Testaţi capacităţile fizice ale imprimantei cu comanda HPRINT /i şi pagina de test şi reduceţi cu câteva rânduri lungimea formularului, dacă este necesar şi/sau micşoraţi MARGINE_SUS.

  Lungimea formularului poate fi suprascrisă şi din hMARFA la generarea fişierului de descriere. Deci dacă este necesar se pot implementa modele cu lungimi diferite pentru imprimante diferite.
  De altfel, definiţia documentului recomandat preia lungimea definită în Format pagină asociată documentului şi suprascrie valoarea setată în Parametri generali.
  Studiaţi definiţia de document prezentată mai jos.

  Lungime formular - lungimea totală a formularului de factură exprimată în linii de 6 LPI, nu înseamnă numărul de rânduri rezervate pentru articolele de pe factură !

• GROSIMEL - Grosime linie. Exprimat în puncte de tipar.
  Un punct de tipar= 1/72 inch.
  Implicit este de 0.5 puncte. Se poate mări sau micşora, dacă anumite imprimante nu reproduc suficient de pronunţat, sau dacă se consideră că se poate tipări mai economicos.
  Are influenţă numai la linii, nu şi la textele tipărite.
• Cu parametrul COLOR se alege tipărire color sau alb/negru. Pentru a economisi toner, se tipăreşte color numai denumirea vânzătorului, titlul documentului şi număr exemplare. Culorile sunt în funcţie de numărul exemplarului. Parametrul nu influenţează imprimarea culorii la logo şi watermark.

• Parametrul NR_EX

  • dacă #NR_EX = 1, nu se înscrie numărul exemplarului pe formular.
  • dacă #NR_EX > 1, se înscrie numărul exemplarului, iar dacă #COLOR=D, atunci anumite texte pe primul exemplar se scriu cu albastru, pe al doilea cu roşu, pe al treilea cu verde şi mai departe cu negru. Nu se scrie întregul formular colorat, pentru a nu consuma prea multă cerneală sau toner colorat.

  Observaţie: nu utilizaţi număr exemplar din Tipuri de documente/Format pagina, acolo introduceţi valoarea 1.

• Parametrii LOGO şi WATERMARK: indică fişierele logo şi imagine de fundal semitransparentă (watermark) care servesc pentru personalizarea documentelor. La factură şi aviz zona în care se tipăreşte imaginea de fundal este zona în care se tipăresc rândurile cu articole.
  Crearea imaginilor logo şi watermark.
• Parametrul SIGNATURE: indică un fişier de tip bitmap, conţinând ştampila şi semnătura.
  Se tipăreşte pe toate tipurile de factură şi aviz.
  Nu se tipăreşte pe chitanţe.
  Se tipăreşte în zona rezervată pentru semnătură şi ştampilă.
  Se creează prin scanarea ştampilei şi a semnăturii.
  Se tipăreşte cu dimensiunea de 3.5 x 3.5 cm.
  Pentru ca ştampila şi semnătura să nu fie distorsionate, micşorate, mărite la tipărire, este necesar ca fişierul .bmp să fie creat cu dimensiunile de mai sus.
  Pe factura format A5, semnătura şi ştampila poate să se suprapună peste imaginea watermark, adică fundalul alb din semnătură şi ştampilă să acopere o parte din colţul stânga jos. Dacă se întâmplă acest lucru, activaţi parametrul CULOARE_TRANSP: #CULOARE_TRANSP = 16777215
• Parametrul CULOARE_TRANSP reprezintă culoarea considerată „transparentă“ din fisierul BMP, culoare care nu va fi tipărită efectiv pe imprimantă.
  Funcţionează numai sub sisteme de tip NT.
  16777215 - alb
  Implicit NIL
  Vezi şi parametrul #SIGNATURE.
• Parametrul SABLON este folosit numai în faza de implementare.
  Tipăreşte un şablon peste formular. Se foloseşte pentru determinarea coordonatelor câmpurilor care urmează să fie completate pe formularul pretipărit din hMARFA.
  Dacă parametru COLOR=D, şablonul se tipăreşte cu culoarea roşie !
• Parametrul Vanzator de obicei se defineşte tot în Parametri generali.
  Defineşte liniile tipărite în antetul documentului în zona rezervată vânzătorului. Primele două linii sunt rezervate pentru numele vânzătorului.
  Aceste două rânduri se tipăresc cu caractere mai mari şi color, dacă s-a ales COLOR=D.
  Restul liniilor sunt reproduse cu caractere aldine aşa cum au fost înscrise, fără nici o prelucrare. Pot exista maxim 15 linii pentru descrierea vânzătorului.
  Parametrul Vanzator apare de mai multe ori, pentru fiecare tip de document implementat în hPRINT în secţiunea corespunzătoare tipului de document.
  Secţiunile agreate: [AVIZ], [FACTURA], [FACTURA_A5], [FACTURA_CHITANTA], [FACTURA_FTVA], [CHITANTA].

Fazele următoare ale implementării diferă în funcţie de modalitatea de imprimare a documentelor:

• se tipăresc mai întâi formulare care se completează mai târziu, sau
• se imprimă deodată formularul şi conţinutul.

Mediu pentru tipărire formular

Pentru a asigura modul controlat de tipărire a formularelor, mediul hPRINT poate fi păstrat pe CD sau pe memorie flash, de unde poate fi lansat direct, iar după tipărirea formularelor suportul poate fi scos şi păstrat în siguranţă.

Mediul hPRINT arată astfel:

• DBF\ - bază de date de tip hPRINT,
  • HPRINT\ - subcatalog HPRINT,
    • HPRINT.DBF,DBT - parametrii generali de configurare,
    • LOGO.BMP - opţional. Fişier de tip bitmap conţinând un logo al firmei care va fi tipărit pe formular,
    • TEXT.BMP - opţional. Fişier de tip bitmap conţinând o imagine folosită ca „watermark“ care se tipăreşte pe document în zona în care vor fi tipărite rândurile,
    • SIGN.BMP - opţional. Fişier de tip bitmap conţinând o imagine folosită pentru semnătură şi ştampilă.
      Pe document va fi tipărită în zona rezervată pentru semnătură şi ştampilă.
      Dacă parametrul SIGNATURE este definit, semnătura şi ştampila se tipăreşte pe toate tipurile de factură, aviz şi nu se tipăreşte pe chitanţe.
• hPRINT.EXE - utilitarul de imprimare.

Acest mediu trebuie pregătit pe hard-disk, iar după finalizare se copiază pe CD şi se şterge de pe hard-disk.
Formularele se tipăresc de pe suportul pregătit.

Recomandăm să definiţi parola normală pentru hPRINT.
Astfel, tipărirea formularelor va fi condiţionată de parola normală, ceea ce reduce riscul privind accesul neautorizat.

Recomandăm să definiţi şi parola specială pentru hPRINT.
Astfel modificarea setărilor din Parametri generali de configurare va fi condiţionată de parola specială.

Definiţi parola specială pentru hUTIL, astfel citirea parolelor setate pentru hPRINT la pasul anterior va fi condiţionată de această parolă.

Adaptare formular model hMARFA

Formularul modelulului de document din hMARFA trebuie adaptat în aşa fel încât să se potrivească cu formularul pretipărit.

Imprimaţi din hPRINT un formular cu #SABLON=D. Se va tipări un formular peste care se tipăreşte un şablon. Cu ajutorul şablonului se pot citi coordonatele câmpurilor care urmează să fie completate.
Modificaţi definiţiile pentru documentul hMARFA în Tipuri de documente (Formular, Formule).

Imprimaţi un document din hMARFA pe o hârtie albă. Suprapuneţi pe formularul tipărit la pasul anterior sau cu un formular fără şablon şi verificaţi dacă câmpurile se tipăresc sau nu în căsuţele rezervate pentru informaţiile corespunzătoare.

Modificaţi definiţiile din tipuri de documente în aşa fel, ca documentul să se completeze corect.

În cazul imprimării complete a documentelor (formular + conţinut), utilitarul este folosit împreună cu hMARFA.

În acest caz utilitarul se instalează pe baza de date hMARFA.
Utilitarul presupune cel puţin hMARFA V 6.2, dar pachetul de instalare este corespunzător versiunii de program hMARFA.
Instalarea pe baza de date hMARFA are loc cu ajutorul procedurii de instalare.

Prin lansarea listării, mai intâi se creează fişierul de descriere a documentului, după care se lansează utilitarul hPRINT care tipăreşte efectiv documentul pe imprimantă.

Recomandăm să setaţi Parola specială pentru hPRINT, astfel modificarea Parametrilor generali de configurare va fi conditionată de această parolă.

Recomandăm să definiţi şi o parolă normală pentru hPRINT, deoarece această parolă impiedică lansarea nejustificată a utilitarului.

Definiţi parola specială pentru hUTIL, astfel citirea parolei setate pentru hPRINT la pasul anterior va fi condiţionată de această parola.

Fişierul de descriere a documentului

Descrierea documentului de imprimat se află într-un un fişier text, generat în hMARFA la listarea documentului, pe baza modelului din tipuri de documente şi pe baza parametrilor generali de configurare.

În acest caz, prin listarea documentului rezultă de fapt un fişier care conţine descrierea documentului pentru hPRINT. Prin urmare, definiţia tipului de document din hMARFA trebuie să fie astfel realizată, încăt la ieşire să genereze un fişier de intrare pentru hPRINT.

Este important de înţeles că în hPRINT aspectul final al documentelor rezultă din descrierile existente în parametrii generali de configurare şi fişierul de descriere a documentului.
Cele două descrieri au o sintaxă identică, diferenţa constă în interpretarea lor, aşa cum a fost prezentat mai înainte.
Totuşi cele două descrieri pot să conţină şi informaţii comune. În această situaţie informaţiile din fişierul de descriere le suprascriu pe cele din parametrii generali.

Aşa cum s-a văzut mai înainte, parametrii generali pot fi consultaţi şi modificaţi cu comanda hPRINT dbf /c.

Exemplu:

• în parametrii generali găsim #LUNGIME_FORMULAR = 65
• în fişierul de descriere se generează #LUNGIME_FORMULAR = 64, potrivit documentului hMARFA listat.

În acest caz documentul tipărit de hPRINT va fi procesat cu #LUNGIME_FORMULAR = 64 confrom descrierilor din fişierul de descriere generat de hMARFA.

Chiar dacă parametrii de configurare şi/sau fişierele de configurare lipsesc, utilitarul este funcţional şi va lucra cu datele prestabilite. Un astfel de mod de lucru însă nu are sens.

Detalii despre documentele livrate.

Imprimare documente completate

În comenzi generale va exista în mod obligatoriu scriptul „DOC_PR“.
Logica tipăririi se implementează în acest script.

Scriptul detectează dacă urmează tipărirea unui document obişnuit de tip hMARFA sau a unui document de tip hPRINT.
Pentru documentele hMARFA tipărirea are loc în modul obişnuit.
Pentru documentele de tip hPRINT se generează fişierul de definiţie, după care se apelează utilitarul de tipărire pentru destinaţia IMPRIMANTA sau se listează pe ecran pentru destinaţia ECRAN.

Utilitarul hPRINT este lansat pentru toate documentele al căror model începe cu cuvântul cheie #HPRINT.

La generarea fişierului de definiţie hMARFA sesizează dacă sunt prea multe rânduri şi nu încap pe formular. În acest caz hPRINT nu este lansat.
Acestă logică de fapt este implementată în document prin intermediul câmpului {Pag2HPRINT}.

• > hPRINT dbf /fFACTURA - tipărire formulare de factură A4
• > hPRINT dbf /fFACTURA_A5 - tipărire formulare de factură A5
• > hPRINT dbf /fFACTURA_CHITANTA - tipărire formulare de factură cu chitanţă
• > hPRINT dbf /fFACTURA_FTVA - tipărire formulare de factură fără TVA
• > hPRINT dbf /fCHITANTA - tipărire formulare de chitanţă
• > hPRINT dbf /fAVIZ - tipărire formulare de aviz

Cu aceste comenzi se pot tipări formulare goale.

După lansarea utilitarului se afişează o fereastră în care se completează:

• numărul de formulare dorite,
• eventual seria şi numărul primului formular. De exemplu: ABC 000001, maximum 3 caractere la serie şi 12 litere/cifre la număr. Seria se scrie pe pagină în dreapta-sus.
• eventual numărul de factură al primului formular. De exemplu: 110001, maximum 6 litere/cifre. Numărul se scrie în rubrica Nr.factura.

Recomandăm distribuitorilor să utilizeze varianta cu serie/număr şi să ţină evidenţa formularelor tipărite şi predate la utilizatorii hMARFA într-o fişă.

În cazul documentelor care se vor imprima în mod grafic, la lansarea listării se va alege destinaţia:

• IMPRIMANTA sau
• ECRAN

După generarea fişierului de descriere a documentului, dacă s-a ales IMPRIMANTA se lansează hPRINT pentru a imprima documentul. Documentul se tipăreşte pe imprimanta specificată şi în numărul de exemplare specificat. Dacă s-a ales pe ECRAN, este afişat fişierul de descriere a documentului.

hPRINT este lansat într-un task separat care este pus pe task-bar. Dacă pe parcursul imprimării apare o eroare, mesajul de eroare se afişează şi execuţia hPRINT se suspendă. Dar acest lucru este observat doar după ridicarea„ programului de pe task-bar. Poate să apară de exemplu eroarea:

  EROARE: Eroare de structura. Linia: xx Fisier: DBF\HPRINT\HPRINTxx.TXT...

Lansând din nou listarea pe ECRAN se poate identifica linia: xx care a cauzat eroarea.

În hMARFA, la generarea modelului, trebuie sesizat că sunt prea multe rânduri şi nu încap pe formular. În acest caz hPRINT nu trebuie lansat. Dacă acest test este omis, atunci hPRINT va imprima rânduri şi pe partea de jos a formularului.