アクション機能の構成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：9分

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

    始める前に

    必要なロール：admin

    手順

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

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

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

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

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

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

    次のタスク

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