- 홈
- /
- 문서
BroadWorks의 전화기에 대한 XML 애플리케이션 구성
이 도움말 문서는 Cisco BroadWorks에 등록된 Cisco Desk Phone 9800 시리즈 및 Cisco Video Phone 8875에 적용됩니다. 지원되는 XML 개체, URI 및 전화기 웹 페이지에서 XSI 서비스를 구성하는 단계에 대해서는 이 문서를 참조하십시오.
개요
XSI(XML Services Interface)는 애플리케이션과 전화기 시스템 간의 통신을 허용하는 프로토콜입니다. 지원되는 XML 개체 및 URI를 사용하여 전화기에 자신의 XSI 서비스를 추가할 수 있습니다.
서비스에 전화기를 가입하면 사용자는
를 탐색하여 전화에서 구성된 모든 서비스에 액세스할 수 있습니다. Cisco XML 서비스가 기본 이름입니다. 이름을 변경할 수도 있습니다. 사용자에게 쉬운 액세스를 제공하기 위해 XML 애플리케이션을 소프트키 또는 회선 키에 추가할 수 있습니다.지원되는 기능은 다음과 같습니다.
- 메시지(이미지 및 텍스트)
- 페이징
지원되는 XML 개체
-
Cisco IP 전화기 메뉴
-
CiscoIP 전화기 텍스트
-
Cisco IP 전화기 입력
-
Cisco IP 전화기 디렉터리
-
CiscoIP 전화기 이미지
-
CiscoIPPhoneImageFile의
-
CiscoIPPhoneIconMenu
-
Cisco IP 전화기 아이콘 파일 메뉴
-
CiscoIPPhoneStatus(9841 제외)
-
CiscoIPPhoneStatusFile(9841 제외)
-
CiscoIPPhoneExecute는
지원되는 URI
-
장치
-
다이얼
-
편집Dail
-
초기화
-
키
-
재생 (벨소리만)
-
소프트키
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 코드를 사용하여 전화기 구성 파일(cfg.xml)에 추가된 문자열의 구문을 정의하여 매개 변수를 구성합니다.
파라미터 |
기본 및 옵션 |
설명 |
---|---|---|
XML 애플리케이션 서비스 이름 |
기본값: 비어 있음 |
XML 애플리케이션의 이름입니다. 전화기에 웹 애플리케이션 선택으로 이름이 표시됩니다. 다음 형식으로 문자열을 입력하여 전화기 구성 XML 파일(cfg.xml)에서 이 매개 변수를 구성할 수도 있습니다.
|
XML 응용프로그램 서비스 URL |
기본값: 비어 있음 |
XML 애플리케이션이 위치한 URL입니다. 다음 형식으로 문자열을 입력하여 전화기 구성 XML 파일(cfg.xml)에서 이 매개 변수를 구성할 수도 있습니다.
매크로 변수는 XML URL에서 지원됩니다. 유효한 매크로 변수에 대해서는 XML URL에서 지원되는 매크로 변수를 참조하십시오. HTTP 또는 HTTP 프로토콜만 URL에서 지원됩니다. |
XML 사용자 이름 |
기본값: 비어 있음 |
인증을 위한 XML 서비스 사용자 이름입니다. 다음 형식으로 문자열을 입력하여 전화기 구성 XML 파일(cfg.xml)에서 이 매개 변수를 구성할 수도 있습니다.
|
XML 비밀번호 |
기본값: 비어 있음 |
지정된 XML 사용자 이름에 대한 XML 서비스 암호입니다. 이 필드에 입력한 비밀번호는 구성 파일(cfg.xml)에 다음과 같이 표시됩니다.
|
CISCO XML EXE 활성화 |
기본값: 아니요 옵션: 예, 아니요 |
XML 애플리케이션 서버에 액세스하기 위해 인증이 필요한지 여부를 지정합니다. 다음 형식으로 문자열을 입력하여 전화기 구성 XML 파일(cfg.xml)에서 이 매개 변수를 구성할 수도 있습니다.
|
CISCO XML EXE 인증 모드 |
기본값: 로컬 자격 증명 옵션: 신뢰할 수 있는, 로컬 자격 증명, 원격 자격 증명 |
Cisco XML EXE에 대한 인증 모드를 지정합니다.
다음 형식으로 문자열을 입력하여 전화기 구성 XML 파일(cfg.xml)에서 이 매개 변수를 구성할 수도 있습니다.
|
소프트키에 XML 애플리케이션 추가
사용자가 서비스에 쉽게 액세스할 수 있도록 자주 사용되는 애플리케이션을 소프트키에 추가합니다.
시작하기 전에
XML 애플리케이션 서비스가 올바르게 구성되었습니다.
1 |
전화기 관리 웹 페이지에 액세스합니다. |
2 |
를 선택합니다. |
3 |
프로그래밍 가능한 소프트키 섹션에서 프로그래밍 가능한 소프트키 활성화를 예로 설정합니다. 구성 파일(cfg.xml)에서 이 매개 변수를 구성할 수도 있습니다. 다음 형식으로 문자열을 입력합니다.
|
4 |
프로그래밍 가능한 소프트키 섹션에서 다음 형식으로 PSK1의 사용 가능한 필드를 PSK16로 편집합니다. fnc=xml;url=<xml_app_path>;nme=<app_name>
여기서 url은 XML 응용프로그램이 저장된 링크입니다. nme는 전화 화면에 있는 응용프로그램의 표시명입니다.
예
구성 파일(cfg.xml)에서 이 매개 변수를 구성할 수도 있습니다. 다음 형식으로 문자열을 입력합니다.
여기서 n은 소프트키 번호입니다. |
5 |
모든 변경 사항 저장을 클릭합니다. |
회선 키에 XML 애플리케이션 추가
사용자가 서비스에 쉽게 액세스할 수 있도록 자주 사용되는 응용프로그램을 회선 키에 추가합니다.
시작하기 전에
XML 애플리케이션 서비스가 올바르게 구성되었습니다.
1 |
전화기 관리 웹 페이지에 액세스합니다. |
2 |
를 선택합니다. |
3 |
회선 키를 선택합니다. |
4 |
내선 번호를 비활성화하려면 내선 번호 파라미터를 비활성화됨으로 설정합니다. 다이렉트 PLK 구성 기능이 비활성화된 경우 회선 키에 확장 기능을 추가하려면 내선 번호를 비활성화해야 합니다. 기능이 활성화된 경우 이 단계를 건너뛸 수 있습니다. 자세한 내용은 다이렉트 PLK 구성 활성화를 참조하십시오. |
5 |
확장된 기능 파라미터에서 다음 형식으로 문자열을 입력합니다. fnc=xml;url=<xml_app_path>;nme=<app_name>
여기서 url은 XML 응용프로그램이 저장된 링크입니다. nme는 전화 화면에 있는 응용프로그램의 표시명입니다.
예
구성 파일(cfg.xml)에서 이 매개 변수를 구성할 수도 있습니다. 다음 형식으로 문자열을 입력합니다.
여기서 n은 내선 번호입니다. |
6 |
모든 변경 사항 저장을 클릭합니다. |
XML URL에서 지원되는 매크로 변수
XML URL에서 매크로 변수를 사용할 수 있습니다. 다음 매크로 변수가 지원됩니다.
-
사용자 ID—UID1, UID2 - UIDn
-
표시명—DISPLAYNAME1, DISPLAYNAME2 - DISPLAYNAMEn
-
인증 ID—AUTHID1, AUTHID2 - AUTHIDn
-
프록시—PROXY1, PROXY2 to PROXY
-
소문자 16진수를 사용하는 MAC 주소—MA
-
제품 이름—PN
-
제품 일련 번호—PSN
-
시리얼 번호—SERIAL_NUMBER
매크로 이름 | 매크로 확장 |
---|---|
$ | $$ 형식은 단일 $ 문자로 확장됩니다. |
A ~ P까지 | 일반 목적 파라미터 GPP_A ~ GPP_P로 대체됩니다. |
SD를 통한 SA | 특수 목적 매개 변수 GPP_SA ~ GPP_SD로 대체됩니다. 이러한 매개 변수는 프로비저닝에 사용되는 보류 키 또는 암호입니다. $SA ~ $SD는 선택적 재동기화 URL 자격 증명, --key에 대한 인수로 인식됩니다. |
MA | 소문자 16진수를 사용하는 MAC 주소(000e08aabbcc)입니다. |
MAU | 대문자 16진수를 사용하는 MAC 주소(000E08AABBCC)입니다. |
맥 | 16진수 쌍을 구분하기 위해 콜론이 있는 소문자 16진수를 사용하는 MAC 주소(00:0e:08:aa:bb:cc). |
pn의 | 제품 이름입니다. 예: 비디오 전화기 8875, 데스크 폰 9851. |
PSN은 | 제품 일련 번호. 예: 8875, 9841, 9861 |
주석 | 일련 번호 문자열. 예: 88012BA01234. |
인증서 | SSL 클라이언트 인증서 상태, 설치되었거나 설치되지 않았습니다. |
IP | 로컬 서브넷 내 전화기의 IP 주소(예: 192.168.1.100). |
extip를 | 인터넷에 표시된 전화기의 외부 IP입니다. 예: 66.43.16.52. |
swver는 |
소프트웨어 버전 문자열입니다. 예: 전화 번호 3-2-1-0104-37 |
hwver는 |
하드웨어 버전 문자열입니다. 예: 2.0.1 |
PRVST는 |
프로비저닝 상태(숫자 문자열): -1 = 명시적 재동기화 요청 0 = 전원 재동기화 1 = 주기적 재동기화 2 = 재동기화 실패, 재시도 시도 |
최고 |
업그레이드 상태(숫자 문자열): 1 = 첫 번째 업그레이드 시도 2 = 업그레이드 실패함, 다시 시도 |
업거 |
이전 업그레이드 시도의 결과 메시지(ERR). 예: http_get 실패함. |
prvtmr은 |
마지막 재동기화 시도 이후의 초. |
upgtmr은 |
마지막 업그레이드 시도 이후의 초. |
regtmr1은 |
회선 1이 SIP 서버에 대한 등록이 손실된 이후 초. |
레트미르2 |
회선 2에서 SIP 서버에 대한 등록이 손실된 이후의 초. |
업그콘드 |
레거시 매크로 이름입니다. |
체계 |
재동기화 또는 업그레이드 URL을 구문 분석한 후에 얻는 파일 액세스 체계(TFTP, HTTP 또는 HTTPS 중 하나)입니다. |
서비스 |
재동기화 또는 업그레이드 URL을 구문 분석한 후에 얻은 요청 대상 서버 호스트 이름입니다. |
서빙 |
재동기화 또는 업그레이드 URL을 구문 분석한 후에 얻는 요청 대상 서버 IP 주소는 DNS 조회를 따르는 것일 수 있습니다. |
포트 |
재동기화 또는 업그레이드 URL을 구문 분석한 후에 얻는 요청 대상 UDP/TCP 포트. |
경로 |
재동기화 또는 업그레이드 URL을 구문 분석한 후에 얻는 요청 대상 파일 경로. |
오류 |
재동기화 또는 업그레이드 시도의 결과 메시지입니다. 결과 syslog 메시지 생성에만 유용합니다. 업그레이드 시도 시 해당 값은 UPGERR 변수에 보존됩니다. |
UIDn |
회선 n 사용자 ID 구성 매개 변수의 내용입니다. |
iscust는 |
단위가 사용자 정의된 경우 값=1이고 그렇지 않으면 0입니다. 사용자 정의 상태는 웹 UI 정보 페이지에서 볼 수 있습니다. |
받는 사람name | 첫 번째 연결된 전화, 벨 울림 또는 착신 전화와 연계된 이름입니다. |
원격 번호 |
첫 번째 연결됨, 벨 울림 또는 착신 전화의 전화 번호입니다. 여러 통화가 있는 경우 발견된 첫 번째 통화와 연결된 데이터가 제공됩니다. |
표시명 | 회선 N 표시 이름 구성 매개 변수의 내용입니다. |
인증 | 회선 N 인증 ID 구성 매개 변수의 내용입니다. |