Formulaires Self Service

RealmJoin Self Service Forms collecte des données structurées auprès des utilisateurs, telles que des rapports d'incident ou des demandes de changement, une fois activé par le Support.

Aperçu

Vous pouvez utiliser Self Service Forms pour collecter des données structurées auprès des utilisateurs. Cela peut servir à permettre aux utilisateurs de signaler des incidents ou d'indiquer des changements, comme le besoin d'une nouvelle configuration de poste de travail dans un bureau.

"Self Service Forms" est une fonctionnalité optionnelle qui peut être activée pour votre Tenant par RealmJoin Support. Si elle n'est pas activée, vous pouvez tout de même saisir/préparer des formulaires dans la page des paramètres, mais les utilisateurs ne pourront pas voir/utiliser les formulaires en libre-service.

Nous utiliserons un workflow pour « indiquer un nouvel animal de compagnie » comme exemple.

Exemple de formulaire

Utilisation des formulaires

À l'aide de la élément de navigation, les utilisateurs peuvent sélectionner un formulaire à remplir et à soumettre.

Sélecteur de formulaire

Lorsqu'un utilisateur remplit et soumet un formulaire, son contenu sera envoyé par e-mail au destinataire indiqué dans la définition du formulaire. L'e-mail sera envoyé via l'infrastructure de RealmJoin et ne proviendra pas des adresses e-mail de votre entreprise.

Exemple d'e-mail d'un formulaire

Lorsque Self Service Forms est activé pour votre Tenant, tous les utilisateurs peuvent utiliser / soumettre des formulaires.

Examiner les soumissions

À l'aide de la icône de navigation, vous pouvez consulter les anciennes soumissions de formulaires de vos utilisateurs.

Liste des soumissions

Vous pouvez rechercher des soumissions par nom d'utilisateur expéditeur et par nom de formulaire, mais pas par les champs de la soumission du formulaire.

Cliquez sur « Voir » pour voir les données du formulaire rempli. La vue est en lecture seule.

Page des paramètres

La page des paramètres de Self Service Forms permet de gérer les formulaires existants, d'en ajouter, de les modifier et de les supprimer.

Liste des formulaires sur la page des paramètres

Liste des formulaires

Utilisez « Nouveau formulaire » ou « Modifier » pour décrire le formulaire à l'aide de Schéma JSON. Cela définit quels champs doivent être saisis et quelles valeurs sont valides. L'interface utilisateur propose un éditeur de vérification de syntaxe et un aperçu du formulaire obtenu.

Le schéma sera utilisé pour créer dynamiquement un formulaire pour l'utilisateur. En pratique, utilisez le schéma non seulement pour décrire les données souhaitées, mais aussi pour créer implicitement l'interface utilisateur du formulaire.

Éditeur de schéma

Au-dessus de l'éditeur, il y a deux champs. Utilisez le champ de gauche pour donner à votre formulaire un nom descriptif. Utilisez le champ de droite pour nommer l'adresse e-mail du destinataire des données soumises par l'utilisateur.

Exemple d'éditeur de schéma

Vous pouvez utiliser « Mettre à jour l'aperçu du formulaire JSON » pour créer un aperçu du formulaire obtenu sous l'éditeur.

Aperçu de l'éditeur

Après avoir modifié le schéma, appuyez sur « Soumettre » pour enregistrer vos modifications. Une erreur s'affichera si la vérification de la syntaxe échoue.

Schéma JSON

L'utilisation de JSON Schema sort du cadre de ce document. Vous pouvez utiliser des générateurs de schémas en ligne (comme celui-ci) pour simplifier le processus.

Pour donner au moins un point de départ, examinons le schéma de notre exemple

{
  "title": "Personne",
  "type": "object",
  "required": [
    "name",
    "date",
    "location",
    "pets"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Prénom et nom",
      "minLength": 4,
      "default": "- Votre nom ici -"
    },
    "date": {
      "type": "string",
      "format": "date",
      "options": {
        "flatpickr": {}
      }
    },
    "location": {
      "type": "object",
      "title": "Localisation",
      "properties": {
        "city": {
          "type": "string",
          "default": "San Francisco"
        },
        "state": {
          "type": "string",
          "default": "CA"
        },
        "citystate": {
          "type": "string",
          "description": "Ceci est généré automatiquement à partir des deux champs précédents",
          "template": "{{city}}, {{state}}",
          "watch": {
            "city": "location.city",
            "state": "location.state"
          }
        }
      }
    },
    "pets": {
      "type": "array",
      "format": "table",
      "title": "Animaux de compagnie",
      "uniqueItems": true,
      "items": {
        "type": "object",
        "title": "Animal de compagnie",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "chat",
              "chien",
              "oiseau",
              "reptile",
              "autre"
            ],
            "default": "chien"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "default": [
        {
          "type": "chien",
          "name": "Walter"
        }
      ]
    }
  }
}

Chaque schéma JSON est constitué d'objets. Chaque objet doit au moins avoir un type et un nom.

Types

Objet

Les objets « complexes » contenant d'autres objets enfants doivent utiliser le objet type. Dans notre exemple, le nœud racine « Personne » du schéma est de ce type.

Vous pouvez définir des champs obligatoires à l'aide du required mot-clé. Ces champs doivent également être définis dans le schéma.

Utilisez propriétés pour décrire les caractéristiques requises de chaque champ, y compris lui attribuer un type et un nom.

Tableau

Les tableaux vous permettent d'ajouter plusieurs éléments similaires éléments à une liste. Utilisez le éléments mot-clé pour décrire le type des éléments, etc.

Chaîne

Du texte simple. Vous pouvez le préremplir à l'aide du default mot-clé.

Pour n'autoriser que certaines valeurs, vous pouvez utiliser le enum mot-clé.