Form Builder App

​

はじめに

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］**を選択します。

フォームエディターが表示されます。

3. フォームを定義します。フォームの定義については以下を参照してください。

​

基本的なフォームの定義

フォームエディターで以下の項目を使用して基本的なフォーム定義を設定することにより、新規フォームを作成したり、既存のフォームを管理したりするときに、ユーザーがフォームをどのように検索し、操作するかを選択できます。

• ［Name］ — フォームの名前
• ［Description］（オプション） — フォームの説明
• ［Tags］（オプション） — フォームを迅速に見つけられるようにする検索可能なタグ
• ［Groups］（オプション） — フォームに返信することを許可されているユーザー（1つ以上のグループで指定）
• ［Response Type］（必須） — 回答の制限とフォーマットを決定します
• ［Form Settings］（オプション） — ユーザーがフォームを操作できる様々な方法

​

回答タイプ

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

一括回答の定義は、表の下にあります。

回答タイプ	説明
Crowdsourced (Collaborative)	Crowdsourced回答では、複数のユーザーが同じ投稿に貢献できます。 アクティブな投稿を読み込むと、ユーザーはほかのユーザーの未送信の回答を見ることができます。 ユーザーは送信せずにフォーム送信を保存し、後で戻って送信前に修正することができます。
One response per user	各ユーザーは1つの回答しか送信できません。 このタイプは、投票の収集やほかの1回限りの回答の取得に役立ちます。
Multiple responses per user	ユーザーは複数の回答を送信できます。 このタイプは、メンテナンスリクエストなど、何度もデータを収集する場合に役立ちます。
Multi-session form	ユーザーは複数の回答を送信できます。一度に複数の名前付きセッションをアクティブにすることができます。フォームにアクセスすると、新しい入力の開始または既存のセッションの再開が要求されます。 既存のセッションの名前を変更するには、セッション名を選択してテキスト入力をアクティブにし、希望するタイトルを入力し、クリックしてテキスト入力を終了して新しい名前を保存します。 ユーザーは送信せずにフォーム送信を保存し、後で戻って送信前に修正することができます。

​

一括回答

一括回答オプションは、フォームエディターの**［Response Type］**メニューでは利用できません。使用するには、以下の手順に従ってください。

1. フォームエディターの**［Form Settings］で、［Allow bulk response uploads］**ボックスにチェックを入れます。

2. Form Builderでフォームの設定を終了します。

3. Form Viewerで**［Bulk Upload］**を選択します。
   ［Bulk Upload］メニューが表示されます。

4. **［Download Template］**を選択します。

一括回答テンプレートはカンマ区切り値ファイル（.CSV）形式でフォーマットされます。デフォルトでは、最初の4行には重要なメタデータが含まれており、アップロード時にファイルと回答を正しく解析して送信できます。テンプレートのデフォルト値は、上から順に以下の通りです。

1. Section ID
2. Section Name
3. Question ID
4. Question Name

**注記：**これらの値およびその他の回答データの詳細については、「フォーム回答データについて」を参照してください。

5. 回答を.CSVファイルに入力します。

6. Form Viewerで、［Bulk Upload］>**［Upload Bulk Responses］**を選択します。

7. 回答を記入したファイルをアップロードします。

8. 一括回答が処理されるまで待ちます。エラーが見つかると、通知が送信され、エラーが解決されるまですべての回答が却下されます。

**重要：**一括回答テンプレートの最初の4行は未変更のままにする必要があります。変更されたテンプレートは送信時に却下される可能性があります。

​

フォームの設定

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

設定	説明
Show submit button on every page	送信ボタンをすべてのページに表示するか、フォームの最後のページにのみに表示するかを指定します。
Make all questions required	ボックスにチェックを入れた場合 — ユーザーはフォームを送信する前にすべての質問に対して有効な回答を入力する必要があります（表セクションには適用されません）。 ボックスのチェックを外した場合 — ユーザーは「optional」とマークされた質問には回答しないことを選択できます。 **注記：****［Make all questions required］**ボックスにチェックを入れると、個別の質問に対して必要な設定を変更できなくなります。
Allow bulk response uploads	ユーザーが一括送信できるかどうかを示します（「一括回答」を参照）。
Allow previous submissions to be viewed	ユーザーが以前に送信したフォームの回答を表示できるかどうかを示します。 **［Select preview fields］を使用すると、［Previous Submissions］**ページに表示されるフィールドをユーザーが設定できるようになります。
Allow previous submissions to be edited	ユーザーが以前に送信したフォームの回答を編集できるかどうかを示します。 **［Allow previous submissions to be viewed］**が有効になっていないと利用できません。
Allow previous submissions to be deleted	ユーザーが以前に送信したフォームの回答を削除できるかどうかを示します。 **［Allow previous submissions to be viewed］**が有効になっていないと利用できません。

​

セクション

フォーム定義を入力したら、フォームに質問を追加する前に、少なくとも1つのセクションを追加する必要があります。定義する各セクションは、エンドユーザーがデータを入力するときにフォームのページとして表示されます。関連する質問を同じセクションにまとめておくと便利です。

Form Builderは2つのタイプのセクションをサポートしています。

• 項目セクション — テキスト入力やドロップダウン選択など、標準の質問タイプをサポートしています。
• 表セクション — 表カードを使ってユーザーに項目入力を要求します。

​

セクションを追加する

フォームエディターの右側のセクション管理メニューで、

新しい名前のないセクションはフォームエディターの下に表示されます。

整理しておくために**［Section Name］**を入力して、各セクションに名前を付けることを推奨します。

​

セクションを並べ替える

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

2. ハンドルをクリックしてセクションを希望する位置にドラッグします。

​

セクションを削除する

1. 削除するセクションを見つけ、 **［More Options］**を選択します。

2. **
   
   ****［Delete］**を選択します。

削除を確認するダイアログが表示されます。再度**［Delete］**を選択すると、セクションが削除されます。この操作を取り消すことはできません。 # 項目セクション

下表は、項目セクションでサポートされている項目と質問のタイプの定義を示します。

アイコン	名前	説明
	Title and Description	追加のメタデータおよびコンテキスト情報。 単一のセクション内で論理的な切れ目を作成する場合や、単純に追加情報を提供する場合に使用できます。
	Text	自由形式のテキストによる回答をユーザーに要求します。
	Dropdown	ユーザーによる入力を設定可能なオプションのリストに限定します。
	Date	日付または日付範囲をユーザーに要求します。
	Image	フォームに画像を表示します（ユーザー入力をサポートしていません）。
	Lookup	表カードの固有の値からオプションリストを生成するドロップダウンの質問（PDPに対応）
	File Attachment	ユーザーが回答の一部としてファイルを添付できるようにします。

項目タイプを選択するには、セクション定義の下部にある項目管理メニューのアイコンを選択します。項目と質問のタイプの詳細については、後述の「詳細な項目設定」を参照してください。

​

表セクション

表セクションはDomo表カードを利用してデータを表示し、ユーザーに行/列フォーマットの入力を要求します。

表セクションを選択したら、セクションで**［Table Card］**メニューを選択し、表カードのあるページ/ダッシュボードを見つけて選択します。

次のメニューコントロールを使用して、選択したページ/ダッシュボードから表カードを探します。使用する表カードを選択し、**［Connect］**をクリックして接続プロセスを開始します。

**注記：**表セクションはPDPをサポートしています。

​

表カードを接続する

表セクションに接続する表カードを選択すると、モーダルが表示されます。

表から1つ以上の列を選択する必要があります。その列の値を結合すると、各行を一意に識別できます。表カードには、固有のID列を持つものも、複数の識別子列を必要とするものもあります。下記の例では、識別子列は地域、州、都市です。

識別子列を選択したら、**［Connect］**を選択して接続処理を完了します。

​

表の列

接続処理が完了すると、Form Builderのフォームの表セクションに表カードを構成する列のリストが表示されます。列のリスト項目の右側にあるメニューオプションで利用可能なオプションを選択すると、列の入力タイプを変更できます。

下表は、表列がサポートする入力タイプを説明しています。

**注記：**識別子列を入力列として設定することはできません。

入力	説明	カスタム列のサポート	既存の列のサポート
None	入力コントロールがありません。 表カードから既存のデータを表示します。	いいえ	はい
Checkbox	ボックスにチェックを入れて表から1行以上を選択します。	はい	はい
Dropdown	ユーザーによる入力を、フォームエディターで設定した値セットのみに制限します。	はい	はい
Lookup	表カードの列からユーザー入力を固有の値のみに制限します。検索オプションを設定するには、ページ、カード、列を選択します。	はい	はい
Single Select (radio)	表から1行を選択/マークします。	はい	はい
Text	自由形式のテキスト入力を許可します。	はい	はい
Validated Input	正しい入力コントロールタイプを表示するために表カードの列に割り当てられたタイプを検出します。 サポートされているタイプ： - ［Text］ — 自由形式。検証は強制されていません。 - ［Date (short)］ — 時間値をサポートしていません。 - ［Date (datetime)］ — 時間値をサポートしています。 - ［Numeric (long)］ — 小数点をサポートしていません。 - ［Numeric (decimal/double)］ — 小数点をサポートしています。	いいえ	はい

列リストの下部にある**［Add Column］**を選択すると、カスタム列を追加できます。カスタム列の名前を変更するには、名前を表示するスペースの上にカーソルを置き、グレーのボックスを選択してテキストエディターをアクティブにします。希望する名前を入力し、クリックしてテキスト入力の外側をクリックします。

カスタム列を削除したり、既存の列の可視化を変更したりするには、列のリスト項目の左側にカーソルを置き、 **［Delete］**または **［Hide Column］**を選択します。

​

表フィルター（フィルターフィールド）

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

​

表の設定

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

設定	説明
Freeze identifier columns	表の左側に識別子列を固定し、常に表示されるようにします。 表示または変更されている個別の行を識別するのに役立ちます。
Interdependent filter fields	前の選択にもとづいて、それぞれの表フィルターフィールドのオプションにフィルターをかけます。
Prefer page filters over filter fields	有効にすると、ページフィルターの設定にもとづいて表にフィルターをかけます。これにより、より多様なフィルターが可能になります。 フォームでページフィルターを有効にする手順については、「ページフィルターを使用する」を参照してください。

​

詳細な項目設定

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

項目/質問のタイプ	設定	説明
All item and question types	Descriptions	質問の追加情報とコンテキストを提供します。
Required questions	ユーザー入力を受け付けるすべての項目には、**［required］フラグを付けることができます。これにより、回答が得られるまでフォームの送信が禁止されます（［Title and Description］と［Image］は、ユーザー入力を受け付けないため、［required］**設定をサポートしていません）。 各質問は個別に［required］とマークすることも、フォームレベル設定（「フォーム設定」を参照）を使用してすべての質問を同時にマークすることもできます。
Text questions	Multiline	長いテキスト入力を表示するには、**［Multiline］**設定を使用します（テキスト領域）。
Dropdown questions	Multiselect	ユーザーが回答に対して複数の値を選択できるようにするには、**［Multiselect］**設定を有効にします。
Explanation field	選択に関する追加情報をユーザーに要求するには、 をクリックして**［Additional Options］メニューを開き、［Include Explanation Field］**を選択して説明フィールドを追加します。プロンプトのメッセージを選択するには、新しく表示されるテキストボックスに任意のメモを入力します。ここを空のままにすると、デフォルトのメッセージ「Please explain your response」が使用されます。
Date questions	Date Range	**［Date Range］**設定を有効にすると、ユーザーが日付範囲（開始日と終了日）を選択できるようになります。
Lookup questions 検索の質問を設定するには、選択/入力コントロールに表示されるオプションの取得元となるページ、カード、列を選択します。	Use Page Filters to filter available options	必要な値をすばやく簡単に見つけるために、ページフィルターを使用してオプションリストを絞り込むことができます（設定手順については、「ページフィルターを使用する」を参照）。
Filter based on preceding lookup question responses	同じセクションで同じ表カードから作成した検索の質問が複数ある場合、前の検索の質問の選択値を使用して、以降の検索の質問で利用可能なオプションにフィルターをかける依存関係を構築できます。依存関係を構築する際に注意すべき点がいくつかあります。 - 検索の質問は、同じ表カードの異なる列から作成されたほかの検索の質問にのみ依存できます。 - 検索の質問は、同じセクションのほかの検索の質問にのみ依存できます。 - セクションの検索の質問の表示順序が変更された場合、依存関係が壊れてしまう可能性があるため、順序の変更によって直接影響を受ける質問のために再構築する必要があります。 - アクティブな回答セッションで依存する検索の質問を表示すると、親が回答を持つまで子の検索の質問は無効になります（ユーザー入力が禁止されます）。 設定例については、「設定例」の「依存する検索の質問」を参照してください。
File attachment	Allowed file types	アップロードするファイルのフォーマットを常に正しいタイプに制限できます。タイプが選択されていない場合、Domoファイルサービスがサポートするフォーマットのファイルを使用できます。 **注記：**ユーザーが添付ファイルを送信した場合、次のURLを使ってDomoのインスタンス内からファイルを読み取ります：https://{INSTANCE}.domo.com/api/data/v1/data-files/{FILE_ID}。 INSTANCEはユーザーの個別のDomoインスタンスであり、FILE_IDは出力DataSetで返されるフォームの一意の識別子です。 連結を使用してBeast ModeまたはETLを介して完全なURLを生成することを検討してください。

​

ページフィルターを使う

フォームが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と一致している場合、検索の質問または表セクションにのみ適用されます。

​

設定例

以下の表カードがあるとします。

この表カードを使用すると、列ごとに検索の質問を作成できます。

| 地域の検索の質問

州のリストを、ユーザーが地域の検索の質問で選択した地域内の州に限定する場合、州の検索の質問の下にある**［Use previous lookup question response to filter available options］というメニューで［State］を選択することができます。新しい州**の検索の質問の設定：

同様に、利用可能な都市を州の検索の質問でユーザーによって選択された州の都市に限定するには、以下のように都市の検索の質問を設定できます。

アクティブなセッションでユーザーがこれらの質問を表示すると、次のように表示されます。

州を地域に依存させると、ユーザーが地域を選択するまで州の入力も無効になります。また、利用可能な州の値は選択された地域に対応する値に、都市の値は選択された州に対応する値に制限されます。

|