Aktionstaste anpassen

Die benutzerdefinierten Optionen für die Aktionstaste auf dem Cisco Tischtelefon der Serie 9800 erfordern eine spezielle PhoneOS-Firmware-Unterstützung. Details hierzu finden Sie in der folgenden Tabelle:

FunktionErforderliche Firmware-Version
NotrufPhoneOS 3.0.1 und höher
Maßgeschneiderter ServicePhoneOS 3.2.1 und höher
Mehrere AuslöserPhoneOS 3.3.1 und höher
HTTP-BeitragPhoneOS 3.3.1 und höher
Mehrere Ereignisse für einen einzelnen TriggerPhoneOS 3.4.1 und höher
1

Melden Sie sich bei Cisco Unified Communications Manager Administration an.

2

Führen Sie bei Bedarf einen der folgenden Schritte 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

3

Passen Sie die Einstellungen der Aktionsschaltfläche mit den folgenden Parametern 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.

  • Notrufe

    Konfigurieren Sie die folgenden Parameter:

    • Aktionstastenfunktion: Notruf auswählen.

    • Aktionstaste Serviceziel: Geben Sie die Telefonnummer oder den URI des Notfalldienstes ein.

    • Name des Aktionsschaltflächendienstes (optional): Geben Sie einen Namen für den Dienst an, der mit dem Aktionsauslöser verknüpft ist. Dieser Name wird in der Bildschirmmeldung angezeigt, wenn der Benutzer die Taste drückt, und gibt an, welches Ereignis ausgelöst wird. Wenn kein Name angegeben ist, wird Notruf als Anzeigename verwendet.

    • Herauswahlverzögerung: Legen Sie den Timeout-Zeitraum (in Sekunden) fest, in dem das Telefon einen Notruf einleitet, nachdem der Auslöser erkannt wurde. Die Standardeinstellung ist 5 Sekunden. Bei Wert auf 0 wird der Anruf sofort nach Erkennung des Auslösers getätigt.

    • Service-Trigger Wählen Sie einen Trigger aus der Liste aus: Einmal drücken, langes Drücken oder 3 Mal drücken.

    • Stiller Notruf (optional): Standardmäßig funktioniert der Notruf als bidirektionaler Anruf, ähnlich wie andere ausgehende Anrufe. 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 friert der Bildschirm auf dem Telefon 9841 ein und der Bildschirm auf den Telefonen 9851, 9861 und 9871 wird 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.

    • Automatisches Abrufen von Notrufen zulassen (optional): Aktivieren Sie diese Funktion, wenn Sie zulassen, dass Benutzer eine beliebige Taste drücken können, um den normalen Telefonbetrieb wiederherzustellen, während der Notruf aufrechterhalten wird. Der Ton bleibt stumm, bis der Benutzer die Lautsprecherlautstärke mit der Lautstärketaste erhöht.

  • Maßgeschneiderte Dienstleistungen

    Konfigurieren Sie die folgenden Parameter:

    • Funktion der Aktionstaste: Wählen Sie Benutzerdefiniert.

    • Aktionsschaltfläche Serviceziel: Geben Sie die URL des benutzerdefinierten Services ein. Die URL muss mit http:// oder https:// beginnen, beispielsweise https://10.11.20.159/path/service.xml .

    • Aktionsschaltfläche Dienstname (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 das Telefon beim Drücken der Aktionstaste eine HTTP-Post-Anforderung senden soll, 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, in dem das Telefon nach Erkennung des Auslösers ein Ereignis initiiert. Die Standardeinstellung ist 5 Sekunden. Wenn der Wert auf 0 gesetzt wird, wird das Ereignis sofort nach der Erkennung des Auslösers ausgelöst.

    • Service-Trigger Wählen Sie einen Trigger aus der Liste aus: Einmal drücken, langes Drücken oder 3 Mal drücken.

    • Dienstgeheimnis (optional): Geben Sie das Authentifizierungsgeheimnis, das Token oder das Kennwort ein, wenn Ihr benutzerdefinierter Dienst eine Authentifizierung für den Zugriff erfordert. 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.

  • 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 Auslöser für mehrere Ereignisse

    Konfigurieren Sie die folgenden Parameter, um einem Trigger mehrere Ereignisse zuzuweisen:

    • Funktion der Aktionstaste: Wählen Sie Benutzerdefiniert.

    • Aktionsschaltfläche Serviceziel: Geben Sie die anzurufende Telefonnummer und die XML Service-URL 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äche Dienstname (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 das Telefon beim Drücken der Aktionstaste eine HTTP-Post-Anforderung senden soll, 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, in dem das Telefon nach Erkennung des Auslösers ein Ereignis initiiert. Die Standardeinstellung ist 5 Sekunden. Wenn der Wert auf 0 gesetzt wird, wird das Ereignis sofort nach der Erkennung des Auslösers ausgelöst.

    • Service-Trigger Wählen Sie einen Trigger aus der Liste aus: Einmal drücken, langes Drücken oder 3 Mal drücken.

    • Dienstgeheimnis (optional): Geben Sie das Authentifizierungsgeheimnis, das Token oder das Kennwort ein, wenn Ihr benutzerdefinierter Dienst eine Authentifizierung für den Zugriff erfordert. 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): Wenn Sie eine Telefonnummer oder einen URI im Serviceziel eingegeben haben, werden Notrufe lautlos gemacht, wenn Sie diese Funktion aktivieren.

      Standardmäßig funktioniert der Notruf wie andere ausgehende Anrufe als bidirektionaler Anruf. Wenn diese Option aktiviert ist, ist die Audiowiedergabe auf der Anruferseite stummgeschaltet, um die Aufmerksamkeit während des eingehenden Anrufs zu vermeiden. Nur der Anrufempfänger kann den Anruf beenden.

      Während eines stillen Notrufs friert der Bildschirm auf dem Telefon 9841 ein und der Bildschirm auf den Telefonen 9851, 9861 und 9871 wird 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.

    • Automatisches Abrufen von Notrufen zulassen (optional): Aktivieren Sie diese Funktion, wenn Sie zulassen, dass Benutzer eine beliebige Taste drücken können, um den normalen Telefonbetrieb wiederherzustellen, während der Notruf aufrechterhalten wird. Der Ton bleibt stumm, bis der Benutzer die Lautsprecherlautstärke mit der Lautstärketaste erhöht.

Weitere Informationen zu diesen Parametern finden Sie unter Parameter für die Schaltfläche "Aktion".

4

Wählen Sie Speichern aus.

5

Wählen Sie Konfiguration übernehmen.

Referenzen

Parameter für die Schaltfläche "Aktion"

Die Parameter sind in der Firmentelefonkonfiguration, im allgemeinen Telefonprofil und in der individuellen Telefonkonfiguration verfügbar.

Tabelle 1. Parameter für die Schaltfläche "Aktion"
ParameterStandard und OptionenBeschreibung
Aktionstaste Funktion 1 ~ 3

Standardeinstellung: Aus

Optionen: Aus, Notruf, Benutzerdefiniert

Sie können die Taste für einen bestimmten Dienst konfigurieren.

  • Aus: Wenn diese Option deaktiviert ist, funktioniert die Aktionstaste für einen einzelnen Dienst auf dem Telefon nicht.
  • Notruf: Benutzer können mit der Aktionstaste einen Notruf absetzen, sofern konfiguriert.
  • Benutzerdefiniert: Benutzer können die Aktionsschaltfläche verwenden, um auf den benutzerdefinierten Dienst zuzugreifen, sofern konfiguriert.

Wenn Sie das Feld auf "Notruf" oder "Benutzerdefiniert" festlegen, stellen Sie sicher, dass Sie das Serviceziel in das Feld "Aktionsschaltfläche Serviceziel " eingeben. Oder es zeigt ein Konfigurationsfehler auf dem Telefon an.

Aktionsschaltfläche Dienstname 1~3

Standard: leer

Geben Sie optional einen Namen für den Dienst an, der der Aktionstaste 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 Sie keinen Namen angeben, lautet der Standardname Notruf, "Stiller Notruf" oder "Benutzerdefinierte Aktion", basierend auf Ihrer Auswahl im Feld "Aktionstastenfunktion ".

Aktionsschaltfläche Serviceziel 1~3

Standard: leer

Geben Sie das Serviceziel in einem der folgenden Formate an, basierend auf dem Service, der der Aktionstaste zugewiesen ist:

  • Für Notrufdienste geben Sie eine Telefonnummer oder die URI des Notrufdienstes ein.

  • Wenn Sie die Schaltfläche für einen benutzerdefinierten Dienst konfigurieren, geben Sie die Dienst-URL ein. Die URL muss mit http:// oder https:// beginnen. Beispiel: https://10.11.20.159/path/service.xml.

  • Um die Taste so zu konfigurieren, dass mehrere Ereignisse mit einem einzigen Auslöser ausgelöst werden, geben Sie Tel:<Telefonnummer oder SIP-URL> + <Service RUL > ein. Beispiel: tel:1234 + https://10.11.20.159/path/service.xml.

    Das Anrufen von SIP-URIs wird ebenfalls unterstützt. Geben Sie die URI im Format Tel: sip 4567@co.webex.com ein.

Wenn Sie die Aktionstaste aktivieren, ohne ein gültiges Dienstziel festzulegen, wird dem Benutzer auf dem Telefon eine Meldung angezeigt, in der er zur Konfiguration aufgefordert wird. Nachdem der Benutzer diese Benachrichtigung geschlossen hat, bleibt das Warnsymbol in der Kopfzeile des Telefondisplays erhalten, bis die Taste ordnungsgemäß konfiguriert oder deaktiviert wird.

Telefonnummern können nicht als Ziele für benutzerdefinierte Services verwendet werden. Wenn Sie die Aktionstaste als benutzerdefiniert konfigurieren und eine Telefonnummer als Dienstziel eingeben, wird auf dem Telefon eine Warnmeldung angezeigt, die darauf hinweist, dass die Taste nicht konfiguriert ist. Sie können stattdessen eine Telefonnummer im Format tel:<Telefonnummer> hinzufügen, beispielsweise tel:1234.

Wenn Sie keine URL mit kaufmännischem Und-Zeichen (&) eingeben dürfen, verwenden Sie %26 als Ersatz. Geben Sie z. B. http://1.2.3.4/phone?a=1%26b=2%26c=3 anstelle von http://1.2.3.4/phone?a=1&b=2&c=3 ein.

Benutzerdefiniertes Inhaltsfeld 1~3

Standard: leer

Diese Einstellung funktioniert nur, wenn die Funktion " Aktionstaste" auf "Benutzerdefiniert "festgelegt ist.

Geben Sie die HTTP-Daten wie Methode, Header und Post-Inhalt mit einer maximalen Länge von 1024 Zeichen ein. Wenn konfiguriert, sendet das Telefon eine HTTP Post-Anforderung, wenn die Aktion gedrückt wird.

Wenn für den Zugriff auf den Dienst eine Authentifizierung erforderlich ist, stellen Sie sicher, dass Sie den Authentifizierungsschlüssel in das Feld "Dienstgeheimnis" eingeben. Verwenden Sie in den HTTP-Daten das Makro $SS als Verweis auf den geheimen Dienstschlüssel.

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

Dienstgeheimnis 1~3

Standard: leer

Ein geheimer Dienstschlüssel kann ein Authentifizierungsgeheimnis, ein Token oder ein Kennwort sein. 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.

Service-Trigger 1~3

Standard: Einmaliges Drücken

Optionen: Einmaliges Drücken, langes Drücken, 3-mal drücken

Wählen Sie aus, wie Benutzer über die Aktionstaste des Telefons einen Notruf absetzen oder einen benutzerdefinierten Dienst initiieren können.

Einmaliges Drücken: Drücken Sie die Aktionstaste, um den zugehörigen Anruf oder Dienst auszulösen.

Langes Drücken: Drücken Sie die Aktionstaste mindestens 2 Sekunden lang, um den zugehörigen Anruf oder Dienst auszulösen.

3 Mal drücken: Drücken Sie die Aktionstaste dreimal in Abständen von jeweils weniger als 2 Sekunden, um den zugehörigen Anruf oder Dienst auszulösen.

Wiederholen Sie einen Trigger nicht über mehrere Dienste hinweg, da die Parameter mit niedrigerer Priorität nicht funktionieren. Die Priorität gilt von der höchsten zur niedrigsten Priorität: Gruppe 1, Gruppe 2, Gruppe 3.

Herauswahlverzögerung 1~3

Standard: 5

Optionen: 0 - 30

Legen Sie den Timeout-Zeitraum in Sekunden fest, über den das Telefon nach dem Drücken der Aktionstaste einen Notruf oder eine benutzerdefinierte Aktion einleiten soll.

Legen Sie den Wert auf 0 fest, wenn Sie möchten, dass das Telefon den Anruf einleitet oder ein Ereignis sofort nach Erkennen des Auslösers auslöst. Wird durch einmaliges, langes oder dreimaliges Drücken der Taste festgelegt.

Stiller Notruf 1~3

Standard: Deaktiviert

Optionen: Aktiviert, Deaktiviert

Der stille Notruf dient der diskreten Hilfe in Gefahrensituationen. Es ermöglicht Benutzern, Hilfe zu suchen, ohne Lärm zu machen.

  • Wenn aktiviert, können Benutzer mit der Aktionstaste unidirektionale Anrufe tätigen.

    Nachdem der stille Notruf abgesetzt wurde, kann nur der andere Teilnehmer den Anruf beenden. Um die Aufmerksamkeit während des laufenden Anrufs nicht auf sich zu ziehen, friert der Bildschirm auf den Telefonen 9841 ein und der Bildschirm der Telefone 9851, 9861 und 9871 wird ausgeschaltet. Das Telefon sperrt standardmäßig alle Funktionen während eines stillen Notrufs. Damit Benutzer den normalen Telefonbetrieb wiederherstellen können, während der stille Notruf aufrechterhalten wird, aktivieren Sie die Funktion "Abrufen stiller Notrufe zulassen".

  • Wenn er deaktiviert ist, funktioniert der Notruf wie andere ausgehende Anrufe als bidirektionaler Anruf.

Stillen Notrufabruf zulassen

Standard: Nein

Optionen: Ja, Nein

Legt fest, ob Benutzer während eines stillen Notrufs die Telefonfunktionalität abrufen können. Sobald ein stiller Notruf eingeleitet wurde, sperrt das Telefon standardmäßig alle Funktionen, bis der Anrufempfänger den Anruf beendet.

Wenn dieser Parameter auf "Ja" festgelegt ist, können Benutzer eine beliebige Taste drücken, um den normalen Telefonbetrieb wiederherzustellen und gleichzeitig den Notruf aufrechtzuerhalten. Der Ton des Anrufs bleibt stumm, es sei denn, der Benutzer erhöht die Lautstärke durch Drücken der Lautstärketaste.

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

Die Aktionstaste der Cisco Tischtelefone der Serie 9800 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 XML oder den JSON-Inhaltstyp 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:

Beispiel #1: XML --method POST --header 'Content-Type: application/xml' --header 'Autorisierung: Bearer username:$SS' --body '<MetaData><Trigger>True</Trigger><Description>Dies ist für HTTP POST XML</Description></MetaData>' Beispiel #2: JSON --method POST --header 'Content-Type: application/json' --header 'Autorisierung: $SS' --body '{"events":[{"evtid":"12345", "parameters": {"trigger": {"trigger": true}, "Description":"Dies ist für HTTP POST JSON"}]}'

Cisco Unified Communications Manager (UCM) erfordert für die reservierten Zeichen gemäß RFC 3986 eine Prozentcodierung.

Tabelle 2. 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%3eDies ist für HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27
Tabelle 3. 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.