Contacto

El Deep Linking

Home / Tutoriales/El Deep Linking

07Dic, 2022

0Comments

El Deep Linking

Categorias / Tutoriales Por Nathalie Castagnier

Deep Linking , o el uso de un Deep Link, hace que sea claro y simple dirigir a los usuarios a contenido específico en la aplicación móvil Kizeo Forms. Para hacer esto, todo lo que tiene que hacer es proporcionarles un enlace de hipertexto que contenga el formalismo requerido.

¡Te lo explicamos todo en este tutorial!

¿Qué es un Deep Link?

Un Deep Link es una URL, es decir, una dirección Web , pero su formalismo es un poco diferente al de la URL clásica. De hecho, una URL clásica comienza con https://, mientras que Deep Link comienza con kizeoforms:// . Esta especificidad significa que algún software no interpreta este enlace como una URL y no permite que se pueda hacer clic en él.

Para que sea funcional, todo lo que tiene que hacer es crear un enlace de hipertexto y enviarlo a sus usuarios, en un software compatible. Así, al hacer clic en el enlace, Android e iOS redirigen la URL a la aplicación KizeoForms.

Importante : los Deep Links siguen las mismas reglas que las URL del navegador, es decir, algunos caracteres no están permitidos. Por lo tanto, deben reemplazarse por su codificación porcentual y su longitud máxima es de 2048 caracteres.

El formalismo del Deep Link

Las reglas básicas

Se debe tener en cuenta las siguientes reglas:

Para abrir los enlaces es necesario ser usuario de la aplicación Kizeo Forms
El Deep Link siempre comienza con kizeoforms://–/
Siempre se escribe en minúsculas, sin acento y sin espacio.
Los caracteres especiales deben estar codificados
El formalismo debe ser respetado hasta el mas mínimo carácter.
El Deep Link debe ponerse en forma de enlace de hipertexto

¿Qué es la codificación porcentual?

Es un mecanismo de codificación de caracteres utilizado en el contexto de las URL. Consiste en la sustitución de un carácter por % seguido de un código hexadecimal correspondiente al valor ASCII del carácter a sustituir.

La siguiente tabla presenta los caracteres especiales con su respectiva codificación:

Para saber : Otros códigos están disponibles en Internet, por ejemplo aquí

Campos compatibles con Deep Linking

Es posible prellenar solo ciertos campos, siempre que no estén en una tabla. Aquí está la lista:

El campo de entrada
El cuadro de texto
El campo de fecha y hora
El campo de Checkbox
El control deslizante
El campo Lista. Si es una lista con atributos, estos aparecerán automáticamente en los campos de atributos vinculada.
El campo de Selección
El campo de geolocalización
El campo Código de barras/Código QR
El campo Tag NFC
El campo Cálculo. Es posible poner un Deep link en un campo de tipo Cálculo

Formalismos especiales

Si bien la mayoría de los campos aceptan cadenas de caracteres, algunos tienen un formalismo particular. Por ejemplo :

Casilla de verificación marcada: 1 , ‘1’ , verdadero o ‘verdadero’ . Cualquier otro valor se interpretará como falso.
Fecha: AAAA-MM-DD
Hora: hh:mm:ss
Fecha y hora: AAAA-MM-DDThh:mm:ss . Tienes que poner T entre la fecha y la hora

Casos prácticos

1 – Deep Links genéricos

Con enlaces básicos, esto es lo que puede hacer:

kizeoforms://–/ abre la aplicación Kizeo Forms
kizeoforms://–/login permite el acceso a la página de autenticación
kizeoforms://–/login/code permite el acceso a la página de autenticación con un código de empresa precargado. el código debe ser reemplazado por el código de la empresa deseada
kizeoforms://–/forms permite acceder a la lista de formularios
kizeoforms://–/favorites permite acceder a la lista de formularios favoritos
kizeoforms://–/settings permite el acceso a la configuración de la aplicación
kizeoforms://–/forms/formId le permite ingresar datos en el formulario que corresponde al formId
kizeoforms://–/data permite acceder a la lista de datos ingresados
kizeoforms://–/receipts permite el acceso a la bandeja de entrada

Importante : Los primeros tres enlaces no necesitan estar conectados a la aplicación, mientras que los siguientes sí deben estarlo.

Nota : Si el usuario aún no ha iniciado sesión cuando hace clic en el enlace, solo tendrá acceso a la página de autenticación, mientras que si ya ha iniciado sesión, será redirigido automáticamente a la página de bienvenida.

2 – Deep Links personalizados

Aunque no reemplaza el push, Deep Linking permite completar previamente los campos del formulario, gracias a Deep Links personalizados.

El formalismo de un Deep Link personalizado es el siguiente: kizeoforms://–/forms/formId?tag1=value1&tag2=value2&tag3=value3

formId debe reemplazarse con el ID de formulario . Esta es la referencia de 6 dígitos que se encuentra en la URL de la página de creación del formulario
tag1 , tag2 , tag3 etc… corresponden al identificador de los campos
value1 , value2 , value3 etc… son los valores que se ingresarán

Veamos algunos casos concretos, utilizando los siguientes campos con sus respectivos identificadores.

1 - Recuperar un campeón

Queremos poner el nombre Kizeo Forms en el campo de entrada del formulario cuyo id es 123456 .

El nombre_del_ campo es nuestra etiqueta pero sin los ##

El espacio entre Kizeo y Forms es un carácter especial, su código es %20

El formalismo es: kizeoforms://–/forms/ formid ? nombre_del_campo = Kizeo(espacio)Forms

El enlace será: kizeoforms://–/forms/ 123456 ? input_field1 =Kizeo %20 Forms

2 - Rellenar un campo con Enter

Queremos poner la dirección de Kizeo con Enter el campo Cuadro de texto del formulario cuyo id es 123456 .

Caracteres especiales :

Espacio entre palabras, su código es % 20
La é de Bernabéu, su código es %C3%A9
El Enter en la dirección, su código es %5Cn

kizeoforms ://–/formularios/ formularios ? nombre_del_campo =55 espacio Santiago espacio Bernab é u Enter 84000 espacio Madrid

kizeoforms://–/forms/ 123456 ? cuadro_de_texto =55 %20 Santiago %20 Bernab%C3%A9 u %5Cn 84000 %20 Madrid

3 - Rellenar varios campos

Queremos poner el nombre de Kizeo Forms en el campo de entrada y la dirección de Kizeo con Enter en el campo Cuadro de texto del formulario cuya identificación es 123456 .

Caracteres especiales :

Espacio entre palabras, su código es % 20
La é de Bernabéu, su código es %C3%A9
El Enter en la dirección, su código es %5Cn
El y entre dos elementos ingresados, su código es &

kizeoforms ://–/formularios/ formularios ? nombre_del_campo =Kizeo Espacio Forms & nombre_del_campo =55 espacio Santiago espacio Bernab é u Enter 84000 espacio Madrid

kizeoforms://–/forms/ 123456 ? campo_de_entrada =Kizeo %20 Forms & cuadro_de_texto =55 %20 Santiago %20 Bernab%C3%A9 u %5Cn 84000 %20 Madrid

4 - Rellenar un campo de casilla de verificación

Queremos marcar la casilla del campo cuyo identificador es checkbox

Fórmula: kizeoforms://–/forms/ formid ? nombre_campo = 1 (o nombre_campo = verdadero )

Enlace: kizeoforms://–/forms/ 123456 ? checkbox = 1 (si checkbox = verdadero )

5 - Rellenar un campo de fecha y hora

Queremos mostrar la fecha del 24 de noviembre de 2022 en el campo de solo fecha

Fórmula: kizeoforms://–/forms/ formid ? nombre_del_campo = AAAA-MM-DD

Enlace: kizeoforms://–/forms/ 123456 ? fecha = 2022-11-24

Queremos mostrar la hora 11:56 en el campo de hora

Fórmula: kizeoforms://–/forms/ formid ? nombre_del_campo = hh:mm:ss

Enlace: kizeoforms://–/forms/ 123456 ? hora = 11:56:00

Queremos mostrar la fecha del 24 de noviembre de 2022 y la hora 11:56 en el campo fecha_y_hora

Fórmula: kizeoforms://–/forms/ formid ? nombre_del_campo = AAAA-MM-DD

Enlace : kizeoforms://–/forms/ 123456 ? date_et_heure1 = 2022-11-24 martes 11:56:00

Para ir más lejos…

No dude enviarnos sus comentarios sobre esta artículo.
Estamos a su disposición para responder a sus preguntas, sugerencias, comentarios, etc.