# Formularios de autoservicio
## Información general
Puedes usar los Formularios de autoservicio para recopilar datos estructurados de los usuarios. Esto puede usarse para permitir que los usuarios informen incidentes o indiquen cambios, como la necesidad de una nueva configuración del puesto de trabajo en una oficina.
"Self Service Forms" es una función opcional que puede habilitarse para tu tenant mediante el soporte de RealmJoin. Si no está habilitada, aún puedes introducir/preparar formularios en la página de configuración, pero los usuarios no podrán ver/usar los formularios de autoservicio.
Usaremos un flujo de trabajo para "indicar una nueva mascota" como ejemplo.
Ejemplo de formulario
## Uso de formularios
Usando el  elemento de navegación, los usuarios pueden seleccionar un formulario para rellenar y enviar.
Selector de formularios
Cuando un usuario rellena y envía un formulario, su contenido se enviará por correo electrónico al destinatario indicado en la definición del formulario. El correo se enviará a través de la infraestructura de RealmJoin y no procederá de las direcciones de correo de tu empresa.
Correo de ejemplo de un formulario
{% hint style="info" %}
Cuando los Formularios de autoservicio están habilitados para tu tenant, todos los usuarios pueden usar/enviar formularios.
{% endhint %}
## Revisar envíos
Usando el  icono de navegación, puedes revisar los envíos anteriores de formularios de tus usuarios.
Lista de envíos
Puedes buscar envíos por nombre de usuario y por nombre de formulario, pero no por los campos del envío del formulario.
Haz clic en "Ver" para ver los datos del formulario rellenado. La vista es de solo lectura.
## Página de configuración
La página de configuración de Formularios de autoservicio permite administrar formularios existentes, así como agregar, editar y eliminar formularios.
### Lista de formularios en la página de configuración
Lista de formularios
Usa "Nuevo formulario" o "Editar" para describir el formulario usando [Esquema JSON](https://json-schema.org/). Esto define qué campos deben introducirse y qué valores son válidos. La interfaz ofrece un editor con comprobación de sintaxis y una vista previa del formulario resultante.
El esquema se usará para crear dinámicamente un formulario para el usuario. Básicamente, usa el esquema no solo para describir los datos deseados, sino también para crear implícitamente la interfaz de usuario del formulario.
### Editor de esquema
Encima del editor hay dos campos. Usa el campo de la izquierda para darle a tu formulario un nombre descriptivo. Usa el campo de la derecha para nombrar la dirección de correo electrónico del destinatario de los datos enviados por el usuario.
Ejemplo del editor de esquemas
Puedes usar "Actualizar vista previa del formulario JSON" para crear una vista previa del formulario resultante debajo del editor.
Vista previa del editor
Después de modificar el esquema, pulsa "Enviar" para guardar tus cambios. Se mostrará un error si falla la comprobación de sintaxis.
## Esquema JSON
El uso de JSON Schema queda fuera del alcance de este documento. Puedes usar generadores de esquemas en línea (como [este](https://www.jsonschema.net/app)) para simplificar el proceso.
Para dar al menos un punto de partida, examinemos el esquema de nuestro ejemplo
```json
{
"title": "Persona",
"type": "object",
"required": [
"name",
"date",
"location",
"pets"
],
"properties": {
"name": {
"type": "string",
"description": "Nombre y apellidos",
"minLength": 4,
"default": "- Tu nombre aquí -"
},
"date": {
"type": "string",
"format": "date",
"options": {
"flatpickr": {}
}
},
"location": {
"type": "object",
"title": "Ubicación",
"properties": {
"city": {
"type": "string",
"default": "San Francisco"
},
"state": {
"type": "string",
"default": "CA"
},
"citystate": {
"type": "string",
"description": "Esto se genera automáticamente a partir de los dos campos anteriores",
"template": "{{city}}, {{state}}",
"watch": {
"city": "location.city",
"state": "location.state"
}
}
}
},
"pets": {
"type": "array",
"format": "table",
"title": "Mascotas",
"uniqueItems": true,
"items": {
"type": "object",
"title": "Mascota",
"properties": {
"type": {
"type": "string",
"enum": [
"cat",
"dog",
"bird",
"reptile",
"other"
],
"default": "dog"
},
"name": {
"type": "string"
}
}
},
"default": [
{
"type": "dog",
"name": "Walter"
}
]
}
}
}
```
Todo JSON Schema consta de objetos. Todo objeto debe tener al menos un tipo y un nombre.
### Tipos
#### Objeto
Los objetos "complejos" que contienen otros subobjetos deben usar el **tipo** object. En nuestro ejemplo, el nodo raíz "Persona" del esquema es de este tipo.
Puedes definir campos obligatorios usando la palabra clave **required** . Estos campos también deben definirse en el esquema.
Usa **properties** para describir las características necesarias de cada campo; esto incluye indicar un tipo y un nombre.
#### Array
Los arrays te permiten añadir múltiples **elementos** similares **elementos** a una lista. Usa la palabra clave
#### Cadena
para describir el tipo de los elementos, etc. Solo texto sin formato. Puedes precargar esto usando la **predeterminado** palabra clave.
Para permitir solo ciertos valores, puedes usar la **enum** palabra clave.
