> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/es/administracion-y-configuracion/self-service-forms.md).
# Formularios de autoservicio
## Descripción general
Puede usar Formularios de autoservicio para recopilar datos estructurados de los usuarios. Esto puede utilizarse 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.
"Formularios de autoservicio" es una función opcional que el soporte de RealmJoin puede habilitar para su tenant. 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 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 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 electrónico se enviará a través de la infraestructura de RealmJoin y no se originará en las direcciones de correo electrónico de su empresa.
Correo electrónico de ejemplo de un formulario
{% hint style="info" %}
Cuando los Formularios de autoservicio están habilitados 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 los 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 Formularios de autoservicio permite administrar los formularios existentes, así como añadir, editar y eliminar formularios.
### Lista de formularios en la página de configuración
Lista de formularios
Utilice "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 de comprobación de sintaxis y una vista previa del formulario resultante.
El esquema se utilizará 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 de usuario del formulario.
### Editor de esquema
Encima del editor hay dos campos. Use el campo de la izquierda para darle a su formulario un nombre descriptivo. Use el campo de la derecha para indicar la dirección de correo electrónico del destinatario de los datos enviados por el usuario.
Ejemplo del 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 la comprobación de sintaxis falla.
## Esquema JSON
El uso de JSON Schema queda 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 ofrecer 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 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": [
"gato",
"perro",
"pájaro",
"reptil",
"otro"
],
"default": "perro"
},
"name": {
"type": "string"
}
}
},
"default": [
{
"type": "perro",
"name": "Walter"
}
]
}
}
}
```
Todo JSON Schema consiste en objetos. Todo objeto debe tener al menos un tipo y un nombre.
### Tipos
#### Objeto
Los objetos "complejos" que contienen otros objetos secundarios deben usar el **object** tipo. En nuestro ejemplo, el nodo raíz "Persona" del esquema es de este tipo.
Puede definir campos obligatorios usando la **required** palabra clave. Estos campos también tienen que definirse en el esquema.
Use **properties** para describir las características de cada campo necesarias, esto incluye asignar un tipo y un nombre.
#### Array
Los arrays le permiten añadir múltiples **items** similares a una lista. Use la **items** palabra clave para describir el tipo de los items, etc.
#### Cadena
Solo texto sin formato. Puede precompletarlo usando la **default** palabra clave.
Para permitir solo ciertos valores, puede usar la **enum** palabra clave.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.realmjoin.com/es/administracion-y-configuracion/self-service-forms.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.