セルフサービスフォーム

概要

セルフサービスフォームを使用して、ユーザーから構造化データを収集できます。これは、ユーザーにインシデントを報告させたり、オフィスでの新しい職場配置の必要性などの変更を示してもらうために使用できます。

"セルフサービスフォーム"はオプション機能であり、RealmJoinサポートによってテナントに有効化できます。有効化されていない場合でも、設定ページでフォームを入力/準備することはできますが、ユーザーはセルフサービスフォームを閲覧/使用することはできません。

例として「新しいペットを登録する」をワークフローで使用します。

フォームの例

フォームの使用方法

を使用して ナビゲーション項目から、ユーザーは記入して送信するフォームを選択できます。

フォームセレクタ

ユーザーがフォームに記入して送信すると、その内容はフォーム定義で指定された受信者宛てに電子メールで送信されます。メールはRealmJoinのインフラストラクチャ経由で送信され、あなたの会社のメールアドレスから送信されることはありません。

フォームからのサンプルメール

セルフサービスフォームがあなたのテナントで有効になっている場合、すべてのユーザーがフォームを使用/送信できます。

送信の確認

を使用して ナビゲーションアイコンから、ユーザーの過去のフォーム送信を確認できます。

送信一覧

送信は送信ユーザー名やフォーム名で検索できますが、フォーム送信内のフィールドでは検索できません。

"表示"をクリックして記入されたフォームデータを確認してください。表示は読み取り専用です。

設定ページ

セルフサービスフォームの設定ページでは、既存のフォームの管理やフォームの追加、編集、削除ができます。

設定ページ上のフォーム一覧

フォーム一覧

"新しいフォーム"または"編集"を使用して、フォームを JSON Schemaで記述してください。これにより、どのフィールドを入力する必要があるか、どの値が有効かが定義されます。UIは構文チェック可能なエディタと結果として得られるフォームのプレビューを提供します。

スキーマはユーザー向けのフォームを動的に作成するために使用されます。基本的に、望ましいデータを記述するだけでなく、スキーマを使ってフォームのUIを暗黙的に作成してください。

スキーマエディタ

エディタの上部には2つのフィールドがあります。左側のフィールドにはフォームの説明的な名前を付けてください。右側のフィールドには、ユーザーが送信したデータの受信者のメールアドレス名を記入してください。

スキーマエディタのサンプル

"JSONフォームプレビューを更新"を使用して、エディタの下に生成されるフォームのプレビューを作成できます。

エディタプレビュー

スキーマを変更した後、"送信"を押して変更を保存してください。構文チェックに失敗した場合はエラーが表示されます。

JSON Schema

JSON Schemaの使用法はこのドキュメントの範囲外です。プロセスを簡素化するために（例えば こちらのような）オンラインスキーマジェネレーターを使用できます。

少なくとも出発点を示すために、例のスキーマを見てみましょう

{
  "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"
        }
      ]
    }
  }
}

すべてのJSON Schemaはオブジェクトで構成されます。各オブジェクトは少なくともタイプと名前を持っている必要があります。

タイプ

オブジェクト

他の子オブジェクトを含む「複雑な」オブジェクトは object タイプを使用するべきです。例ではスキーマのルートノード"Person"がこのタイプです。

必須フィールドは required キーワードを使用して定義できます。これらのフィールドはスキーマ内でも定義されている必要があります。

を使用して properties 各フィールドに必要な特徴を記述します。これにはタイプや名前を指定することが含まれます。

配列

配列を使うと、複数の類似した items をリストに追加できます。アイテムのタイプなどを記述するには items キーワードを使用してください。

文字列

単なるプレーンテキストです。これを事前入力するには デフォルト キーワードを使用できます。

特定の値のみを許可するには、 enum キーワードを使用できます。