> 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/configuracion-de-realmjoin/self-service-forms.md).

# Formularios de autoservicio

## Resumen

Puede usar Formularios de autoservicio 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 Office.

"Self Service Forms" es una función opcional que puede habilitarse para su Tenant mediante el soporte de RealmJoin. 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.

<figure><img src="/files/806537027b312631c808dadc03fac0ff40585893" alt=""><figcaption><p>Ejemplo de formulario</p></figcaption></figure>

## Uso de formularios

Mediante la ![](/files/bc8ab0dabf286961d92dcc689ad28fad964153e2) elemento de navegación, los usuarios pueden seleccionar un formulario para completarlo y enviarlo.

<figure><img src="/files/55e9789db52de1ca760c85046be2f537d1cc02f6" alt=""><figcaption><p>Selector de formularios</p></figcaption></figure>

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.

<figure><img src="/files/cacbf9a7f05cd8a0da2c2f6b9e5e843c289a458f" alt=""><figcaption><p>Correo electrónico de ejemplo de un formulario</p></figcaption></figure>

{% 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

Mediante la ![](/files/176e2744b51271316e7d86dfdff3a26c4ac8b61c) icono de navegación, puede revisar los envíos anteriores de formularios de sus usuarios.

<figure><img src="/files/05fabaec3beb0a8db9b68e32195dbea0a01f8b93" alt=""><figcaption><p>Lista de envíos</p></figcaption></figure>

Puede buscar envíos por nombre de usuario remitente y por nombre de formulario, pero no por campos dentro 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 formularios existentes, agregar, editar y eliminar formularios.

### Lista de formularios en la página de configuración

<figure><img src="/files/768f5c853397d5139566b8cd7056b52248990b2f" alt=""><figcaption><p>Lista de formularios</p></figcaption></figure>

Use "Nuevo formulario" o "Editar" para describir el formulario usando [Esquema JSON](https://json-schema.org/). Esto define qué campos deben ingresarse y qué valores son válidos. La interfaz de usuario ofrece un editor de 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 de usuario del formulario.

### Editor de esquema

Encima del editor hay dos campos. Use el campo de la izquierda para dar 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.

<figure><img src="/files/d24a2edbd2093630bd0f1b715e414435cd818c65" alt=""><figcaption><p>Ejemplo del editor de esquema</p></figcaption></figure>

Puede usar "Actualizar la vista previa del formulario JSON" para crear una vista previa del formulario resultante debajo del editor.

<figure><img src="/files/7a7b9e779c1064b813d4506574331ec6486dbad8" alt=""><figcaption><p>Vista previa del editor</p></figcaption></figure>

Después de modificar el esquema, pulse "Enviar" para guardar los cambios. Se mostrará un error si falla la comprobación de sintaxis.

## Esquema JSON

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 tener 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": [
              "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 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 necesario; esto incluye asignarle un tipo y un nombre.

#### Arreglo

Los arreglos le permiten añadir varios elementos similares **items** a una lista. Use la **items** palabra clave para describir el tipo de los elementos, etc.

#### Cadena

Solo texto sin formato. Puede rellenarlo previamente 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:

```
GET https://docs.realmjoin.com/es/configuracion-de-realmjoin/self-service-forms.md?ask=<question>
```

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.
