Rapoarte în Nexus ERP :: 2.3. Formatarea rapoartelor

2.3. Formatarea rapoartelor

În Nexus există mai multe tipuri de rapoarte și fiecare tip în parte are o formatare specifică. E important să cunoaștem aceste moduri de formatare, deoarece ne vor ajuta să înțelegem mai bine care sunt opțiunile noastre atunci când dorim să personalizăm un anumit raport.

### Raportul standard de tip listă de articole
Acesta este cel mai întâlnit tip de raport din Nexus, pentru exemplificare deschidem modulul __Facturi clienți__ și din meniul __Rapoarte__ alegem primul raport care apare în acest meniu: __Borderou Facturi Clienți__. Am inclus, în prealabil, în acest raport filtre și grupări și am setat și o imagine pentru logo.
Ca paranteză, haideți să vedem și cum putem include în rapoartele noastre un logo al firmei pe prima pagină a raportului, în colțul din dreapta sus. Este destul de simplu: va trebui doar să copiem în subdirectorul Reports din directorul unde am instalat aplicația Nexus un fișier cu extensia JPG și denumirea logo_antet_ urmată de denumirea societății noastre. Pentru cazul prezentat de noi în acest curs, fișierul se va numi: logo_antet_cursurisrl.jpg.

Încheiem aici paranteza. Haideți să analizăm, rând pe rând, componentele raportului:
Avem trei mari grupe de informații:
1. Antetul raportului.
2. Corpul raportului.
3. Subsolul raportului.
**Antetul raportului** este format din mai multe elemente, și anume:
- În partea din stânga-sus apare așa-numitul "Antet al firmei - Denumire, cod fiscal, telefon și așa mai departe".
- În partea din dreapta-sus apare o imagine cu logo-ul firmei.
- Titlul raportului.
- Informații privind perioada pentru care s-a efectuat raportul.
- Informații despre eventualele filtre aplicate raportului.
- Și un text opțional pe care-l putem adăuga în antetul raportului.
Antetul se finalizează cu așa-numitul capul de tabel al raportului.
Acesta este antetul primei pagini din raport. Antetul celei de a doua pagini și al următoarelor este mult mai simplu și conține doar:
- Numele firmei.
- Denumirea raportului.
- Capul de tabel al acestuia.

**Corpul raportului** este un tabel, corelat cu capul de tabel din antet, care poate conține grupări și subtotaluri. În cazul nostru, am adăugat 2 grupări:
- Clasificarea clientului.
- Județul din adresa clientului.
Ca particularitate, trebuie să știm că acest tabel poate fi afișat și pe mai multe rânduri atunci când numărul de coloane este foarte mare. De exemplu, rapoartele de la salarii, de genul statelor de plată, pot fi afișate și pe 3 rânduri.

Am ajuns și la **Subsolul raportului**. Acesta poate conține:
- Totalul general al raportului.
- Un text opțional pentru diverse explicații.
- Zona de semnături.
Acesta este subsolul de pe ultima pagină a raportului. Mai există un subsol care apare pe toate paginile raportului, scris cu albastru, și care, conform legii contabilității, conține următoarele informații:
- Data și ora când a fost creat raportul.
- Utilizatorul care a executat raportul.
- Denumirea aplicației și versiunea acesteia care a creat raportul.
- Numărul paginii din cadrul raportului.
Cum spuneam, această formatare este valabilă pentru toate rapoartele de tip listă de articole.

### Rapoartele formular cu antet și subsol de tip HTML
Rapoartele de tip formular sunt cele care conțin un document, cum ar fi de exemplu: Facturile, Comenzile, Bonurile de consum, și așa mai departe. Ceea ce este particular la acest tip de rapoarte este că le putem configura, particulariza folosind o notație simplă numită taguri HTML - aceste taguri sunt folosite pentru paginile web. Haideți să vedem un exemplu în care este folosit acest tip de raport. Vom deschide __Facturi Clienți__, apoi deschidem __configurare rapoarte__.
Aici am salvat deja un raport numit Formular Factură Client - HTML.  Mergem în pagina __Texte__, vedem că în zona de antet există 3 zone de date și în zona de subsol avem, de asemenea, definite 3 zone de date. Haideți să executăm acest raport pentru a înțelege mai bine unde sunt poziționate aceste zone.
Cum am văzut în configurare, există 3 zone în antet și 3 zone în subsol. Toate aceste zone sunt complet configurabile, putem scrie orice dorim aici. Ca și formatare, acest raport are 3 mari zone:
1. O zonă de antet, în care intră inclusiv capul de tabel.
2. O zonă de subsol, în care intră inclusiv linia de total.
3. O zonă de date în care, în cazul acestui raport, sunt publicate produsele vândute, cu: preț, cantitate și așa mai departe.
Ne întoarcem în pagina de configurare și modificăm denumirea raportului să apară pe 2 rânduri. Dăm un enter aici sau scriem tag-ul `< br >`, adică break. Mai facem încă o dată raportul și observăm modificarea. Ne întoarcem iar în pagina de configurare. Dacă dorim să modificăm zona de date, mergem în pagina __Campuri__ și aici putem adăuga sau scoate câmpuri. Pentru a scoate un câmp, apăsăm pe X-ul acesta, iar dacă dorim să adăugăm câmpuri, bifăm în lista din dreapta câmpurile dorite a fi adăugate în raport, după care apăsăm de aici de jos butonul __Includ în raport__.

### Rapoarte de tip HTML
Pentru a crea astfel de rapoarte, utilizatorii trebuie să aibă cunoștințe mult mai avansate privind crearea paginilor HTML. Avantajul este că pot formata sau picta întreaga pagină după cum doresc. Am făcut un exemplu tot cu o factură. Ne poziționăm în __Configurare rapoarte__ pe __Formular factură produse cu poze - Complet HTML__. Mergem în pagina __Texte__ și vedem că aici avem format text HTML, iar raportul este scris mai jos. Vom vedea că se folosesc niște macrosubstituții pentru a include date în pagina HTML. Cum sunt acestea de aici... Câmpul care va fi înlocuit va începe cu # și % și se va termina cu % și #.

În pagina __Campuri__ adăugăm, din sursa de date, câmpurile pe care dorim să le folosim în raport, apoi luăm denumirea care apare aici și o punem în pagina HTML folosind notația cu # și %. Nu este foarte complicat. Acum haideți să vedem cât de ușor putem, de exemplu, modifica culoarea de fundal a unei coloane pentru a o evidenția. O să modificăm coloana denumire produs și o să-i dăm și un padding de 10 px. O să punem o culoare care iese mai ușor în evidență:
__background-color: moccasin; padding: 10px;__
Codurile de culori HTML pe care le puteți folosi le găsiți pe unul din site-urile noastre utilitare [html-colors-table.nxm.ro](http://html-colors-table.nxm.ro). Puteți folosi, ca și în exemplul meu, direct denumirea sau codul culorii. Acest tip de raport nu are o formatare impusă. Puteți să includeți într-un raport mai multe tabele, tabele care au coloane diferite.
Recomandarea este de a crea cu acest tip de raport documente personalizate precum:
- Contracte
- Acte adiționale la contracte
- Certificate de garanție 
și altele asemănătoare.

### Rapoartele Custom
Rapoartele de tip listă de articole cu funcții custom și rapoartele de tip formular cu funcții custom au o formatare identică cu rapoartele prezentate la începutul lecției, și anume:
- Rapoartele de tip listă de articole
- Rapoartele de tip formular cu antet și subsol HTML
De aceea, nu le vom mai prezenta încă o dată. Vom vorbi doar despre diferențele aduse de utilizarea funcțiilor custom. La rapoartele despre care am vorbit până acum, sursa de date era oferită de sistemul ERP și era fixă, iar noi puteam să configurăm rapoartele folosind câmpurile existente în acea sursa de date.
Funcțiile custom ne oferă o sursă de date personalizabilă, putem chiar să creăm câmpuri noi prin concatenarea altora sau prin diverse calcule mai mult sau mai puțin complexe. Adică, putem scrie o comandă SELECT, oricât de complexă, care să ne întoarcă un set de câmpuri pe care le vom folosi în crearea raportului pe care vrem să-l obținem. Nu vom face aici un exemplu de creare a unui raport folosind funcții custom, deoarece există o lecție specială care se va ocupa doar de acest lucru.

### Rapoartele de tip formular de tip REPX (Devexpress)
Rapoartele de tip formular REPX se pot configura folosind designerul de rapoarte Devexpress. Aceste rapoarte au în principiu, ca formatare, aceeași structură generală ca și celelalte rapoarte, adică antet, zona de date și subsol. Numai că acestea pot avea formatări mult mai complexe și este recomandat să se utilizeze aplicația de design de la Devexpress doar de către utilizatori care au cunoștințe IT avansate. Și inclusiv pentru aceștia este necesară o instruire specială prealabilă. Noi nu vom face această instruire aici. Doritorii pot accesa site-ul Devexpress.com pentru a căuta resurse și manuale de instruire. Aici doar vă vom prezenta cum intrăm în modul de editare a raportului și cum putem salva o variantă nouă a unui raport. Varianta inițială livrată de ERP nu o vom putea suprascrie.
Haideți să vedem cum arată un astfel de raport: Intrăm în zona de __Configurare__, ne poziționăm pe __Factura internă__. Vedem că nu avem acces la câmpuri și nici la texte, în schimb avem foarte multe setări. Toate aceste setări sunt, de fapt, parametri care vor fi utilizați în mod programatic în cadrul raportului. Deschidem acest raport în vizualizare. Așa cum vă spuneam, raportul are o zonă de antet, o zonă de date și o zonă de subsol. 
Haideți să vedem de unde deschidem designerul în editare: Apăsăm __File__ și din meniu selectăm __Personalizare raport__. După cum am amintit și anterior, există mai multe zone care pot fi activate sau dezactivate în mod programatic. Tot aici vedem și controale de diverse tipuri: imagini, text, tabele, și așa mai departe.
Dacă operăm modificări asupra raportului și dorim să le salvăm, apelăm __Save__ sau __Save As__ din meniul __File__. Iar raportul nostru va fi salvat pe disc, cu extensia .repx, în locația pe care o alegem. Este recomandat să salvăm rapoartele în subdirectorul Reports din directorul Nexus. Iar în cazul formularelor de factură, să le lăsăm prefixul Factura personalizată. Vom vedea că în acest fel vom putea selecta modelul de factură din setările raportului.

Ne oprim aici cu informațiile privind formatarea rapoartelor și vom dezvolta mai mult subiectele discutate aici pe măsură ce le vom reîntâlni în lecțiile următoare.
Vă mulțumesc pentru atenție și vă aștept la următoarea lecție!

Timp	Denumire	Căutare aditională	Chei cautare
00:00:15	Formatarea rapoartelor	Personalizare,tip,specifica,moduri	format,rapoart,personalizare,tip,specifica,modur
00:00:49	Raportul standard de tip listă de articole	facturi,clienti,borderou,logo,reports,antet,jpg,corp,subsol,cap de tabel,zona de date,clasificare,total general,semnaturi	raport,standard,tip,list,articol,facturi,clienti,borderou,logo,reports,antet,jpg,corp,subsol,cap,tabel,zon,date,clasificare,total,general,semnatur
00:05:22	Rapoartele formular cu antet și subsol de tip HTML	factura,comanda,bon de consum,tag,zona,date,br,break,	rapoart,formular,antet,subsol,tip,html,factura,comanda,bon,consum,tag,zona,date,br,break,
00:08:20	Rapoarte de tip HTML	complet,macrosubstituții,#,%,culoare de fundal,padding,cod,formatare,contracte,acte,aditionale,certificate,garantie	rapoart,tip,html,complet,macrosubstitutii,#,%,culoar,fundal,padding,cod,formatare,contracte,acte,aditionale,certificate,garant
00:11:55	Rapoartele Custom	lista,articole,formular,functii,Select,set,campuri	rapoart,custom,lista,articole,formular,functii,select,set,campur
00:13:38	Rapoartele de tip formular de tip REPX (Devexpress)	design,cunostinte,IT,avansate,instruire,configurare,setari,parametri,editare,personalizare,raport	rapoart,tip,formular,repx,(devexpress),design,cunostinte,it,avansate,instruire,configurare,setari,parametri,editare,personalizare,raport

	Sintaxa	Exemplu
H1	#Exemplu titlu H1	Exemplu titlu H1
H2 (cu meniu subcapitol)	##Exemplu titlu H2	Exemplu titlu H2
H3	###Exemplu titlu H3	Exemplu titlu H3
H4	####Exemplu titlu H4	Exemplu titlu H4
H5	#####Exemplu titlu H5	Exemplu titlu H5
H6	######Exemplu titlu H6	Exemplu titlu H6
Italic	_text italic_ text italic	Exemplu de text italic
Bold	__text bold__ text bold	Exemplu de text bolt
Link	[click aici](https://docs.nexuserp.ro)	click aici
Imagine	![text](https://docs.nexuserp.ro/dist/docs.nexuserp.ro/logo.png)
Imagine cu chenar	![text](https://docs.nexuserp.ro/dist/docs.nexuserp.ro/logo.png "blue") "blue" "red" "yellow" "black"
Video YouTube	![text](https://www.youtube.com/watch?v=VNGMRjiXvjs&ab_channel=NEXUSMEDIAS.R.L.)
Prezentare Power Point (Google Slides)	![text](https://docs.google.com/presentation/d/e/2PACX-1vSJ0lj6ldwUqV9FJ9RFuW6wwgnnx4J3i4tj9E32rV2GdYhFRrHldCP52OFy2R8hbK0MiJQ3JAwdbG5V/pub?start=false&loop=false&delayms=3000) Pentru a obține link-ul: Din prezentare selectați Fișier > Publicați pe web > Link > Publicați > OK
Lista	* primul element * al doilea element * subelement 1 * subelement 2 * al treilea element	primul element al doilea element subelement 1 subelement 2 al treilea element
Chenar albastru (default)	> text care va fi incadrat intr-un chenar	text care va fi incadrat intr-un chenar
Chenar rosu	>(red) text care va fi incadrat intr-un chenar rosu	text care va fi incadrat intr-un chenar rosu
Chenar galben	>(yellow) text care va fi incadrat intr-un chenar galben	text care va fi incadrat intr-un chenar galben
Chenar verde	>(green) text care va fi incadrat intr-un chenar verde	text care va fi incadrat intr-un chenar verde
Chenar cu mai multe linii	>(red) text care va fi incadrat intr-un chenar, prima linie > text de pe a doua linie	text care va fi incadrat intr-un chenar, prima linie text de pe a doua linie
Text preformatat	``` function test() { console.log("aceasta este o functie?"); } ```	`function test() { console.log("aceasta este o functie?"); }`