¿Cómo inicializo el formulario con datos del solicitante?

Existen determinados momentos en los que nos puede interesar inicializar un formulario con determinados datos. Un ejemplo común de este uso es cuando en una Sede Electrónica iniciamos un formulario por primera vez y queremos precargar datos que ya conocemos en base a la información que se dispone del tercero.

Supongamos que tengamos un objeto con datos del solicitante, como por ejemplo:

var datosSolicitante = {
    nombre: "Juan",
    apellido: "Garcia",
    dni: "43829267"
}
JS


Si no tenemos un jsonData pre-existente, podemos construir el nuestro propio, creándolo con el formato adecuado, como claves y valores.

En el siguiente ejemplo vemos como del objeto “datosSolicitante” del que partimos, lo que vamos a hacer es extraer el nombre para inicializarlo en el formulario. En ese caso usaremos como clave el nombre que recibe el campo en el formulario y como valor el texto que queremos inicializar para dicho campo.

Este mismo mecanismo se podría repetir con todos los campos del formulario que se desean inicializar. Para ello, lo único que debemos hacer es conocer la clave asignada en el formulario al campo que se quiere inicializar.

Por ejemplo:

       var datosSolicitante = {
            nombre: "Juan",
            apellido: "Garcia",
            dni: "43829267"
        }

        var jsonData = {
            "nombre-solicitante": datosSolicitante.nombre
        }

        // Obligatorio
        var webformCode = "ejemplo-integracion";

        // Opcionales
        var jsonData = JSON.stringify(jsonData);
        var token = "";
        var checkIntegrity; // Ejemplo: false;
        visualizer.renderEditableWebform(jsonData, webformCode, token, checkIntegrity)
            .then(function () {
                console.info('Editable webform rendered');
            });
JS

¿Cómo puedo modificar los estilos HTML del formulario?

En el apartado de “Cargar estilos del visualizador” ya se ha explicado el procedimiento a seguir para que los formularios se carguen correctamente con sus estilos.

Sin embargo, conviene destacar que si el integrador lo necesita, también podría optar por personalizar sus propios estilos.

En este sentido lo único que hay que tener en cuenta es que los estilos mínimos de partida son una extensión de Bootstrap 3, es decir, usan sus clases en el HTML.

En el caso de que se quisieran personalizar los estilos lo que se tendría que hacer es generar un archivo CSS propio, que realice las modificaciones necesarias, y que sea añadido en una línea posterior al de visualizer.min.css.


¿Cómo puedo consultar la definición de un formulario?

El JSON que define la estructura de un formulario, también conocido como JsonDef, se puede obtener a través de la API REST. Esta API expone una URL para obtener webforms a partir de su identificador.

Cada versión de un webform posee un identificador único en la plataforma, por lo que siempre es posible obtener una versión en concreto. Este identificador se forma a partir de dos variables: código semántico/número de versión.

El procedimiento para obtener el webform consiste en realizar una petición de tipo:

GET http://webforms.es/webforms/api/v1/webforms/solicitud/?version=1.0
POWERSHELL

Donde “solicitud” es el identificador del formulario y “1.0” la versión en concreto que se desea obtener.


Además, si no se especifica una versión, el método devuelve por defecto la última versión publicada del webform, es decir, podríamos hacer la siguiente petición para obtener la última versión del formulario.

GET http://webforms.es/webforms/api/v1/webforms/solicitud
POWERSHELL