Creazione di regole di convalida tramite funzioni
Le schermate in questo articolo sono in lingua inglese. L'interfaccia di Zoho CRM potrebbe variare in base alla versione e alla lingua impostata.
Utilizzando le funzioni è possibile creare una regola di convalida in cui il valore inserito dall'utente deve essere verificato al di fuori del database di CRM. È possibile anche convalidare campi come numeri di telefono, codice postale e così via per un determinato pattern specificando il pattern appropriato nella funzione. Ad esempio, è possibile scrivere una funzione per convalidare il campo numero di conto, in modo che accetti valori solo se aderiscono a questo pattern: xxx-999-x00. Poiché i numeri di conto sono riservati e molto probabilmente archiviati in un database governativo o in un archivio bancario, è necessario consentire a CRM di verificare il pattern in quei database di terze parti e generare un avviso ogni volta che si verifica una discrepanza.
Scenario
Si opera nel settore della vendita al dettaglio e si utilizzano servizi logistici di terze parti per gestire le consegne porta a porta e le spedizioni in blocco. Ogni spedizione viene tracciata utilizzando un numero di riferimento a 10 cifre che è archiviato nel database del fornitore logistico. Ogni volta che un rappresentante commerciale inserisce un numero di riferimento errato in CRM, si desidera impedire il salvataggio del record per evitare problemi e ritardi inutili nel tracciamento delle spedizioni durante le richieste dei clienti. È possibile convalidare il campo "numero di riferimento" utilizzando una funzione, in modo che il valore venga verificato nel database dell'azienda logistica per una corrispondenza esatta. Il record verrà quindi salvato solo se il rappresentante inserisce un valore a 10 cifre nel formato appropriato (xxx-9999999999) indicato nella regola di convalida, altrimenti verrà generato un errore che indica dati non validi.
/* The snippet below shows you how to get a list of fields, their values from a MAP object. The fields' values can be obtained from the same MAP object. */
entityMap = crmAPIRequest.toMap().get("record");
/* The example below demonstrates how a field's value (email) can be obtained from a MAP object. Here, entityMap - Map Object, Email - Field's API name
Sample entityMap= {'Email': 'xxx@xxx.com', 'Last_Name': 'xxx'}; */
referenceField= entityMap.get("Reference_Number"); // Reference_Number is the API name for "Reference number" field.
response = Map();
/* ---------------------------------------------------------------------------------------------- */
Iniziare a scrivere il codice qui per eseguire la convalida necessaria dei campi *
/* ---------------------------------------------------------------------------------------------- */
/* If the code identifies a validation error, set the status and alert message as shown below: */
if(referenceField.matches("[A-Z]{3}-[0-9]{10}")) {
response.put('status','error');
response.put('message', 'Invalid Reference Number');
} else {
/* If there are no errors found during validation, set the status as shown below: */
response.put('status','success');
}
}
/* ---------------------------------------------------------------------------------------------- */
return response.toString();
Nota
- È possibile modificare la regola di convalida basata su criteri dei record esistenti in una regola di convalida basata su funzioni scrivendo una funzione che faciliti la regola di convalida.
- Il numero totale di regole di convalida che possono essere create dipende dall'edizione sottoscritta. Sul numero totale di regole/moduli, è possibile creare 3 regole di convalida tramite funzioni nell'edizione Enterprise, e 5 regole tramite funzioni nell'edizione Ultimate. Per conoscere il numero totale di regole per ciascuna edizione, consultare la pagina Disponibilità funzionalità.
- Solo i campi supportati nella regola di convalida basata su criteri saranno disponibili anche nella regola basata su funzioni.
- Per evitare il fallimento della funzione, è consigliabile inserire controlli per valori vuoti poiché a volte i campi sono vuoti (campi senza valore).
- Il valore di ritorno della funzione deve essere come indicato nel codice di esempio. Qualsiasi valore diverso dal valore di ritorno indicato verrà considerato come errore.
- I valori dei campi saranno disponibili all'interno della funzione solo in formato API. Per accedere ai valori è possibile utilizzare il nome API del campo.
- L'esecuzione della convalida sarà applicabile anche nell'app mobile di Zoho CRM. Tuttavia, non sarà possibile creare una regola dall'app mobile.
- Nel caso in cui la funzione non riesca ad essere eseguita, verrà visualizzato un avviso per verificare le seguenti possibili cause:
- Errori logici nel codice.
- Timeout dell'esecuzione che causa il fallimento della funzione.
- Se il problema persiste, contattare support@zohocrm.com per assistenza.
Per creare una regola di convalida tramite funzioni
- Andare su Setup > Customization > Modules and Fields.
- Selezionare il modulo per il quale si desidera creare la regola di convalida.
- Nella pagina [Modulo], fare clic sulla scheda Validation Rules.
- Fare clic su Create New Validation Rule.
- Nel pop-up Create Validation Rule, eseguire le seguenti azioni:
- Selezionare il layout a cui appartiene il campo che si desidera convalidare.
- Selezionare il campo da convalidare.
- Selezionare il tipo di convalida come Using function.
- Selezionare Save Only o Field Verify and Save dal menu a discesa Validate on.
- Fare clic su Next.
- Nella pagina Configure Function, eseguire una delle seguenti operazioni:
- Fare clic su Functions > Choose a function > Configure > Save.
- Fare clic su Write your own > Inserire la funzione > Save.
- Fare clic su Save per salvare la regola di convalida.
Nota
Le funzioni create nella scheda Functions possono essere associate a una regola di convalida.
- Andare su Setup > Developer Hub > Functions > + New Function.
- Nel popup Create New Function, selezionare Validation Rule dall'elenco a discesa Category.
Utilizzando le funzioni è possibile creare una regola di convalida in cui il valore ins
Articoli Correlati
Zoho Premium Partner
Hai bisogno di aiuto con Zoho CRM?
I nostri esperti possono aiutarti con implementazione, personalizzazione e supporto. Oltre 200 progetti completati dal 2011.
Contattaci