Reguli de validare

​

Ce sunt regulile de validare?

O regulă de validare este o condiție care trebuie să fie adevărată înainte ca o înregistrare să poată fi creată sau actualizată. Dacă condiția este falsă, Twenty blochează salvarea și afișează un mesaj care explică ce trebuie modificat. Folosește reguli pentru a solicita informații la momentul potrivit, cum ar fi o valoare înainte ca o oportunitate să devină client, sau pentru a preveni valori inconsecvente, cum ar fi o dată de încheiere anterioară unei date de început.

​

Creează o regulă de validare

1. Accesează Setări → Model de date și selectează obiectul pe care vrei să îl configurezi.
2. Deschide fila Setări, găsește Reguli de validare și fă clic pe Adaugă o regulă.
3. Dă regulii un nume și, opțional, o descriere care să îi explice scopul.
4. Scrie o Condiție. Începe să tastezi un nume de câmp sau o funcție și selectează sugestii din panoul de asistență.
5. Sub Eroare, introdu un Mesaj care le spune utilizatorilor cum să corecteze înregistrarea. Folosește Afișează în pentru a o atașa la un anumit câmp sau selectează Întreaga înregistrare.
6. Verifică Previzualizarea pentru a vedea cum se comportă condiția pentru înregistrările existente.
7. Fă clic pe Activează pentru a începe să aplici regula.

Regulile noi rămân inactive până le activezi. O regulă are nevoie de un nume, de o condiție validă și de un mesaj de eroare înainte de a putea fi activată.

​

Previzualizează regula

Previzualizarea folosește până la trei înregistrări recente din obiectul selectat. Folosește săgețile pentru a te deplasa între ele și a verifica valorile utilizate de condiție. Previzualizarea unei reguli nu modifică nicio înregistrare. Dacă obiectul nu are încă înregistrări, creează câteva pentru a încerca previzualizarea.

​

Scrie o condiție

Scrie condiția care permite salvarea. De exemplu, employees > 0 permite salvarea unei companii doar atunci când numărul său de angajați este mai mare decât zero. Folosește nume de câmpuri precum employees, în loc de etichete de afișare precum Angajați. Selectarea unui câmp din asistent inserează referința corectă. Puneți textul între ghilimele simple sau duble și utilizați paranteze pentru a grupa condițiile. Utilizați and și or în loc de && și ||.

​

Verificați valorile lipsă

Pentru a face obligatoriu un câmp, utilizați not isEmpty(fieldName). Acest lucru funcționează și pentru câmpuri compuse, cum ar fi e-mailurile și adresele.

​

Faceți referire la câmpuri compuse și asociate

Utilizați un punct pentru a citi o parte a unui câmp compus, cum ar fi name.firstName sau amount.amountMicros. De asemenea, puteți citi un câmp printr-o relație de tip mulți-la-unu, cum ar fi company.name pentru o persoană. Selectați câmpuri din asistent pentru a găsi căile disponibile. Sumele monetare sunt stocate în micros: o unitate monetară este egală cu 1000000 micros. De exemplu, amount.amountMicros >= 100000000 necesită o sumă de cel puțin 100 în moneda înregistrării. Pentru câmpurile de selecție, comparați valoarea stocată a opțiunii, cum ar fi 'CUSTOMER', nu eticheta sa afișată. Verificați exemplele din asistent pentru valorile disponibile în câmpul dvs.

​

Reguli exemplificative

Adaptați numele câmpurilor și valorile opțiunilor la modelul dvs. de date. Câmpurile startDate, endDate și tags de mai jos sunt exemple de câmpuri personalizate. Exemplul cu oportunitatea utilizează or pentru a face condițională cerința privind suma: celelalte etape pot fi salvate fără o sumă.

​

Când sunt verificate regulile

Regulile active sunt verificate atunci când înregistrările sunt create sau actualizate, inclusiv pentru modificările efectuate prin API, importuri și Workflows. O înregistrare trebuie să respecte toate regulile active ale obiectului său pentru a putea fi salvată. Activarea unei reguli nu modifică înregistrările existente. O înregistrare care nu respectă noua condiție trebuie corectată la următoarea salvare. O condiție care citește o înregistrare asociată este evaluată atunci când este salvată înregistrarea căreia îi aparține regula. Editarea numai a înregistrării asociate nu o verifică din nou.

​

Editați, dezactivați sau ștergeți o regulă

Reveniți la Setări → Model de date → obiectul dvs. → Setări → Reguli de validare, apoi faceți clic pe regulă.

• Editare: Actualizați condiția sau mesajul, verificați previzualizarea și faceți clic pe Salvare. Pentru o regulă inactivă, acest buton este Activare.
• Dezactivare: În Zona periculoasă, faceți clic pe Dezactivare pentru a opri aplicarea regulii, păstrând configurația acesteia. Faceți clic pe Activare pentru a o aplica din nou.
• Ștergere: În Zona periculoasă, faceți clic pe Ștergere și confirmați pentru a elimina definitiv regula. Înregistrările existente nu sunt modificate.

Dezactivarea sau ștergerea unui câmp utilizat într-o condiție dezactivează și regulile care îl citesc. Revizuiți acele reguli înainte de a le activa din nou. Pentru a defini reguli de validare într-o aplicație, consultați ghidul pentru dezvoltatori.