Formularios de autoservicio

pestaña Resumen

Puedes usar Formularios de Autoservicio para recopilar datos estructurados de los usuarios. Esto se puede usar para permitir que los usuarios reporten incidentes o indiquen cambios, como la necesidad de una nueva configuración de puesto de trabajo en una oficina.

"Formularios de Autoservicio" es una función opcional que RealmJoin Support puede habilitar para tu inquilino. 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 completar y enviar.

Selector de Formulario

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á desde las direcciones de correo electrónico de tu empresa.

Correo de ejemplo desde un formulario

Cuando los Formularios de Autoservicio están habilitados para tu inquilino, todos los usuarios pueden usar/enviar formularios.

Revisar Envíos

Usando el icono de navegación, puedes revisar envíos de formularios anteriores de tus usuarios.

Lista de Envíos

Puedes buscar envíos por nombre de usuario remitente y por nombre de formulario, pero no por campos dentro del envío del formulario.

Haz clic en "Ver" para ver los datos del formulario completado. La vista es solo lectura.

Página de Configuración

La página de configuración de Formularios de Autoservicio permite gestionar los formularios existentes, 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 JSON Schema. Esto define qué campos deben ingresarse 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 del formulario.

Editor de Esquemas

Sobre el editor hay dos campos. Usa el campo izquierdo para dar a tu formulario un nombre descriptivo. Usa el campo derecho 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, presiona "Enviar" para guardar tus cambios. Mostrará un error si la comprobación de sintaxis falla.

JSON Schema

El uso de JSON Schema está fuera del alcance de este documento. Puedes usar generadores de esquemas en línea (como este) para simplificar el proceso.

Para dar al menos un punto de partida, examinemos el esquema de nuestro ejemplo

{
  "title": "Person",
  "type": "object",
  "required": [
    "name",
    "date",
    "location",
    "pets"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "First and Last name",
      "minLength": 4,
      "default": "- Your Name here -"
    },
    "date": {
      "type": "string",
      "format": "date",
      "options": {
        "flatpickr": {}
      }
    },
    "location": {
      "type": "object",
      "title": "Location",
      "properties": {
        "city": {
          "type": "string",
          "default": "San Francisco"
        },
        "state": {
          "type": "string",
          "default": "CA"
        },
        "citystate": {
          "type": "string",
          "description": "This is generated automatically from the previous two fields",
          "template": "{{city}}, {{state}}",
          "watch": {
            "city": "location.city",
            "state": "location.state"
          }
        }
      }
    },
    "pets": {
      "type": "array",
      "format": "table",
      "title": "Pets",
      "uniqueItems": true,
      "items": {
        "type": "object",
        "title": "Pet",
        "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. Cada objeto debe al menos tener un tipo y un nombre.

Tipos

Objeto

Los objetos "complejos" que contienen otros objetos secundarios deben usar el objeto tipo. En nuestro ejemplo, el nodo raíz "Person" del esquema es de este tipo.

Puedes definir campos obligatorios usando la required palabra clave. Estos campos también deben estar definidos en el esquema.

Usa properties para describir las características de cada campo necesario, esto incluye dar un tipo y un nombre.

Arreglo

Los arreglos te permiten añadir múltiples items similares a una lista. Usa la items palabra clave para describir el tipo de los items, etc.

Cadena

Solo texto simple. Puedes rellenarlo previamente usando la predeterminada palabra clave.

Para permitir solo ciertos valores, puedes usar la enum palabra clave.