Rapoarte în Nexus ERP :: 3.1. Adăugarea şi eliminarea coloanelor

3.1. Adăugarea şi eliminarea coloanelor

Așa cum am văzut în capitolul anterior, majoritatea rapoartelor permit configurarea coloanelor. Iar în funcție de tipul de raport, acest lucru se poate realiza în moduri diferite. Această lecție își dorește tocmai să acopere toate modurile în care se pot adăuga sau scoate coloane dintr-un raport.

### Rapoartele de tip listă de articole
Haideți să exemplificăm direct pe un raport această operațiune de configurare a coloanelor.
1. Deschidem modulul __Facturi Clienți__.
2. Deschidem __Configurare rapoarte__.
3. Ne poziționăm pe un raport.
4. Și alegem pagina de configurare __Campuri__.

În pagina __Campuri__ vedem 2 elemente principale:
- Tabelul de campuri selectate.
- Tabelul de campuri disponibile.

În Tabelul de campuri selectate se găsesc exact coloanele care vor apărea în raport, și acest tabel are două coloane:
- Coloana din dreapta conține denumirea generică a câmpului și aceasta nu poate fi modificată.
- Coloana din stânga conține denumirea care va apărea în capul de tabel din raport și pe aceasta o putem redenumi așa cum dorim.

**Când am avea nevoie să redenumim o coloană?**
- Dacă avem un raport cu foarte multe coloane, putem să rescriem denumirile cu unele prescurtate, astfel încât acestea să apară cât mai vizibile și să nu fie scrise trunchiat pe mai multe rânduri.
- Dacă dorim să facem un raport în limba engleză sau în orice altă limbă.
- Dacă avem pentru anumite coloane niște denumiri personalizate cu care salariații noștri sunt obișnuiți.

Tot acest tabel ne mai oferă funcționalitatea de a elimina coloane, și pentru aceasta va trebui să facem click pe X-ul din dreptul coloanei pe care dorim să o eliminăm. Cum spuneam anterior, câmpurile din acest tabel sunt cele care apar în raport, iar lățimea fiecărei coloane în parte a fost calculată în prealabil - la crearea raportului - ca procent din lățimea unei pagini în funcție de numărul de caractere al coloanei. Dacă dorim să ajustăm manual lățimea de afișare a coloanelor, va trebui să accesăm instrumentul __Configurare avansată coloane__.

Aici putem ajusta:
- Lățimea coloanelor.
- Ordinea acestora în cadrul raportului.
- Alinierea textului unei coloane: stânga, dreapta sau centru.
- Și pentru coloanele numerice putem seta să aibă sau nu afișat un total.
În partea de jos a acestei ferestre avem explicații detaliate privind toate configurările pe care le putem opera aici.

### Tabelul de câmpuri disponibile
Tabelul de câmpuri disponibile, cel din partea dreaptă, ne prezintă o listă de câmpuri din:
- tabelele de bază ale modulului,
- câmpuri din alte tabele cu care se leagă aceste tabele de bază,
- câmpuri din tabele legate în lanț.

De exemplu:
- Tabelul de facturi este legat direct cu tabelul de parteneri, iar tabelul de parteneri este legat, mai departe, de tabelul de clasificare a partenerilor.
- Tabelul de linii facturi este legat direct cu nomenclatorul de produse, iar nomenclatorul de produse este legat de tabelul cu clasificarea produselor și putem merge și mai departe: tabelul de clasificare a produselor este legat de tabelul de grupe de produse.

Revenim la această listă de coloane disponibile. Pentru a adăuga câmpuri noi în raportul pe care-l configurăm, bifăm în această listă coloanele dorite și apăsăm butonul __Includ în raport__. Pentru a salva modificările operate aici avem posibilitatea să salvăm toate modificările într-un raport nou sau să suprascriem raportul curent de la care am plecat. Dacă dorim să vedem cum arată raportul modificat înainte de a-l salva, va trebui să folosim butonul __Afișează raport__. Trebuie să avem în vedere că, dacă părăsim raportul modificat fără să salvăm, vom pierde toate modificările operate. Preventiv, o fereastră de avertizare se va deschide și ni se va propune să salvăm modificările.

### Rapoartele de tip tabel
Același mod de operare, ca cel prezentat anterior, se aplică și în cazul rapoartelor de tip tabel. Bineînțeles, cu particularitatea că setările privind lățimea coloanelor nu vor avea efect aici.

### Rapoartele de tip formular cu antet și subsol HTML
De asemenea, se aplică același mod de operare ca și în cazul rapoartelor de tip listă de articole.

### Rapoartele de tip HTML
În acest caz, tabelele de date nu pot fi configurate în sensul de a adăuga sau scoate coloane. Cel mult, dacă sursa de date conține mai multe seturi de tabele, vom putea schimba un tabel cu altul.

Haideți să vedem cum putem face acest lucru:
- Ne poziționăm pe un raport de tip HTML.
- Trebuie să fim tot în pagina __Campuri__.
- În partea dreaptă, filtrăm după cuvântul tabele și acestea sunt tabelele oferite de sursa de date.
- Le putem trage în coloane ca mai apoi să le putem include în codul HTML (fac o înlocuire de tabel).

Pentru rapoartele de tip HTML, lista de coloane disponibile nu reprezintă coloanele unui tabel. Acestea reprezintă blocuri de informații care pot fi macro-substituite în cadrul raportului HTML.
Iar lista de coloane selectate nu sunt coloane ale unui tabel, ci, la fel, blocuri de informații selectate a fi calculate și pregătite pentru inserarea în raportul HTML.

### Rapoartele de tip Custom
Rapoartele Custom, bineînțeles, așa cum rezultă și din denumirea lor, sunt customizabile și sunt bazate pe funcții custom. Coloanele pe care le dorim a fi disponibile în cadrul raportului, în prealabil, vor trebui selectate sau construite de funcția custom asociată raportului. În rest, modul de operare privind adăugarea și eliminarea de coloane este identic cu cel de la rapoartele de tip listă de articole. Am pregătit două funcții custom. Deschidem modulul __Funcții Customizate__ din __Instrumente__.
Primul raport este de tip standard, adică are definită o structură de date, iar funcția noastră va insera datele selectate în această structură.

Avantajele utilizării funcțiilor standard sunt următoarele:
- O claritate mai bună a codului.
- Posibilitatea de a defini strict tipurile de date.
- Posibilitatea ca înainte de a face insertul să putem face diverse calcule, să pregătim fișiere temporare, să citim din setări diverși parametri etc.

Pentru a fi mai ușor de înțeles, am făcut un exemplu relativ simplu: selectăm dintr-un view cu facturi de clienți câteva câmpuri și punem condiția de selecție ca data facturii să fie mai mare sau egală cu această dată de start și valoarea facturii să fie mai mare sau egală cu media facturilor. Data start este calculată mai sus ca data curentă, data de azi, minus 90 de zile, iar valoarea medie a unei facturi este calculată aici. Cu alte cuvinte, vom obține o listă cu facturile din ultimele 90 de zile care depășesc media vânzărilor per factură. Mai multe detalii privind construcția funcțiilor custom vom vedea într-o lecție viitoare care este destinată exclusiv rapoartelor cu funcții custom.

Această funcție face exact același lucru ca și cea anterioară, numai că codul este mult mai complicat atât de scris, cât și de citit. Cu cât vom avea nevoie de funcții mai complexe, cu atât complexitatea codului funcțiilor inline va crește. Revenim acum la fereastra noastră de configurare a rapoartelor. Deci, presupunând că avem deja una sau mai multe funcții custom pentru rapoarte, haideți să vedem cum le putem folosi.

Din meniul superior apăsăm butonul __Funcții customizate__, apoi din meniu selectăm Import din funcții customizate, bifăm rapoartele pe care dorim să le adăugăm și apăsăm __Salvez__. În continuare, vom vedea că putem să configurăm câmpurile exact ca și la celelalte rapoarte. Trebuie să avem în vedere că la import toate câmpurile definite în funcția custom au fost deja inserate în __Coloane__. Dacă sunt unele de care nu avem nevoie în raport, le putem scoate din coloane și se vor muta în lista de câmpuri disponibile.

### Rapoartele create cu designerul Devexpress
Asupra acestor rapoarte, ca utilizatori cu medii cunoștințe IT, nu putem interveni pentru a adăuga și/sau scoate câmpuri. Cum am amintit și în lecțiile anterioare, va trebui să apelăm la specialiști IT, în speță programatori, care ne vor putea ajuta să configurăm acest tip de rapoarte.
Închei aici această lecție și sper că am reușit să vă ofer cunoștințele necesare și curajul de a vă configura singuri coloanele rapoartelor. După cum ați văzut, este destul de simplu.

Timp	Denumire	Căutare aditională	Chei cautare
00:00:47	Rapoartele de tip listă de articole	tabel,selectate,disponibile	rapoart,tip,list,articol,tabel,selectate,disponib
00:02:08	Când am avea nevoie să redenumim o coloană?	limba,engleza,denumiri,personalizate	am,ave,nevoi,redenum,coloan,limba,engleza,denumiri,personaliz
00:04:17	Tabelul de câmpuri disponibile	lista,lant,legat,coloane,includ	tabel,campur,disponib,lista,lant,legat,coloane,includ
00:06:18	Rapoartele de tip tabel		rapoart,tip,tabel
00:06:39	Rapoartele de tip formular cu antet și subsol HTML		rapoart,tip,formular,antet,subsol,html
00:06:55	Rapoartele de tip HTML	Coloane,campuri,tabel	rapoart,tip,html,coloane,campuri,tabel
00:09:16	Rapoartele de tip Custom	functie,media,vanzarilor,	rapoart,tip,custom,functie,media,vanzarilor,
00:13:24	Rapoartele create cu designerul DevExpress		rapoart,creat,designer,devexpress

	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?"); }`