セルフサービスフォーム

RealmJoin Self Service Forms は、Support により有効化されると、インシデント報告や変更要求など、ユーザーから構造化データを収集します。

概要

Self Service Forms を使うと、ユーザーから構造化データを収集できます。これを使えば、インシデントの報告や変更の申請、たとえばオフィスで新しいワークプレースの設定が必要だと知らせる、といったことができます。

「Self Service Forms」は、RealmJoin Support によってあなたのテナントで有効化できる任意の機能です。有効化されていない場合でも、設定ページでフォームを作成/準備することはできますが、ユーザーはセルフサービスフォームを表示/使用できません。

例として、「新しいペットを申告する」というワークフローを使用します。

フォームの使用

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

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

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

送信内容の確認

ナビゲーション項目を使うとナビゲーションアイコンを使うと、ユーザーの過去のフォーム送信を確認できます。

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

「表示」をクリックすると、入力済みフォームデータを表示できます。表示は読み取り専用です。

設定ページ

Self Service Forms の設定ページでは、既存フォームの管理、フォームの追加・編集・削除を行えます。

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

「New Form」または「Edit」を使用して、フォームを JSON Schemaで記述します。これにより、入力が必要なフィールドと有効な値が定義されます。UI には、構文チェック付きエディターと生成結果のフォームのプレビューがあります。

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

スキーマエディター

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

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

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

JSON Schema

JSON Schema の使用法はこの文書の範囲外です。オンラインのスキーマジェネレーター（たとえばこちら）を使うと、手順を簡単にできます。

まずは出発点として、例のスキーマを見てみましょう

{
  "title": "人物",
  "type": "object",
  "required": [
    "name",
    "date",
    "location",
    "pets"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "姓と名",
      "minLength": 4,
      "default": "- ここに名前を入力 -"
    },
    "date": {
      "type": "string",
      "format": "date",
      "options": {
        "flatpickr": {}
      }
    },
    "location": {
      "type": "object",
      "title": "所在地",
      "properties": {
        "city": {
          "type": "string",
          "default": "サンフランシスコ"
        },
        "state": {
          "type": "string",
          "default": "CA"
        },
        "citystate": {
          "type": "string",
          "description": "これは前の 2 つのフィールドから自動的に生成されます",
          "template": "{{city}}, {{state}}",
          "watch": {
            "city": "location.city",
            "state": "location.state"
          }
        }
      }
    },
    "pets": {
      "type": "array",
      "format": "table",
      "title": "ペット",
      "uniqueItems": true,
      "items": {
        "type": "object",
        "title": "ペット",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "猫",
              "犬",
              "鳥",
              "爬虫類",
              "その他"
            ],
            "default": "犬"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "default": [
        {
          "type": "犬",
          "name": "Walter"
        }
      ]
    }
  }
}

すべての JSON Schema はオブジェクトで構成されています。すべてのオブジェクトには少なくとも type と name が必要です。

型

オブジェクト

他の子オブジェクトを含む「複雑な」オブジェクトには、 object 型を使用します。例では、スキーマのルートノードである「Person」はこの型です。

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

使用してください properties を使って、必要な各フィールドの機能を説明します。これには type と name を指定することが含まれます。

配列

配列を使うと、同様の 項目を リストに追加できます。 項目を キーワードを使って、項目の型などを説明します。

文字列

ただのテキストです。これには既定キーワードを使って事前入力できます。

特定の値だけを許可するには、 enum キーワードを使って事前入力できます。

最終更新 1 か月前

役に立ちましたか？