3. Ferestre, Tab-uri & Câmpuri

În fereastra Ferestre, Tab-uri & Câmpuri din meniul Dicţionarul Aplicaţiei se defineşte prezentarea tabelelor şi coloanelor în fiecare fereastră. Un tab dintr-o fereastră se referă la o singură tabelă. Câmpurile din taburile unei ferestre se referă la coloanele unei tabele.

Ferestre

În fereastra Ferestre, Tab-uri & Câmpuri se definește fiecare fereastră a sistemului. Se completează câmpurile:

• Denumire - numele ferestrei, se va afişa în zona de titlu a ferestrei şi în meniul Socrate. Sistemul va sincroniza numele ferestrei cu entitatea meniu.

• Tip Fereastră - determină comportamentul ferestrei atunci când este accesată. Ex:

  • Menţinere -  toate înregistrările active sunt returnate

  • Tranzacţie - doar înregistrările care au fost create sau modificate azi vor fi afişate. De obicei când se lucrează cu ferestre tranzacţii (ex. Facturile) nu se doreşte afişarea tranzacţiilor de acum 2 ani.

Butonul Copiază Taburi permite copierea taburilor din ferestre deja definite.

În tab-ul Acces se introduc rolurile care au acces la fereastră.

Se poate seta la nivel de System, în fereastra cu același nume (System) informația ”Timeout Grid” și ”Timeout rapoarte/procese” ce reprezintă timpul de așteptare maxim pentru încărcarea informațiilor unui grid (ferestre sau info window) sau ale unui raport/proces. Sunt utile aceste setări în vederea protejării resurselor serverului în cazul în care apar interogări greșite ce ar duce la cererea unui volum foarte mare de date în mod inutil.

Taburi

În tabul Tab se defineşte fiecare tab a unei ferestre. Fiecare tab se referă la o singură tabelă sau un singur endpoint de API Extern. 

Se completează câmpurile:

• Denumire - numele tab-ului;

• Sursă Date - sursa de date pentru tab. Acest câmp se poate completa doar adăugare tab nou. După salvare înregistrare nu se mai poate modifica. Valori posibile Tabelă, API Extern;
  Taburile cu Sursă Date = API Extern sunt totdeauna read-only. De asemenea nu au funcționalitățile de Căutare, Atașament, Raport, Printare, Trimitere EMail și Blocare Înregistrare

• Tabelă - determină ce câmpuri sunt disponibile pentru afişare cât şi tabela care va fi updatată la adăugarea, modificarea sau ştergerea unei înregistrări în acest tab. Se poate completa doar dacă Sursă Date = Tabelă

• API Extern - determină ce Endpoint API Extern va fi folosit pentru a aduce datele pentru afișare. Se poate completa doar dacă Sursă Date = API Extern.

• Endpoint API Extern - indică ce câmpuri sunt disponibile pentru afișare cât și endpoint-ul de unde se vor aduce datele. Se poate completa doar dacă Sursă Date = API Extern.

• Secvență - determină ordinea tabului în fereastră. Iniţial sistemul va incrementa secvenţa de la valoarea 10 pentru fiecare tab nou adăugat.

• Nivel Tab - determină dacă tabul este o înregistrare copil sau un tab anterior.

  • 0 - tabul este parinte

  • 1 - tabul este copilul tabului principal

  • 2 - tabul este copilului tabului cu nivel 1 cu secvența imediat anterioară;

• Proces - se indică procesul care printează un document şi este disponibil pentru acest tab.

• Single Row Layout - se bifează pentru ca la deschiderea afişarea să fie de tip înregistrarea singulară

• Tab Avansat, Tab contabilitate şi Tab Traducere - se bifează dacă afişarea acestui tab va fi controlată de setările definite în Preferinţe.

• Verificare Atașamente - se bifează dacă pe acest tab se va actualiza în mod dinamic iconul de ataşamente.

• Afișat şi Read-Only - prin bifarea permite definirea de reguli pentru controlşul afişării şi modificarea unui tab.
  Tabul este totdeauna Read-Only pentru Sursă Date = API Extern.

• Read Only Logic - dacă expresia introdusă aici este evaluată ca fiind adevărată, atunci toate informațiile din tabul respectiv devin ”read only” (needitabile), indiferent de înregistrarea pe care ești poziționat.

  • Read Only Logic All Fields - dacă expresia introdusă aici este evaluată ca fiind adevărată, atunci toate informațiile din tabul respectiv devin ”read only” (needitabile), dar dependent de înregistrarea pe care ești poziționat. Evaluarea expresiei se face pentru fiecare înregistrare în parte. Ca excepție de la regulă, câmpurile marcate în tabela ca fiiind ”Modificabil oricând” nu vor deveni ”read only” (râmân editabile tot timpul). În fapt, regula scrisă aici este aplicată pentru toate câmpurile din tabul respectiv ca și cum ar fi setată la nivel de coloană pe tabela aferentă.

    • se pot folosi expresii logice ce conțin variabile de context global (ex: @##AD_User_ID@), exact în forma aceasta (2 diezi !!!).

    • exemplu de obținere read only pe înregistrările introduse de către alți utilizatori decât utilizatorul logat: @##AD_User_ID@!@CreatedBy@.

• Commit Warning - dacă se completează, la salvarea unei înregistrări afișate în acest tab va fi afișat mesajul completat, cu opțiunea de a readuce înregistrarea la starea inițială.

• este disponibil câmpul Actualizare automată în (min:), prin care se poate seta reactualizarea automata a datelor în mod vizualizare "grid" a tabului respectiv. 

  • • se pot seta doar valori întregi, care reprezintă numărul de minute la care se face actualizarea datelor

    • după setarea unei valori în acest câmp, în interfață, pe tabul respectiv, va aparea o bifă, Actualizare automată, lângă butonul Refresh

      • valoarea implicită a acestei bife este False

      • pentru activarea actualizaii automate pe tab a datelor va trebui ca această bifa sa fie setata cu valoarea True

Câmpuri

În tab-ul Câmpuri se definesc câmpurile care se afişează într-un tab. Modificările efectuate în tab - ul Câmpuri devin vizibile după o resetare de cache. Dacă secvenţa introdusă este negativă înregistrările sunt ordonate descendent. Dacă menţinerea se realizează la nivel central numele, descrierea şi comentarii/ajutor sunt sincronizate automat.

   Câmpurile Denumire şi Coloană sunt obligatorii. Lista de coloane disponibile pentru selecţie se bazează pe tabela definită pentru tab. Denumirea, Descrierea şi Comentarii/Ajutor se vor sincroniza din definirea coloanei. Dacă într-o anume fereastră se doreşte folosirea unei etichete diferite pentru câmp se completează manual câmpurile şi se debifează căsuţa Întreţinere centralizată  

Alte atribute ale Câmpurilor care vor afecta afişarea, sunt:

• Grup Câmpuri - se alege grupul din care face parte câmpul. Pentru câmpurile ce au setate un grup se poate bifa Implicit restrâns. La deschiderea unei ferestre, grupurile marcate asfel vor fi implicit restrânse. 

  • • se se pot defini câmpuri obligatorii în secțiuni implicit restrânse. Până la această versiune la salvare nu se ținea cont de obligativitatea câmpurilor respective;

• Afişat - se bifează pentru afişarea câmpului. Dacă un câmp nu este necesar într-o implementare specifică se debifează

• Read Only - bifa indică faptul că respectivul câmp nu poate fi modificat

• Logică ReadOnly - logică specifică pentru câmp/fereastră, având aceiași sintaxă ca logica de afișare. Dacă există setată și logică pe coloană și rezultă ca fiind adevărată (true), atunci nu se mai ține cont de logica de pe câmp/fereastră.

• Logică Afișare - logică specifică pentru câmp/fereastră.

• • reguli și exemple de operatori:

    • paranteze pentru stabilirea precedenței

    • '|' = sau

    • '&' = și

    • '='  = egal

    • '!' = diferit

  • exemple de completare:

    • @R_Status_ID@=1003025 | @R_Status_ID@=1003037 | @R_Status_ID@=1002693

    • @TokenType@!Q

    • @$Element_U1@=Y & @AnyUser1@=N

    • (@Order_Receive_Status@=NEW | @Order_Receive_Status@=STR) & @IsFreeInOut@=Y

      • @Inventory_Status@ = STR & (@SCWI_NoTasks@=N | @IsCompleteAllData@=Y) & @IsOrderTasksFinished@=Y

      • @Name@ = '' (Pentru verificare că o coloană de tip alfanumerică este nulă)

      • @C_Order_ID@ = 0 (Pentru verificare că o coloană de tip ID este nulă)

  • Secvenţa şi Acelaşi Rând - determină unde va fi afişat în fereastră

  • Default Focus - bifa indică că la o nouă înregistrare cursorul utilizatorului va fi poziţionat în acest câmp

  • Encrypted - dacă este bifa pusă atunci valorile din acest câmp nu se vor mai vedea din interfață (ex: ”********”). Această setare are efect și asupra rapoartelor ce conțin această coloană, aceasta nemaifiind afișată!

  • Obscure - dacă este aleasă o variantă atunci valorile din acest câmp nu se vor mai vedea din interfață în mod complet (ex: ”*******1234”). Această setare are efect și asupra rapoartelor ce conțin această coloană, aceasta nemaifiind afișată!

Tab-ul Suprascriere permite suprascrierea regulilor definite la nivel de tabelă și coloană:

• • Validare Dinamică - regulă de validare aditivă la regula definită pentru coloană;

    • Atenție: nu înlocuiește regula definită pentru coloană!

Definire Fereastră Nouă

SocrateCloud permite definirea de ferestre noi la nivel de titular. Pentru a defini o fereastră sunt necesari următorii pași:

• 1. se introduce o înregistrare nouă în fereastra Ferestre, Tab-uri & Câmpuri, localizată în meniul Dicționarul Aplicației, conform regulilor prezentate mai sus;

  2. opțional, la nivel de fereastră, se poate utiliza butonul Copiază taburi pentru a copia tab-urile dintr-o fereastră existentă;

  3. optional, la nivel de tab, se poate utiliza butonul Generează Câmpuri pentru a genera câmpuri pentru tab, pe baza coloanelor din tabelă sau butonul Creează Câmpuri Tab pentru a genera câmpuri pe baza unui alt tab care utilizează aceiași tabelă;

  4. opțional, se pot adăuga câmpuri virtuale care să aducă valori din coloane ale unor entități referite. Entitățile referite sunt cele de tip combobox, care au la randul lor fereastră (au detaliere din câmp). De asemenea, mai pot fi câmpuri de tip Adresa,  tip Instanță set proprietăți,  tip Cont contabil.

Câmpurile virtuale: 

• 1. 1. • se pot defini la nivel de titular pe ferestre customizate de entități sau documente. Pot fi adăugate și pe rapoarte și formate de tipărire;

        • se pot introduce atât pe master cât și pe tab-uri și subtab-uri (tab de orice nivel: 0, 1, 2) ;

          • • În câmpul “Coloană” se precizează coloana de pe care se dorește preluarea atributului dorit;

            • bifa “Este câmp virtual” devine vizibilă doar dacă se alege o tabelă care permite preluarea de câmpuri virtuale;

            • când se pune bifa “Este câmp virtual”, se deblochează “Câmp virtual”, unde sunt disponibile spre selecție doar entitățile prezente în tabela selectată 

        • vor fi readonly, întrucât scopul lor este de afișare a informației în fereastră, nu de modificare/introducere;

        • se populează cu valori după salvarea master document sau linie document (în funcție de nivelul la care au fost adăugate);

        • pot fi folosite în căutări, căutare avansată, sortare, grupare, etc (câmpurile virtuale apar în grid);

  2. după definirea tuturor câmpurilor și tab-urilor, fereastra trebuie adăugată la meniul SocrateCloud prin crearea unei înregistrări corespunzătoare în fereastra Meniu;

  3. de asemenea trebuie efectuate setările corespunzătoare la nivel de rol.

Obs: 

• 1. Ferestrele custom  cu Tip Fereastră  "User maintained", definite de utilizatori cu procesul ”Copiază Taburi”, vor avea taburile și câmpurile copiate, traduse. Traducerea este identică cu traducerea din taburile și câmpurile ferestrei sursă.

  2. Ferestrele custom, cu Tip Fereastră  "User maintained" nu beneficiază automat de modificările, actualizările aduse ferestrelor standard de către BITSoftware, prin procesul de migrare aplicație. 

Utile:

1. sintaxă sql pentru adăugarea de câmpuri virtuale care prezintă valorile atributelor articolelor care prin definiție au indicat un set de atribute:

SELECT ai.M_Attribute_ID

FROM M_AttributeSetInstance asi

JOIN M_AttributeInstance ai ON (ai.M_AttributeSetInstance_ID = asi.M_AttributeSetInstance_ID)

JOIN M_AttributeUse au ON (au.M_AttributeSet_ID = asi.M_AttributeSet_ID AND au.M_Attribute_ID = ai.M_Attribute_ID)

WHERE asi.M_AttributeSetInstance_ID = M_AttributeInstance.M_AttributeSetInstance_ID

ORDER BY au.SeqNo

LIMIT 1 OFFSET 0

unde ”OFFSET 0” va returna valoarea din primul atribut alocat articolului, ”OFFSET 1” va returna valoarea celui de al 2-lea atribut al articolului, șamd.

Configurare Fereastră de Detaliere Personalizată pentru Câmpuri de Referință 

Pentru a permite controlul asupra ferestrei de destinație accesată prin opțiunea de detaliere (click dreapta/zoom) pe câmpurile de referință dintr-o fereastră personalizată, a fost introdusă posibilitatea de a configura explicit fereastra care se va deschide la utilizarea acestei funcționalități.

În lipsa unei configurări explicite, se aplică mecanismul standard de detaliere.

Configurare:

• Configurarea se realizează în ecranul de definire câmp fereastră, în subtab-ul Fereastră detaliere câmp.

• Subtab-ul este disponibil doar pentru câmpurile care suportă detaliere (zoom), inclusiv în layout-ul minimal al ferestrei.
  
  

Reguli de Configurare

• Pentru un câmp pot fi definite mai multe ferestre de detaliere, corespunzătoare unor perechi societate–rol.

• Rolul este opțional. Dacă nu este specificat, configurația este aplicabilă tuturor rolurilor pentru societatea respectivă.

• Pentru o pereche unică societate–rol poate exista o singură înregistrare.
  
  

Niveluri de Definire

1. La nivel de Titular

   • Se pot defini ferestre de detaliere pentru câmpuri din ferestre standard sau user maintained definite pe titular.

   • Configurațiile sunt aplicabile exclusiv titularului respectiv.
     
     

2. La nivel de System

   • Se pot defini ferestre de detaliere pentru câmpuri din ferestre standard sau user maintained definite pe System.

   • Configurațiile sunt aplicabile tuturor titularilor.

   • Aceste ferestre se definesc doar pentru societatea * și fără rol.

Atenție: Se poate selecta orice fereastră în câmpul de configurare, însă dacă aceasta nu este aplicabilă pentru câmpul sursă, va fi ignorată fără eroare, iar sistemul va căuta următoarea fereastră validă conform algoritmului descris mai jos.

Ferestrele de detaliere personalizate sunt utilizate doar pentru câmpurile din ferestre. Nu se aplică pentru câmpuri din formulare sau parametri proces.

Algoritm de Determinare a Ferestrei de detaliere/Zoom

La inițierea detalierii (zoom) pe un câmp dintr-o fereastră, sistemul determină fereastra de deschidere utilizând următoarea succesiune (este utilizată prima fereastră accesibilă utilizatorului și care poate afișa înregistrarea):

1. Fereastra zoom custom definită pe titular, pentru rolul utilizatorului și societatea documentului sursă.

2. Fereastra zoom custom definită pe titular, pentru rolul utilizatorului și una din societățile părinte ale societății documentului sursă (se parcurg în ordine ierarhică).

3. Fereastra zoom custom definită pe titular, pentru rolul utilizatorului și societatea *.

4. Fereastra zoom custom definită pe titular, fără rol, pentru societatea documentului sursă.

5. Fereastra zoom custom definită pe titular, fără rol, pentru una din societățile părinte ale societății documentului sursă (se parcurg în ordine ierarhică).

6. Fereastra zoom custom definită pe titular, fără rol și pentru societatea *.

7. Fereastra zoom definită pe System pentru câmpul respectiv (valabil doar pentru ferestrele definite pe System).

8. Fereastra determinată de mecanismul standard de zoom.