Creación de un nuevo formulario en Zoho Creator

Supongamos que tiene una tabla de ventas en un espacio de trabajo denominado “Ventas de tienda” en su cuenta de Zoho Analytics, como se muestra a continuación, y desea crear un formulario web de ingreso de datos en esta tabla. Para ello siga los pasos que se indican a continuación.

Inicie sesión en Zoho Creator (http://creator.zoho.com/) con las mismas credenciales de inicio de sesión que utiliza para Zoho Analytics.

Si ya creó una aplicación en Zoho Creator, puede abrir la aplicación existente. Si no es así, cree una nueva aplicación haciendo clic en el botón Crear aplicación disponible en la página de inicio. Deberá proporcionar un nombre de aplicación obligatorio para continuar. Puede obtener más información sobre cómo crear una aplicación en nuestro documento de ayuda de Creator.

• Para editar una aplicación existente, debe ir al modo de edición de la aplicación haciendo clic en el ícono “Editar” junto al nombre de la aplicación. 
• Para crear un formulario nuevo, seleccione Crear nuevo --> Formulario. Puede crear un formulario desde cero, importar un archivo o usar una plantilla existente para crear su formulario.
• En la ventana “Nuevo formulario”, ingrese un nombre de formulario y seleccione también la sección en la que desea colocar el formulario cuando acceda a la aplicación.
• Seleccione la opción Los datos se almacenarán en Creator y haga clic en Crear. De forma predeterminada, Zoho Creator tendrá una tabla generada en el servidor para almacenar los datos enviados a través del formulario. Para guardar los datos enviados en una tabla de Zoho Analytics en lugar de una tabla de Zoho Creator, se debe desmarcar esta opción.

Se creará un nuevo formulario en blanco llamado Formulario de ventas y se mostrará en la pestaña “Formularios”. Ahora, arrastre y suelte los tipos de campo requeridos desde el cuadro Campos que se muestra en el lado izquierdo de su formulario, según el tipo de datos que el formulario debe recopilar.

• Puede cambiar el nombre del campo haciendo clic en la etiqueta Nombre del campo en el cuadro de propiedades de campo como se muestra arriba. 
• Haga clic en el botón “+” para agregar un botón (cambie su nombre a “Agregar al espacio de trabajo de Zoho Analytics”) y seleccione “Enviar” en “Tipo de campo”. 
• Una vez que haya agregado todos los campos obligatorios y les haya cambiado el nombre, haga clic en Acceder a esta aplicación. El formulario resultante debe ser similar al que se muestra en la siguiente imagen.

Script tras hacer clic

Después de crear el formulario, debe escribir una secuencia de comandos Deluge simple que se ejecuta tras hacer clic en el botón. Un script Deluge es un lenguaje de secuencias de comandos en línea que le permite agregar la lógica necesaria al formulario para realizar una acción.

Script tras hacer clic para agregar datos:

Para agregar datos enviados mediante el formulario como una nueva fila en la tabla de su cuenta de Zoho Analytics, debemos escribir un comando Deluge con la tarea createRow().
Sintaxis. Lo siguiente es un formato generalizado de la tarea Deluge para agregar datos:

<Workspace Name> es el nombre del espacio de trabajo en Zoho Analytics.
<Table Name> es el nombre de la tabla en el espacio de trabajo correspondiente en Zoho Analytics.
<Data as map> es la variable de mapa que contiene pares de clave y valor. La clave del mapa es el nombre de la columna de la tabla en su cuenta de Zoho Analytics y el valor del mapa es el valor de campo enviado en el formulario de Zoho Creator.
<return value as map> es el objeto del mapa que contiene la respuesta que devuelve Zoho Analytics.

Continuemos con el ejemplo anterior para ilustrar cómo utilizar la tarea createRow() para agregar datos. Una vez que haya soltado los campos obligatorios y agregado el botón Agregar al espacio de trabajo de Zoho Analytics al formulario de ventas, haga lo siguiente:

• Pase el cursor sobre el botón Agregar al espacio de trabajo de Zoho Analytics y seleccione la opción Acción al hacer clic. Esto invocará el generador de secuencias de comandos en la pestaña Script.
• Cambie al modo Script de flujo libre haciendo clic en la opción presente en la esquina superior derecha del editor de scripts.
• Escriba el siguiente script Deluge como se muestra a continuación en el editor de script y haga clic en Guardar script.

  creatingMap = map();
  creatingMap.put("Date", input.Date_field);
  creatingMap.put("Region", input.Region);
  creatingMap.put("Product Category", input.Product_Category);
  creatingMap.put("Product", input.Product);
  creatingMap.put("Customer Name", input.Customer_Name);
  creatingMap.put("Sales", input.Sales.toString());
  creatingMap.put("Cost", input.Cost.toString());
  mapResponse = zoho.reports.createRow("StoreSales", "Sales", creatingMap);

En el script Deluge anterior:

creatingMap es la variable de mapa que contiene los nombres de las columnas (Fecha, Región, Categoría de producto, Producto, Nombre del cliente, Ventas y Costo) y sus valores correspondientes enviados al Formulario de ventas.

mapResponse es la variable que contiene la cadena XML que devuelve Zoho Analytics como respuesta al agregar la fila.

Cuando un usuario ingresa datos y hace clic en el botón Agregar al espacio de trabajo de Zoho Analytics en el formulario de ventas, se ejecuta el script Deluge asignado y se agregan los datos enviados como una nueva fila a la tabla de ventas en su cuenta de Zoho Analytics.

Script tras hacer clic para actualizar datos:

También puede utilizar un formulario de Zoho Creator para actualizar los datos existentes de una tabla en su cuenta de Zoho Analytics. Para actualizar una fila en Zoho Analytics con un formulario creado en Zoho Creator, debemos escribir un script Deluge con la tarea update data(). Lo siguiente es un formato generalizado de la tarea Deluge para actualizar las filas en Zoho Analytics:
Sintaxis:

<Workspace Name> es el nombre del espacio de trabajo en Zoho Analytics.
<Table Name> es el nombre de la tabla en el espacio de trabajo correspondiente en Zoho Analytics.
<Data as map> es la variable de mapa que contiene pares de clave y valor. La clave del mapa es el nombre de la columna de la tabla en su cuenta de Zoho Analytics y el valor del mapa es el valor de campo enviado en el formulario de Zoho Creator.
<Criteria> debe tener el siguiente formato: {<colName> <operator> <colValue>}. Por ejemplo ("Region"='East'). Consulte aquí para obtener más detalles sobre el formato de los criterios.
<return value as map> es el objeto de mapa que contiene la respuesta que devuelve Zoho Analytics. En el ejemplo dado, para actualizar una fila existente en la tabla de ventas del espacio de trabajo “Ventas de tienda” en su cuenta de Zoho Analytics con los datos enviados a través del formulario de ventas, haga lo siguiente:

• Agregue un botón (por ejemplo, un botón Actualizar) al Formulario de ventas siguiendo los mismos pasos descritos anteriormente.
• Pase el cursor sobre el botón Actualizar y seleccione la opción Acción al hacer clic. Esto invocará el generador de secuencias de comandos en la pestaña Script.
• Cambie al modo Script de flujo libre haciendo clic en la opción presente en la esquina superior derecha del editor de scripts.
• Escriba el siguiente script Deluge como se muestra a continuación en el editor de scripts y haga clic en Guardar script.

Cuando un usuario ingresa datos en el Formulario de ventas y hace clic en el botón Actualizar, se ejecuta el script Deluge y todas las filas de la tabla de ventas en el espacio de trabajo “Ventas de tienda” con “East” en Región y “10000” en Ventas se actualizarán con los datos enviados.

Script tras hacer clic para eliminar una fila:

Para eliminar una fila específica de una tabla en Zoho Analytics, debemos escribir un script Deluge con la tarea deleterow().

Sintaxis: lo siguiente es el formato de la tarea Deluge para eliminar filas en Zoho Analytics:

<Workspace Name> es el nombre del espacio de trabajo en Zoho Analytics.
<Table Name> es el nombre de la tabla en el espacio de trabajo correspondiente en Zoho Analytics.
<Criteria> debe tener el siguiente formato: {<colName> <operator> <colValue>}. Por ejemplo ("Region"='East'). Consulte aquí para obtener más detalles sobre el formato de los criterios.
<return value as map> es el objeto de mapa que contiene la respuesta que devuelve Zoho Analytics.
Por ejemplo, para eliminar todos los datos de ventas de la región “Oeste” de la tabla de ventas del espacio de trabajo “Ventas de tienda” en su cuenta de Zoho Analytics, se debe escribir el script Deluge en el generador de scripts tal como se muestra a continuación.

Ingreso de datos en el formulario

Para ingresar los datos en el formulario y agregar o actualizar los datos ingresados en la tabla en su cuenta de Zoho Analytics, seleccione la opción Acceder a esta aplicación en la parte superior derecha. Ingrese los datos requeridos en los campos correspondientes y haga clic en el botón requerido para agregar o actualizar el registro en la tabla correspondiente en Zoho Analytics.

Comprobación de datos en una tabla de Zoho Analytics

Una vez que el formulario se envíe correctamente, los datos se agregarán como una nueva fila a la tabla de ventas del espacio de trabajo “Ventas de tienda” cuando haga clic en el botón Agregar al espacio de trabajo de Zoho Analytics, como se muestra a continuación.

De manera similar, si un usuario hace clic en el botón Actualizar, todas las filas de la tabla de Zoho Analytics que coincidan con los criterios determinados se actualizarán con los datos enviados.

Compartir el Formulario y proceso de incrustación

De forma predeterminada, solo el propietario de la aplicación puede acceder al formulario en una aplicación privada. Para permitir que sus usuarios accedan al formulario, debe compartir el formulario con sus usuarios o incrustarlo en su sitio web/blog y establecer los permisos necesarios.

Compartir su formulario:

Puede compartir sus vistas con su usuario si proporciona la dirección de correo electrónico del usuario en la pestaña Compartir. Consulte los documentos de ayuda de Zoho Creator sobre Uso compartido para obtener detalles sobre cómo compartir un formulario y establecer diferentes niveles de permiso para cada usuario.
Si el usuario compartido tiene una cuenta existente de Zoho cuyo ID de inicio de sesión es el ID de correo electrónico compartido, solo puede iniciar sesión en Zoho Creator para acceder a la aplicación. Si el usuario compartido no es propietario de una cuenta existente de Zoho, debe registrarse con esta ID de correo electrónico especificada en el correo electrónico de invitación.
Después de iniciar sesión, el usuario puede acceder al formulario compartido haciendo clic en la pestaña Compartido conmigo que aparece en su página de inicio de sesión y seleccionando la aplicación correspondiente. De manera alternativa, el usuario puede acceder directamente al formulario haciendo clic en el enlace proporcionado en el correo de invitación que usted le habrá enviado mientras compartía el formulario.

Incrustar su formulario:

También puede incrustar sus formularios en sus páginas web, aplicaciones web o blogs incluyendo algunas líneas de fragmentos de código HTML en el contenido HTML de su página web. Cuando se incluya este fragmento de código, cada vez que se cargue la página web en un navegador, también se cargará el formulario incrustado.
El fragmento de código HTML se puede generar invocando la opción Más acciones -> Incrustar en el sitio web desde el encabezado del formulario, como se muestra a continuación.

Puede pegar este código HTML en la sección correspondiente del contenido HTML de su página web para ver el formulario incrustado. En la siguiente captura de pantalla, se muestra el Formulario de ventas incrustado en una página web.

Consulte el documento de ayuda de Zoho Creator sobre Incrustación para obtener detalles sobre cómo incrustar un formulario y las diversas configuraciones posibles.