Help & Tips - ViewSections Manuals

Wizard Home > Tipi campo

Cod.	Ultima revisione	Wiki	Note
725	2024/03/19 - MM	email_checkmark_list

Permette di eseguire una selezione fra una lista di email e, opzionalmente, inserirne una nuova.
È possibile inserire indirizzi email non presenti in lista; il sistema esegue un controllo sulla stringa immessa per verificarne la validità come email.

Caratteristica

Il campo presenta un'interfaccia che consente la selezione di email predefinite da una lista e, tramite apposito setting, l'inserimento di una o più nuove email.
Il form di inserimento segnala un errore se il formato dell'email non è valido.
La lista delle email esistenti viene prelevata dalle email indicate nella scheda dell'anagrafica di fatturazione.

Casistiche Esempio app demo

App Demo Zotsell È possibile trovare un esempio nell'app Zotsell disponibile nello store, visualizzando i dati aggiuntivi.

Vedi questa guida per le App Zotsell nello Store

UI

Di seguito l'interfaccia dettagliata nel Client IOS della caratteristica descritta:

Immagine di esempio	Descrizione
	Campo Email
	Immissione email con controllo formato email

Settings base

{ "label" : "Emails", "field_type" : "email_checkmark_list", "identifier" : "emails_notifiche" },

new_value

Abilita la funzione di inserimento nuova email.
Di default "new_value" == false
Esempio: { "label" : "Emails", "field_type" : "email_checkmark_list", "identifier" : "emails_notifiche", "options" : { "new_value" : true } },

default_all_unchecked

Se valorizzato a true, il campo non viene preimpostato con nessuna email: è necessario entrare in lista e selezionare le email desiderate.
Esempio: { "label" : "Emails", "field_type" : "email_checkmark_list", "identifier" : "emails_notifiche", "options" : { "default_all_unchecked" : true } },

add_login_email

Permette di proporre tra le email selezionabili anche l'email dell'utente loggato che ha l'app in uso.
Esempio: { "placeholder" : "email01@acme.spa", "identifier" : "notifica_a", "label" : "Notifica a", "field_type" : "email_checkmark_list", "options" : { "new_value" : true, "default_all_unchecked" : true, "add_login_email" : true } },

Stato implementativo

Client	Versione Rilascio	Stato
IOS App8E	8E: 2019-03-20 - 2.5.106	Completata
Sell	Dati aggiuntivi	Completata

Attenzione Ove non indicato "Completato" nella colonna Stato, la caratteristica non è ancora implementata in quell'ambiente.
La presenza di un'indicazione nella colonna Issue Implementativa indica che la caratteristica è programmata nello sviluppo.
Ove non è indicata alcuna informazione significa che non è ancora schedulata o programmata l'implementazione nell'ambiente specifico.

Tracciati in uscita

Il dato viene salvato in JSON nella forma:
"identifier" = array email con flag selezionata o meno Esempio:

"notifica_a":[
  {
    "checked":true,
    "value":"aaaaaa@bbb.it"
  },
  {
    "checked":false,
    "value":"bbb@ccc.com"
  },
  {
    "checked":true,
    "value":"ccc@ddd.com"
  }
],

Contesto: Tab Dati aggiuntivi ordine e identifier = notifica_a

Esiste un caso particolare con le seguenti condizioni:

form: Tab Dati aggiuntivi ordine
identifier = notifica_a

In questo caso, viene proposta come lista di email il contenuto del campo dell'anagrafica; se il contenuto è nella forma aaaaaa@bbb.it,bbb@ccc.com ... le email vengono separate nella lista.
Invece di salvare in JSON l'array come nella serializzazione standard, viene salvata nell'identificativo notifica_a un'unica stringa contenente la lista delle email selezionate, separate da virgola.

"notifica_a": "aaaaaa@bbb.it,bbb@ccc.com"

Argomenti correlati

Tipi campo:email -
Tipi campo:emails -

Email Checkmark List