Formularios de autoservicio

RealmJoin Self Service Forms recopila datos estructurados de los usuarios, como informes de incidentes o solicitudes de cambio, una vez habilitado por Support.

Descripción general

Puede usar Self Service Forms para recopilar datos estructurados de los usuarios. Esto puede usarse para permitir que los usuarios informen incidencias o indiquen cambios, como la necesidad de una nueva configuración de puesto de trabajo en una oficina.

"Self Service Forms" es una función opcional que RealmJoin Support 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 se enviará a través de la infraestructura de RealmJoin y no procederá de las direcciones de correo de su empresa.

Correo electrónico de ejemplo de un formulario

Cuando Self Service Forms está habilitado para su Tenant, todos los usuarios pueden usar / enviar formularios.

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 del remitente y por nombre del formulario, pero no por los campos del envío del formulario.

Haga clic en "View" 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, añadir, editar y eliminar formularios.

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

Lista de formularios

Use "New Form" o "Edit" para describir el formulario usando JSON Schema. Esto define qué campos deben introducirse y qué valores son válidos. La IU 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 IU del formulario.

Editor de esquema

Encima del editor hay dos campos. Use el campo izquierdo para darle a su formulario un nombre descriptivo. Use el campo derecho 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 "Update JSON Form Preview" para crear una vista previa del formulario resultante debajo del editor.

Vista previa del editor

Después de modificar el esquema, pulse "Submit" 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) para simplificar el proceso.

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

{
  "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",
              "ave",
              "reptil",
              "otro"
            ],
            "default": "perro"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "default": [
        {
          "type": "perro",
          "name": "Walter"
        }
      ]
    }
  }
}

Cada JSON Schema consta de objetos. Cada objeto debe tener al menos un tipo y un nombre.

Tipos

Objeto

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

Puede definir campos obligatorios usando la required palabra clave. Estos campos también deben definirse en el esquema.

Utilice properties para describir las características de cada campo necesario; esto incluye proporcionar un tipo y un nombre.

Arreglo

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

Cadena

Texto sin formato. Puede rellenarlo previamente usando la predeterminado palabra clave.

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