Self-Service-Formulare

Übersicht

Sie können Self Service Forms verwenden, um strukturierte Daten von Benutzern zu sammeln. Dies kann genutzt werden, damit Benutzer Vorfälle melden oder Änderungen angeben, wie den Bedarf an einer neuen Arbeitsplatz-Einrichtung in einem Büro.

"Self Service Forms" ist eine optionale Funktion, die von RealmJoin Support für Ihren Mandanten aktiviert werden kann. Wenn sie nicht aktiviert ist, können Sie Formulare weiterhin auf der Einstellungsseite eingeben/vorbereiten, aber Benutzer können Self Service Forms nicht sehen/verwenden.

Wir werden einen Workflow zur "Anmeldung eines neuen Haustiers" als Beispiel verwenden.

Formularbeispiel

Verwendung von Formularen

Verwendung des Navigationselements können Benutzer ein Formular auswählen, ausfüllen und absenden.

Formularauswahl

Wenn ein Benutzer ein Formular ausfüllt und absendet, werden dessen Inhalte per E-Mail an den im Formular definier-ten Empfänger gesendet. Die E-Mail wird über die Infrastruktur von RealmJoin gesendet und stammt nicht von den E-Mail-Adressen Ihres Unternehmens.

Beispiel-E-Mail aus einem Formular

Wenn Self Service Forms für Ihren Mandanten aktiviert sind, können alle Benutzer Formulare verwenden/absenden.

Eingaben prüfen

Verwendung des Über das Navigationssymbol können Sie vergangene Formulareinreichungen Ihrer Benutzer prüfen.

Liste der Einreichungen

Sie können Einreichungen nach sendendem Benutzernamen und nach Formularnamen suchen, aber nicht nach Feldern innerhalb der Formulareinreichung.

Klicken Sie auf "Ansehen", um die ausgefüllten Formulardaten zu sehen. Die Ansicht ist schreibgeschützt.

Einstellungsseite

Die Einstellungsseite für Self Service Forms ermöglicht die Verwaltung vorhandener Formulare, Hinzufügen, Bearbeiten und Löschen von Formularen.

Formularliste auf der Einstellungsseite

Formularliste

Verwenden Sie "Neues Formular" oder "Bearbeiten", um das Formular mit Hilfe von JSON Schema. Dies definiert, welche Felder ausgefüllt werden müssen und welche Werte gültig sind. Die Benutzeroberfläche bietet einen Editor zur Syntaxprüfung und eine Vorschau des resultierenden Formulars.

Das Schema wird verwendet, um dynamisch ein Formular für den Benutzer zu erstellen. Verwenden Sie das Schema im Grunde nicht nur, um die gewünschten Daten zu beschreiben, sondern auch, um die Formular-Benutzeroberfläche implizit zu erstellen.

Schema-Editor

Über dem Editor befinden sich zwei Felder. Verwenden Sie das linke Feld, um Ihrem Formular einen beschreibenden Namen zu geben. Verwenden Sie das rechte Feld, um die E-Mail-Adresse des Empfängers der vom Benutzer übermittelten Daten anzugeben.

Beispiel Schema-Editor

Sie können "JSON-Formular-Vorschau aktualisieren" verwenden, um eine Vorschau des resultierenden Formulars unterhalb des Editors zu erstellen.

Editor-Vorschau

Nach dem Ändern des Schemas drücken Sie "Senden", um Ihre Änderungen zu speichern. Es wird einen Fehler anzeigen, wenn die Syntaxprüfung fehlschlägt.

JSON Schema

Die Verwendung von JSON Schema liegt außerhalb des Umfangs dieses Dokuments. Sie können Online-Schema-Generatoren verwenden (wie diese hier), um den Prozess zu vereinfachen.

Um zumindest einen Ausgangspunkt zu geben, untersuchen wir das Schema aus unserem Beispiel

{
  "title": "Person",
  "type": "object",
  "required": [
    "name",
    "date",
    "location",
    "pets"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Vor- und Nachname",
      "minLength": 4,
      "default": "- Dein Name hier -"
    },
    "date": {
      "type": "string",
      "format": "date",
      "options": {
        "flatpickr": {}
      }
    },
    "location": {
      "type": "object",
      "title": "Ort",
      "properties": {
        "city": {
          "type": "string",
          "default": "San Francisco"
        },
        "state": {
          "type": "string",
          "default": "CA"
        },
        "citystate": {
          "type": "string",
          "description": "Dies wird automatisch aus den vorherigen zwei Feldern generiert",
          "template": "{{city}}, {{state}}",
          "watch": {
            "city": "location.city",
            "state": "location.state"
          }
        }
      }
    },
    "pets": {
      "type": "array",
      "format": "table",
      "title": "Haustiere",
      "uniqueItems": true,
      "items": {
        "type": "object",
        "title": "Haustier",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "cat",
              "dog",
              "bird",
              "reptile",
              "other"
            ],
            "default": "dog"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "default": [
        {
          "type": "dog",
          "name": "Walter"
        }
      ]
    }
  }
}

Jedes JSON Schema besteht aus Objekten. Jedes Objekt muss mindestens einen Typ und einen Namen haben.

Typen

Objekt

"Komplexe" Objekte, die andere Unterobjekte enthalten, sollten den object Typ verwenden. In unserem Beispiel ist der Wurzelknoten "Person" des Schemas von diesem Typ.

Sie können Pflichtfelder mit dem required Schlüsselwort definieren. Diese Felder müssen ebenfalls im Schema definiert sein.

Verwenden Sie properties um die Merkmale jedes benötigten Feldes zu beschreiben, dies umfasst die Angabe eines Typs und eines Namens.

Array

Arrays erlauben es Ihnen, mehrere ähnliche items zu einer Liste hinzuzufügen. Verwenden Sie das items Schlüsselwort, um den Typ der Items usw. zu beschreiben.

String

Einfach nur reiner Text. Sie können dies mit dem Standard- Schlüsselwort vorbefüllen.

Um nur bestimmte Werte zuzulassen, können Sie das enum Schlüsselwort vorbefüllen.