プッシュ通知メッセージのコンテンツを構成する

プッシュ通知メッセージのコンテンツを構成し、通知を受信するモバイル アプリケーションを選択します。重大なアラート通知を設定したり、メッセージの外観をカスタマイズしたり、ユーザーが通知をタップしたときに使用するディープリンクを決定したりできます。

始める前に

プッシュ通知メッセージのコンテンツを設定するには、モバイルディープリンクジェネレーターを使用してディープリンクを生成する必要があります。詳細については、「モバイル向けディープリンク」を参照してください。

必要なロール：admin

このタスクについて

プッシュメッセージコンテンツフォームに入力して、次の操作を行います。

• 通知に名前を付ける
• 通知の送信先のモバイルアプリを選択します
• オプションで通知メッセージの外観をカスタマイズします
• ユーザーが通知をタップしたときに使用するディープリンクを決定します

プッシュ通知メッセージコンテンツは、最大 3 つの追加フィールドをサポートします。これらのフィールドがオプションのテキストスロットとして使用されている場合、スロットにはソースレコードのフィールドを表示できます。

注:

テキストスロットはモバイルアプリで固定されているため、場所やサイズを変更することはできません。各スロットは、プッシュ通知メッセージコンテンツスクリプトの JSON オブジェクト内のステータス、識別子、および説明にマップされます。

モバイル UI スタイルは、追加フィールドでも使用できます。スタイリングの詳細については、「 モバイル UI スタイル」を参照してください。

手順

1. 移動先 すべて > システム通知 > プッシュ > プッシュメッセージコンテンツ.
2. [新規] を選択します。
3. [プッシュメッセージコンテンツ] フォームで、次のフィールドに入力します。

   表 : 1. プッシュメッセージコンテンツフォーム

   フィールド	説明
   名前	このレコードの文字列値。 注: この名前は通知には表示されず、構成中に使用するための参照にすぎません。
   プッシュアプリ	通知の送信先のモバイルアプリを参照します。 モバイルエージェントにはServiceNow モバイルアプリケーションを使用します。 Now Mobile アプリにはServiceNow要求アプリケーションを使用します。
   プッシュ メッセージ生成	通知リンクを含むスクリプトブロック。スクリプトブロックでは、 JSON オブジェクトがリンクを返す必要があり、 リンク キーが存在する必要があります。キーには、対応するディープリンク値がモバイルディープリンクジェネレーターによって生成されている必要があります。

   この例は、完成したフォームと、適切なリンクキーと対応するディープリンク値を持つJSONオブジェクトを示しています。
4. オプション: テキストスロットなどのフィールドを通知コンテンツに追加します。

   プッシュメッセージ生成スクリプトブロックで、各フィールドのレイアウトフィールドオブジェクトを作成します。

   1. 通知レイアウトオブジェクトをインスタンス化します。

      var layoutGen = new global.NotificationLayoutFieldGenerator();

   2. 通知レイアウトスクリプトを使用し、グローバルアプリケーションスコープを含めてレイアウトフィールドを生成します。
      スクリプトインクルードの詳細については、「 スクリプトインクルード」を参照してください。

      注:

      通知レイアウトジェネレーターのスクリプトインクルードは変更しないでください。
   3. レイアウトフィールドを作成します。
      各レイアウトフィールドには、 テーブル、 Sys_Id、および 列が必要です。

      注:

      テーブルとSys_Idの値は、current.getTableName() と current.sys_id を使用して、現在のレコードから直接取得する必要があります。列の値は目的のテーブルに存在し、辞書の列名と正確に一致する必要があります。

      var text_01 = layoutGen.layoutField(current.getTableName(), current.sys_id, "priority");

   4. レイアウトフィールドを別のオブジェクトとして元の JSON オブジェクトに渡します。

      モバイルアプリケーションは、オプションの レイアウト キー (必要な追加フィールドを含むオブジェクト) をリッスンします。レイアウトオブジェクトで、各追加フィールドをステータスキー、識別子キー、または説明キーに関連付けます。次の例は参考として利用できます。

      (function buildJSON( /*GlideRecord*/ current, /*String*/ message, /*Object*/ attributes) { 
      
          var layoutGen = new global.NotificationLayoutFieldGenerator(); 
          var text_01 = layoutGen.layoutField(current.getTableName(), current.sys_id, "priority"); 
          var text_02 = layoutGen.layoutField(current.getTableName(), current.sys_id, "state"); 
          var text_03 = layoutGen.layoutField(current.getTableName(), current.sys_id, "short_description"); 
      
          var deepLinkGenerator = new global.MobileDeepLinkGenerator("Request"); 
          var link = deepLinkGenerator.getFormScreenLink("b71040b1533a33007bc2ddeeff7b1221", current.getTableName(), current.getValue("sys_id")); 
      
          var json = { 
      
              "Link": link, 
      
              "Layout": { 
      
                  "Status": text_01, 
      
                  "Identifier": text_02, 
      
                  "Description": text_03 
      
              } 
      
          }; 
      
          return json;
      
      })(current, message, attributes);

5. オプション: カスタマイズされた通知タイトルを追加します。
   カスタマイズされた通知タイトルを追加しない場合、通知にはデフォルトのモバイルアプリ名が表示されます。

   

   プッシュメッセージ生成スクリプトブロックで、json セクションに次のコード例を追加します。

   var json= {};
   var msg_title  = "System updates!";
   json= {
     "android_title" : msg_title,
     "aps": {
       "alert": {
         "title": msg_title,
       }
     }
   

   サンプル JSON コードの要素は次のとおりです。

   • 「システムアップデート!」というmsg_title変数は、iOSとAndroidの両方に適用される通知タイトル名です。
   • ノードjson["android_title"] は Androidの変数です。
   • ノード json["aps"]["alert"]["title"] は iOSの変数です。
6. 次のコードを追加して、 Android デバイスの起動をアクティブ化し、通知をトリガーできるようにします。

   ユーザーは iOS デバイスと Android デバイスの両方を使用しているため、このコードを追加する必要があります。コード内の JSON エントリは、スクリプトから返された辞書名の値です。

   Android メッセージ配信を制御する特定のフィールドは、 sncGoogleKeys でサポートされています。詳細については、「 Firebase Cloud Messaging HTTP プロトコル」を参照してください。

   注:

   デバイスがスリープモードの場合、 priority パラメーターは 高 に設定され、 Android デバイスをウェイクアップします。このパラメーターは、重要なアラートをエンドユーザーに配信するのに役立ちます。

   json["sncGoogleKeys"] = {
       "priority": "high",
       "android": {
         "priority": "high"
       }
   }
   

7. [Update (更新)] を選択します。

タスクの結果

ディープリンクを含むプッシュ通知メッセージコンテンツレコードが作成されました。

次のタスク

プッシュ通知メッセージコンテンツを構成した後、プッシュ通知メッセージレコードとペアリングする必要があります。プッシュ通知メッセージの設定の詳細については、「 プッシュ通知メッセージを構成する」を参照してください。