In diesem Artikel
dropdown icon
Aktionstaste anpassen
    Parametereinstellungen für Notrufe
    Benutzerdefinierte Serviceparametereinstellungen
    Parametereinstellungen für mehrere Auslöser
    Ein einzelner Trigger für mehrere Ereignisparametereinstellungen
HTTP POST-Anforderung für die Schaltfläche "Aktion"
Konfigurieren Sie die Aktionstaste (Unified CM)
list-menuIn diesem Artikel
list-menuFeedback?

Dieser Hilfeartikel ist für Cisco Wireless Phone 9821, registriert unter Cisco Unified Communications Manager (Unified CM).

Die Aktionstaste ist die rote Taste, die sich auf der rechten Seite des Cisco Wireless Phone 9821 befindet. Benutzer können damit schnell auf bestimmte Services zugreifen, beispielsweise Notfalldienste oder benutzerdefinierte Services. Sie können die Schaltfläche anpassen, um Ereignisse zu initiieren, die Ihren spezifischen Anwendungsfällen entsprechen.

Aktionstaste anpassen

1

Führen Sie in Cisco Unified Communications Manager Administration nach Bedarf eine der folgenden Aktionen aus:

  • Um alle bereitgestellten Telefone zu konfigurieren, wechseln Sie zu System-> Firmentelefonkonfiguration .
  • Um Telefone mit demselben Telefonprofil zu konfigurieren, wechseln Sie zu Gerät>Geräteeinstellungen > Allgemeines Telefonprofil .
  • Um ein einzelnes Telefon zu konfigurieren, gehen Sie zu Gerät > Telefon. Suchen Sie dann Ihr Telefon und öffnen Sie die Seite Telefonkonfiguration.

Die Konfiguration folgt einer hierarchischen Struktur:

  • Individuelle Geräteeinstellungen haben Vorrang vor Einstellungen im allgemeinen Telefonprofil und auf Enterprise-Ebene
  • Allgemeine Telefonprofileinstellungen haben Vorrang vor Einstellungen auf Unternehmensebene

2

Passen Sie die Parameter der Aktionsschaltfläche basierend auf Ihren Anwendungsfällen an.

Es gibt drei Gruppen von Parametern für die Schaltfläche "Aktion", die jeweils einem Dienst mit einem eindeutigen Auslöser entsprechen. Wenn ein Service-Trigger in mehreren Gruppen angegeben wird, haben die Einstellungen in Gruppe 1 Vorrang vor denen in Gruppe 2 und 3, während Gruppe 2 Vorrang vor Gruppe 3 hat.

Weitere Informationen zu diesen Parametern finden Sie unter Produktspezifische Konfigurationsparameter.

3

Wählen Sie Speichern.

4

Wählen Sie Konfiguration übernehmen.

Parametereinstellungen für Notrufe

Konfigurieren Sie die folgenden Parameter für Notrufe.

Tabelle 1. Parametereinstellungen für Notrufe

Parameter

Einstellungen

Funktion der Aktionsschaltfläche

Wählen Sie Notruf aus.

Aktionsschaltfläche – Serviceziel

Geben Sie die Telefonnummer oder URI des Notrufdienstes ein.

Aktionsschaltflächendienstname

(Optional) Geben Sie einen Namen für den Dienst an, der dem Auslöser zugeordnet ist. Dieser Name wird in der Bildschirmmeldung angezeigt, wenn der Benutzer die Taste drückt, und gibt an, welcher Dienst ausgelöst wird. Wenn kein Name angegeben ist, wird "Notruf " oder "Stiller Notruf " als Anzeigename verwendet.

Herauswahlverzögerung

Legen Sie den Timeout-Zeitraum in Sekunden fest, über den das Telefon nach Erkennung des Auslösers ein Ereignis auslösen soll. Die Standardeinstellung ist 5 Sekunden. Wenn der Wert auf 0 gesetzt wird, wird das Ereignis sofort nach der Erkennung des Auslösers ausgelöst.

Auf dem Verzögerungsbildschirm wird ein Countdown-Timer angezeigt, über den der Benutzer die durch die Aktionstaste ausgelöste Aktion abbrechen kann. In Notrufszenarien vibriert das Cisco Wireless Phone 9821 kontinuierlich, während der Verzögerungsbildschirm angezeigt wird. Bei stillen Notrufen oder Signalen vibriert das Cisco Wireless Phone 9821 jedoch nicht.

Service-Trigger

Wählen Sie einen Auslöser aus der Liste aus: Einmal drücken, langes Drücken oder 3 Mal drücken.

Stiller Notruf

(Optional) standardmäßig funktioniert der Notruf wie andere ausgehende Anrufe als bidirektionaler Anruf. Wenn der stille Notruf aktiviert ist, ist die Audiowiedergabe auf der Anruferseite stummgeschaltet, um die Aufmerksamkeit während des eingehenden Anrufs zu vermeiden. Nur der Empfänger kann den stillen Notruf beenden.

Während eines stillen Notrufs wird der Bildschirm des Cisco Wireless Phone 9821 ausgeschaltet. Auf alle anderen Funktionen kann nicht zugegriffen werden. Das Telefon kehrt wieder zum normalen Betrieb zurück, nachdem der Empfänger den Anruf beendet hat.

Stillen Notrufabruf zulassen

(Optional) Aktivieren Sie diese Funktion, wenn Sie zulassen, dass der Benutzer eine beliebige Taste drücken kann, um den normalen Telefonbetrieb wiederherzustellen und gleichzeitig den Notruf aufrechtzuerhalten. Der Ton bleibt stumm, bis der Benutzer die Lautsprecherlautstärke mit der Lautstärketaste erhöht.

Benutzerdefinierte Serviceparametereinstellungen

Konfigurieren Sie die folgenden Parameter für benutzerdefinierte Services.

Tabelle 2. Benutzerdefinierte Serviceparametereinstellungen

Parameter

Einstellungen

Funktion der Aktionsschaltfläche

Wählen Sie Benutzerdefiniert aus.

Aktionsschaltfläche – Serviceziel

Geben Sie die URL für den benutzerdefinierten Service ein. Die URL muss mit http:// oder https:// beginnen, z. B. https://10.11.20.159/path/service.xml .

Aktionsschaltflächendienstname

(Optional) Geben Sie einen Namen für den Dienst an, der dem Auslöser zugeordnet ist. Dieser Name wird in der Bildschirmmeldung angezeigt, wenn der Benutzer die Taste drückt, und gibt an, welcher Dienst ausgelöst wird. Wenn kein Name angegeben ist, wird der benutzerdefinierte Service als Anzeigename verwendet.

Benutzerdefiniertes Inhaltsfeld

(Optional) Wenn Sie möchten, dass das Telefon beim Drücken der Aktionstaste eine HTTP POST-Anforderung sendet, geben Sie die HTTP-Daten mit maximal 1024 Zeichen ein, beispielsweise Methode, Header und POST-Inhalt.

Beispiele für POST Skripts und die Syntax finden Sie unter HTTP POST-Anforderung für die Schaltfläche Aktion.

Herauswahlverzögerung

Legen Sie den Timeout-Zeitraum in Sekunden fest, über den das Telefon nach Erkennung des Auslösers ein Ereignis auslösen soll. Die Standardeinstellung ist 5 Sekunden. Wenn der Wert auf 0 gesetzt wird, wird das Ereignis sofort nach der Erkennung des Auslösers ausgelöst.

Auf dem Verzögerungsbildschirm wird ein Countdown-Timer angezeigt, über den der Benutzer die durch die Aktionstaste ausgelöste Aktion abbrechen kann. In benutzerdefinierten Dienstszenarien vibriert das Cisco Wireless Phone 9821 kontinuierlich, während der Verzögerungsbildschirm angezeigt wird.

Service-Trigger

Wählen Sie einen Auslöser aus der Liste aus: Einmal drücken, langes Drücken oder 3 Mal drücken.

Dienstgeheimnis

Legen Sie eine geheime Zeichenfolge fest, bei der es sich um einen Authentifizierungsschlüssel, ein Token oder ein Kennwort handeln kann. Der eingegebene geheime Schlüssel wird als maskierte Zeichenfolge angezeigt und kann mithilfe des Makros $SS im Feld "benutzerdefinierter Inhalt" und unter "Aktionsschaltflächendienstziel "referenziert werden.

Parametereinstellungen für mehrere Auslöser

Legen Sie die Parameter in jeder Gruppe entsprechend fest. Weitere Informationen finden Sie oben in den Abschnitten Notrufe und benutzerdefinierte Dienste .

Ein einzelner Trigger für mehrere Ereignisparametereinstellungen

Konfigurieren Sie die folgenden Parameter, um einem Auslöser mehrere Ereignisse zuzuweisen.

Tabelle 3. Ein einzelner Trigger für mehrere Ereignisparametereinstellungen

Parameter

Einstellungen

Funktion der Aktionsschaltfläche

Wählen Sie Benutzerdefiniert aus.

Aktionsschaltfläche – Serviceziel

Geben Sie die anzurufende Telefonnummer und die Dienst-URL XML in folgendem Format ein:

Tel:<Telefonnummer oder SIP URI> + <Service-URL>

Die URL muss mit http:// oder https:// beginnen.

Beispiel: tel:1234 + https://10.11.20.159/path/service.xml

Aktionsschaltflächendienstname

(Optional) Geben Sie einen Namen für den Dienst an, der dem Auslöser zugeordnet ist. Dieser Name wird in der Bildschirmmeldung angezeigt, wenn der Benutzer die Taste drückt, und gibt an, welcher Dienst ausgelöst wird. Wenn kein Name angegeben ist, wird der benutzerdefinierte Service als Anzeigename verwendet.

Benutzerdefiniertes Inhaltsfeld

(Optional) Wenn Sie möchten, dass das Telefon beim Drücken der Aktionstaste eine HTTP POST-Anforderung sendet, geben Sie die HTTP-Daten mit maximal 1024 Zeichen ein, beispielsweise Methode, Header und POST-Inhalt.

Beispiele für POST Skripts und die Syntax finden Sie unter HTTP POST-Anforderung für die Schaltfläche Aktion.

Herauswahlverzögerung

Legen Sie den Timeout-Zeitraum in Sekunden fest, über den das Telefon nach Erkennung des Auslösers ein Ereignis auslösen soll. Die Standardeinstellung ist 5 Sekunden. Wenn der Wert auf 0 gesetzt wird, wird das Ereignis sofort nach der Erkennung des Auslösers ausgelöst.

Auf dem Verzögerungsbildschirm wird ein Countdown-Timer angezeigt, über den der Benutzer die durch die Aktionstaste ausgelöste Aktion abbrechen kann. Während Notruf- und benutzerdefinierten Dienstszenarien vibriert das Cisco Wireless Phone 9821 kontinuierlich, während der Verzögerungsbildschirm angezeigt wird. Bei stillen Notrufen oder Signalen vibriert das Cisco Wireless Phone 9821 jedoch nicht.

Service-Trigger

Wählen Sie einen Auslöser aus der Liste aus: Einmal drücken, langes Drücken oder 3 Mal drücken.

Dienstgeheimnis

Legen Sie eine geheime Zeichenfolge fest, bei der es sich um einen Authentifizierungsschlüssel, ein Token oder ein Kennwort handeln kann. Der eingegebene geheime Schlüssel wird als maskierte Zeichenfolge angezeigt und kann mithilfe des Makros $SS im Feld "benutzerdefinierter Inhalt" und unter "Aktionsschaltflächendienstziel "referenziert werden.

Stiller Notruf

(Optional) standardmäßig funktioniert der Notruf wie andere ausgehende Anrufe als bidirektionaler Anruf. Wenn der stille Notruf aktiviert ist, ist die Audiowiedergabe auf der Anruferseite stummgeschaltet, um die Aufmerksamkeit während des eingehenden Anrufs zu vermeiden. Nur der Empfänger kann den stillen Notruf beenden.

Während eines stillen Notrufs wird der Bildschirm des Cisco Wireless Phone 9821 ausgeschaltet. Auf alle anderen Funktionen kann nicht zugegriffen werden. Das Telefon kehrt wieder zum normalen Betrieb zurück, nachdem der Empfänger den Anruf beendet hat.

Stillen Notrufabruf zulassen

(Optional) Aktivieren Sie diese Funktion, wenn Sie zulassen, dass der Benutzer eine beliebige Taste drücken kann, um den normalen Telefonbetrieb wiederherzustellen und gleichzeitig den Notruf aufrechtzuerhalten. Der Ton bleibt stumm, bis der Benutzer die Lautsprecherlautstärke mit der Lautstärketaste erhöht.

HTTP POST-Anforderung für die Schaltfläche "Aktion"

Die Aktionstaste auf dem Cisco Wireless-Telefon 9821 kann so konfiguriert werden, dass XML-Anwendungen über HTTP POST-Anforderungen ausgelöst werden.

Geben Sie im Feld Benutzerdefinierter Inhalt Ihr benutzerdefiniertes Anforderungsskript ein. Sie können entweder den Inhaltstyp XML oder JSON angeben und Makros in die Anforderung einschließen. Beispielsweise kann dem Skript $SShinzugefügt werden, um den geheimen Schlüssel, das Token oder das Kennwort für die Authentifizierung abzurufen, das im Feld "Dienstgeheimnis" angegeben ist.

Die folgenden Beispiele finden Sie in XML und JSON:

Sample #1: XML
--method POST
--header 'Content-Type: application/xml'
--header 'Authorization: Bearer username:$SS'
--body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>' 

Sample #2: JSON
--method POST
--header 'Content-Type: application/json'
--header 'Authorization: $SS'
--body '{"events":[{"evtid":"12345", "parameters": {"trigger":true}, "Description":"This is for HTTP POST JSON"}]}' 

Cisco Unified CM erfordert eine prozentuale Codierung für die reservierten Zeichen gemäß RFC 3986.

Tabelle 4. Prozentcodierung für reservierte Zeichen
ZeichenProzent-Codierung
&%26
'%27
"%22
< %3c
> %3e

Das folgende Skript ist ein Beispiel für die Verwendung von als Prozent codierten Zeichenfolgen.

--method POST
--header %27Content-Type: application/xml%27
--body %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3eThis is for HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27
Tabelle 5. Unterstützte Makros
MakronameMakroerweiterung
#DEVICENAME#Der im Anrufsystem angezeigte Gerätename. Beispiel: SEP845A3EC21288
$SSDienstgeheimnis, das eine maskierte Zeichenfolge auf der Telefonkonfigurationsseite darstellt, z. B. ein Authentifizierungsgeheimnis, ein Token oder ein Kennwort.
War dieser Artikel hilfreich für Sie?
War dieser Artikel hilfreich für Sie?