# Formularios de autoservicio
## Información general
Puede usar Self Service Forms para recopilar datos estructurados de los usuarios. Esto se puede usar para permitir que los usuarios informen incidentes o indiquen cambios, como la necesidad de una nueva configuración del lugar de trabajo en una oficina.
"Self Service Forms" es una función opcional que puede habilitarse para su Tenant mediante RealmJoin Support. Si no está habilitada, aún puede introducir/preparar formularios en la página de configuración, pero los usuarios no podrán ver/usar self service forms.
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 completar y enviar.
Selector de formularios
Cuando un usuario completa 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 electrónico de su empresa.
Correo de ejemplo de un formulario
{% hint style="info" %}
Cuando Self Service Forms está habilitado para su Tenant, todos los usuarios pueden usar/enviar formularios.
{% endhint %}
## Revisar envíos
Usando el  icono de navegación, puede revisar los envíos anteriores de formularios de sus usuarios.
Lista de envíos
Puede buscar envíos por nombre de usuario remitente y por nombre del formulario, pero no por campos del envío del formulario.
Haga clic en "Ver" para ver los datos del formulario completado. La vista es de solo lectura.
## Página de configuración
La página de configuración de Self Service Forms permite administrar los formularios existentes, así como agregar, editar y eliminar formularios.
### Lista de formularios en la página de configuración
Lista de formularios
Use "Nuevo formulario" o "Editar" para describir el formulario usando [JSON Schema](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, use el esquema no solo para describir los datos deseados, sino también para crear implícitamente la interfaz del formulario.
### Editor de esquema
Encima del editor hay dos campos. Use el campo izquierdo para asignar a su formulario un nombre descriptivo. Use el campo derecho para nombrar la dirección de correo electrónico del destinatario de los datos enviados por el usuario.
Ejemplo de editor de esquema
Puede 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, pulse "Enviar" para guardar los cambios. Se mostrará un error si falla la comprobación de sintaxis.
## JSON Schema
El uso de JSON Schema está fuera del alcance de este documento. Puede 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": "Person",
"type": "object",
"required": [
"name",
"date",
"location",
"pets"
],
"properties": {
"name": {
"type": "string",
"description": "Nombre y apellido",
"minLength": 4,
"default": "- Su 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"
}
]
}
}
}
```
Cada JSON Schema consta de objetos. Cada objeto debe tener, como mínimo, un tipo y un nombre.
### Tipos
#### Objeto
Los objetos "complejos" que contienen otros objetos secundarios deben usar el tipo **object** . En nuestro ejemplo, el nodo raíz "Person" del esquema es de este tipo.
Puede definir campos obligatorios usando la palabra clave **required** . Estos campos también tienen que definirse en el esquema.
Usa **properties** para describir las características necesarias de cada campo; esto incluye asignarle un tipo y un nombre.
#### Array
Los arrays le permiten agregar varios **items** similares a una lista. Use la palabra clave **items** para describir el tipo, etc. de los items.
#### Cadena
Solo texto sin formato. Puede precargar esto usando la palabra clave **predeterminado** .
Para permitir solo ciertos valores, puede usar la palabra clave **enum** .
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.realmjoin.com/es/configuracion-de-realmjoin/self-service-forms.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.