アクション機能の構成

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：9分

    • ユーザーはアクション機能を使用して、データベース内のデータを変更できます。たとえば、レコードへの更新を行ったり、コメントを追加したりするには、アクション機能が必要です。

    始める前に

    必要なロール：admin

    手順

    1. 次のように移動する。 All (すべて) > システムモバイル > Mobile App Builder (モバイルアプリビルダー).
      モバイルアプリビルダー が新しいブラウザータブで開き、アプリケーションスコープ選択画面が表示されます。
    2. 作業しているアプリケーションスコープを検索し、アプリケーション画面の名前を選択します。
      モバイルアプリビルダー カテゴリのホーム画面が表示されます。
    3. メニューの 関数 を選択し、 新規 を選択します。
    4. フォームのフィールドに入力します。
      表 : 1. 関数フィールド
      フィールド 説明
      プロパティ
      [Name (名前)] 関数の名前。識別しやすい名前を選択してください。
      説明 関数に関する追加情報。
      タイプ 関数のタイプ。[アクションアイテム] を選択します。
      コンテキスト アクションを適用するレベル。
      • レコード: レコードレベルでのみ適用されます。たとえば、レコードの状態を変更するボタンを作成するには、このオプションを使用します。特定のフィールド、特定のレコード、またはスワイプアクションのアクションについて、レコードにコンテキストを設定できます。アクション機能に、[入力ソース] フィールドが [自動入力] に設定された UI パラメーターが含まれている場合は、[テーブル] フィールドでテーブルを指定する必要があります。
      • グローバル: グローバルレベルまたはリストレベルでアクションを適用します。たとえば、レコードを作成するボタンを追加するには、このオプションを使用します。レコードのコンテキストにあるアクション、または [入力ソース] フィールドが [自動入力] になっている UI パラメーターを含むアクションには、グローバル設定を使用しないでください。
      ボタンの場所の詳細については、「機能をアプリ内の場所に関連付ける」を参照してください。
      オフラインで利用可能 デバイスがオフラインのときにこの機能を使用できるかどうか。
      注:
      このオプションは、 ServiceNow モバイルエージェント アプリでのみサポートされています。
      アクション アイテム アクションに関連付けるアクションアイテム。詳細については、「アクションアイテムの設定」を参照してください。
      Settings (設定)
      画像アップロードを許可 画像のアップロードを許可します。画像は添付ファイル [sys_attachment] テーブルに保存されます。
      署名フィールドを表示します アクションを送信する前にユーザー署名が必要です。ユーザーは、署名フィールドに指で署名したり、名前を入力したりすることができます。[画像アップロードを許可] が選択されている場合、アクションが実行されると、署名の画像が署名画像 [signature_image] テーブルに送信されます。選択すると、署名フォームが別のページに表示されます。署名フォームをオーバーレイするには、[前提条件] フィールドで [署名] オプションを使用します。
      オーバーレイを使用 現在の詳細画面にテキスト入力パラメーターをオーバーレイします。このアクションに対しては、テキスト入力パラメーターが 1 つだけ定義されている必要があります。このオプションが定義されていない場合、入力パラメーターは別の画面に表示されます。
      前提条件 アクションを送信する前にユーザーの確認が必要なオプションを選択します。
      • なし: ユーザーの確認は必要ありません。これがデフォルトのオプションです。
      • [人事タスク署名]：アクションを送信する前にユーザー署名を要求します。ユーザーは、署名フィールドに指で署名したり、名前を入力したりすることができます。[画像アップロードを許可] が選択されている場合、アクションが実行されると、署名の画像が署名画像 [signature_image] テーブルに送信されます。このオプションを選択すると、現在の画面に署名フォームがオーバーレイされます。
      • [人事タスク資格情報]：アクションを送信する前にユーザーに資格情報の入力を要求します。このオプションは、ローカル認証でのみサポートされています。
      • [再認証]：アクションを実行する前にユーザーに資格情報の再認証を要求します。詳細については、「モバイル再認証システムのプロパティを構成する」を参照してください。
      データ
      テーブル

      アクションが適用されるテーブル。[コンテキスト] が [レコード] に設定されている場合は、テーブルを選択する必要があります。

      [コンテキスト] が [グローバル] に設定されている場合、テーブルの選択はオプションです。
      条件
      条件 アクションを使用するために満たす必要のある条件。たとえば、[クローズ]、[解決済み]、または [キャンセル] のステータスにあるインシデントをユーザーが解決できないようにすることができます。
      メッセージ
      確認メッセージを表示 ユーザーがアクションを続行するかどうかを確認するための確認メッセージを表示します。
      確認メッセージ 表示する確認メッセージ。
      注:
      [確認メッセージを表示] が選択されている場合にのみ表示されます。
      [確認] ラベル アクションを確認するボタンのラベル。
      注:
      [確認メッセージを表示] が選択されている場合にのみ表示されます。
      [キャンセル] ラベル アクションをキャンセルするボタンのラベル。
      注:
      [確認メッセージを表示] が選択されている場合にのみ表示されます。
      成功メッセージ 成功確認メッセージのテキスト。動的な成功メッセージを作成するには、中括弧を使用します。例: {{number}} が正常に更新されました。
      エラーメッセージ 確認失敗メッセージのテキスト。動的な失敗メッセージを作成するには、中括弧を使用します。例: {{number}} を更新できませんでした。
      応答確認メッセージ
      確認応答テキストを表示 アクションを送信する前にユーザー確認応答が必要です。このフィールドが有効になっている場合、[コンテキスト] フィールドは [レコード] である必要があります。
      応答確認フィールド ユーザーに表示する受信確認テキストを含むフィールド。[データ] エリアでフィールドのテーブルを選択します。文字列フィールドのみがサポートされています。
      注:
      [確認応答テキストを表示] が選択されている場合にのみ表示されます。
      [確認] ラベル 確認テキストの下に表示される確認ボタンのラベル。デフォルト値は [同意]です。
      注:
      [確認応答テキストを表示] が選択されている場合にのみ表示されます。
      アクション完了
      アクション後に全画面を更新 アクションが完了したときに現在の画面を自動的に更新するオプション。

      このオプションは、[コンテキスト] が [グローバル] に設定されている場合にのみ使用できます。

      注:
      リフレッシュオプションは、画面 (アプレット) ではサポートされていますが、ランチャー画面ではサポートされていません。
      前の画面に移動 アクションの完了後に、ユーザーを前の画面にリダイレクトします。
      前の画面でリフレッシュを表示 ユーザーがアクションを完了した後に [新規更新] メッセージを表示し、ユーザーを前の画面にリダイレクトします。
      アクションの正常完了後に画面に移動 ユーザーがアクションを完了した後に、追加の画面ナビゲーション構成オプションを表示します。このフィールドを使用して、指定した画面に移動する前にユーザーの操作が必要かどうかを判断します。

      このオプションは、フォームの [条件 ] エリアでテーブルが選択されている場合にのみ使用できます。
      ユーザーのインタラクションなしで画面に移動 ユーザーを宛先画面に送ります。
      • 選択すると、ユーザーのインタラクションなしで自動的に宛先画面へとリダイレクトされます。
      • 選択しない場合、リダイレクトは成功メッセージに対するユーザーのインタラクションでのみ発生します。成功メッセージを定義するには、フォームの [ メッセージ ] セクションの必須フィールドに入力する必要があります。
      注:
      このオプションは、[アクションの正常完了後に画面に移動] が選択されている場合にのみ使用できます。
      画面パラメーターに自動入力 宛先画面のパラメーターを自動的に入力します。
      注:
      このオプションは、[アクションの正常完了後に画面に移動] が選択されている場合にのみ使用できます。
      宛先画面に移動 アクションの正常完了後にユーザーがリダイレクトされる画面を指定します。利用可能な場合、この画面には新しく作成されたレコードが表示されます。
      注:
      このオプションは、[アクションの正常完了後に画面に移動] が選択されている場合にのみ使用できます。
      UI のパラメーター 宛先画面のパラメーターを自動的に入力します。
      注:
      このオプションは、[ アクションの正常完了後に画面に移動 ] が選択されている場合にのみ使用できます。
      グループ化された入力 このフィールドは、アクション機能の構成には使用されません。グループ化された入力により、ユーザーは複数のバーコードを順番にスキャンできます。複数のバーコードスキャンを受け入れるように、UI パラメーターを使用してグループ化された入力を構成できます。グループ化された入力の詳細については、次を参照してください。 複数のスキャンにグループ化された入力を設定する
      ボタン属性 ボタンの追加属性を指定します。このオプションを構成するには、[ 新規 ] を選択します。次のボタン属性から選択できます。
      • alerts_require_dismissal:button 属性を true に設定すると、ユーザーが却下するまでバナーメッセージを保持できます。デフォルトでは、バナーメッセージは自動的に却下されます。
      • used_for_deeplink: button 属性を true に設定すると、ボタンがディープリンクに使用されることが決定されます。詳細については、「モバイル向けディープリンク」を参照してください。
      • trigger_offline_cache_download:button 属性を true に設定すると、オフラインキャッシュの生成がトリガーされます。キャッシュが正常に生成されると、キャッシュのダウンロードがトリガーされます。
      • check_acl_on_url_parameter_field:このボタン属性が選択され、 true に設定されている場合、URL 文字列内のすべてのフィールドが ACL (アクセス制御リスト) と照合されます。たとえば、{{meeting_id}} のような文字列です。フィールドがこのチェックに合格しない場合、フィールド値は URL に含まれません。デフォルトでは、[URL パラメーター] フィールドは下位互換性について ACL に対してチェックされません。
      アクセスロール ロールによってアクションへのユーザーアクセスを制限します。
      注:
      フォームの [アクション完了 ] 領域のすべてのオプションを設定できますが、それらのアクションは互いに重複する可能性があります。期待どおりの結果が得られるように、設定をテストしてください。
    5. [Save (保存)] をクリックする。

    次のタスク

    アクション機能を作成したら、それをモバイルアプリ内の特定の場所に関連付ける必要があります。アクション機能は、トップメニュー、スワイプアクション、または特定のフィールドに追加できます。アクション機能を場所に関連付ける方法の詳細については、「機能をアプリ内の場所に関連付ける」を参照してください。