How to Use the CAP Alert App – OptiSigns

In dit artikel laten we u zien hoe u de CAP Alert-app in OptiSigns kunt instellen en testen.

Hoe u een CAP Alert-app instelt
Hoe u uw CAP Alert test

OPMERKING

De CAP Alert-app is beschikbaar voor Pro Plus-abonnees en hoger.

Sommige noodalarmeringsystemen of Emergency Mass Notification Systems (zoals Everbridge en Alertus) kunnen CAP (Common Alerting Protocol) berichten naar doelen sturen, waaronder digital signage, wanneer er een noodsituatie is. U kunt met deze systemen integreren met behulp van de CAP Alert-app met OptiSigns.

Met de CAP Alert-app van OptiSigns kunt u een webhook genereren en deze integreren met het noodalarmeringsysteem. Wanneer er een noodsituatie is, zal het noodalarmeringsysteem de webhook aanroepen om het CAP-bericht te verzenden en de CAP Alert-app te activeren. De CAP-waarschuwing neemt de doelschermen over en toont het noodbericht. Het scherm hervat en speelt de oorspronkelijke inhoud af wanneer de noodsituatie voorbij is.

example of CAP alert with emergency text

Hoe u een CAP Alert-app instelt

Eerst moet u uw schermen instellen en koppelen. Voor meer informatie hierover, zie ons artikel over How to Set Up Digital Signs with OptiSigns.

Meld u vervolgens aan op ons portaal: http://app.optisigns.com/

Ga naar Bestanden/Assets, Klik op "App"

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

Selecteer "CAP Alert" app:

optisigns web browsers showing the cap alert app

Stel uw CAP Alert-app in:

cap alert app setup window in optisigns web browser

Naam - Naam van uw asset, deze wordt niet weergegeven op de schermen.
Doel - Selecteer Schermen of Tags.
Schermen/Tags - Selecteer welke schermen of groep schermen (tags) u wilt targeten voor deze noodsituatie. (bijv. Brand in gebouw/locatie 1)
Content-Type - Selecteer "Post naar Webhook" als u het CAP-bericht naar uw signage wilt posten. De app ondersteunt ook RSS-feeds.
Webhook - De app genereert een webhook-URL nadat deze is opgeslagen. Dit is wat u moet delen met het noodalarmeringsysteem.
Weergavetype - Momenteel neemt de app het volledige scherm over wanneer er een noodsituatie is
Status - Stel de app in op actief of inactief.
Noodsituatieduur - Hoe lang het noodbericht het scherm overneemt. De waarde kan worden overschreven door de webhook-aanroep.

Geavanceerde instellingen:

advanced settings of cap alert app in optisigns web browser

Lettertype, Kleur, Achtergrondkleur, Tekstuitlijning en Achtergrondafbeelding gebruiken - Hiermee kunt u het bericht naar wens ontwerpen (bijv. tekst verschijnt in het midden van het scherm bovenop de merkafbeeldingsjabloon van uw organisatie)
Itemduur - Hoe lang elk afzonderlijk item in de RSS-feed wordt weergegeven.
Titeltag - Berichttitel uit het CAP-bericht/RSS-feed, standaard is <headline> - u kunt dit wijzigen als uw feed anders is
Beschrijvingstag - Berichtinhoud uit het CAP-bericht/RSS-feed, standaard is <description> - u kunt dit wijzigen als uw feed anders is
Locatie (Schermtags) - Als u de schermtags kunt matchen met uw locatie die wordt doorgegeven vanuit het CAP-bericht/RSS-feed - kunt u dit gebruiken om de selectie van de doelschermen te controleren. Standaard wordt dit gekoppeld aan het "areaDesc"-attribuut uit de CAP-waarschuwing.

BELANGRIJK: Een veelvoorkomend probleem dat we tegenkomen is dat het scherm een "Geen inhoud beschikbaar"-bericht weergeeft nadat gebruikers de CAP-waarschuwing hebben uitgezonden met behulp van het "areaDesc"-attribuut. De oplossing: als u niet van plan bent schermtags te gebruiken om aan locatie te koppelen, probeer dan de Locatiewaarde te wijzigen van "areaDesc" naar een andere waarde, zoals "areaDesc2".

Filter inhoud met - Hiermee kan inhoud worden gefilterd op basis van specifieke woorden in de titel of beschrijving. Bijv.: "brand", dus als een titel of beschrijving het woord "brand" bevat (hoofdletterongevoelig), activeert de app de schermovername.
Titel uitsluiten met - Filter alleen van toepassing op de titel. U kunt alle oude feeds verbergen door te filteren met specifieke woorden in de titel. Bijv.: "Alles veilig", dus nadat de noodsituatie voorbij is, worden alle feeds vóór deze titel verborgen, waarna het scherm terugkeert naar de oorspronkelijke inhoud of alleen de nieuwe inhoud daarna weergeeft.
Gebruik Urgentie, Ernst, Zekerheid en Status om het filter van de CAP-berichten te controleren, dit zijn standaardattributen van CAP-berichten. Standaard wordt de app geactiveerd op alle waarden. Eenmaal geselecteerd, kunnen ze vergelijkbaar met tags worden ingesteld:

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

Geselecteerde keuzes blijven zichtbaar.

Klik op Opslaan wanneer u klaar bent.

Hoe u uw CAP Alert test

Na het opslaan genereert de app automatisch een Webhook-URL. Wanneer deze Webhook wordt aangeroepen, voert deze de functies uit die zijn toegewezen in uw CAP Alert-app. Als u de Webhook-URL deelt met uw noodalarmeringsysteem, kan het deze Webhook activeren tijdens een noodsituatie en de schermen overnemen.

Om uw CAP Alert-integratie te testen, raden we aan Postman te gebruiken om een CAP-bericht naar de Webhook te posten.

Download eerst Postman of meld u aan. Navigeer vervolgens naar Home → Send an API request → New Request:

Wijzig hier het aanvraagtype naar POST:

postman demonstration of how to select POST option

Voer vervolgens de Webhook-URL voor uw CAP Alert in.

Navigeer nu naar het tabblad Body. Hier kunt u gegevens op twee manieren verzenden: URL-gecodeerd of als een raw XML-bestand. Hier gaan we ervan uit dat u uw gegevens als raw XML verzendt, omdat dit het meest voorkomende formaat is dat we van noodalarmeringsystemen zien.

CAP-waarschuwingen worden doorgaans geleverd via een extern noodalarmeringsysteem, die worden opgeslagen als .xml- of .txt-bestanden. Deze worden uitgezonden via het Common Alerting Protocol Version 1.2. Om een XML-bestand te versturen, klikt u op raw → Dropdown → selecteer XML.

Kopieer en plak vervolgens het volgende stuk testcode in het veld:

<?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>

Het ziet er ongeveer zo uit:

postman xml input example

U kunt ook de duur van het CAP-waarschuwingsbericht instellen. In raw XML-formaat kunt u de duurwaarde doorgeven via een systeemparameter in uw CAP-waarschuwingsbericht.

Om het verzoek te testen, klikt u op Send. Er verschijnt een stuk tekst in de console hieronder. Als de test succesvol was, zou het een 200 OK-code moeten geven en "status": "success" moeten weergeven:

postman showing code layout under raw data tab

En dit bericht (ervan uitgaande dat alle standaardinstellingen in de CAP Alert-app zijn behouden) verschijnt op uw scherm:

test message for the CAP alert system

Een testverzoek maken in urlEncoded-formaat

Met het urlEncoded-formaat kan de duur als URL-parameter samen met data worden doorgegeven.

example in postman of urlencoded format

De rest van de test kan identiek worden uitgevoerd.

Dat is alles!

Als u aanvullende vragen of opmerkingen heeft over OptiSigns, neem dan gerust contact op met ons ondersteuningsteam via support@optisigns.com