f:id:mofumofu_dance:20210921171732p:plain

モデル駆動型アプリでのアプリ内通知は2021年8月末にパブリックプレビューが開始された新機能です。これまでもPush通知は提供されてきましたが、これはモバイルアプリ限定で動作するものでした。

アプリ内通知はモバイルアプリ利用中のみならず、ブラウザーでアプリを利用している場合にもユーザーに通知を送ることができる機能です。

f:id:mofumofu_dance:20210921151327p:plain

通知はユーザー単位で送られます。(今のところ) 複数のアプリを使っている場合には、通知を有効にしたすべてのアプリで通知が表示されます。

本投稿ではアプリ内通知の設定方法、解除方法、カスタムページからの通知、Power Automateを使った通知について紹介します。

公式のDocsは以下を参照してください。

docs.microsoft.com

アプリ内通知を設定する

アプリ内通知はアプリ単位で有効にします。事前にアプリの"名前"を控えておいてください。アプリの"名前"はソリューションエクスプローラで確認できます。

f:id:mofumofu_dance:20210921160400p:plain

通知の設定を有効にするにはブラウザーのデベロッパーツールを使います。

対象のアプリを実行(編集ではなく実行)した状態でデベロッパーツールを起動します。(ChromeならCtrl+Shift+I)

デベロッパーツールのコンソールに以下Javascriptコードをコピペします。その際、"Your app unique name"の部分を先ほど控えておいたアプリの名前と置き換えてください。

fetch(window.origin + "/api/data/v9.1/SaveSettingValue()",{
 method: "POST", 
   headers: {'Content-Type': 'application/json'},
   body: JSON.stringify({AppUniqueName: "Your app unique name", SettingName:"AllowNotificationsEarlyAccess", Value: "true"})
   });

f:id:mofumofu_dance:20210921161355p:plain

エンターを押してコードを実行します。

アプリが存在するソリューションを開き (どこのソリューションにも追加していない場合には既定のソリューション)、すべてのカスタマイズの発行を行います。(ここ大事！)

f:id:mofumofu_dance:20210921161917p:plain

以上で設定は完了です。

設定状況を確認するには既定のソリューション内にある「モデル駆動型アプリの設定」テーブルのデータを表示して、この中でSettingDefinitionId が Allow notifications early access になっている行を見てください。

一意の名前の列に設定したアプリの名前が入っていれば設定成功です。

f:id:mofumofu_dance:20210921162423p:plain

設定の解除

通知を解除する場合にも「モデル駆動型アプリの設定」テーブルにある対象のレコードを削除することで解除できます。

f:id:mofumofu_dance:20210921162824p:plain

通知の作成 (Power Automate の利用)

アプリ内通知は「通知」テーブルのレコードを介して実行されます。通知テーブルを確認するには既定のソリューション内で「通知」で検索してください。

通知テーブルにはさまざまな列が含まれますが、利用するのは「IconType」、「タイトル」、「データ」、「本文」です。また、通知の送信先はレコードの「所有者」で決まります。

f:id:mofumofu_dance:20210921163229p:plain

通知のテストは Power Automate のクラウドフローを使うのが簡単です。

「通知」テーブルにレコードを追加するアクションを実行すれば、通知設定をしておいたアプリのベルマークをクリックしたときに通知内容が表示されることが確認できます。

f:id:mofumofu_dance:20210921165527p:plain

また、通知を X で消すとレコードも消えていることが確認できると思います。

カスタムページからの通知

「通知」テーブルにレコードが作成できれば良いので、プレビュー提供されている「カスタムページ」(モデル駆動型の上で動くキャンバスアプリ) からも通知を送ることができます。

カスタムページを追加し、そのページ (キャンバス) 上で「通知」テーブルをデータソースとして追加、ボタンに以下の関数を設定します。

Patch(通知, {
    タイトル:"Out of stock",
    本文: "THIS ONE WON'T BE USED",
    IconType: 'IconType (通知)'.情報, 
    データ:  JSON({
        body : "HERE I OVERWRITE THE BODY"
    })
});

f:id:mofumofu_dance:20210921170504p:plain