How to Use the CAP Alert App – OptiSigns

In questo articolo, ti mostreremo come configurare e testare l'app CAP Alert in OptiSigns.

Come Configurare un'App CAP Alert
Come Testare il tuo CAP Alert

NOTA

L'app CAP Alert è disponibile per gli abbonati Pro Plus e superiori.

Alcuni Sistemi di Allerta di Emergenza o Sistemi di Notifica di Massa di Emergenza (come Everbridge e Alertus) possono inviare messaggi CAP (Common Alerting Protocol) ai destinatari, inclusa la segnaletica digitale, quando si verifica un'emergenza. Puoi integrarti con questi sistemi utilizzando l'app CAP Alert con OptiSigns.

Utilizzando l'app CAP Alert di OptiSigns, puoi generare un webhook e integrarlo con il Sistema di Allerta di Emergenza. Quando si verifica un'emergenza, il sistema di allerta di emergenza chiamerà il webhook per inviare il messaggio CAP e attivare l'app CAP Alert. L'allerta CAP prenderà il controllo degli schermi target e visualizzerà il messaggio di emergenza. Lo schermo riprenderà e riprodurrà il contenuto originale quando l'emergenza sarà terminata.

example of CAP alert with emergency text

Come Configurare un'App CAP Alert

Per prima cosa, dovrai avere i tuoi schermi configurati e accoppiati. Per ulteriori informazioni su come farlo, consulta il nostro articolo su Come Configurare la Segnaletica Digitale con OptiSigns.

Quindi accedi al nostro portale: http://app.optisigns.com/

Vai su File/Asset, Clicca su "App"

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

Seleziona l'app "CAP Alert":

optisigns web browsers showing the cap alert app

Configura la tua app CAP Alert:

cap alert app setup window in optisigns web browser

Nome - Nome del tuo asset, questo non verrà visualizzato sugli schermi.
Target - Seleziona Schermi o Tag.
Schermi/Tag - Seleziona quali schermi o gruppo di schermi (tag) vuoi targettizzare per questa emergenza. (es. Incendio nell'edificio/posizione 1)
Content-Type - Seleziona "Post to Webhook" se desideri pubblicare il messaggio CAP sulla tua segnaletica. L'app supporta anche feed RSS.
Webhook - L'app genererà un URL webhook dopo essere stata salvata. Questo è ciò che dovresti condividere con il sistema di allerta di emergenza.
Tipo di Visualizzazione - Attualmente l'app prenderà il controllo dell'intero schermo quando c'è un'emergenza
Stato - Imposta l'app su attiva o inattiva.
Durata dell'Emergenza - Quanto tempo il messaggio di emergenza prenderà il controllo dello schermo. Il valore può essere sovrascritto dalla chiamata webhook.

Impostazioni avanzate:

advanced settings of cap alert app in optisigns web browser

Utilizzo di Font del Testo, Colore, Colore di Sfondo, Allineamento del Testo e Immagine di Sfondo - Ti permette di progettare il messaggio come desideri (es. il testo appare al centro dello schermo sopra l'immagine modello del marchio della tua organizzazione)
Durata dell'Elemento - Quanto tempo ogni singolo elemento nel feed RSS verrà visualizzato.
Tag del Titolo - Titolo del messaggio dal messaggio CAP/feed RSS, l'impostazione predefinita è <headline> - puoi cambiarlo se il tuo feed è diverso
Tag della Descrizione - Contenuto del messaggio dal messaggio CAP/feed RSS, l'impostazione predefinita è <description> - puoi cambiarlo se il tuo feed è diverso
Posizione (Tag dello Schermo) - Se puoi far corrispondere i tag dello schermo con la tua posizione passata dal messaggio CAP/feed RSS - puoi usarlo per controllare la selezione degli schermi target. Per impostazione predefinita, si mappa sull'attributo "areaDesc" dall'allerta CAP.

IMPORTANTE: Un problema comune che riscontriamo è che lo schermo visualizza un messaggio "Nessun Contenuto Disponibile" dopo che gli utenti inviano l'allerta CAP usando l'attributo "areaDesc". La soluzione: se non intendi utilizzare i tag dello schermo per mappare la posizione, prova a cambiare il valore Posizione da "areaDesc" a qualsiasi altro valore, come "areaDesc2".

Filtra contenuto contenente - Permette di filtrare il contenuto in base a parole specifiche nel titolo o nella descrizione. ES: "incendio", quindi se qualsiasi titolo o descrizione contiene la parola "incendio" (non sensibile alle maiuscole), l'app attiverà il takeover dello schermo.
Escludi titolo contenente - Filtro che si applica solo al titolo. Puoi nascondere tutti i feed vecchi filtrando con parole specifiche nel titolo. ES: "Tutto Chiaro", quindi dopo che l'emergenza è terminata, tutti i feed prima di questo titolo saranno nascosti, quindi lo schermo tornerà al contenuto originale o visualizzerà solo il nuovo contenuto dopo di esso.
Usa Urgenza, Gravità, Certezza e Stato per controllare il filtro dei messaggi CAP, questi sono attributi standard dei messaggi CAP. Per impostazione predefinita, l'app sarà attivata su tutti i valori. Una volta selezionati, possono essere impostati in modo simile ai tag:

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

Le scelte selezionate continueranno ad apparire.

Quando hai finito, clicca Salva.

Come Testare il tuo CAP Alert

Dopo il salvataggio, l'app genererà automaticamente un URL Webhook. Quando questo Webhook viene chiamato, eseguirà le funzioni designate nella tua app CAP Alert. Se condividi l'URL Webhook con il tuo Sistema di Allerta di Emergenza, sarà in grado di attivare questo Webhook durante un'emergenza e prendere il controllo degli schermi.

Per testare la tua integrazione CAP Alert, ti consigliamo di utilizzare Postman per pubblicare un messaggio CAP al Webhook.

Per prima cosa, scarica o accedi a Postman. Una volta lì, naviga su Home → Invia una richiesta API → Nuova Richiesta:

Una volta qui, cambia il tipo di richiesta in POST:

postman demonstration of how to select POST option

Inserisci l'URL Webhook per il tuo CAP Alert successivamente.

Ora, naviga nella scheda Body. Qui, puoi inviare dati in due modi: URL encoded o come file XML raw. Qui assumeremo che tu stia inviando i tuoi dati come XML raw, poiché questo è il formato più comune che vediamo dai Servizi di Allerta di Emergenza.

Gli Alert CAP sono generalmente consegnati tramite un Sistema di Allerta di Emergenza esterno, che sono salvati come file .xml o .txt. Questi sono trasmessi tramite il Common Alerting Protocol Version 1.2. Per inviare un file XML, clicca su raw → Menu a tendina → seleziona XML.

Quindi, copia e incolla il seguente pezzo di codice di test nel campo:

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

Apparirà qualcosa del genere:

postman xml input example

Puoi anche impostare la durata del messaggio di allerta CAP. In formato XML raw, puoi passare il valore della durata attraverso un parametro di sistema nel tuo messaggio di allerta CAP.

Ora, per testare la richiesta, premi Invia. Un pezzo di testo dovrebbe apparire nella console sottostante. Se il test ha avuto successo, dovrebbe dare un codice 200 OK e dire "status": "success":

postman showing code layout under raw data tab

E questo messaggio (assumendo che tutte le impostazioni predefinite siano state mantenute nell'app CAP Alert) apparirà sul tuo schermo:

test message for the CAP alert system

Creare una Richiesta di Test in Formato urlEncoded

Utilizzando il formato urlEncoded, la durata può essere passata come parametro URL insieme ai dati.

example in postman of urlencoded format

Il resto del test può essere eseguito in modo identico.

Ecco tutto!

Se hai domande aggiuntive, dubbi o qualsiasi feedback su OptiSigns, non esitare a contattare il nostro team di supporto all'indirizzo support@optisigns.com