Konfigurieren Sie Code für kritische Warnungen

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer
  • Sie können eine Push-Benachrichtigung zu einer kritischen Warnung machen, indem Sie JSON-Code hinzufügen. Für wird ein anderer JSON-Code verwendet iOS Und Android Betriebssysteme und für ITSM Geschäftsbereich.

    Beim Erstellen kritischer Warnungsbenachrichtigungen benötigen Sie die Codestruktur einer Push-Benachrichtigungsnachricht sowie den erforderlichen JSON-Code, der die Benachrichtigung als kritische Warnung definiert. Sie fügen diesen Code im Inhaltsbereich der Push-Nachricht hinzu. Weitere Informationen finden Sie unter Kritische mobile Warnungen.

    Wichtig:

    Auf der Android Plattform: Wenn ein Anwender eine kritische Warnung zu bestimmten Telefontypen erhält, kann es zu folgendem Geräteverhalten kommen:

    OnePlus-Geräte mit hardwaregesteuertem Klingelmodus:
    Auf Geräten wie OnePlus, bei denen der Klingelmodus von einem physischen Switch gesteuert wird, kann die App die Lautstärke des Benachrichtigungs-Sounds möglicherweise nicht überschreiben, wenn das Gerät auf den lautlosen oder vibrierenden Modus eingestellt ist.
    Verhalten des OnePlus- oder Oppo-Geräts im Modus nicht stören:
    Wenn auf bestimmten Geräten wie Oppo und OnePlus der DND-Modus (Do Not Disturb) aktiviert ist, kann die DND-Einstellung vorübergehend deaktiviert werden, bis der Signalton für kritische Benachrichtigungen abgeschlossen ist.
    Ein Android Clients, Version 20.0.0 und höher, kritische Warnungen funktionieren für Folgendes nicht:
    • Die Android Funktion „privater Bereich“, die in eingeführt wurde Android15.
    • Android Geräte, die von der Software Mobile Device Management (MDM) verwaltet werden. Beispiel: Microsoft Intune.

    JSON für kritische Warnung zum Aktivieren Android Betriebssysteme

    Der folgende Code muss dem JSON-Code hinzugefügt werden, da er aktiviert wird Android Geräte, die aktiviert werden sollen, damit eine kritische Warnung ausgelöst werden kann.
    Hinweis:
    Weil Anwender beides verwenden iOS Und Android Geräte, die Sie diesen Code hinzufügen müssen. Der JSON-Eintrag im Code ist ein zurückgegebener Wörterbuchnamenwert aus dem Skripting.
     
    
    json["sncGoogleKeys"] = { 
              "android": { 
                  "priority": "high" 
              }, 
              "priority": "high" 
          }; 
    

    Kritische Warnung – JSON für alle Betriebssysteme

    Das folgende JSON-Objekt muss hinzugefügt werden, damit eine Benachrichtigung sich als kritische Warnung verhält.

    var json = {};
    json["aps"] = { 
    "sound": {
              "critical": 1, 
              "name": "NotificationAlert-1.caf", 
              "volume": 1.0 
    }
          };
    
    Die Parameter im JSON-Beispielcode sind:
    • Die criticalParameter definiert die Benachrichtigung als kritische Warnung. 1 Bedeutet, dass die kritische Warnung aktiv ist, 0 Bedeutet, dass die kritische Warnung inaktiv ist.
    • Die nameParameter ist der Name des Signals, der aktiviert wird, wenn eine kritische Warnung gesendet wird. Einige Töne für kritische Warnungen sind in der Tabelle aufgeführt. Eine vollständige Liste finden Sie unter Konfigurieren Sie Sounds für Push-Benachrichtigungen.
      Akzeptierte Dateinamenwerte Tonrhythmus
      NotificationAlert-2.caf Dramatisch
      NotificationAlert-2-Short.caf Dramatisch
      NotificationAlert-9.caf Dramatisch, Leistungsstark
      NotificationAlert-9-Short.caf Dramatisch, Leistungsstark
      NotificationAlert-10.caf Dramatisch, Aufdringlich
      NotificationAlert-10-Short.caf Dramatisch, Aufdringlich
      Hinweis:
      Wenn ein nameWert ist nicht definiert, das System verwendet den standardmäßigen Klingelton der Anwendung. Wenn für eine Anwendung kein definierter Klingelton vorhanden ist, verwendet das System den Standardklingelton des Geräts.
    • Die volumeParameter definiert das Volumen des kritischen Warntons. Der Bereich ist von 0,1 So leise wie möglich 1,0 Als am lautesten.

    Beispiel für JSON-Codeblock für kritische Warnung

    Im Folgenden finden Sie einen vollständigen Beispielblock für JSON-Code, den Sie hinzufügen und konfigurieren müssen, um eine kritische Warnung für zu aktivieren Android Und iOS Geräte.

    json["sncGoogleKeys"] = { 
              "android": { 
                  "priority": "high" 
              }, 
              "priority": "high" 
          }; 
      
    json["aps"]["sound"] = { 
              "critical": 1, 
              "name": "NotificationAlert-1.caf", 
              "volume": 1.0 
          };

    IT Service Management ( ITSM) CriticalPushPayloader-Skripteinbindung

    Die Inhalt der Push-Nachricht Der Bereich kann zuvor konfigurierten Code einschließlich der Skripteinbindung enthalten CriticalPushPayLoadBuilder , Erstellt von ITSM Geschäftsbereich. Wenn dies der Fall ist, ist keine zusätzliche Konfiguration für kritische Warnungen erforderlich. Skripteinbindungen sind wiederverwendbare serverseitige Skriptlogik, die eine Funktion oder Klasse definiert.  CriticalPushPayLoadBuilder Ist eine Skripteinbindung, die Funktionen zur Unterstützung kritischer Warnungen enthält. Der Aufruf der Skripteinbindungen sieht wie folgt aus: CriticalPushPayloadBuilder (aktuell, JSON, Attribute).buildJSON()
    Hinweis:
    Wenn Sie die Werte von ändern müssen Volume Oder Name Parameter oder ändern Sie die Warnung von kritisch in nicht kritisch. Sie müssen auf die Funktionsparameter zugreifen, die die Skripteinbindung als Eingaben erhält.

    Das Ändern des Werts der Skripteinbindung für kritische Warnungen wirkt sich auf alle aus ITSM Implementierungen der Skripteinbindung. Ähnlich ist ein ITSM Das Plugin-Upgrade könnte Ihre Änderungen an Ihrer Skripteinbindung überschreiben.