Määritä toimintopainike 9800: lle (Unified CM)

Toimintopainikkeen mukauttaminen

Cisco Desk Phone 9800 -sarjan toimintopainikkeen mukautetut vaihtoehdot edellyttävät erityistä PhoneOS-laiteohjelmistotukea. Katso lisätietoja seuraavasta taulukosta:

Ominaisuus	Vaadittu laiteohjelmistoversio
Hätäpuhelu	PhoneOS 3.0.1 ja uudemmat
Mukautettu palvelu	PhoneOS 3.2.1 ja uudemmat
Useita laukaisimia	PhoneOS 3.3.1 ja uudemmat
HTTP-viesti	PhoneOS 3.3.1 ja uudemmat
Useita tapahtumia yhdellä liipaisimella	PhoneOS 3.4.1 ja uudemmat

1	Kirjaudu sisäänCisco Unified Communications Manager Administration.
2	Tee jokin seuraavista toimista tarpeen mukaan: Voit määrittää kaikki käytössä olevat puhelimet valitsemalla Järjestelmä > Yrit yspuhelimen määritykset. Voit määrittää puhelimet, jotka jakavat saman puhelinprofiilin, valitsemalla La ite > Laitteen asetukset > Yhteinen puhelinprofiili. Voit määrittää yksittäisen puhelimen valitsemalla La ite > Puhelin. Etsi sitten puhelimesi ja avaa Puhelimen asetukset -sivu. Kokoonpano noudattaa hierarkkista rakennetta: Yksittäiset laiteasetukset ovat etusijalla yhteisen puhelin profiilin ja yritystason asetuksiin nähden Yleiset puhelinprofiiliasetukset ohittavat yritystason asetukset
3	Mukauta toimintopainikkeen asetuksia seuraavilla parametreilla käyttö tapauksesi perusteella. Toimintopainikkeella on kolme parametriryhmää, joista kukin vastaa palvelua, jolla on ainutlaatuinen liipaisin. Jos palvelun laukaisu on määritetty useissa ryhmissä, ryhmän 1 asetukset ovat etusijalla ryhmän 2 ja 3 asetuksiin näh den, kun taas ryhmä 2 on etusijalla ryhmään 3 nähden. Hätäpuhelut Määritä seuraavat parametrit: Toimintapainikkeen toiminto: Valitse Hätä puhelu. Toimintapainikkeen palvelun kohde: Anna hätäpalvelun puhelinnumero tai URI. Toimintapainikkeen palvelun nimi (valinnainen): Määritä toiminn on laukaisimeen liittyvän palvelun nimi. Tämä nimi näkyy näytön viestissä, kun käyttäjä painaa painiketta, mikä osoittaa, mikä tapahtuma aloitetaan. Jos nimeä ei ole määritetty, näyttönimenä käytetään hätäpuhel ua. Soittoviive: Aseta aikakatkaisuaika (sekunteina), jolloin puhelin aloittaa hätäpuhelun laukaisimen havaitsemisen jälkeen. Oletusarvo on 5 sekuntia. Jos asetukseksi on 0, puhelu soitetaan välittömästi liipaisimen havaitsem isen jälkeen. Huoltokäyn nistin Valitse lii paisin luettelosta: Yksi painallus, Pit kä pain allus tai Paina kolme kertaa. Hiljainen hätäpuhel u (valinnainen): Hätä puhelu toimii oletusarvoisesti kaksisuuntaisena puheluna, kuten muut lähtevät puhelut. Kun hiljainen hätäpuhelu on käytössä, ääni on hiljainen soittajan puolella, jotta huomion kiinnittäminen ei kiinnitetä puhelun aikana. Vain puhelun vastaanottaja voi lopettaa äänettömän hätäpuhelun. Hiljaisen hätäpuhelun aikana puhelimen 9811 ja 9841 näyttö jäätyy, kun taas puhelimen 9851, 9861 ja 9871 näyttö sammutetaan. Kaikki muut toiminnot eivät ole käytettävissä. Puhelin palauttaa normaalin toiminnan, kun vastaanottaja lopettaa puhelun. Salli hiljainen hätäpuhelun hak u (valinnainen): Ota tämä ominaisuus käyttöön, jos sallit käyttäjien painaa mitä tahansa näppäintä palauttaakseen puhelimen normaalin toiminnan säilyttäen hätäpuhelun. Puhelun ääni pysyy hiljaisena, ellei käyttäjä lisää kaiuttimen ään envoimakkuutta äänenvoimakkuusnäppäimellä. Räätälöidyt palvelut Määritä seuraavat parametrit: Toimintopainikkeen toiminto: Valitse Mu kautettu. Toimintapainikkeen palvelun kohde: Anna mukautetun palvelun URL-osoite. URL-osoitteen on alettava `http://`kirj `https://`aimella tai, esimerkiksi, `https://10.11.20.159/path/service.xml`. Toimintapainikkeen palvelun nimi (valinnainen): Määritä laukaisimeen liittyvän palvelun nimi. Tämä nimi näkyy näytön viestissä, kun käyttäjä painaa painiketta, mikä osoittaa, mikä palvelu käynnistetään. Jos nimeä ei ole määritetty, näytönimenä käytetään mukaut ettua palvelua. Mukautettu sisältökent tä (valinnainen): Jos haluat, että puhelin voi lähettää HTTP-postipyynnön, kun Toiminto-painiketta painetaan, kirjoita HTTP-tiedot, kuten menetelmä, otsikko ja julkaisusisältö, enintään 1024 merkkiä. POST-komentosarjojen esimerkit ja syntaksi ovat kohdassa Toiminto-painikkeen HTTP-postipyyntö. Valintaviive: Aseta aikakatkais ujakso sekunteina, jolloin puhelin aloittaa tapahtuman laukaisimen havaitsemisen jälkeen. Oletusarvo on 5 sekuntia. Kun arvo on 0, tapahtuma käynnistetään välittömästi laukaisimen havaitsemisen jälkeen. Huoltokäyn nistin Valitse lii paisin luettelosta: Yksi painallus, Pit kä pain allus tai Paina kolme kertaa. Palvelusalaisuus (valinnainen): Anna todennussalaisuus, tunnus tai salasana, jos mukautettu palvelu vaatii todennuksen käyttääksesi sitä. Syötetty salaisuus näkyy peitettynä merkkijonona, ja siihen voidaan viitata käyttämällä Mukautettu sisältö kenttä- ja toiminto painikkeen palveluk oh de -mak `$SS`ron avulla. Useita laukaisimia Aseta parametrit kussakin ryhmässä vastaavasti. Katso yllä olevat Hätäpuhelut ja Mukautetut palvelut -osiot. Yksi liipaisin useille tapahtumille Määritä seuraavat parametrit määrittääksesi useita tapahtumia liipaisimelle: Toimintopainikkeen toiminto: Valitse Mu kautettu. Toimintapainikkeen palvelun kohde: Anna soit ettava puhelinnumero ja XML-palvelun URL-osoite tässä muodossa: `tel:<phonenumber or SIP URI> + <serviceURL>` URL-osoitteen on alettava `http://`tai `https://`. Esimerkki: `tel:1234 + https://10.11.20.159/path/service.xml` Toimintapainikkeen palvelun nimi (valinnainen): Määritä laukaisimeen liittyvän palvelun nimi. Tämä nimi näkyy näytön viestissä, kun käyttäjä painaa painiketta, mikä osoittaa, mikä palvelu käynnistetään. Jos nimeä ei ole määritetty, näytönimenä käytetään mukaut ettua palvelua. Mukautettu sisältökent tä (valinnainen): Jos haluat, että puhelin voi lähettää HTTP-postipyynnön, kun Toiminto-painiketta painetaan, kirjoita HTTP-tiedot, kuten menetelmä, otsikko ja julkaisusisältö, enintään 1024 merkkiä. POST-komentosarjojen esimerkit ja syntaksi ovat kohdassa Toiminto-painikkeen HTTP-postipyyntö. Valintaviive: Aseta aikakatkais ujakso sekunteina, jolloin puhelin aloittaa tapahtuman laukaisimen havaitsemisen jälkeen. Oletusarvo on 5 sekuntia. Kun arvo on 0, tapahtuma käynnistetään välittömästi laukaisimen havaitsemisen jälkeen. Huoltokäyn nistin Valitse lii paisin luettelosta: Yksi painallus, Pit kä pain allus tai Paina kolme kertaa. Palvelusalaisuus (valinnainen): Anna todennussalaisuus, tunnus tai salasana, jos mukautettu palvelu vaatii todennuksen käyttääksesi sitä. Syötetty salaisuus näkyy peitettynä merkkijonona, ja siihen voidaan viitata käyttämällä Mukautettu sisältö kenttä- ja toiminto painikkeen palveluk oh de -mak `$SS`ron avulla. Hiljainen hätäpuhel u (valinnainen): Jos olet lisännyt puhelinnumeron tai valinta-URI-osoitteen palvelukohteeseen, tämän ominaisuuden käyttöönotto hiljentää hätäpuhelut. Hätäpuhelu toimii oletusarvoisesti kaksisuuntaisena puheluna, kuten muut lähtevät puhelut. Kun asetus on käytössä, ääni on hiljainen soittajan puolella, jotta huomion kiinnittäminen ei kiinnitetä puhelun aikana. Vain puhelun vastaanottaja voi lopettaa puhelun. Hiljaisen hätäpuhelun aikana puhelimen 9811 ja 9841 näyttö jäätyy, kun taas puhelimen 9851, 9861 ja 9871 näyttö sammutetaan. Kaikki muut toiminnot eivät ole käytettävissä. Puhelin palauttaa normaalin toiminnan, kun vastaanottaja lopettaa puhelun. Salli hiljainen hätäpuhelun hak u (valinnainen): Ota tämä ominaisuus käyttöön, jos sallit käyttäjien painaa mitä tahansa näppäintä palauttaakseen puhelimen normaalin toiminnan säilyttäen hätäpuhelun. Puhelun ääni pysyy hiljaisena, ellei käyttäjä lisää kaiuttimen ään envoimakkuutta äänenvoimakkuusnäppäimellä. Lisätietoja näistä parametreista on kohdassa Toiminto- painikkeen parametrit.
4	Valitse Tallenna.
5	Valitse Käytä konfigurointia.

Referenssit

Toimintopainikkeen parametrit

Parametrit ovat käytettävissä yrityspuhelimen kokoonpanoissa, Yhteisessä puhelinprofiilissa ja yksittäisissä puhelinmäärityksissä.

Taulukko 1. Toimintopainikkeen parametrit
Parametri	Oletus ja asetukset	Kuvaus
Toimintapainikkeen toiminto 1 ~ 3	Oletus: Pois Vaihtoehdot: Pois, Hätäpuhelu, Mukautettu	Voit määrittää painikkeen tietyllä palvelulla. Pois käytöstä: Kun asetus on Pois käytöstä, puhelimen yksittäisen palvelun toimintopainike ei toimi. Hätäpuhel u: Käyttäjät voivat soittaa hätäpuhelun To iminto-painikkeella, jos se on määritetty. Mukaut ettu: Käyttäjät voivat käyttää Toiminto-painiketta mukautetun palvelun käyttämiseen, jos se on määritetty. Kun asetat kentän Hätä puheluksi tai Mu kautet uksi, varmista, että syötät palvelun määrän pään toiminto painikkeen Palvelun kohde - kenttään. Tai puhelin näyttää kokoonpanovirheen.
Toimintapainikkeen palvelun nimi 1 ~ 3	Oletus: Tyhjä	Voit halutessasi määrittää toimintopainikkeeseen liittyvän palvelun nimen. Tämä nimi näkyy näytön viestissä, kun käyttäjä painaa painiketta, mikä osoittaa, mikä palvelu käynnistetään. Jos et määritä nimeä, oletusnimi on Hätäpuhelu, Hiljainen hätäpuhelu tai Mukautettu toiminto, joka perustuu toiminto painikkeen toiminto - kenttään.
Toimintapainikkeen palvelukohde 1 ~ 3	Oletus: Tyhjä	Määritä palvelukohde jossakin seuraavista muodoista Action-pain ikkeelle määritetyn palvelun perusteella: Anna hätäpuhelupalveluille puhelinnumero tai hätäpalvelun URI. Kun määrität mukautetun palvelun painikkeen, kirjoita palvelun URL-osoite. URL-osoitteen on alettava `http://`tai `https://`. Esimerkiksi, `https://10.11.20.159/path/service.xml`. Jos haluat määrittää painikkeen käynnistämään useita tapahtumia yhdellä liipaisimella, kir joita `tel:<phonenumber or SIP URL> + <Service RUL>`. Esimerk ki: `tel:1234 + https://10.11.20.159/path/service.xml`. Myös SIP URI: n soittaminen on tuettu. Anna URI muodossa `tel: sip 4567@co.webex.com` Jos otat Toiminto-painikkeen käyttöön asettamatta kelvollista palveluk ohdetta, puhelimen käyttäjä näkee viestin, jossa kehotetaan määrittämään. Kun käyttäjä sulkee tämän ilmoituksen, varoituskuvake pysyy puhelimen näytön otsi kossa, kunnes painike on määritetty oikein tai poistettu käytöstä. Puhelinnumeroita ei voi käyttää räätälöityjen palvelujen kohteina. Jos määrität toimintopainikkeen Mu kaut etuksi ja annat puhelin numeron palvelun kohteeksi, puhelimeen tulee hälytysviesti, joka osoittaa, että painike ei ole määritetty. Sen sijaan voit lisätä puhelin numeron tässä muodossa `tel:<phone number>`, esimerkiksi `tel:1234`. Jos et saa syöttää URL-osoitetta, joka sisältää ampersandin (&), käytä %26 korvikkeena. Kirjoita esimerkiksi http://1.2.3.4/phone?a=1%26b=2%26c=3 sijasta http://1.2.3.4/phone?a=1&b=2&c=3.
Mukautettu sisältökenttä 1 ~ 3	Oletus: Tyhjä	Tämä asetus toimii vain, kun toiminto painikkeen toim into on asetettu Mukautet uksi. Anna HTTP-tiedot, kuten menetelmä, otsikko ja postin sisältö, enintään 1024 merk kiä pituisiksi. Kun asetus on määritetty, puhelin lähettää HTTP-postipyynnön, kun toimintoa painetaan. Jos palvelu vaatii todennuksen käyttämiseen, varmista, että syötät todennussalaisuuden Palvelusalais uus - kenttään. Käytä HTTP-tiedoissa makroa `$SS`viittauksena Palvelusalaisuuteen. Esimerkkejä ja syntaksia on kohdassa To iminto-painikkeen HTTP-postipyyn tö.
Palvelusalaisuus 1 ~ 3	Oletus: Tyhjä	Palvelusalaisuus voi olla todennussalaisuus, tunnus tai salasana. Syötetty salaisuus näkyy peitettynä merkkijonona, ja siihen voidaan viitata käyttämällä Mukautettu sisältö kenttä- ja toiminto painikkeen palveluk oh de -mak `$SS`ron avulla.
Palvelun liipaisin 1 ~ 3	Oletus: Yksi painallus Vaihtoehdot: Yksi painallus, pitkä painallus, paina 3 kertaa	Valitse, miten käyttäjät voivat soittaa hätäpuhelun tai aloittaa mukautetun palvelun puhelimen Toiminto-painikkeella. Yksi painal lus: Käynnistä siihen liittyvä puhelu tai palvelu pain amalla Toiminto-painiketta. Pitkä pain allus: Käynnistä siihen liittyvä puhelu tai palvelu painamalla toimintopainiketta vähintään 2 sekunnin ajan. Paina 3 kertaa: Käynnistä siihen liittyvä puhelu tai palvelu painamalla toimintopainiketta kolme kertaa alle 2 sekunnin välein jokaisen pain alluksen välillä. Älä toista laukaisinta useissa palveluissa, koska parametrit, joilla on alhaisempi prioriteetti, eivät toimi. Prioriteettijärjestys korkeimmasta alimpaan on seuraava: ryhmä 1, ryhmä 2, ryhmä 3.
Valintaviive 1 ~ 3	Oletus: 5 Vaihtoehdot: 0 - 30	Aseta aikakatkaisujakso sekunteina, jolloin puhelin aloittaa hätäpuhelun tai mukautetun toiminnon Toiminto-painikkeen painamisen jälkeen. Aseta se arvoon 0, jos haluat puhelimen soittaa puhelun tai aloittaa tapahtuman heti liipaisimen havaitsemisen jälkeen, kuten yhdellä painalluksella, pitk ällä painalluksella tai kolminkertaisella painalluksella määritetään.
Hiljainen hätäpuhelu 1 ~ 3	Oletus: Ei käytössä Asetukset: Käytössä, Ei käytössä	Hiljainen hätäpuhelu on suunniteltu huomaamattomaan apuun vaarallis issa tilanteissa. Sen avulla käyttäjät voivat hakea apua aiheuttamatta melua. Kun se on käytössä, käyttäjät voivat soittaa yksisuuntaisia puheluita Toiminto-painikkeella. Kun hiljainen hätäpuhelu on soitettu, vain toinen osapuoli voi lopettaa puhelun. Jotta vältetään huomion kiinnittäminen meneillään olevan puhelun aikana, puhelimen 9811 ja 9841 näyttö jäätyy, kun taas puhelimen 9851, 9861 ja 9871 näyttö sammutetaan. Puhelin lukitsee oletusarvoisesti kaikki toiminnot hiljaisen hätäpuhelun aikana. Jos haluat, että käyttäjät voivat palauttaa normaalin puhelimen toiminnan säilyttäen äänettömän hätä puhelun, ota käyttöön S alli hiljainen hätäpuhelun hak u - ominaisuus. Kun hätäpuhelu on poistettu käytöstä, se toimii kaksisuuntaisena puheluna, kuten muut lähtevät puhelut.
Salli hiljainen hätäpuhelun haku	Oletus: Ei Vaihtoehdot: Kyllä, Ei	Määrittää, voivatko käyttäjät hakea puhelimen toimintoja hiljaisen hätäpuhelun aikana. Oletusarvoisesti, kun hiljainen hätäpuhelu on aloitettu, puhelin lukitsee kaikki toiminnot, kunnes puhelun vastaanottaja lopettaa puhelun. Kun tämän parametrin arvoksi on aset ettu Kyllä, käyttäjät voivat painaa mitä tahansa näppäintä palauttaakseen puhelimen normaalin toiminnan säilyttäen samalla hätäpuhelun. Puhelun ääni pysyy hiljaisena, ellei käyttäjä lisää äänenvoimakkuutta äänenvoimakkuusnäppä imellä.

HTTP Post -pyyntö Toimintopainikkeelle

Cisco Desk Phone 9800 -sarjan toimintopainike voidaan määrittää käynnistämään XML-sovellukset HTTP Post -pyyntöjen kautta.

Kirjoita mukautettu pyyntökomentosarja Mukautettu sisältökent tä -kohtaan. Voit määrittää joko XML- tai JSON-sisältötyypin ja sisällyttää makrot pyyntöön. $SSVoit esimerkiksi lisätä komentosarjaan Service Secret -kentässä annetun todennussalais uuden, tunnuksen tai salasanan hakem iseksi.

Seuraavat esimerkit ovat XML- ja JSON-muodossa:

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 Communications Manager(UCM) edellyttää prosenttikoodausta varatuille merkeille RFC 3986 -standardin mukaisesti.

Taulukko 2. Varattujen merkkien prosenttikoodaus
Hahmo	Prosenttikoodaus
&	`%26`
'	`%27`
"	`%22`
<	`%3c`
>	`%3e`

Seuraava komentosarja on esimerkki prosenttikoodattujen merkkijonojen käytöstä.

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

Taulukko 3. Tuetut makrot
Makron nimi	Makrolaajennus
#DEVICENAME#	Soittajajärjestelmässä näkyvä laitteen nimi. Esimerkiksi SEP845A3EC21288
$SS	Palvelusalaisuus, joka esittää puhelimen määrityssivulla peitetyn merkkijonon, kuten todennussalaisuuden, tunnuksen tai salasanan.

Cisco AI Assistant

Kiitos palautteestasi.

Toimintopainikkeen mukauttaminen

Referenssit

Toimintopainikkeen parametrit

HTTP Post -pyyntö Toimintopainikkeelle

Pienyritys

Enterprise

Laitteet

Ratkaisut:

Resurssit

Yritys