Skip to main content

はじめに

Form Builder Appでは、カスタマイズされたフォーム、フォームテンプレート、ユーザーからのフィードバックを収集するためのアンケートを作成および編集できます。フォームにデータを入力するには、Form Viewer Appを使用します。Domo Appstoreから両方のAppをダウンロードしてインストールできます。Form Builderはトライアルモードでダウンロードできます。Appを購入すると、トライアルバージョンはフルバージョンに変換されます。
注記:Form Builderのトライアルバージョンに機能の制限はありません
Form Builderは、複数のDomoダッシュボードに作成できます。Form Viewerを使用してフォームに入力された回答データは、Appデータベースに保存され、Domo Data Centerに同期されます。通常は、その後、Domoでデータを変換する必要があります。

回答DataSet

Form Builderで作成した1つのフォームを使用して、1つまたは複数のForm Viewerのインスタンスでデータを収集することも、Form Builder自体でデータを収集することもできます。

例えば、ユーザーAとユーザーBが、それぞれ別のForm Viewerのインスタンスを使用して、同じフォームにデータを入力するとします。また、Form Builderでフォームを作成したユーザーCも同じフォームにデータを入力するとします。 この状況では、フォームに対する回答のDataSetが3つあります(ユーザーAの回答、ユーザーBの回答、ユーザーCの回答)。 デフォルトでは、これらのDataSetには以下の命名規則があります。 < フォーム名
Responses - < フォームのGUID _< Form BuilderまたはViewerのインスタンスのGUID > 回答データの詳細については、「 フォーム回答データについて 」を参照してください。

必要条件

フォーム、テンプレート、またはアンケートを作成する前に、Domoインスタンスで以下のグループを作成しておく必要があります。
  • _FB_CreateForms_
  • _FB_CreateTemplate_
Form Builderを使用している間、これらのグループはグループメンバーに固有の権限セットを付与します。
  • _FB_CreateForms_グループのメンバーには、自分が属するDomoグループ用にフォームを作成して管理する権限が付与されます。
  • _FB_CreateTemplate_グループのメンバーには、すべてのDomoグループとユーザー用にアンケート、テンプレート、フォームを管理する権限が付与されます。
**注記:**フォームにデータを入力するには、これらのグループのメンバーである必要はありません。フォームの作成および編集が必要なユーザーのみがグループのメンバーである必要があります。

設定

AppstoreからForm Builderをダウンロードします。Appをダウンロードすると、自動的にそのダッシュボードが作成されます。App用のカードはDomo Asset Libraryから追加できます。
**注記:**Appの新しいカードを展開すると、「An error occurred while fetching data from the server」というエラーメッセージが表示される場合があります。これは、カードを保存するまで、基盤となるアプリケーションデータの一部が作成されないためです。このエラーは無視できます。
Form Builderを使用するには、Form Builder用に配置されているダッシュボードにアクセスし、この記事で後ほど説明するタスクのいずれかを選択します。

FormDefinition DataSet

Form Builderで最初のフォームを作成した後、一連のFormDefinition DataSetがDomoに作成され、Data Centerに表示されます。これらのDataSetにはフォームを定義するメタデータが含まれています。Appを使用するには、これらのFormDefinition DataSetをForm Viewerに接続する必要があります。
**重要:**Appアセットを所有するユーザーは、アクティブなユーザーである必要があります。非アクティブなユーザーの場合、DataSetは更新されません。
FormDefinition DataSetは以下の通りです。
  • ExportForms
  • ExportGroups
  • ExportTags
  • ExportSubmittedUsers
  • ExportSections
  • ExportItems
  • ExportColumns
  • ExportFilters
  • ExportPreviousResponseItems
Form ViewerでこれらのDataSetに接続する方法については、「Form Viewer」を参照してください。

フォームを作成する

Appのインストール後、_FB_CreateForms_グループまたは**_FB_CreateTemplate_**グループのメンバーであれば、フォームを作成および管理するためのアクセス権が付与されています。
  1. Form Builderカードを開いて**[Form]**タブに進みます。
  2. **[Create Form]**を選択します。
create_form.png
フォームエディターが表示されます。
  1. フォームを定義します。フォームの定義については以下を参照してください。

基本的なフォームの定義

フォームエディターで以下の項目を使用して基本的なフォーム定義を設定することにより、新規フォームを作成したり、既存のフォームを管理したりするときに、ユーザーがフォームをどのように検索し、操作するかを選択できます。
  • [Name] — フォームの名前
  • [Description](オプション) — フォームの説明
  • [Tags](オプション) — フォームを迅速に見つけられるようにする検索可能なタグ
  • [Groups](オプション) — フォームに返信することを許可されているユーザー(1つ以上のグループで指定)
  • [Response Type](必須) — 回答の制限とフォーマットを決定します
  • [Form Settings](オプション) — ユーザーがフォームを操作できる様々な方法
Screen_Shot_2022-05-04_at_5.00.49_PM.png

回答タイプ

エンドユーザーがフォームをどのように操作できるかを管理する回答タイプには、複数のタイプがあります。各タイプは特定の使用事例に適しています。下表は、フォームエディターで利用可能な4つの回答タイプの定義および使用事例に関するメモを示します。 一括回答の定義は、表の下にあります。

一括回答

一括回答オプションは、フォームエディターの**[Response Type]**メニューでは利用できません。使用するには、以下の手順に従ってください。
  1. フォームエディターの**[Form Settings]で、[Allow bulk response uploads]**ボックスにチェックを入れます。
allow_bulk_response.png
  1. Form Builderでフォームの設定を終了します。
  2. Form Viewerで**[Bulk Upload]**を選択します。
    [Bulk Upload]メニューが表示されます。
  3. **[Download Template]**を選択します。
mceclip3.png
一括回答テンプレートはカンマ区切り値ファイル(.CSV)形式でフォーマットされます。デフォルトでは、最初の4行には重要なメタデータが含まれており、アップロード時にファイルと回答を正しく解析して送信できます。テンプレートのデフォルト値は、上から順に以下の通りです。
  1. Section ID
  2. Section Name
  3. Question ID
  4. Question Name
**注記:**これらの値およびその他の回答データの詳細については、「フォーム回答データについて」を参照してください。
  1. 回答を.CSVファイルに入力します。
  2. Form Viewerで、[Bulk Upload]>**[Upload Bulk Responses]**を選択します。
  3. 回答を記入したファイルをアップロードします。
  4. 一括回答が処理されるまで待ちます。エラーが見つかると、通知が送信され、エラーが解決されるまですべての回答が却下されます。
**重要:**一括回答テンプレートの最初の4行は未変更のままにする必要があります。変更されたテンプレートは送信時に却下される可能性があります。

フォームの設定

下表は、フォームエディターで利用可能な各フォーム設定の定義を示します。

セクション

フォーム定義を入力したら、フォームに質問を追加する前に、少なくとも1つのセクションを追加する必要があります。定義する各セクションは、エンドユーザーがデータを入力するときにフォームのページとして表示されます。関連する質問を同じセクションにまとめておくと便利です。 Form Builderは2つのタイプのセクションをサポートしています。
  • 項目セクション テキスト入力やドロップダウン選択など、標準の質問タイプをサポートしています。
  • 表セクション 表カードを使ってユーザーに項目入力を要求します。

セクションを追加する

フォームエディターの右側のセクション管理メニューで、
mceclip3.png
**[Add Item Section]**または **[Add Table Section]**を選択します。
section_management_menu.png
新しい名前のないセクションはフォームエディターの下に表示されます。 整理しておくために**[Section Name]**を入力して、各セクションに名前を付けることを推奨します。
section.png

セクションを並べ替える

  1. セクション管理メニューで **[Reorder]**を選択します。
    **[Reorder Sections]**モーダルが表示されます。 2. カーソルが手の形に変わるまで、移動したいセクションの クリック&ドラッグハンドルにカーソルを合わせます。
  2. ハンドルをクリックしてセクションを希望する位置にドラッグします。

セクションを削除する

  1. 削除するセクションを見つけ、 **[More Options]**を選択します。
section_options.png
  1. **
    mceclip10.png
    ****[Delete]**を選択します。
削除を確認するダイアログが表示されます。再度**[Delete]**を選択すると、セクションが削除されます。この操作を取り消すことはできません。 # 項目セクション 下表は、項目セクションでサポートされている項目と質問のタイプの定義を示します。 項目タイプを選択するには、セクション定義の下部にある項目管理メニューのアイコンを選択します。項目と質問のタイプの詳細については、後述の「詳細な項目設定」を参照してください。
mceclip20.png

表セクション

mceclip1.png
表セクションはDomo表カードを利用してデータを表示し、ユーザーに行/列フォーマットの入力を要求します。 表セクションを選択したら、セクションで**[Table Card]**メニューを選択し、表カードのあるページ/ダッシュボードを見つけて選択します。
Screen_Shot_2022-09-20_at_2.57.52_PM.png
次のメニューコントロールを使用して、選択したページ/ダッシュボードから表カードを探します。使用する表カードを選択し、**[Connect]**をクリックして接続プロセスを開始します。
Screen_Shot_2022-09-20_at_2.59.31_PM.png
**注記:**表セクションはPDPをサポートしています。

表カードを接続する

表セクションに接続する表カードを選択すると、モーダルが表示されます。 表から1つ以上の列を選択する必要があります。その列の値を結合すると、各行を一意に識別できます。表カードには、固有のID列を持つものも、複数の識別子列を必要とするものもあります。下記の例では、識別子列は地域、州、都市です。 識別子列を選択したら、**[Connect]**を選択して接続処理を完了します。
mceclip25.png

表の列

接続処理が完了すると、Form Builderのフォームの表セクションに表カードを構成する列のリストが表示されます。列のリスト項目の右側にあるメニューオプションで利用可能なオプションを選択すると、列の入力タイプを変更できます。
mceclip26.png
下表は、表列がサポートする入力タイプを説明しています。
**注記:**識別子列を入力列として設定することはできません。
列リストの下部にある**[Add Column]**を選択すると、カスタム列を追加できます。カスタム列の名前を変更するには、名前を表示するスペースの上にカーソルを置き、グレーのボックスを選択してテキストエディターをアクティブにします。希望する名前を入力し、クリックしてテキスト入力の外側をクリックします。
blobid1.png
カスタム列を削除したり、既存の列の可視化を変更したりするには、列のリスト項目の左側にカーソルを置き、 **[Delete]**または **[Hide Column]**を選択します。
mceclip30.png

表フィルター(フィルターフィールド)

**[Filter Field]サブメニューの下で、表の行をフィルターするために使用できるフィールドを管理できます。フィルターフィールドは、割り当てられた列の固有の値を含むドロップダウンメニュー(選択ボックス)です。ユーザーがこれらのフィールドの選択を変更して新しい選択を適用すると、フィルターされた表カードのビューが読み込まれ、フィルター設定に一致する行のみが表示されます。フィルターフィールドを追加するには、[Filter Field]入力コントロールから列を選択し、[Add Filter]をクリックします。ユーザーが単一のフィルターで複数の値を選択できるようにするには、リスト項目の右側にある[multi-select]**ボックスにチェックを入れます。
mceclip0.png

表の設定

表セクションの表示方法と使用方法を管理するために、以下の設定がサポートされています。

詳細な項目設定

下表は、様々な項目と質問タイプでサポートされている設定を示しています。

ページフィルターを使う

フォームがDomoの統合コンポーネントの一部のように感じられるように、Form BuilderとForm Viewerのアプリケーションはページフィルターをサポートしています。以下の手順に従い、DataSetをアプリケーションに接続し、ページフィルターを有効にします。

データをForm BuilderとForm Viewerに接続する

  1. Form BuilderまたはForm Viewerを開きます。
  2. **[Card options]**を選択します。
  3. **[Edit Card]**を選択します。
    カードエディターが開きます。
  4. 一番下までスクロールしてFilterConfiguration DataSetのリストを検索します。
    Form BuilderとForm Viewerの両方で25個のプレースホルダーDataSetを使用し、表や検索フィルターに使用するDataSetを変更できます。
  5. 使用していないFilterConfiguration DataSetのいずれかを選択します。
  6. **[Select DataSet]**でDataSetを選択します。
    **[Select a DataSet]**モーダルが表示されます。
  7. アプリケーションに接続するDataSetを検索して選択します。
  8. **[Choose DataSet]**を選択します。
  9. **[Save & Finish]**を選択して、エディターを閉じます。
    DataSetをアプリケーションに接続すると、そのページフィルターが関連するクエリにも適用されます。
**注記:**ページフィルターは、検索の質問/表セクションの作成に使用された表カードが、ページフィルターが対象としているDataSetと一致している場合、検索の質問または表セクションにのみ適用されます。

設定例

以下の表カードがあるとします。
mceclip38.png
この表カードを使用すると、列ごとに検索の質問を作成できます。 | 地域の検索の質問
mceclip40.png
| | 州の検索の質問
mceclip41.png
| | 都市の検索の質問
mceclip43.png
|
州のリストを、ユーザーが地域の検索の質問で選択した地域内の州に限定する場合、の検索の質問の下にある**[Use previous lookup question response to filter available options]というメニューで[State]を選択することができます。新しい州**の検索の質問の設定:
mceclip44.png
同様に、利用可能な都市をの検索の質問でユーザーによって選択された州の都市に限定するには、以下のように都市の検索の質問を設定できます。
mceclip45.png
アクティブなセッションでユーザーがこれらの質問を表示すると、次のように表示されます。
mceclip46.png
地域に依存させると、ユーザーが地域を選択するまでの入力も無効になります。また、利用可能なの値は選択された地域に対応する値に、都市の値は選択されたに対応する値に制限されます。 |
mceclip48.png
|
mceclip47.png
|