Tilpas handlingsknappen

De brugerdefinerede indstillinger for handlingsknappen på Cisco Desk Phone 9800-serien kræver specifik PhoneOS-firmwareunderstøttelse. Se følgende tabel for at få flere oplysninger:

FunktionPåkrævet firmwareversion
NødopkaldPhoneOS 3.0.1 og nyere
Tilpasset servicePhoneOS 3.2.1 og nyere
Flere udløserePhoneOS 3.3.1 og nyere
HTTP-indlægPhoneOS 3.3.1 og nyere
Flere hændelser på en enkelt udløserPhoneOS 3.4.1 og nyere
1

Log ind på Cisco Unified Communications Manager Administration.

2

Udfør en af følgende handlinger efter behov:

  • Hvis du vil konfigurere alle installerede telefoner, skal du gå til System > Konfiguration af firmatelefoner.
  • Hvis du vil konfigurere telefoner, der deler den samme telefonprofil, skal du gå til Enhed > Enhedsindstillinger > Fælles telefonprofil.
  • Hvis du vil konfigurere en individuel telefon, skal du gå til Enhed > Telefon. Find derefter din telefon, og åbn siden Telefonkonfiguration.

Konfigurationen følger en hierarkisk struktur:

  • Individuelle enhedsindstillinger har forrang frem for indstillinger på almindeligt telefonprofil- og virksomhedsniveau
  • Almindelige telefonprofilindstillinger tilsidesætter indstillinger på virksomhedsniveau

3

Tilpas indstillingerne for handlingsknappen med følgende parametre baseret på dine use cases.

Der er tre grupper af parametre for handlingsknappen, der hver svarer til en tjeneste med en unik udløser. Hvis en tjenesteudløser er angivet i flere grupper, har indstillingerne i Gruppe 1 prioritet over indstillingerne i Gruppe 2 og 3, mens Gruppe 2 har prioritet over Gruppe 3.

  • Nødopkald

    Konfigurer følgende parametre:

    • Handlingsknapfunktion: Vælg Nødopkald.

    • Handlingsknap Servicedestination: Indtast telefonnummeret eller URI på nødtjenesten.

    • Handlingsknaptjenestenavn (valgfrit): Angiv et navn på den tjeneste, der er knyttet til handlingsudløseren. Dette navn vises i meddelelsen på skærmen, når brugeren trykker på knappen, hvilket angiver, hvilken hændelse der startes. Hvis der ikke er angivet noget navn, anvendes nødopkald som visningsnavn.

    • Opkaldsforsinkelse: Angiv timeoutperioden (i sekunder), hvor telefonen skal starte et nødopkald, når udløseren registreres. Standardindstillingen er 5 sekunder. Hvis indstillingen er angivet til 0, foretages opkaldet umiddelbart efter, at udløseren registreres.

    • Serviceudløser Vælg en udløser på listen: Enkelt tryk,Langt tryk, eller tryk 3 gange.

    • Lydløst nødopkald (valgfrit): Nødopkaldet fungerer som standard som et tovejsopkald på samme måde som andre udgående opkald. Når lydløst nødopkald er aktiveret, er lyden lydløs på opkaldssiden for at undgå at tiltrække opmærksomhed under det igangværende opkald. Det er kun modtageren af opkaldet, der kan afslutte det lydløse nødopkald.

      Under et lydløst nødopkald fryser skærmen på telefon 9841, mens skærmen på telefon 9851, 9861 og 9871 slukkes. Alle andre funktioner er utilgængelige. Telefonen genopretter normal drift, når modtageren afslutter opkaldet.

    • Tillad lydløs hentning af nødopkald (valgfrit): Aktivér denne funktion, hvis du giver brugerne mulighed for at trykke på en vilkårlig tast for at genoprette normal telefondrift, samtidig med at nødopkaldet bevares. Opkaldslyden forbliver lydløs, medmindre brugeren øger højttalerlydstyrken ved hjælp af lydstyrketasten.

  • Tilpassede tjenester

    Konfigurer følgende parametre:

    • Handlingsknapfunktion: Vælg Brugerdefineret.

    • Handlingsknap Servicedestination: Angiv URL-adressen til den brugerdefinerede tjeneste. URL-adressen skal starte med http:// eller https://, f.eks. . https://10.11.20.159/path/service.xml .

    • Handlingsknaptjenestenavn (valgfrit): Angiv et navn på den tjeneste, der er knyttet til udløseren. Dette navn vises i meddelelsen på skærmen, når brugeren trykker på knappen, hvilket angiver, hvilken tjeneste der udløses. Når der ikke er angivet noget navn, bruges Tilpasset tjeneste som visningsnavn.

    • Brugerdefineret indholdsfelt (valgfrit): Hvis du vil aktivere telefonen til at sende en HTTP Post-anmodning, når der trykkes på handlingsknappen, skal du indtaste HTTP-dataene, f.eks. metode, overskrift og indlægsindhold, med en maksimal længde på 1024 tegn.

      Du kan finde eksempler på POST-scripts og syntaksen under HTTP-indlægsanmodning for knappen Handling.

    • Forsinkelse ved opkald: Angiv timeoutperioden i sekunder, hvor telefonen skal starte en hændelse efter registrering af udløseren. Standardindstillingen er 5 sekunder. Når den er indstillet til 0, startes hændelsen straks efter triggerregistrering.

    • Serviceudløser Vælg en udløser på listen: Enkelt tryk,Langt tryk, eller tryk 3 gange.

    • Tjenestehemmelighed (valgfrit): Angiv godkendelseshemmeligheden, tokenet eller adgangskoden, hvis din brugerdefinerede tjeneste kræver godkendelse for at få adgang til den. Den angivne hemmelighed vises som en maskeret streng, og der kan refereres til den ved hjælp af makroen $SS i Brugerdefineret indholdsfelt og Handlingsknaptjenestedestination.

  • Flere udløsere

    Indstil parametrene i hver gruppe henholdsvis. Se afsnittene Nødopkald og Tilpassede tjenester ovenfor.

  • En enkelt udløser for flere hændelser

    Konfigurer følgende parametre for at tildele flere hændelser til en udløser:

    • Handlingsknapfunktion: Vælg Brugerdefineret.

    • Handlingsknap Servicedestination: Angiv telefonnummeret, der skal ringes til, og XML-tjeneste-URL-adressen i dette format:

      tlf.<telefonnummer eller SIP-URI> + <serviceURL>

      URL-adressen skal starte med http:// eller https://.

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

    • Handlingsknaptjenestenavn (valgfrit): Angiv et navn på den tjeneste, der er knyttet til udløseren. Dette navn vises i meddelelsen på skærmen, når brugeren trykker på knappen, hvilket angiver, hvilken tjeneste der udløses. Når der ikke er angivet noget navn, bruges Tilpasset tjeneste som visningsnavn.

    • Brugerdefineret indholdsfelt (valgfrit): Hvis du vil aktivere telefonen til at sende en HTTP Post-anmodning, når der trykkes på handlingsknappen, skal du indtaste HTTP-dataene, f.eks. metode, overskrift og indlægsindhold, med en maksimal længde på 1024 tegn.

      Du kan finde eksempler på POST-scripts og syntaksen under HTTP-indlægsanmodning for knappen Handling.

    • Forsinkelse ved opkald: Angiv timeoutperioden i sekunder, hvor telefonen skal starte en hændelse efter registrering af udløseren. Standardindstillingen er 5 sekunder. Når den er indstillet til 0, startes hændelsen straks efter triggerregistrering.

    • Serviceudløser Vælg en udløser på listen: Enkelt tryk,Langt tryk, eller tryk 3 gange.

    • Tjenestehemmelighed (valgfrit): Angiv godkendelseshemmeligheden, tokenet eller adgangskoden, hvis din brugerdefinerede tjeneste kræver godkendelse for at få adgang til den. Den angivne hemmelighed vises som en maskeret streng, og der kan refereres til den ved hjælp af makroen $SS i Brugerdefineret indholdsfelt og Handlingsknaptjenestedestination.

    • Lydløst nødopkald (valgfrit): Hvis du har inkluderet et telefonnummer eller en URI i tjenestedestinationen, vil aktivering af denne funktion gøre nødopkald lydløse.

      Nødopkaldet fungerer som standard som et tovejsopkald på samme måde som andre udgående opkald. Når indstillingen er aktiveret, er lyden lydløs på opkaldssiden for at undgå at tiltrække opmærksomhed under det igangværende opkald. Det er kun modtageren af opkaldet, der kan afslutte opkaldet.

      Under et lydløst nødopkald fryser skærmen på telefon 9841, mens skærmen på telefon 9851, 9861 og 9871 slukkes. Alle andre funktioner er utilgængelige. Telefonen genopretter normal drift, når modtageren afslutter opkaldet.

    • Tillad lydløs hentning af nødopkald (valgfrit): Aktivér denne funktion, hvis du giver brugerne mulighed for at trykke på en vilkårlig tast for at genoprette normal telefondrift, samtidig med at nødopkaldet bevares. Opkaldslyden forbliver lydløs, medmindre brugeren øger højttalerlydstyrken ved hjælp af lydstyrketasten.

Du kan finde flere oplysninger om disse parametre under Parametre for handlingsknappen.

4

Vælg Gem.

5

Vælg Anvend konfig.

Referencer

Parametre for handlingsknappen

Parametrene er tilgængelige i Konfiguration af firmatelefon, Almindelig telefonprofil og konfiguration af individuelle telefoner.

Tabel 1. Parametre for handlingsknappen
ParameterStandard og indstillingerBeskrivelse
Handlingsknapfunktion 1~3

Standard: fra

Indstillinger: Fra, Nødopkald, Brugerdefineret

Du kan konfigurere knappen med en bestemt tjeneste.

  • Fra: Når indstillingen er slået Fra, fungerer handlingsknappen for engangsservice på telefonen ikke.
  • Nødopkald: Brugere kan bruge handlingsknappen til at foretage et nødopkald, hvis konfigureret.
  • Brugerdefineret: Brugere kan bruge handlingsknappen til at få adgang til den brugerdefinerede tjeneste, hvis den er konfigureret.

Når du indstiller feltet til Nødopkald eller Brugerdefineret , skal du sørge for at angive servicedestinationeni feltet Servicedestination for handlingsknap. Eller telefonen viser en konfigurationsfejl.

Handlingsknap Servicenavn 1~3

Standard: tom

Du kan også angive et navn på den tjeneste, der er knyttet til handlingsknappen. Dette navn vises i meddelelsen på skærmen, når brugeren trykker på knappen, hvilket angiver, hvilken tjeneste der udløses.

Hvis du ikke angiver et navn, vil standardnavnet være Nødopkald, Lydløst nødopkald eller Brugerdefineret handling baseret på dit valg i feltet Handlingsknapfunktion .

Handlingsknap Servicedestination 1~3

Standard: tom

Angiv tjenestedestinationen i et af følgende formater baseret på den tjeneste, der er tildelt handlingsknappen:

  • Indtast et telefonnummer eller nødtjenestens URI for nødopkaldstjenester.

  • Når du konfigurerer knappen til en brugerdefineret tjeneste, skal du angive tjenestens URL-adresse. URL-adressen skal starte med http:// eller https://. For eksempelhttps ://10.11.20.159/path/service.xml.

  • Hvis du vil konfigurere knappen til at starte flere hændelser med en enkelt udløser, skal du angive tel:<phonenumber eller SIP URL> + <Service RUL>. Eksempel: tel:1234 + https://10.11.20.159/path/service.xml.

    Kaldende SIP URI'er understøttes også. Indtast URI i formatet tel: sip 4567@co.webex.com

Hvis du aktiverer handlingsknappen uden at angive en gyldig tjenestedestination, ser brugeren af telefonen en meddelelse, hvor du bliver bedt om konfiguration. Når brugeren har lukket denne besked, bevares advarselsikonet i overskriften på telefonskærmen, indtil knappen er korrekt konfigureret eller deaktiveret.

Telefonnumre kan ikke bruges som destinationer for tilpassede tjenester. Hvis du konfigurerer handlingsknappen som brugerdefineret og angiver et telefonnummer som tjenestedestination, vises der en advarsel på telefonen om, at knappen ikke er konfigureret. Du kan i stedet tilføje et telefonnummer i dette format tel:<telefonnummer>, f.eks . tel:1234.

Hvis du ikke har tilladelse til at angive en webadresse, der indeholder og-tegn (&), skal du bruge %26 som erstatning. Skriv f.eks .http://1.2.3.4/phone?a=1%26b=2%26c=3 i stedet for http://1.2.3.4/phone?a=1&b=2&c=3.

Brugerdefineret indholdsfelt 1~3

Standard: tom

Denne indstilling fungerer kun, når handlingsknapfunktionen er indstillet til Brugerdefineret.

Angiv HTTP-data, f.eks. metode, sidehoved og indlægsindhold med en maksimal længde på 1024 tegn. Når telefonen er konfigureret, sender den en HTTP Post-anmodning, når der trykkes på handlingen.

Hvis tjenesten kræver godkendelse for at få adgang, skal du sørge for at angive godkendelseshemmeligheden i feltet Tjenestehemmelighed . I HTTP-dataene skal du bruge makroen $SS som reference til Servicehemmelighed.

Du kan finde eksempler og syntaksen under HTTP-indlægsanmodning for knappen Handling.

Servicehemmelighed 1~3

Standard: tom

En tjenestehemmelighed kan være en godkendelseshemmelighed, et token eller en adgangskode. Den angivne hemmelighed vises som en maskeret streng, og der kan refereres til den ved hjælp af makroen $SS i Brugerdefineret indholdsfelt og Handlingsknaptjenestedestination.

Tjenesteudløser 1~3

Standard: Enkelt tryk

Indstillinger: Enkelt tryk, langt tryk, tryk 3 gange

Vælg, hvordan brugere kan foretage et nødopkald eller starte en tilpasset tjeneste ved hjælp af telefonens handlingsknap.

Enkelt tryk: Tryk på handlingsknappen for at udløse det tilknyttede opkald eller den tilknyttede tjeneste.

Langt tryk: Tryk handlingsknappen ned i mindst 2 sekunder for at udløse det tilknyttede opkald eller den tilknyttede tjeneste.

Tryk 3 gange: Tryk på handlingsknappen tre gange med mindre end 2 sekunders mellemrum mellem hvert tryk for at udløse det tilknyttede opkald eller den tilknyttede tjeneste.

Gentag ikke en udløser på tværs af flere tjenester, da parametrene med lavere prioritet ikke fungerer. Prioritetsrækkefølgen, fra højeste til laveste, er som følger: Gruppe 1, Gruppe 2, Gruppe 3.

Forsinkelse ved udgående opkald 1~3

Standard: 5

Valgmuligheder: 0 - 30

Angiv timeoutperioden i sekunder, hvor telefonen skal starte et nødopkald eller en brugerdefineret handling, efter at der er trykket på handlingsknappen.

Indstil den til 0, hvis du foretrækker, at telefonen foretager opkaldet eller starter en hændelse umiddelbart efter, at udløseren registreres. Det angives med et enkelt tryk, et langt tryk eller tre tryk på knappen.

Lydløst nødopkald 1~3

Standard: Deaktiveret

Indstillinger: Aktiveret, Deaktiveret

Lydløst nødopkald er designet til diskret hjælp i farlige situationer. Det giver brugerne mulighed for at søge hjælp uden at lave støj.

  • Når indstillingen er aktiveret, kan brugerne foretage envejsopkald med handlingsknappen.

    Når det lydløse nødopkald er foretaget, er det kun den anden part, der kan afslutte opkaldet. For at undgå at tiltrække opmærksomhed under det igangværende opkald fryser skærmen på telefon 9841, mens skærmen på telefon 9851, 9861 og 9871 slukkes. Telefonen låser som standard alle funktioner under et lydløst nødopkald. Hvis brugerne skal kunne gendanne normal telefondrift, samtidig med at det lydløse nødopkald bevares, skal du aktivere funktionen Tillad hentning af lydløse nødopkald .

  • Når nødopkaldet er deaktiveret, fungerer det som et tovejsopkald på samme måde som andre udgående opkald.

Tillad lydløs hentning af nødopkald

Standard: nej

Indstillinger: Ja, Nej

Styrer, om brugere kan hente telefonens funktionalitet under et lydløst nødopkald. Når et lydløst nødopkald er startet, låser telefonen som standard alle funktioner, indtil modtageren af opkaldet afslutter opkaldet.

Når denne parameter er indstillet til Ja, kan brugerne trykke på en vilkårlig tast for at genoprette normal telefondrift, samtidig med at nødopkaldet bevares. Opkaldslyden forbliver lydløs, medmindre brugeren øger lydstyrken ved hjælp af lydstyrketasten.

HTTP-postanmodning for handlingsknappen

Handlingsknappen på Cisco Desk Phone 9800-serien kan konfigureres til at udløse XML programmer via HTTP Post-anmodninger.

Angiv dit tilpassede anmodningsscript i Brugerdefineret indholdsfelt. Du kan angive enten XML- eller JSON-indholdstypen og medtage makroer i anmodningen. Der kan f.eks. . føjes $SStil scriptet for at hente den godkendelseshemmelighed, det token eller den adgangskode, der findes i feltet Tjenestehemmelighed .

Følgende eksempler findes i XML og JSON:

Eksempel #1: XML --metode POST --header 'Content-Type: application/xml' --header 'Authorization: Bearer username:$SS' --body '<Metadata><Trigger>True</Trigger><Description>Dette er til HTTP POST XML</Description></Metadata>' Eksempel #2: JSON --metode POST --header 'Content-Type: application/json' --header 'Authorization: $SS' --body '{"events":[{"evtid":"12345", "parameters": {"trigger": true}, "Beskrivelse":"Dette er til HTTP POST JSON"}]}'

Cisco Unified Communications Manager (UCM) kræver procentvis kodning for de reserverede tegn i overensstemmelse med RFC 3986.

Tabel 2. Procentvis kodning for reserverede tegn
TegnProcentvis kodning
&%26
'%27
"%22
< %3c
> %3e

Følgende script er et eksempel på brug af procentkodede strenge.

--metode POST --header %27Content-Type: application/xml%27 --body %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3eDette er til HTTP POST XML%3c/Description%3e%3c/Metadata%3e%27
Tabel 3. Understøttede makroer
MakronavnMakroudvidelse
#DEVICENAME#Enhedsnavnet, der vises i opkaldssystemet. For eksempel SEP845A3EC21288
$SSServicehemmelighed, der viser en maskeret streng på telefonkonfigurationssiden, f.eks. godkendelseshemmelighed, token eller adgangskode.