AWA 通知:デバッグ 受信ボックスカードに関連する問題は、ワークスペースのエージェントには表示されません。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: ; } } body { font-family: Arial, sans-serif; background-color: #f0f8ff; margin: 0; padding: 20px; line-height: 1.6; } .container { background-color: #ffffff; border-radius: 10px; padding: 20px; box-shadow: 0 0 10px rgba(0, 0, 0, 0.1); max-width: 800px; margin: auto; } h1 { color: #333; text-align: center; } p, li { color: #555; font-size: 14pt; } ol { margin-left: 20px; padding-left: 20px; } .highlight { background-color: #e0f7fa; padding: 10px; border-left: 5px solid #00796b; margin-bottom: 20px; border-radius: 5px; } .important { color: #d32f2f; font-weight: bold; } AWA 受信ボックスの一般的な問題 AWA を使用すると、エージェントにタスクがアサインされたときに受信ボックスカードが表示されなかったり、関連するオーディオ通知が聞こえなかったりすることがあるというよくある苦情を耳にします。「com.glide.awa.client_logging.enabled」プロパティが有効になっている場合、受信トレイ関連の更新を受信したときにクライアントからサーバーに送信されたログを調べるなど、この問題に対処するために実行できるさまざまなチェックがあります。 それにもかかわらず、クライアントが必要なメッセージを時間通りに受信したにもかかわらず、受信ボックスカードまたはアラートが見落とされたことがログ記録に示されている場合があります。正確な原因を特定したり、説明したりすることは、いくつかの要因により困難な場合があります。 問題はクライアント側のみにあります。断続的に発生します。エラーに関連しない要因 (エージェントが別の場所で占有されているなど) が関係している可能性があります。 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: ; } } body { font-family: Arial, sans-serif; background-color: #f0f8ff; margin: 0; padding: 20px; line-height: 1.6; } .container { background-color: #ffffff; border-radius: 10px; padding: 20px; box-shadow: 0 0 10px rgba(0, 0, 0, 0.1); max-width: 800px; margin: auto; } p { color: #555; font-size: 14pt; } .highlight { background-color: #e0f7fa; padding: 10px; border-left: 5px solid #00796b; margin-bottom: 20px; border-radius: 5px; } 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: ; } } body { font-family: Arial, sans-serif; line-height: 1.6; background-color: #f4f6f9; margin: 0; padding: 20px; } .content { background-color: #ffffff; border-radius: 10px; padding: 20px; box-shadow: 0 0 10px rgba(0, 0, 0, 0.1); } h1 { color: #333333; } h2 { color: #4CAF50; margin-top: 20px; } h3 { color: #2E7D32; margin-bottom: 10px; } p, li { color: #555555; font-size: 14pt; } ol { margin-left: 40px; } .important { color: #D32F2F; font-weight: bold; } .highlight { background-color: #e8f5e9; padding: 10px; border-radius: 5px; border: 1px solid #AED581; } .code-block { background-color: #f1f1f1; padding: 10px; border-radius: 5px; border: 1px solid #ccc; font-family: 'Courier New', Courier, monospace; font-size: 12pt; white-space: pre-wrap; } 作業項目カードが受信トレイにプッシュされたことを示すクライアント側のログを取得する方法は次のとおりです。 必須条件 まずcom.glide.awa.client_logging.enabled プロパティが存在することを確認して、クライアントからサーバーへのログ記録呼び出しが記録されていることを確認します。このプロパティはタイプが (true|false)true に設定されている必要があります。さらに、このプロパティが awa_agent、 awa_manager、および awa_admin ロールの読み取りアクセスを許可していることを確認します。 スクリプトの実行 その後、断続的な受信ボックスの問題が発生したエージェントは、ワークスペースがロードまたは更新されるたびにスクリプトを実行する必要があります。スクリプトの継続的な実行を確保することは、デバッグ目的で関連するログをキャプチャできるため、非常に重要です。スクリプトを実行するには、次の 2 つの方法があります。 Tamper Monkey ブラウザ拡張機能を利用しています。Chrome 開発ツール内でのスニペットの使用。 Tamper Monkey を Chrome 拡張機能として使用してスクリプトを実行するには: ブラウザに TamperMonkey 拡張機能をインストールします。TamperMonkey インターフェイス内に新しい UserScript を作成します。添付された inbox_logger_2024_03_04.txt の内容をスクリプトにコピーします。この拡張機能は、ほとんどの一般的なブラウザと互換性があります。TamperMonkey 拡張機能をインストールしてスクリプトを作成する手順については、次のビデオを参照してください。 Chrome 開発ツールでスニペットを使用してスクリプトを実行するには: SN_AWA_script.pdfで説明されている手順を参照し、添付の inbox_logger_2024_03_04_new.txt の内容をコピーするか、提供されているビデオの手順をご覧ください。 スクリプトの実行 スクリプトをインストールしたら、関連するログを正確にキャプチャするために、ワークスペースがロードまたは更新されるたびにスクリプトを実行してください。関連するログ (以下に示すように) がないと、さらなるデバッグは不可能であるため、このステップは非常に重要です。スクリプトがエージェントのブラウザで実行されていることが確認されたら (ブラウザコンソールで「### INBOX LOGGER ### Logging script enabled for targetNode:」というメッセージを確認してください)、次のシナリオごとにログをサーバーに送信する必要があります (それぞれのサンプルログが提供されています)。 受信ボックスカードが表示された場合: 受信ボックスロガー ### (2024-02-02T21:49:45.839Z):sn-inbox-card が追加されました: 受信ボックスカードが削除された場合: 受信ボックスロガー ### (2024-02-02T21:59:55.542Z):削除された sn-inbox-card: オーディオ通知が再生されると、次のようになります。 受信ボックスロガー ### オーディオ通知が再生されました。 その他のログ: 受信ボックスロガー ### AWA メッセージが正常にログに記録されました。 これらのログを使用して、特定のインタラクションの受信ボックスカードが表示されたかどうか、オーディオ通知が再生されたかどうか、およびその他の関連する詳細 (ユーザーがページを最後にインタラクションしてからの期間、または受信ボックスカードを表示するはずだったときのブラウザの関連エラーなど) を確認できます。 スクリーン 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: ; } } body { font-family: Arial, sans-serif; line-height: 1.6; background-color: #f4f6f9; margin: 0; padding: 20px; } .content { background-color: #ffffff; border-radius: 10px; padding: 20px; box-shadow: 0 0 10px rgba(0, 0, 0, 0.1); } h1 { color: #333333; } h2 { color: #4CAF50; margin-top: 20px; } h3 { color: #2E7D32; margin-bottom: 10px; } p, li { color: #555555; font-size: 14pt; } ol, ul { margin-left: 40px; } .highlight { background-color: #e8f5e9; padding: 10px; border-radius: 5px; border: 1px solid #AED581; } a { color: #1E88E5; text-decoration: none; } a:hover { text-decoration: underline; } .important { color: #D32F2F; font-weight: bold; } img { display: block; margin: 10px auto; } ServiceNow アラートのブラウザ設定の調整 Web ブラウザには、特定のサイトまたはタブのメディア制限を緩和するオプションが用意されています。ServiceNow と高度な作業アサインを使用する場合は、アラートを見逃さないように、次の対策を講じることをお勧めします。 Google Chrome: メニュー>設定を選択します。左側のナビゲーションメニューで「プライバシーとセキュリティ」を選択します。「プライバシーとセキュリティ」オプションから「サイト設定」を選択します。インスタンスのホスト名 (「Instance.service-now.com」など) が [最近のアクティビティ] に表示される場合があります。そこで選択するか、[すべてのサイトに保存されている権限とデータの表示] で検索します。サイトの権限ページで、「通知」権限と「サウンド」権限が「許可」に設定されていることを確認します。デフォルトでは、サウンド権限は「自動 (デフォルト)」に設定されており、ユーザーのインタラクションのない音声は許可されません。 Microsoft Edge: メニュー>設定を選択します。左側のナビゲーションメニューで「Cookieとサイトの権限」を選択します。「すべての権限」で「メディア自動再生」を選択します。[サイトでオーディオとビデオを自動的に再生するかどうかを制御する] で、[許可] を選択します。すべてのサイトでこれが望ましくない場合は、ServiceNow インスタンスのホスト名を「許可」リストに追加できます。 Firefox Firefox >設定を選択します。左側のナビゲーションメニューで「プライバシーとセキュリティ」を選択します。「権限」セクションまで下にスクロールし、「自動再生」設定を選択します。すべての Web サイトのデフォルトを [音声とビデオを許可] に設定します。または、ServiceNow インスタンスに対してのみオーディオとビデオを許可する場合は、サイトにアクセスし、 このページの「サイトの設定」セクションの指示に従って例外を設けることができます。 仮想エージェントアラート エージェントに対して次のユーザー設定が true に設定されていることを確認してください。 connect.notifications.desktopworkspace.notifications.chat.desktopworkspace.notifications.inbox.desktop