アプリでのフォームステップの使用方法をご覧ください。
Creating and editing form steps will no longer be supported starting r401 /LTS18. Users should migrate existing form steps when possible.
As of r234, form steps have been disabled for all new Tulip Instances.
フォームステップの移行
r383 / LTS 17 以降、Tulip では、フォームステップを、同等の入力ウィジェットと「送信」および「キャンセル」ボタンを備えた通常のステップに変換する移行支援ツールを提供しています。この移行ツールは完全な置換を行うものではないため、ユーザーは公開前に移行されたステップを検証する必要があります。
このツールは、アプリの開発バージョンのみを変更します。公開済みのアプリバージョンを編集したり、元のフォームステップを削除したりすることはありません。
フォームステップを移行するには:
- App Editorでアプリを開きます。フォームステップを使用しているステップには、「今後のリリースでは、フォームステップの作成および編集はサポートされなくなります。このステップを通常のステップに変換してください」というバナーが表示されます。
- [ステップの変換] をクリックします。
- 生成されたステップを確認します。変換は可能な限り正確に行われますが、レイアウト、検証、トリガーについては手動での調整が必要になる場合があります。
- 古いフォームステップへの残りの参照をすべて更新します。
- フォームステップを削除し、アプリを公開します。
フォームフィールド

フォーム内のさまざまなオプションは以下の通りです:
ブール値

**デフォルト値:**デフォルト値を「はい」または「いいえ」のいずれかに設定します
ドロップダウン

**デフォルト:**デフォルトで選択されるオプションを選択します。
**ボタンとして表示:**オペレーターがドロップダウンを開く必要がないよう、画面上に選択肢を一覧表示します
**ドロップダウンドロップダウンオプション:**ドロップダウンリストに新しいオプションを追加するか、リスト内にグループを追加します。
「Enter」キーを押すと、新しいオプションを追加できます。また、テキストエディタ(Word やメモアプリなど)で各オプションを個別の行に分けてあれば、オプションのリストを貼り付けることもできます。
複数選択

**複数選択オプション:**リストに新しいオプションを追加するか、リスト内にグループを追加します。
デフォルト:デフォルトで選択されるオプションを選択します。
**列:**選択肢のリストが長い場合は、複数の列に分割できるようにします
「複数選択」フォームウィジェットは、すべての選択肢を変数内のテキスト値として保存します。
テキスト

**複数行入力:**1 行の入力欄を複数行入力欄に変更し、より長い回答を促します。
**デフォルト値:**ウィジェットのデフォルト値を追加します
数値

**デフォルト値:**ウィジェットにデフォルトの数値を設定します
**必須範囲:**特定の範囲内に収まらない限り、フォームの送信を許可しないようにします
**「+/-」コントロールを非表示にする:**ウィジェットから「+」および「-」ボタンを非表示にします
画像

**写真の入力オプション:**オペレーターが、カメラ経由、ローカルコンピュータからの画像アップロード、またはその両方の方法で写真を追加できるかどうかを選択します。
フォームフィールドの変更
すべての種類のフォームウィジェットで、以下のオプションを変更できます:

**入力ラベル:**フォーム内のラベル
**フォントサイズ:**ラベルのフォントサイズ
**フォントの色:**ラベルのフォントの色
**フォントスタイル:**ラベルのフォントスタイル
**変数:**オペレーターが入力した値を格納する変数
**必須:**フォームを送信する前に、オペレーターが値を入力する必要があるかどうか
各フォームウィジェットの詳細については、こちらのフォームウィジェットガイドをご覧ください
フォームのレイアウトを変更する
ステップ上の任意の場所をクリックすると、画面右側のコンテキストペインにレイアウトを変更するためのオプション一覧が表示されます。

コンテキストペインのドロップダウンメニューを使用して、「キャンセル」ボタンと「送信」ボタンの機能を変更できます。これらのオプションを使用して、より複雑なロジックを構築する方法については、次のセクションで説明します。
複数の列を追加し、各フィールドを新しい列にドラッグすることで、フォームにより多くのフィールドを配置できます。
すべてのフォームステップの下部には、次の3つのボタンがあります:

- 「キャンセル」:トリガーに関する複数のオプションがあります
- メニュー
- 送信:トリガーに関する複数のオプションがあります
フォーム内での変数の使用
フォーム内の特定の回答に基づいて動的なロジックを構築したい場合を考えてみましょう。
たとえば、品質検査を行う担当者が、「スクラップ」ではなく「手直し」というオプションを選択した場合、その担当者に、その部品を手直し用の適切なビンに入れるよう指示したいとします。
このような場合、フォームステップ内のフィールドの値を追跡するための変数が必要になります。
フィールドを選択し、サイドペインの「変数」セクションに移動します。

**「+」**をクリックして、そのフィールドの値を追跡する新しい変数を作成します。

その後、「名前」フィールドから変数の名前を変更できます。

フォームの送信
As of r374, users can no longer copy, cut, or paste form triggers (i.e., form cancel or submit triggers) on form steps.
ユーザーがフォームの送信準備が整った際、いくつかのケースが考えられます。オペレーターは、右下隅にある「送信」ボタン、または左下隅にある「キャンセル」ボタンを押す必要があります。

オペレーターがこれらのボタンのいずれかを押した後の動作を選択するには、フォームステップの背景をクリックして、Side Paneの中央にあるオプションから選択します。
「送信」ボタンのオプションには、次のようなものがあります:
- 「次のステップへ進む」 - デフォルトでは、ユーザーは次のステップに進みます。
- 「ステップへ移動…」- アプリ内の特定のステップを選択します。
- アプリを完了- ユーザーがアプリを完了します。

- カスタムアクション- フォーム内で更新された変数(またはその他の変数)に基づいて、カスタムトリガーを追加できます。
カスタムアクションの詳細はこちらをご覧ください。
フォームステップの値をクリアする方法は2つだけです:
- アプリを完了する
- アプリをキャンセルする
署名フォーム
As of r234, Form steps have been disabled for all new Tulip Instances. Use the electronic signature widget instead.
「署名フォーム」ステップでは、オペレーターはフォームへの入力後に署名を追加する必要があります。これにより、署名を追加するまで次のステップに進めなくなります。
署名フォームを使用すると、オペレーターは完了した作業や不具合報告書に承認の署名を行うことができます。署名は、Tulip Player上でアスタリスク(*)で自動的に隠されます。
署名付きのフォームを追加するには、アプリエディタの左上にある [追加] ボタンをクリックし、[署名フォーム] を選択します。

その後、サイドペインの「フォーム送信者」オプションで、許可される署名の種類として2つの選択肢が表示されます。

「すべてのユーザー」:どのオペレーターでも署名を追加できます。
アプリ実行者以外のすべてのオペレーター:現在ログインしているオペレーターを除き、どのオペレーターでも署名できます。
許可されるユーザーのリストを指定:Tulipアカウント内のすべてのユーザーおよびオペレーターのリストから選択します。複数のユーザーを指定可能です。
現在のユーザー:現在ログインしているオペレーターのみが署名を追加できます。
このオプションを選択すると、オペレーターが署名フォームのステップに進んだ際に、電子署名が自動的に入力されます。オペレーターはこの署名を変更することはできません。
注:ウィジェットが「現在のユーザー」に設定されている場合の認証情報の自動入力は、以下の場合にのみ利用可能です:
- 組織が検証モードを使用していない場合
- 組織がオペレーターに対し、LDAPまたはSAMLの認証情報による認証を必須としている場合。
オペレーターが署名を行う方法は3つあります:
- バッジID
- LDAP ユーザー名/パスワード:組織が Tulip でのユーザー認証に LDAP を使用している場合、オペレーターは LDAP ディレクトリに登録されているユーザー名とパスワードを入力する必要があります。
- SAMLユーザー名/パスワード:組織がTulipでのユーザー認証にSAMLを使用している場合、オペレーターはポップアップウィンドウに、組織のSAMLディレクトリに登録されているユーザー名とパスワードを入力する必要があります。
どのアプリ内でも、複数の署名フォームを追加できます。
署名履歴
各アプリの完了時に追加された署名を確認するには、「**完了」**タブに移動してください。署名フィールドごとに列があり、オペレーターの詳細や署名フォームへの入力時刻が表示されます。このタイムスタンプは、アプリの完了時刻とは異なります。

Analyticsでのフォームフィールドの利用
変数の有無にかかわらず、フォームからのデータを分析できます。
「分析」に移動し、左側のサイドバーから「X軸カテゴリ」を選択します。

既存のデータポイントをクリックします。

次に、「アプリフォーム」カテゴリを選択します。

アプリ全体のどのフォームフィールドでも選択できるようになります。
フォームフィールドの結果を変数で追跡するように選択した場合、その変数を「アプリ変数」カテゴリでも使用できます。

「テーブル分析」では、複数のフォームフィールドを一度に表示できます。複数のフォームフィールドを選択するには、左側のメニューにある「操作」タブをクリックしてください。

[新しい操作を追加] ボタンをクリックし、追加する特定のフォームフィールドを選択します。

テーブルは次のようになります。


