AWA Notifications : ワークスペース上でエージェントに Inbox カードが表示されないことに関連する問題のデバッグSummary<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } 一般的な AWA Inbox の問題 AWA を使用する際、エージェントにタスクが割り当てられたときに、Inbox カードが表示されなかったり、関連する音声通知が聞こえなかったりすることがあるという一般的な苦情をよく耳にします。この問題に対処するために実施できるさまざまな確認事項があります。その中には、Inbox 関連の更新を受信した際にクライアントからサーバーへ送信されるログを確認することも含まれます。ただし、これは com.glide.awa.client_logging.enabled プロパティが有効化されている場合に限ります。 それにもかかわらず、ログによりクライアントが必要なメッセージを適時に受信したことが示されているにもかかわらず、Inbox カードまたはアラートが依然として見落とされるケースがあります。その正確な原因を特定したり、その説明を提供したりすることは、いくつかの要因により困難な場合があります。 問題はクライアント側のみに存在します。断続的に発生します。エラーとは関係のない要因が関与している可能性があります (たとえば、エージェントが別の作業で手一杯になっている場合など)。 Release<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } KB にリンクされているスクリプトは、Utah 以降のリリースと互換性があります。 Instructions<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } Inbox に作業項目カードがプッシュされたタイミングを示すクライアント側ログを取得する方法 前提条件 まず、com.glide.awa.client_logging.enabled プロパティが存在することを確認し、クライアントからサーバーへのログ記録呼び出しが記録されることを確認してください。このプロパティは (true|false) タイプであり、true に設定されている必要があります。 さらに、このプロパティに対して、以下のロールに読み取りアクセス権があることを確認してください。 awa_agentawa_managerawa_admin スクリプトの実行 その後、Inbox の断続的な問題が発生しているエージェントは、ワークスペースがロードまたは更新されるたびにスクリプトを実行する必要があります。デバッグに必要な関連ログを取得できるようにするため、スクリプトを継続的に実行し続けることが重要です。 スクリプトを実行する方法は 2 つあります。 Tamper Monkey ブラウザー拡張機能を使用するChrome Dev Tools の Snippets を使用する Chrome 拡張機能として Tamper Monkey を使用してスクリプトを実行する場合 ブラウザーに TamperMonkey 拡張機能をインストールします。TamperMonkey インターフェイス内で新しい UserScript を作成します。添付ファイル inbox_logger_2024_03_04.txt の内容をスクリプトにコピーします。この拡張機能はほとんどの一般的なブラウザーに対応しています。TamperMonkey 拡張機能のインストール方法およびスクリプトの作成方法については、この動画を参照してください。 Chrome Dev Tools の Snippets を使用してスクリプトを実行する場合 SN_AWA_script.pdf に記載されている手順を参照し、添付ファイル inbox_logger_2024_03_04_new.txt の内容をコピーしてください。または、提供されている動画の手順を参照してください。 スクリプトの実行 スクリプトをインストールした後は、関連ログを正確に取得するために、ワークスペースがロードまたは更新されるたびに必ず実行してください。この手順は重要です。以下のような関連ログがなければ、それ以上のデバッグを実施することはできません。 スクリプトがエージェントのブラウザー上で実行されていることを確認したら (ブラウザーコンソールで ### INBOX LOGGER ### Logging script enabled for targetNode: メッセージを確認してください)、以下の各シナリオについてログがサーバーへ送信される必要があります。 Inbox カードが表示された場合 INBOX LOGGER ### (2024-02-02T21:49:45.839Z): Added sn-inbox-card: Inbox カードが削除された場合 INBOX LOGGER ### (2024-02-02T21:59:55.542Z): Removed sn-inbox-card: 音声通知が再生された場合 INBOX LOGGER ### Audio notification was played. その他のログ: INBOX LOGGER ### Successfully logged AWA message. これらのログを使用することで、特定の Interaction の Inbox カードが表示されたかどうか、音声通知が再生されたかどうか、およびその他の関連情報を確認できます。 たとえば、以下のような情報を確認できます。 ユーザーが最後にページを操作してからの経過時間Inbox カードが表示されるべきタイミングでブラウザーに発生していた関連エラー スクリーン Related Links<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } ServiceNow アラート向けブラウザー設定の調整 Web ブラウザには、特定のサイトまたはタブのメディア制限を緩和するオプションが用意されています。ServiceNow と高度な作業アサインを使用する場合は、アラートを見逃さないように、次の対策を講じることをお勧めします。 Google Chrome Menu > Settings を選択します。左側のナビゲーションメニューで Privacy and Security を選択します。Privacy and Security オプションから Site Settings を選択します。インスタンスのホスト名 (例: instance.service-now.com) が最近のアクティビティに表示される場合があります。その項目を選択するか、View permissions and data stored across all sites から検索します。サイトの権限ページで、Notifications および Sound の権限が Allow に設定されていることを確認します。 デフォルトでは、Sound 権限は Automatic (default) に設定されていますが、この設定ではユーザー操作なしの音声再生は許可されません。 Microsoft Edge Menu > Settings を選択します。左側のナビゲーションメニューで Cookies and Site Permissions を選択します。All permissions の下で Media autoplay を選択します。Control if audio and video play automatically on sites を Allow に設定します。 すべてのサイトに適用したくない場合は、ServiceNow インスタンスのホスト名を Allow リストに追加できます。 Firefox Firefox > Preferences を選択します。左側のナビゲーションメニューで Privacy and Security を選択します。Permissions セクションまでスクロールし、Autoplay の設定を選択します。Default for all Websites を Allow Audio and Video に設定します。 または、ServiceNow インスタンスに対してのみ音声およびビデオを許可する場合は、サイトへアクセスし、このページの Site settings セクションの手順に従って例外を作成できます。 Virtual Agent アラート エージェントについて、以下のユーザー設定が true に設定されていることを確認してください。 connect.notifications.desktopworkspace.notifications.chat.desktopworkspace.notifications.inbox.desktop