이 문서에서
dropdown icon
개요
    지원되는 XML 오브젝트
    지원되는 URI예요
XML 서비스에 연결하도록 전화 구성해요
XML 서비스 파라미터
소프트키에 XML 응용 프로그램 추가
라인 키에 XML 응용 프로그램 추가해요
XML URL에서 지원되는 매크로 변수

9800 및 8875 휴대폰용 XML 애플리케이션 구성 (브로드웍스)

list-menu이 문서에서
list-menu피드백이 있습니까?

이 도움말 문서는 시스코 브로드웍스에 등록된 시스코 데스크 폰 9800 시리즈와 시스코 비디오 폰 8875에 적용돼요.지원되는 XML 객체, URI 및 전화 웹 페이지의 XSI 서비스 구성 단계에 대해서는 이 문서를 읽어보세요.

개요

XML 서비스 인터페이스 (XSI) 는 애플리케이션과 전화 시스템 간의 통신을 가능하게 하는 프로토콜이에요. 지원되는 XML 객체와 URI를 사용하여 휴대폰에 XSI 서비스를 추가할 수 있어요.

전화를 서비스에 가입한 후 사용자는 설정 > 네트워크 및 서비스 > Cisco XML 서비스로 이동하여 전화기에 구성된 모든 서비스에 액세스할 수 있어요. 시스코 XML 서비스가 기본 이름이에요. 이름도 바꿀 수 있어요. 사용자가 쉽게 액세스할 수 있도록 소프트키나 줄 키에 XML 응용 프로그램을 추가할 수 있어요.

지원되는 기능은 다음과 같아요.

  • 메시지 (이미지 및 텍스트)
  • 페이징

지원되는 XML 오브젝트

  • 시스코 아이폰 메뉴

  • 시스코 아이폰 텍스트

  • 시스코 아이폰 입력

  • 시스코 아이폰 전화번호부

  • 시스코 아이폰 이미지

  • 시스코 아이폰 이미지 파일

  • 시스코 아이폰 아이콘 메뉴

  • 시스코 아이폰 아이콘 파일 메뉴

  • 시스코 IP 전화 상태 (9811 및 9841 제외)

  • 시스코 IP 전화 상태 파일 (9811, 9841 제외)

  • 시스코 아이폰 실행

지원되는 URI예요

  • 디바이스

  • 다이얼이에요

  • 에디트데일

  • 초기화돼요

  • 키

  • 재생 (벨소리만)

  • 소프트키

XSI 서비스 구성에 대한 자세한 내용은 Cisco Unified IP Phone 서비스 애플리케이션 개발 노트를 참조하세요.

XML 서비스에 연결하도록 전화 구성해요

1

전화 관리 웹페이지에 접속해요.

2

음성 > 전화를 선택해요.

3

XML 서비스 섹션에서 XML 서비스 매개변수에 정의된 대로 XML 응용 프로그램 서비스 이름과 XML 응용 프로그램 서비스 URL 매개변수를 구성하세요.

4

(선택 사항) 애플리케이션 서비스 액세스를 위한 인증을 추가하려면 XML 사용자 이름, XML 비밀번호, CISCO XML EXE 활성화, CISCO XML EXE 인증 모드 필드를 구성하세요.

5

변경사항 모두 저장을 클릭해요.

XML 서비스 파라미터

다음 표는 전화 웹 인터페이스의 음성 > 전화 탭 아래 XML 서비스 섹션에 있는 XML 응용 프로그램 매개변수의 기능과 사용을 정의해요. 또한 매개 변수를 구성하는 XML 코드와 함께 전화 구성 파일 (cfg.xml) 에 추가되는 문자열의 구문을 정의해요.

테이블 1이에요.XML 서비스 파라미터

파라미터

기본값 및 옵션

설명

XML 응용 프로그램 서비스 이름

기본값: 비어 있어요

XML 응용 프로그램 이름이에요. 이름은 전화기에 웹 애플리케이션 선택으로 표시돼요.

다음 형식으로 문자열을 입력하여 전화 구성 XML 파일 (cfg.xml) 에서 이 매개변수를 구성할 수도 있어요.

<XML_Application_Service_Name
ua="na">XML APP Name</XML_Application_Service_Name>

XML 응용 프로그램 서비스 URL

기본값: 비어 있어요

XML 응용 프로그램이 있는 URL이에요.

다음 형식으로 문자열을 입력하여 전화 구성 XML 파일 (cfg.xml) 에서 이 매개변수를 구성할 수도 있어요.

<XML_Application_Service_URL
ua="na">https://server.com/path/app.xml</XML_Application_Service_URL>

매크로 변수는 XML URL에서 지원돼요. 유효한 매크로 변수는 XML URL에서 지원되는 매크로 변수를 참조하세요.

URL에서 HTTP 또는 HTTPS 프로토콜만 지원돼요.

XML 사용자 이름

기본값: 비어 있어요

인증을 위한 XML 서비스 사용자 이름이에요.

다음 형식으로 문자열을 입력하여 전화 구성 XML 파일 (cfg.xml) 에서 이 매개변수를 구성할 수도 있어요.

<XML_User_Name ua="na">username</XML_User_Name>

XML 비밀번호

기본값: 비어 있어요

지정된 XML 사용자 이름의 XML 서비스 암호예요.

이 필드에 입력한 비밀번호는 구성 파일 (cfg.xml) 에 다음과 같이 표시돼요.

<!--
<XML_Password ua="na">*************</XML_Password>
-->

시스코 XML EXE 활성화

기본값: 아니요

옵션: 네, 아니요

XML 애플리케이션 서버에 액세스하는 데 인증이 필요한지 여부를 지정합니다.

다음 형식으로 문자열을 입력하여 전화 구성 XML 파일 (cfg.xml) 에서 이 매개변수를 구성할 수도 있어요.

<CISCO_XML_EXE_Enable ua="na">Yes</CISCO_XML_EXE_Enable>

시스코 XML EXE 인증 모드

기본값: 로컬 자격 증명

옵션: 신뢰, 로컬 자격 증명, 원격 자격 증명

시스코 XML EXE의 인증 모드를 지정해요.

  • 신뢰할 수 있음 - 로컬 자격 증명에 상관없이 인증이 수행되지 않아요.

  • 로컬 자격 증명—인증은 로컬 자격 증명 (설정된 경우) 을 사용한 다이제스트 인증을 기반으로 해요. 로컬 자격 증명이 설정되지 않으면 인증이 수행되지 않아요.

  • 원격 자격 증명—인증은 웹 페이지의 XML 애플리케이션에 설정된 원격 자격 증명을 사용한 다이제스트 인증을 기반으로 해요 (XML 애플리케이션 서버에 액세스하기 위해).

다음 형식으로 문자열을 입력하여 전화 구성 XML 파일 (cfg.xml) 에서 이 매개변수를 구성할 수도 있어요.

<CISCO_XML_EXE_Auth_Mode ua="na">Local Credential</CISCO_XML_EXE_Auth_Mode>

소프트키에 XML 응용 프로그램 추가

사용자들이 서비스에 쉽게 접근할 수 있도록 자주 사용하는 애플리케이션을 소프트키에 추가해요.

시작하기 전에

XML 애플리케이션 서비스가 제대로 구성됐어요.

1

전화 관리 웹페이지에 접속해요.

2

음성 > 전화를 선택해요.

3

프로그래밍 가능한 소프트키 섹션에서 프로그래밍 가능한 소프트키 활성화를 Yes로 설정하세요.

구성 파일 (cfg.xml) 에서도 이 매개변수를 구성할 수 있어요. 다음 형식으로 문자열을 입력하세요:

<Programmable_Softkey_Enable ua="na">Yes</Programmable_Softkey_Enable>
4

프로그래밍 가능한 소프트키 섹션에서 PSK1에서 PSK16 사이의 사용 가능한 필드를 다음 형식으로 편집하세요.

fnc=xml;url=<xml_app_path>;nme=<app_name>

여기서 url은 XML 응용 프로그램이 저장되는 링크이고, nme은 응용 프로그램의 전화 화면 표시 이름이에요.

예 fnc=xml; URL= http://10.77.21.37/xmlapp/menu.xml;nme=Menu

구성 파일 (cfg.xml) 에서도 이 매개변수를 구성할 수 있어요. 다음 형식으로 문자열을 입력하세요:

<PSK_n ua="na">fnc=xml; URL= http://10.77.21.37/xmlapp/menu.xml;nme=Menu</PSK_n> <configuration code>

여기서 n은 소프트키 번호예요.

5

변경사항 모두 저장을 클릭해요.

라인 키에 XML 응용 프로그램 추가해요

사용자들이 서비스에 쉽게 접근할 수 있도록 자주 사용하는 애플리케이션을 라인 키에 추가해요.

시작하기 전에

XML 애플리케이션 서비스가 제대로 구성됐어요.

1

전화 관리 웹페이지에 접속해요.

2

음성 > 전화를 선택해요.

3

라인 키 선택해요.

4

확장 기능을 비활성화하려면 확장 프로그램 매개 변수를 사용 안 함으로 설정하세요.

직접 PLK 구성 기능이 비활성화되면 라인 키에 확장 기능을 추가하려면 확장을 비활성화해야 해요. 기능이 활성화되면 이 단계를 건너뛰어도 돼요. 자세한 내용은 직접 PLK 구성 활성화를 참조하십시오.
5

확장 함수 매개변수에 다음 형식으로 문자열을 입력하세요.

fnc=xml;url=<xml_app_path>;nme=<app_name>

여기서 url은 XML 응용 프로그램이 저장되는 링크이고, nme은 응용 프로그램의 전화 화면 표시 이름이에요.

예 fnc=xml; URL= http://10.77.21.37/xmlapp/menu.xml;nme=Menu

구성 파일 (cfg.xml) 에서도 이 매개변수를 구성할 수 있어요. 다음 형식으로 문자열을 입력하세요:

<Extended_Function_n_ ua="na">fnc=xml; URL= http://10.77.21.37/xmlapp/menu.xml;nme=Menu</Extended_Function_n_> <configuration code>

여기서 n은 내선 번호예요.

6

변경사항 모두 저장을 클릭해요.

XML URL에서 지원되는 매크로 변수

XML URL에 매크로 변수를 사용할 수 있어요. 다음 매크로 변수가 지원돼요.

  • 사용자 ID—UID1, UID2에서 UIDN으로

  • 디스플레이 이름 - 디스플레이 이름 1, 디스플레이 이름으로 DISPLAYNAME2

  • 인증 ID—AUTHID1, AUTHID2 - 인증 IDN

  • 프록시—프록시1, PROXY2 대 프록신

  • 소문자 16진수를 사용한 MAC 주소—MA

  • 제품 이름—PN

  • 제품 시리즈 번호—PSN

  • 일련번호—일련_번호

테이블 2예요.지원되는 매크로
매크로 이름매크로 확장
$$$ 형식은 단일 $ 문자로 확장돼요.
A부터 P까지범용 매개변수 GPP_A~GPP_P로 대체됐어요.
SA부터 SD까지GPP_SA에서 GPP_SD까지의 특수 목적 매개변수로 대체됐어요. 이 매개변수에는 프로비저닝에 사용되는 키나 암호가 들어 있어요.

$SA~$SD는 선택적 재동기화 URL 한정자 --key에 대한 인수로 인식돼요.

MA소문자 16진수 (000e08aabbcc) 를 사용하는 MAC 주소.
MAU대문자 16진수를 사용한 MAC 주소 (000E08AABBCC).
MAC16진수 쌍을 구분하기 위해 콜론과 함께 소문자 16진수를 사용하는 MAC 주소 (00:0 e:08:aa:bb:cc).
PN제품 이름; 예를 들면, 비디오 폰 8875, 탁상 전화 9851.
PSN제품 시리즈 번호, 예를 들어, 8875, 9841, 9861
SN일련번호 문자열이에요. 예를 들면 88012BA01234.
CCERTSSL 클라이언트 인증서 상태, 설치됨 여부.
IP로컬 서브넷 내 전화의 IP 주소, 예를 들어 192.168.1.100이에요.
EXTIP인터넷에서 볼 수 있는 전화의 외부 IP, 예를 들면 66.43.16.52예요.

SWVER

소프트웨어 버전 문자열. 예를 들자면,

PHONEOS.3-2-1-0104-37

HWVER

하드웨어 버전 문자열. 예를 들면, 2.0.1

PRVST

프로비전 상태 (숫자 문자열):

-1 = 명시적 재동기화 요청

0 = 파워업 리싱크

1 = 주기적 재동기화

2 = 재동기화 실패, 재시도

UPGST

업그레이드 상태 (숫자 문자열):

1 = 첫 업그레이드 시도

2 = 업그레이드 실패, 재시도

UPGERR

이전 업그레이드 시도의 결과 메시지 (오류), 예를 들어 http_get 실패.

PRVTMR

마지막 재동기화 시도 이후 몇 초 후예요.

UPGTMR

마지막 업그레이드 시도 이후 초 됐어요.

REGTMR1

1호선 SIP 서버 등록이 끊긴 지 몇 초 됐어요.

REGTMR2

2호선 SIP 서버 등록이 끊긴 지 몇 초 됐어요.

UPGCOND

레거시 매크로 이름이에요.

SCHEME

재동기화 또는 업그레이드 URL을 파싱한 후 얻은 파일 액세스 체계, TFTP, HTTP, HTTPS 중 하나예요.

SERV

재동기화 또는 업그레이드 URL을 파싱한 후 얻은 대상 서버 호스트 이름을 요청하세요.

SERVIP

DNS 조회 후 재동기화 또는 업그레이드 URL을 파싱한 후 얻은 대상 서버 IP 주소를 요청하세요.

PORT

재동기화 또는 업그레이드 URL을 파싱한 후 얻은 대상 UDP/TCP 포트를 요청하세요.

PATH

재동기화 또는 업그레이드 URL을 파싱한 후 얻은 대상 파일 경로를 요청하세요.

ERR

재동기화 또는 업그레이드 시도 결과 메시지예요. 결과 syslog 메시지 생성에만 유용해요. 업그레이드 시도 시 UPGERR 변수에 값이 보존돼요.

우딘

라인 n 사용자 ID 구성 매개변수의 내용이에요.

ISCUST

단위가 사용자 지정되면 값은 1이고, 그렇지 않으면 0이에요.

사용자 지정 상태는 웹 UI 정보 페이지에서 볼 수 있어요.

INCOMINGNAME첫 연결, 전화 걸기 또는 수신 전화에 연결된 이름이에요.
REMOTENUMBER

처음 연결한 전화 번호, 걸려오는 전화 번호, 수신 전화 번호예요. 전화가 여러 번 걸리면 처음 찾은 통화와 관련된 데이터가 제공돼요.

디스플레이 네임라인 N 디스플레이 이름 구성 매개변수의 내용이에요.
오토 아이디라인 N 인증 ID 구성 매개변수의 내용이에요.
이 문서가 도움이 되었습니까?
이 문서가 도움이 되었습니까?