- 홈
- /
- 문서
XML BroadWorks
이 도움말 문서는 Cisco BroadWorks에 등록된 Cisco Desk Phone 9800 시리즈 및 Cisco Video Phone 8875에 적용됩니다. 지원되는 XML 개체, URI 및 전화기 웹 페이지에서 XSI 서비스를 구성하는 단계에 대해서는 이 문서를 참조하십시오.
개요
XSI(XML Services Interface)는 애플리케이션과 전화 시스템 간의 통신을 허용하는 프로토콜입니다. 지원되는 XML 개체 및 URI를 사용하여 전화기에 XSI 서비스를 추가할 수 있습니다.
전화기에서 서비스에 가입한 후 사용자는 설정
. Cisco XML Services가 기본 이름입니다. 이름을 변경할 수도 있습니다. 사용자가 쉽게 액세스할 수 있도록 소프트키 또는 회선 키에 XML 애플리케이션을 추가할 수 있습니다.지원되는 기능은 다음과 같습니다.
- 메시지(이미지 및 텍스트)
- 페이징
지원되는 XML 개체
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIcon파일 메뉴
-
CiscoIPPhoneStatus(9841 제외)
-
CiscoIPPhoneStatusFile(9841 제외)
-
CiscoIPPhoneExecute
지원되는 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 서비스 기능과 사용법을 정의합니다. 또한 전화기 구성 파일(cfg.xml)에 XML 코드로 추가되어 매개 변수를 구성하는 문자열 구문을 정의합니다.
매개변수 |
기본값 및 옵션 |
설명 |
---|---|---|
XML 애플리케이션 서비스 이름 |
기본값: 비어 있음 |
XML 애플리케이션의 이름입니다. 전화기에 웹 애플리케이션 선택으로 이름이 표시됩니다. 다음 형식으로 문자열을 입력하여 구성 XML 파일(cfg.xml)에서 이 매개 변수를 구성할 수도 있습니다.
|
XML 애플리케이션 서비스 URL |
기본값: 비어 있음 |
XML 애플리케이션이 위치하는 URL입니다. 다음 형식으로 문자열을 입력하여 구성 XML 파일(cfg.xml)에서 이 매개 변수를 구성할 수도 있습니다.
매크로 변수는 XML URL에서 지원됩니다. 유효한 매크로 변수는 XML URL 에서 지원되는 매크로 변수를 참조하세요. URL에는 HTTP 또는 HTTP 프로토콜만 지원됩니다. |
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 Application Service가 제대로 구성되었습니다.
1 |
전화기 관리 웹페이지 액세스. |
2 |
를 선택합니다. |
3 |
프로그래밍 가능한 소프트키 섹션에서 프로그래밍 가능한 소프트키 활성화를 예로 설정합니다. 설정 파일(cfg.xml)에서 이 매개 변수를 설정할 수도 있습니다. 문자열을 다음 형식으로 입력합니다.
|
4 |
프로그램 가능 소프트키 섹션에서 PSK1 부터 PSK16 까지의 사용 가능한 필드를 다음 형식으로 편집합니다. fnc=xml;url=<xml_app_path>; NME=<app_name>
여기서
예: 설정 파일(cfg.xml)에서 이 매개 변수를 설정할 수도 있습니다. 문자열을 다음 형식으로 입력합니다.
여기서 n 은 소프트키 번호입니다. |
5 |
모든 변경 사항 저장을 클릭합니다. |
회선 키에 XML 애플리케이션 추가
사용자가 서비스에 쉽게 액세스할 수 있도록 자주 사용하는 애플리케이션을 회선 키에 추가합니다.
시작하기 전에
XML Application Service가 제대로 구성되었습니다.
1 |
전화기 관리 웹페이지 액세스. |
2 |
를 선택합니다. |
3 |
회선 키를 선택합니다. |
4 |
내선 번호 파라미터를 비활성화됨으로 설정하여 내선 번호를 비활성화합니다. [직접 PLK 설정] 기능이 비활성화된 경우, 회선 키에 확장 기능을 추가하려면 내선 번호를 비활성화해야 합니다. 이 기능이 활성화된 경우, 이 단계를 건너뛸 수 있습니다. 자세한 내용은 Direct PLK 구성 사용 설정을 참조하세요. |
5 |
확장 기능 파라미터에 다음 형식으로 문자열을 입력합니다. fnc=xml;url=<xml_app_path>; NME=<app_name>
여기서
예: 설정 파일(cfg.xml)에서 이 매개 변수를 설정할 수도 있습니다. 문자열을 다음 형식으로 입력합니다.
여기서 n은 내선 번호입니다. |
6 |
모든 변경 사항 저장을 클릭합니다. |
XML URL에서 지원되는 매크로 변수
XML URL에서 매크로 변수를 사용할 수 있습니다. 지원되는 매크로 변수는 다음과 같습니다.
-
사용자 ID—UID1, UID2 ~ UIDn
-
표시 이름—DISPLAYNAME1, DISPLAYNAME2 ~ DISPLAYNAMEn
-
인증 ID—AUTHID1, AUTHID2 ~ AUTHIDn
-
프록시—PROXY1, PROXY2 ~ PROXYn
-
소문자 16진수 숫자를 사용하는 MAC 주소—MA
-
제품 이름—PN
-
제품 일련 번호—PSN
-
일련 번호—SERIAL_NUMBER
매크로 이름 | 매크로 확장 |
---|---|
$ | $$ 형식은 단일 $ 문자를 확장합니다. |
A~P | 일반 목적 매개변수 GPP_A ~ GPP_P로 대체됩니다. |
SA ~ SD | 특수 목적 매개변수 GPP_SA ~ GPP_SD로 대체됩니다. 프로비저닝에서 사용되는 이러한 매개변수 보류 키 또는 암호입니다. $SA ~ $SD는 선택 사항 URL 재동기화 한정자 --key로 간주됩니다. |
MA | 소문자 16진수를 사용하는 MAC 주소(000e08aabbcc)입니다. |
MAU | 대문자 16진수를 사용하는 MAC 주소(000E08AABBCC)입니다. |
MAC | 16진수 쌍을 구분하기 위한 콜론과 소문자 16진수를 사용하는 MAC 주소(00:0e:08:aa:bb:cc)입니다. |
PN | 제품 이름; 예를 들어 Video Phone 8875, Desk Phone 9851입니다. |
PSN | 제품 시리즈 번호; 예: 8875, 9841, 9861 |
SN | 일련 번호 문자열입니다. 예: 88012BA01234. |
CCERT | SSL 클라이언트 인증서 상태로 설치되거나 설치되지 않습니다. |
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 |
이전 업그레이드 시도의 결과 메시지(ERR), 예: http_get 실패. |
PRVTMR |
마지막 재동기화 시도 이후의 초. |
UPGTMR |
마지막 업그레이드 시도 이후의 초. |
REGTMR1 |
회선 1이 SIP 서버에서 등록이 해제된 이후의 초. |
REGTMR2 |
회선 2가 SIP 서버에서 등록이 해제된 이후의 초. |
UPGCOND |
레거시 매크로 이름입니다. |
SCHEME |
재동기화 또는 업그레이드 URL을 구문 분석하여 얻는 파일 액세스 체계입니다(TFTP, HTTP 또는 HTTPS 중 하나). |
SERV |
재동기화 또는 업그레이드 URL을 구문 분석하여 얻는 요청 대상 서버 호스트 이름입니다. |
SERVIP |
재동기화 또는 업그레이드 URL을 구문 분석하고 경우에 따라 DNS 조회를 수행한 후 얻는 요청 대상 서버 IP 주소입니다. |
PORT(포트) |
재동기화 또는 업그레이드 URL을 구문 분석하여 얻는 요청 대상 UDP/TCP 포트입니다. |
PATH |
재동기화 또는 업그레이드 URL을 구문 분석하여 얻는 요청 대상 파일 경로입니다. |
ERR |
재동기화 또는 업그레이드 시도의 결과 메시지입니다. 결과 syslog 메시지를 생성하는 데만 유용합니다. 업그레이드 시도의 경우 UPGERR 변수에 값이 유지됩니다. |
UIDn |
회선 n UserID 설정 매개 변수의 내용. |
ISCUST |
장치가 사용자 지정된 경우 값=1, 그렇지 않으면 0입니다. 사용자 정의 상태는 웹 UI 정보 페이지에서 볼 수 있습니다. |
INCOMINGNAME | 처음으로 연결되거나 벨소리가 울리는 중이거나 인바운드 통화와 연결된 이름입니다. |
REMOTENUMBER |
처음으로 연결되거나 벨소리가 울리는 중이거나 인바운드 통화의 전화 번호입니다. 다중 통화의 경우 발견된 첫 번째 통화와 연결된 데이터가 제공됩니다. |
DISPLAYNAMEn | 회선 N 표시 이름 구성 매개변수의 내용입니다. |
AUTHIDn | 회선 N 인증 ID 구성 매개변수의 내용입니다. |