En el caso de varios eventos de campo en la misma página, puede crear un solo script con una instrucción if o switch.. case para verificar qué campo se actualiza.

Por ejemplo, para agregar validación para los campos Producto, Número de teléfono, País y Categoría en la página Crear, puede crear cuatro scripts de cliente en la página Crear con eventos de campo para cada uno de los campos por separado. Sin embargo, es una práctica recomendable crear un solo script de cliente en la página Crear con un evento de página onChange en lugar de varios scripts de cliente. En el evento de página, puede utilizar condiciones para verificar qué campo se está cambiando y agregar acciones dentro de esas condiciones. A continuación, se muestra el script de ejemplo que tiene varias condiciones para varios campos.

Copy
switch (field_name) 
{ 
case 'Product': 
var product_name = ZDK.Page.getField('Product').getValue(); 
var category_field = ZDK.Page.getField('Category'); 
if (['Sparking cable', 'Ignition box', 'Ignition coil', 'Spark plug'].includes(product_name)) { 
category_field.setValue("Ignition system"); ZDK.Page.getField('Number_of_Boxes').setMandatory(true); } 
else  if (['Speedometer', 'Odometer', 'Voltmeter', 'Temperature gauge'].includes(product_name)) {  category_field.setValue('Gauges and meters'); } 
break;    
case 'Phone_Number': 
var phone_field = ZDK.Page.getField('Phone_Number'); 
if (phone_field.getValue().length < 10) { 
phone_field.showError('Enter a valid phone number'); } 
break;
case 'Country':
ZDK.Page.getField('Phone_Number').setMaxLength(10); break; 
case 'Category': 
if(ZDK.Page.getField('Category').getValue() === 'Ignition system') { ZDK.Page.getField('Number_of_Boxes').setMandatory(true); } 
break; }
       
            

            
Nota:
            
Puede crear hasta 30 scripts de cliente por página.
        
    

Utilice la instrucción de registro para depurar el script cuando sea necesario y ejecute el script mediante la opción Ejecutar en el IDE de script de cliente. Los registros estarán disponibles en el panel de mensajes de la opción Ejecutar. Esta es la captura de pantalla de cómo puede agregar instrucciones de registro en su script y dónde puede ver los registros cuando se ejecuta el script.

Siempre que desee probar nuestros archivos ZDK al instante, puede hacerlo en la sección Terminal disponible en la opción Ejecutar del IDE de script de cliente. Por ejemplo, cuando escribe el siguiente script en la sección Terminal y presiona Intro, puede ver el mensaje de alerta en la pantalla.

CopiarZDK.Client.showMessage('Test ZDK Functionality using Terminal section', { type: 'info' });

Los scripts de cliente se ejecutarán solo para el diseño que especificó al configurar el script de cliente. Si desea que se ejecute el script para otros diseños o para todos los diseños de un módulo, deberá crear un script separado para cada diseño.

Asegúrese de que las llamadas de API de un script de cliente a otros dominios estén en la lista blanca en Dominios de confianza.

Por ejemplo, supongamos que desea completar el campo Distancia con la distancia entre los campos Ubicación del vendedor y Ubicación del fabricante. Para lograrlo, puede escribir un script para el evento de página onChange.

Script:

Copiar//Check if the Location fields are updated if (field_name === "Seller_Location" || field_name === "Manufacturer_Location") { //Assign the third party API key to a variable var api_key = "2Ty9CbowZU8Nu3pl3LQb*********"; //Assign the field "Distance" to a variable var distance = ZDK.Page.getField("Distance"); //Make the field "Distance" read-only. distance.setReadOnly(true); //Get form values var formObj = ZDK.Page.getForm(); var form = formObj.getValues(); if (form.Manufacturer_Location && form.Seller_Location) { /*Third party API call with the Location fields values. The domain of the API call should be added to Trusted Domains of Zoho CRM */ var response = fetch("https://api.***/maps/api/dist**/json?origins="+form.Manufacturer_Location+"&destinations="+form.Seller_Location+"&key="+api_key); //Populate the response in the "Distance field". response.then(res => res.json()).then(data => { distance.setValue(data.rows[0].elements[0].distance.text); }); } }

El script podrá obtener la respuesta correctamente solo si las llamadas API al dominio utilizado están en la lista blanca en Dominios de confianza. Haga clic aquí para saber cómo incluir las llamadas de API de terceros en la lista blanca.

Siempre que desee cambiar el orden de ejecución de los scripts de cliente para una página en particular y un evento en particular, utilice el botón Reordenar disponible en la pantalla del script de cliente.

Recuerde que el cambio de orden se aplica solo dentro de un evento en particular para una página en particular de un módulo.

• Para realizar validaciones antes de guardar el registro, utilice el evento de página onSave. De esta manera, después de ingresar datos para todos los campos, cuando el usuario presiona el botón Guardar, se ejecutará el script.
• Para realizar la validación tan pronto como se ingresen datos en un campo en particular, utilice el evento de campo onChange.
• Para realizar la validación tan pronto como se ingresen los datos para varios campos, utilice el evento de página onChange.
• Si desea mostrar un cuadro de mensaje/información personalizado cada vez que se abra una página, utilice el evento de página onLoad.