オプションで、ユーザーおよびフィールドコードをプロジェクトに追加します。例えば以下のようになります。

ユーザーには、関連フォームの表示前に提出に自動的に追加される userId および userName フィールドがあります。2 つのテキストフィールドをこの実際例に関連付けられたフォームに追加します。

これらのフィールドが追加されたら、データブラウザーの users (ユーザー) コレクションに 2 名のユーザーを追加します。

{
    "userId": "admin",
    "userName": "<<Any Name>>"
}

{
    "userId": "user",
    "userName": "<<Any Name>>"
}

$fh.forms.init 関数をクライアントに追加してフォームの初期化 (Forms Initialization) を追加します。これにより、クライアントアプリのフォームが初期化され、アプリの他の場所で $fh.forms Client API の使用が可能になります。

$fh.forms.init 関数は、アプリのログインプロセスの一部を構成します。

管理者ユーザーとして完了フォームを選択します。これにより、ジョブを完了するために記載する必要のあるフォームが指定されます。$fh.forms.getForms クライアント API 関数を使用してアプリで利用できるすべてのフォームを一覧表示します。

$fh.forms.getForm クライアント API を使用してフォームをクライアントにダウンロードします。

フォームはジョブ作成、ジョブ詳細の表示、およびジョブの完了で使用されるため、この関数はヘルパー関数のセットに抽象化されます (こちらを参照してください)。

$fh.forms.getForm クライアント API の使用法は、FormFunctions.js の loadForm 関数の一部として使用される場合はこちらで確認できます。

提出をアプリにロードします。このプロセスは、FormFunctions.js ファイルの loadSubmission 関数の使用に関連して説明されています。

フォームに入力されるデータは提出に設定されるため、フォームは提出に関連します。ただし、提出はクラウドにアップロードされる前にフォームに対して検証されます。

提出を作成する方法として、以下の 3 つの方法があります。

ユーザーが編集できるようにフォームをビューに表示します。

フォームを既存の Cordova アプリに表示する方法として、以下の 2 つの方法があります。

フィールドに入力できるデータを制限する検証パラメーターを定義します(たとえば、テキストフィールドではフィールドに入力できる最小/最大文字数を指定できます)。この機能をクライアントアプリに追加すると、フィールドの制限が反映されます。

この要件に対応するために、validateInput 関数は FormView.js ファイルの入力の blur イベントに登録されます。

フォームアプリには、フィールドおよびページルールが含まれます。Studio では、フォームエディターでフィールドルールを作成し、フィールド入力データに基づいてフィールドを表示/非表示にしたり、ページルールを作成してフィールドに入力されるデータに基づいてページを表示/スキップしたりすることができます。

この機能は $fh.forms API の実装に反映されます。ルールエンジンを使用して提出を処理することで、その提出で表示/非表示にする必要のあるフィールドまたはページを特定できます。

これは FormView.js ファイルの checkRules 関数で実装されます。

addInputValue 関数を使って提出モデルにデータを追加します。このデータのソースとして、ユーザーに表示されたフォームか、アプリで利用できる外部データ、またはそれらの組み合わせのいずれかを使用することができます。

検証およびルール機能をフォームに追加すると、有効な提出をクラウドに送信して提出エディター (submission editor) で表示または編集を実行できます。

フォームビューは、データの処理およびアップロード時に提出モデルで生成される提出関連のイベント (validationerror、queued、progress、error、submitted) をリッスンします。

提出プロセスには以下の 2 つのステップが関係します。

OpenShift mBaaS サービスのインスタンスの作成およびデプロイ

OpenShift 2 ターゲットに正しい fh-mbaas ホスト URL を設定します。