How to Use the CAP Alert App – OptiSigns

この記事では、OptiSignsでCAP Alertアプリを設定してテストする方法を説明します。

CAP Alertアプリの設定方法
CAP Alertのテスト方法

注意

CAP AlertアプリはPro Plus以上のサブスクライバーが利用できます。

一部の緊急警報システムや緊急一斉通知システム（Everbridge、Alertusなど）は、緊急時にデジタルサイネージを含むターゲットにCAP（Common Alerting Protocol）メッセージをプッシュできます。OptiSignsのCAP Alertアプリを使用して、これらのシステムと統合できます。

OptiSignsのCAP Alertアプリを使用すると、Webhookを生成して緊急警報システムと統合できます。緊急時には、緊急警報システムがWebhookを呼び出してCAPメッセージを送信し、CAP Alertアプリをトリガーします。CAP Alertはターゲット画面を占有し、緊急メッセージを表示します。緊急事態が終了すると、画面は元に戻り、元のコンテンツを再生します。

example of CAP alert with emergency text

CAP Alertアプリの設定方法

まず、スクリーンを設定してペアリングする必要があります。詳細については、OptiSignsでデジタルサインを設定する方法の記事をご覧ください。

次に、ポータルにログオンします：http://app.optisigns.com/

ファイル/アセットに移動し、「アプリ」をクリックします。

optisigns web browser with arrows pointing at files/assets tab and app button

「CAP Alert」アプリを選択します：

optisigns web browsers showing the cap alert app

CAP Alertアプリを設定します：

cap alert app setup window in optisigns web browser

名前 - アセットの名前。画面には表示されません。
ターゲット - スクリーンまたはタグを選択します。
スクリーン/タグ - この緊急事態の対象とするスクリーンまたはスクリーンのグループ（タグ）を選択します。（例：建物/場所1での火災）
コンテンツタイプ - CAPメッセージをサイネージに送信する場合は「Webhookに投稿」を選択します。アプリはRSSフィードもサポートしています。
Webhook - アプリは保存後にWebhook URLを生成します。これを緊急警報システムと共有する必要があります。
表示タイプ - 現在、アプリは緊急時に全画面を占有します。
状態 - アプリをアクティブまたは非アクティブに設定します。
緊急時間 - 緊急メッセージが画面を占有する時間。この値はWebhook呼び出しで上書きできます。

詳細設定：

advanced settings of cap alert app in optisigns web browser

テキストフォント、色、背景色、テキスト配置、背景画像の使用 - 希望通りにメッセージをデザインできます（例：組織のブランド画像テンプレートの上に画面中央にテキストが表示される）
アイテム期間 - RSSフィードの各アイテムが表示される時間。
タイトルタグ - CAPメッセージ/RSSフィードのメッセージタイトル、デフォルトは<headline> - フィードが異なる場合は変更できます
説明タグ - CAPメッセージ/RSSフィードのメッセージコンテンツ、デフォルトは<description> - フィードが異なる場合は変更できます
場所（スクリーンタグ） - スクリーンタグをCAPメッセージ/RSSフィードから渡される場所と一致させることができる場合、ターゲットスクリーンの選択を制御するために使用できます。デフォルトでは、CAP Alertの「areaDesc」属性にマッピングされます。

重要： ユーザーが「areaDesc」属性を使用してCAP Alertをプッシュした後、画面に「利用可能なコンテンツがありません」というメッセージが表示される問題がよくあります。解決策：スクリーンタグを場所にマップする予定がない場合は、場所の値を「areaDesc」から「areaDesc2」などの他の値に変更してください。

次を含むコンテンツをフィルター - タイトルまたは説明の特定の単語に基づいてコンテンツをフィルターできます。例：「火災」、タイトルまたは説明に「火災」という単語（大文字小文字を区別しない）が含まれている場合、アプリは画面の占有をトリガーします。
次を含むタイトルを除外 - タイトルのみに適用されるフィルター。タイトル内の特定の単語でフィルタリングして、すべての古いフィードを非表示にできます。例：「All Clear」、緊急事態が終了した後、このタイトル以前のすべてのフィードが非表示になり、画面は元のコンテンツに戻るか、その後の新しいコンテンツのみを表示します。
緊急度、重大度、確実性、ステータスを使用してCAPメッセージのフィルターを制御、これらはCAPメッセージの標準属性です。デフォルトでは、アプリはすべての値でトリガーされます。選択すると、タグと同様に設定できます：

demonstration of urgency, severity, certainty, status options using tags

選択した選択肢は引き続き表示されます。

完了したら、保存をクリックします。

CAP Alertのテスト方法

保存後、アプリは自動的にWebhook URLを生成します。このWebhookが呼び出されると、CAP Alertアプリで指定された機能を実行します。Webhook URLを緊急警報システムと共有すると、緊急時にこのWebhookをトリガーして画面を占有できます。

CAP Alert統合をテストするには、Postmanを使用してCAPメッセージをWebhookに投稿することをお勧めします。

まず、Postmanをダウンロードまたはログインします。次に、ホーム → APIリクエストの送信 → 新しいリクエスト：に移動します。

ここで、リクエストタイプをPOSTに変更します：

postman demonstration of how to select POST option

次に、CAP AlertのWebhook URLを入力します。

次に、Bodyタブに移動します。ここでは、URLエンコードまたはraw XMLファイルの2つの方法でデータを送信できます。緊急警報サービスから最も一般的に見られる形式であるため、ここではデータをraw XMLとして送信することを想定しています。

CAP Alertは通常、外部の緊急警報システムを介して配信され、.xmlまたは.txtファイルとして保存されます。これらはCommon Alerting Protocol Version 1.2を介してブロードキャストされます。XMLファイルをプッシュするには、raw → ドロップダウン → XMLを選択します。

次に、以下のテストコードをフィールドにコピーして貼り付けます：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alert xmlns="urn:oasis:names:tc:emergency:cap:1.2">
    <identifier>ALERTUS_2317_67_20230131_162046</identifier>
    <sender>Tester</sender>
    <sent>2023-01-31T11:20:47-05:00</sent>
    <status>Actual</status>
    <msgType>Alert</msgType>
    <source>Alertus eEAS Server</source>
    <scope>Public</scope>
    <addresses>ALL</addresses>
    <code>IPAWSv1.0</code>
    <info>
        <language>en-US</language>
        <category>Safety</category>
        <event>TEST Event Name Override</event>
        <responseType>None</responseType>
        <urgency>Immediate</urgency>
        <severity>Severe</severity>
        <certainty>Observed</certainty>
        <eventCode>
            <valueName>SAME</valueName>
            <value>LAE</value>
        </eventCode>
        <effective>2023-01-31T11:20:47-05:00</effective>
        <onset>2023-01-31T11:20:47-05:00</onset>
        <expires>2023-01-31T11:23:46-05:00</expires>
        <headline>Test286</headline>
        <description>This is a Test of the Alertus Emergency Notification System. NO ACTION is Needed. In a real emergency, this system will be used to provide emergency information and protective actions. Please return to your normal activities.</description>
        <area>
            <areaDesc1>Tag1</areaDesc1>
            <geocode>
                <valueName>SAME</valueName>
                <value>000000</value>
            </geocode>
        </area>
        <parameter> 
            <valueName>duration</valueName> 
            <value>30</value> 
        </parameter> 
    </info>
</alert>

次のように表示されます：

postman xml input example

CAP Alertメッセージの継続時間も設定できます。raw XML形式では、CAP Alertメッセージのシステムパラメーターを通じて継続時間の値を渡すことができます。

次に、リクエストをテストするには、送信を押します。下のコンソールにテキストが表示されるはずです。テストが成功した場合、200 OKコードが表示され、"status": "success"と表示されるはずです：

postman showing code layout under raw data tab

そして、このメッセージ（CAP Alertアプリですべてのデフォルトが保持されていると仮定）が画面に表示されます：

test message for the CAP alert system

urlEncoded形式でのテストリクエストの作成

urlEncoded形式を使用すると、継続時間をデータと一緒にURLパラメーターとして渡すことができます。

example in postman of urlencoded format

残りのテストは同様に実行できます。

以上です！

OptiSignsについて追加の質問、懸念事項、またはフィードバックがある場合は、support@optisigns.comのサポートチームまでお気軽にお問い合わせください。