Määritä toiminnon painike 9800 (Unified CM)

Mukauta Toiminto-painiketta

Cisco Desk Phone 9800 -sarjan Toiminto-painikkeen mukautetut asetukset edellyttävät erityistä PhoneOS-laitteisto-ohjelmiston tukea. Lisätietoja on seuraavassa taulukossa:

Ominaisuus	Pakollinen lait.ohj. versio
Hätäpuhelu	PhoneOS 3.0.1 ja uudempi
Mukautettu palvelu	PhoneOS 3.2.1 ja uudempi
Useita käynnistimiä	PhoneOS 3.3.1 ja uudempi
HTTP POST	PhoneOS 3.3.1 ja uudempi
Useita tapahtumia yhdellä käynnistimellä	PhoneOS 3.4.1 ja uudempi

1	Kirjaudu nroon Cisco Unified Communications Manager Administration.
2	Tee jokin seuraavista toimista tarpeen mukaan: Määritä kaikki käyttöönotetut puhelimet valitsemalla Järjestelmä > Enterprise-puhelimen määritykset. Määritä samaa puhelinprofiilia jakavat puhelimet valitsemalla Laite > Device-asetukset > Puhelinprofiili. Määritä yksittäinen puhelin valitsemalla Laite > Puhelin. Etsi sitten puhelin ja avaa Puhelinmääritykset-sivu. Määritys noudattaa hierarkkista rakennetta: Yksittäiset laiteasetukset menevät yleisen puhelinprofiilin ja yritystason asetusten edelle Yleiset puhelinprofiiliasetukset ohittavat yritystason asetukset
3	Mukauta Toiminto-painikkeiden asetuksia seuraavilla parametreilla käyttötapausten mukaan. Toiminto-painikkeelle on kolme parametriryhmää, joista kussakin on yksilöivä käynnistinpalvelu. Jos palvelun käynnistin on määritetty useaan ryhmään, ryhmän 1 asetukset ovat etusijalla ryhmiin 2 ja 3 kuuluviin asetuksiin nähden ja ryhmä 2 etusijalla ryhmään 3 nähden. Hätäpuheluita Määritä seuraavat parametrit: Toimintopainiketoiminto: Valitse hätäpuhelu. Toimintopainikepalvelun kohde: Anna hätäpalvelun puhelinnumero tai URI. Toimintopainikepalvelun nimi (valinnainen): Määritä toiminnon käynnistimeen liittyvän palvelun nimi. Nimi näkyy näytössä, kun käyttäjä painaa painiketta, mikä osoittaa, mikä tapahtuma aloitetaan. Jos nimeä ei ole määritetty, näyttönimeksi käytetään hätäpuhelua . Valitse ulos -viive: Määritä puhelimen aikakatkaisuaika (sekunteina), jotta puhelin aloittaa hätäpuhelun, kun käynnistin on havaittu. Oletusarvo on 5 sekuntia. Jos asetukseksi on valittu 0, puhelu soitetaan heti käynnistimen tunnistamisen yhteydessä. Palvelun käynnistin valitsee käynnistimen luettelosta: Yksi painallus, Pitkä painallus tai Paina 3 Kertaa. Hiljainen hätäpuhelu (valinnainen): Oletusarvon mukaan hätäpuhelu toimii kaksisuuntaisena puheluna, joka on samanlainen kuin muut lähtevät puhelut. Kun hiljainen hätäpuhelu on käytössä, soittajan sivulla oleva ääni on äänetön, jotta ei kiinnitetä huomiota puheluun. Vain puhelun vastaanottaja voi lopettaa hiljaisen 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ö poistetaan käytöstä. Kaikki muut toiminnot eivät ole käytettävissä. Puhelin palauttaa normaalin toiminnon, kun vastaanottaja lopettaa puhelun. Salli hiljaisen hätäpuhelun nouto (valinnainen): Ota tämä toiminto käyttöön, jos annat käyttäjien painaa mitä tahansa näppäintä palauttaakseen normaalin puhelun ja ylläpitääkseen hätäpuhelua. Puhelun ääni pysyy hiljaisena, ellei käyttäjä lisää kaiuttimen äänenvoimakkuutta äänenvoimakkuusnäppäimellä. Mukautetut palvelut Määritä seuraavat parametrit: Toimintopainiketoiminto: Valitse mukautettu. Toimintopainikepalvelun kohde: Anna mukautetun palvelun URL-osoite. URL-osoitteen on alettava `http://` or `https://` esimerkiksi `https://10.11.20.159/path/service.xml`. Toimintopainikepalvelun nimi (valinnainen): Määritä käynnistimelle määritetyn palvelun nimi. Nimi näkyy näytössä näkyvässä viestissä, kun käyttäjä painaa painiketta, mikä osoittaa, mikä palvelu käynnistetään. Kun nimeä ei ole määritetty, näyttönimeksi käytetään mukautettua palvelua . Mukautettu sisältökenttä (valinnainen): Jos haluat, että puhelin lähettää HTTP POST -pyynnön, kun Toiminto-painiketta painetaan, anna HTTP-tiedot, kuten menetelmä, otsikko ja POST-sisältö, joiden enimmäispituus on 1024 merkkiä. Esimerkkejä POST-komentosarjasta ja syntaksista on Toiminto-painikkeen HTTP POST -pyynnössä. Valitse ulos -viive: Määritä puhelimen aikakatkaisuaika sekunteina, jotta puhelin aloittaa tapahtuman käynnistimen tunnistamisen jälkeen. Oletusarvo on 5 sekuntia. Kun arvoksi on valittu 0, tapahtuma käynnistetään välittömästi käynnistimen tunnistamisen yhteydessä. Palvelun käynnistin valitsee käynnistimen luettelosta: Yksi painallus, Pitkä painallus tai Paina 3 Kertaa. Palvelusalaisuus (valinnainen): Anna todennussalaisuus, osoitus tai salasana, jos mukautettu palvelu edellyttää todennusta sen käyttämiseksi. Annettu salaisuus näkyy peitemerkkijonona, ja siihen voi viitata makrolla `$SS mukautetun sisällön kentässä` ja toiminnon painikkeen palvelukohteessa . Useita käynnistimiä Määritä kunkin ryhmän parametrit. Lisätietoja on hätäpuheluiden ja mukautettujen palvelujen osioissa. Yksi käynnistin usealle tapahtumalle Määritä seuraavat parametrit määrittämään useita tapahtumia käynnistimelle: Toimintopainiketoiminto: Valitse mukautettu. Toimintopainikepalvelun kohde: Anna puhelinnumero, johon soitetaan, ja XML-palvelun URL tässä muodossa: `tel:<phonenumber tai SIP URI> + <serviceURL>` URL-osoitteen on alettava `http://` or `https://`. Esimerkki: `puh:1234 + https://10.11.20.159/path/service.xml` Toimintopainikepalvelun nimi (valinnainen): Määritä käynnistimelle määritetyn palvelun nimi. Nimi näkyy näytössä näkyvässä viestissä, kun käyttäjä painaa painiketta, mikä osoittaa, mikä palvelu käynnistetään. Kun nimeä ei ole määritetty, näyttönimeksi käytetään mukautettua palvelua . Mukautettu sisältökenttä (valinnainen): Jos haluat, että puhelin lähettää HTTP POST -pyynnön, kun Toiminto-painiketta painetaan, anna HTTP-tiedot, kuten menetelmä, otsikko ja POST-sisältö, joiden enimmäispituus on 1024 merkkiä. Esimerkkejä POST-komentosarjasta ja syntaksista on Toiminto-painikkeen HTTP POST -pyynnössä. Valitse ulos -viive: Määritä puhelimen aikakatkaisuaika sekunteina, jotta puhelin aloittaa tapahtuman käynnistimen tunnistamisen jälkeen. Oletusarvo on 5 sekuntia. Kun arvoksi on valittu 0, tapahtuma käynnistetään välittömästi käynnistimen tunnistamisen yhteydessä. Palvelun käynnistin valitsee käynnistimen luettelosta: Yksi painallus, Pitkä painallus tai Paina 3 Kertaa. Palvelusalaisuus (valinnainen): Anna todennussalaisuus, osoitus tai salasana, jos mukautettu palvelu edellyttää todennusta sen käyttämiseksi. Annettu salaisuus näkyy peitemerkkijonona, ja siihen voi viitata makrolla `$SS mukautetun sisällön kentässä` ja toiminnon painikkeen palvelukohteessa . Hiljainen hätäpuhelu (valinnainen): Jos olet sisällyttänyt puhelinnumeron tai soittanut URI-numeroon palvelukohteessa, toiminnon käyttöönotto voi aiheuttaa hiljaisia hätäpuheluja. Hätäpuhelu toimii oletusarvoisesti kaksisuuntaisena puheluna, joka on samanlainen kuin muut lähtevät puhelut. Kun asetus on otettu käyttöön, ääni on soittajan puolella hiljaisena, jotta ei kiinnitetä huomiota puheluun. 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ö poistetaan käytöstä. Kaikki muut toiminnot eivät ole käytettävissä. Puhelin palauttaa normaalin toiminnon, kun vastaanottaja lopettaa puhelun. Salli hiljaisen hätäpuhelun nouto (valinnainen): Ota tämä toiminto käyttöön, jos annat käyttäjien painaa mitä tahansa näppäintä palauttaakseen normaalin puhelun ja ylläpitääkseen hätäpuhelua. Puhelun ääni pysyy hiljaisena, ellei käyttäjä lisää kaiuttimen äänenvoimakkuutta äänenvoimakkuusnäppäimellä. Lisätietoja näistä parametreista on Toiminto-painikkeen parametreissa.
4	Valitse Tallenna.
5	Valitse Käytä määrityksiä.

Viittaukset

Toiminto-painikkeen parametrit

Parametrit ovat saatavilla yrityspuhelinmäärityksissä, yleisessä puhelinprofiilissa ja yksittäisissä puhelinmäärityksissä.

Taulukko 1. Toiminto-painikkeen parametrit
Parametri	Oletus ja asetukset	Kuvaus
Toimintopainiketoiminto 1~3	Oletus: ei käytössä Asetukset: Ei käytössä, Hätäpuhelu, Mukautettu	Voit määrittää painikkeen tietylle palvelulle. Ei käytössä: Kun asetukseksi on valittu Ei käytössä, puhelimen yhden palvelun Toiminto-painike ei toimi. Hätäpuhelu: Käyttäjät voivat soittaa hätäpuhelun Toiminto-painikkeella, jos se on määritetty. Mukautettu: Käyttäjät voivat käyttää mukautettua palvelua Toiminto-painikkeella, jos se on määritetty. Kun määrität kentälle Hätäpuhelu tai Mukautettu, varmista, että syötät palvelukohteen Toiminnon painikepalvelun kohde - kenttään. Tai puhelimessa näkyy määritysvirhe.
Toimintopainikepalvelun nimi 1~3	Oletus: tyhjä	Määritä Toiminto-painikkeeseen määritetyn palvelun nimi. Nimi näkyy näytössä näkyvässä 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 Toimintopainikefunktio-kentässä olevan valinnan perusteella.
Toimintopainikepalvelun kohde 1~3	Oletus: tyhjä	Tarjoa palvelukohde seuraavassa muodossa Toiminto-painikkeelle määritetyn palvelun mukaan: Anna hätäpuhelupalveluissa puhelinnumero tai hätäpalvelun URI. Kun määrität painikkeen mukautetulle palvelulle, anna palvelun URL. URL-osoitteen on alettava `http://` or `https://`. Esimerkiksi# `https://10.11.20.159/path/service.xml`. Jos haluat määrittää painikkeen aloittamaan useita tapahtumia yhdellä käynnistimellä, kirjoita `puh:<phonenumber tai SIP URL> + <Service RUL>`. Esimerkki: `puh:1234 + https://10.11.20.159/path/service.xml`. Myös SIP URI:lle soittamista tuetaan. Anna URI puh. muodossa `: SIP 4567@co.webex.com` Jos otat Toiminto-painikkeen käyttöön määrittämättä kelvollista palvelukohdetta, puhelimen käyttäjä näkee määrityssanoman. Kun käyttäjä sulkee tämän ilmoituksen, varoituskuvake säilyy puhelimen näytön otsikossa, kunnes painike on määritetty oikein tai poistettu käytöstä. Puhelinnumeroita ei voi käyttää mukautettujen palvelujen kohteina. Jos määrität Toiminto-painikkeen mukautetuksi ja annat puhelinnumeron palvelun kohteena, puhelimessa näkyy ilmoitus siitä, että painiketta ei ole määritetty. Voit sen sijaan lisätä puhelinnumeron tässä muodossa `: <puhelimen numero>` esimerkiksi `puh:1234`. Jos et voi syöttää URL-osoitetta, joka sisältää et-osoitteen (&), käytä korvaajana %26. Kirjoita esimerkiksi http://1.2.3.4/phone?a=1%26b=2%26c=3 http://1.2.3.4/phone?a=1&b=2&c=3 - asetuksen sijaan.
Mukautettu sisältökenttä 1~3	Oletus: tyhjä	Tämä asetus toimii vain, kun Toiminnon painike -toiminnoksi on määritetty Mukautettu. Anna HTTP-tiedot, kuten menetelmä, otsikko ja POST- ja enimmäispituus on 1 024 merkkiä. Kun puhelin on määritetty, se lähettää HTTP POST -pyynnön, kun toimintoa painetaan. Jos palvelu edellyttää todennusta, anna todennussalaisuus Palvelusalaisuus-kenttään . Käytä HTTP-tiedoissa makroa `$SS` viittauksena palvelusalaisuuteen. Esimerkkejä ja syntaksi on TOIMINTO-painikkeen HTTP POST-pyynnössä.
Palvelusalaisuus 1~3	Oletus: tyhjä	Palvelusalaisuus voi olla todennussalaisuus, osoitus tai salasana. Annettu salaisuus näkyy peitemerkkijonona, ja siihen voi viitata makrolla `$SS mukautetun sisällön kentässä` ja toiminnon painikkeen palvelukohteessa .
Palvelun käynnistin 1~3	Oletus: Yksi paina Asetukset: 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 paina: Käynnistä liitetty puhelu tai palvelu painamalla Toiminto-painiketta. Pitkä paina: Käynnistä liitetty puhelu tai palvelu painamalla Toiminto-painiketta vähintään 2 sekunnin ajan. Paina 3 kertaa: Käynnistä liitetty puhelu tai palvelu painamalla Toiminto-painiketta kolme kertaa, kun kunkin painalluksen välillä on alle 2 sekuntia. Älä toista käynnistintä useissa palveluissa, koska alemman tärkeyden parametrit eivät toimi. Prioriteettijärjestys suurimmasta matalimpaan on seuraava: Ryhmä 1, Ryhmä 2, Ryhmä 3.
Ulossoittoviive 1~3	Oletus: 5 Asetukset: 0 - 30	Määritä puhelimen hätäpuhelun aloittamisen aikakatkaisuaika sekunteina tai mukautettu toiminto, kun Toiminto-painike on painettu. Aseta arvoon 0, jos haluat puhelimen soittavan puhelun, tai aloita tapahtuma välittömästi sen jälkeen, kun havaitset käynnistimen, kuten painike on määrittänyt yhdellä painalluksella, painamalla pitkään tai kolminkertaisesti.
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 vaarallisissa tilanteissa. Sen avulla käyttäjät voivat hakea apua meluamatta. Kun käyttäjät ovat käytössä, he voivat soittaa yksisuuntaisia puheluita Toiminto-painikkeella. Kun hiljainen hätäpuhelu on soitettu, vain toinen osapuoli voi lopettaa puhelun. Jotta vältytään huomion herättämiseltä meneillään olevan puhelun aikana, puhelimen 9811 ja 9841 näyttö jäätyy, kun taas puhelimen 9851, 9861 ja 9871 näyttö poistetaan käytöstä. Puhelin lukitsee oletusarvoisesti kaikki toiminnot hiljaisen hätäpuhelun aikana. Jos haluat käyttäjien palauttavan normaalin puhelintoiminnan säilyttäen hiljaisen hätäpuhelun, ota käyttöön Salli hiljaisen hätäpuhelun nouto -toiminto. Kun hätäpuhelu on poistettu käytöstä, se toimii kaksisuuntaisena puheluna, joka on samanlainen kuin muut lähtevät puhelut.
Salli hiljaisen hätäpuhelun nouto	Oletus: Ei Asetukset: Kyllä, Ei	Määrittää, voivatko käyttäjät noutaa puhelimen toiminnot hiljaisen hätäpuhelun aikana. Kun hiljainen hätäpuhelu on oletusarvoisesti aloitettu, puhelin lukitsee kaikki toiminnot, kunnes puhelun vastaanottaja lopettaa puhelun. Kun parametriksi on valittu Kyllä, käyttäjät voivat palauttaa normaalin puhelimen toiminnan painamalla mitä tahansa näppäintä ja ylläpitää hätäpuhelua. Puhelun ääni pysyy hiljaisena, ellei käyttäjä lisää äänenvoimakkuutta äänenvoimakkuusnäppäimellä.

HTTP POST -toimintopainikkeen pyyntö

Cisco Desk Phone 9800 -sarjan Toiminto-painike voidaan määrittää käynnistämään XML-sovellukset HTTP POST -pyyntöjen avulla.

Anna mukautettu pyyntökomentosarja mukautettuun sisältökenttään. Voit määrittää joko XML- tai JSON-sisältötyypin ja sisällyttää makroja pyyntöön. Esimerkiksi $SSvoidaan lisätä komentosarjaan noutamaan Palvelusalaisuus-kentässä annettu todennussalaisuus, osoitus tai salasana.

Seuraavat esimerkit ovat XML ja JSON:

Esimerkki #1: XML --menetelmä POST --otsikko 'Sisältötyyppi: sovellus/XML' --otsikko 'Tarkistus: Kantajan käyttäjänimi:$SS' --rungon '<MetaData><Trihib>True</Trigger><Kuvaus>Täydennys on kohteelle HTTP POST XML</Description></MetaData>' Esimerkki #2: JSON --menetelmä POST --otsikko 'Sisältötyyppi: sovellus/json' --otsikko 'Tarkistus: $SS' --body '{"tapahtumat": [{"evtid}12345", "parametrit": {"trigger":true}, "Kuvaus\Tämä on HTTP POST JSON"}]}

Cisco Unified Communications Manager (UCM) vaatii varattujen merkkien prosenttikoodauksen RFC 3986 -asetuksen mukaisesti.

Taulukko 2. Varattujen merkkien koodausprosentti
Merkki	Prosenttia koodaamisesta
&	`%26`
'	`%27`
"	`%22`
<	`%3c`
>	`%3e`

Seuraava komentosarja on esimerkki, jossa käytetään prosenttikoodattuja merkkijonoja.

--menetelmä POST --otsikko %27Content-Type: sovellus/XML%27 --runko %27%3cMetaData%3e%3cTrisec%3eTrue%3c/Trigger%3e%3cDescription%3ETämä on kohteelle HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27

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

Cisco AI Assistant

Kiitos palautteestasi.

Määritä toiminnon painike 9800 (Unified CM)

Mukauta Toiminto-painiketta

Viittaukset

Toiminto-painikkeen parametrit

HTTP POST -toimintopainikkeen pyyntö

Pienyritys

Enterprise

Laitteet

Ratkaisut:

Resurssit

Yritys