モバイルアクティビティストリームのメンションのプッシュ通知の設定

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む5読むのに数分
  • プッシュ通知を使用して、スレッドでメンションされているユーザーの連絡先にアラートで伝えることができます。ユーザーは、連絡先にアラートを送信するために、レコードのアクティビティストリームに @ 文字に続けて連絡先の名前を入力します。

    始める前に

    必要なロール:admin

    手順

    1. プッシュ通知メッセージコンテンツを作成します。これは、通知のプッシュ先を定義します。
      1. 移動先 システム通知 > プッシュ > プッシュメッセージコンテンツ 動作を検索できます
      2. [プッシュ通知メッセージコンテンツ] フォームで、[新規] を選択します。
      3. フォームのフィールドに入力します。
        表 : 1. プッシュ通知メッセージコンテンツフォーム
        名前 プッシュメッセージコンテンツレコードの名前。この名前は、ユーザーには表示されません。
        アプリケーション このレコードに関連付けられたスコープ対象のアプリケーション。このフィールドは、デフォルトで現在のアプリケーションになります。
        プッシュアプリ プッシュ通知を使用するモバイルアプリ。
        • モバイルエージェント アプリに対しては、[ServiceNow モバイルアプリケーション] を入力します。
        • Now Mobile アプリに対しては、[ServiceNow 要求アプリケーション(Request Application)] を入力します。
      4. 次のサンプル JSON コードをコピーして、[プッシュメッセージ生成] フィールドに貼り付けます。
        (function buildJSON(/*GlideRecord*/ current, /*String*/ message, /*Object*/ attributes) {
        
            var layoutFieldGenerator = new global.NotificationLayoutFieldGenerator();
            var json = {};
        	var deepLinkGenerator = new global.MobileDeepLinkGenerator("<client type>");
        		
            var link = deepLinkGenerator.getFormScreenLink('<form_screen_sys_id>', current.getValue("table"), current.getValue("document"));
            json = {
                "aps" : {
                    "sound" : "default"
                },
                "Link": link
            };
            
            return json;
            
        })(current, message, attributes);

        コードの値をカスタマイズします。

        1. 画面名を右クリックして [ Copy sys_id (のコピー)] を選択し、レコード画面のsys_idを見つけます。
        2. コードの <form_screen_sys_id> 部分を sys_id で置き換えます。
        3. 変数 global.MobileDeepLinkGenerator でクライアントタイプを定義します。可能な値は次のとおりです。
          • エージェント
          • 要求
          • オンボーディング
      5. [送信] を選択します。
    2. レコードのアクティビティストリームでメンションされたユーザーの連絡先が受信するメッセージを作成します。
      1. 移動先 システム通知 > プッシュ > プッシュメッセージ.
      2. [プッシュ通知メッセージコンテンツ] フォームで、[新規] を選択します。
      3. フォームのフィールドに入力します。
        表 : 2. [プッシュ通知メッセージ] フォーム
        名前 プッシュメッセージコンテンツレコードの名前。この名前は、ユーザーには表示されません。
        アプリケーション このレコードに関連付けられたスコープ対象のアプリケーション。このフィールドは、デフォルトで現在のアプリケーションになります。
        プッシュアプリ プッシュ通知を使用するモバイルアプリ。
        注:
        [プッシュ通知メッセージコンテンツ] フォームの [プッシュアプリ] フィールドに入力したものと同じモバイルアプリを入力してください。
        プッシュメッセージコンテンツ 作成したプッシュメッセージコンテンツを選択します。
        テーブル 通知に関連するレコードが含まれているテーブル。live_notification を選択します。
        メッセージ メンションされたユーザーの連絡先に表示される、メンションされたことを伝えるメッセージ。
      4. [送信] を選択します。
    3. プッシュ通知を作成して、送信時期、受信者、および内容を定義します。
      1. 移動先 システム通知 > プッシュ > プッシュ通知.
      2. [プッシュ通知ビュー] フォームで、[新規] を選択します。
      3. フォームのフィールドに入力します。
        表 : 3. [プッシュ通知ビュー] フォーム
        フィールド 説明
        名前 プッシュ通知の名前。この名前は、ユーザーには表示されません。
        有効 プッシュ通知がアクティブかどうかを決定するオプション。このオプションを選択します。
        テーブル 通知に関連するレコードが含まれているテーブル。[プッシュ通知ビュー] フォームと同じテーブル live_notification を選択します。
        プッシュメッセージのみ モバイルデバイスにプッシュ通知を送信するかどうかを決定するオプション。このフィールドは自動的に選択され、デフォルトで読み取り専用になります。
        カテゴリ この通知が属するカテゴリ。カテゴリは、関連する通知を識別してグループ化します。このカテゴリでは、プッシュ通知で利用可能なアクションを定義します。
      4. [送信時期] タブを選択し、[挿入済み] を選択します。
      5. [受信者] タブを選択し、[ユーザー/グループ] フィールドで [ロック] アイコン (ロックアイコン) を選択します。
      6. [選択済み] リストに [ユーザー] を移動します。
        注:
        通知の宛先が、ユーザー [sys_user] テーブルで非アクティブレコードを持つユーザーの場合、通知は送信されません。
      7. [送信内容] タブを選択し、[プッシュメッセージ] フィールドの横にある [ロック] アイコン (ロックアイコン) を選択します。
      8. [参照ルックアップ] アイコン (参照ルックアップアイコン) を選択して、[プッシュ通知メッセージ] ページを開きます。
      9. 作成したプッシュ通知メッセージを選択します。
        プッシュ通知は、[送信内容] タブに利用可能なメッセージの 1 つとして表示されます。
      10. [送信] を選択します。
    4. 通知のモバイルアプリ設定を有効にします。
      1. [設定] アイコン (設定アイコン) を選択し、[通知] タブを選択します。
      2. [通知を許可 (Allow Notifications)] が有効になっていることを確認します。
      3. [ServiceNow モバイルアプリケーション] または [ServiceNow 要求アプリケーション] フィールドの設定を確認し、通知を受信するために選択したモバイルアプリが有効になっていることを確認します。