- 홈
- /
- 문서
9800 및 8875 휴대폰용 XML 애플리케이션 구성 (브로드웍스)
이 도움말 문서는 시스코 브로드웍스에 등록된 시스코 데스크 폰 9800 시리즈와 시스코 비디오 폰 8875에 적용돼요.지원되는 XML 객체, URI 및 전화 웹 페이지의 XSI 서비스 구성 단계에 대해서는 이 문서를 읽어보세요.
개요
XML 서비스 인터페이스 (XSI) 는 애플리케이션과 전화 시스템 간의 통신을 가능하게 하는 프로토콜이에요. 지원되는 XML 객체와 URI를 사용하여 휴대폰에 XSI 서비스를 추가할 수 있어요.
전화를 서비스에 가입한 후 사용자는 액세스할 수 있어요. 시스코 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) 에 추가되는 문자열의 구문을 정의해요.
|
파라미터 |
기본값 및 옵션 |
설명 |
|---|---|---|
|
XML 응용 프로그램 서비스 이름 |
기본값: 비어 있어요 |
XML 응용 프로그램 이름이에요. 이름은 전화기에 웹 애플리케이션 선택으로 표시돼요. 다음 형식으로 문자열을 입력하여 전화 구성 XML 파일 (cfg.xml) 에서 이 매개변수를 구성할 수도 있어요.
|
|
XML 응용 프로그램 서비스 URL |
기본값: 비어 있어요 |
XML 응용 프로그램이 있는 URL이에요. 다음 형식으로 문자열을 입력하여 전화 구성 XML 파일 (cfg.xml) 에서 이 매개변수를 구성할 수도 있어요.
매크로 변수는 XML URL에서 지원돼요. 유효한 매크로 변수는 XML URL에서 지원되는 매크로 변수를 참조하세요. URL에서 HTTP 또는 HTTPS 프로토콜만 지원돼요. |
|
XML 사용자 이름 |
기본값: 비어 있어요 |
인증을 위한 XML 서비스 사용자 이름이에요. 다음 형식으로 문자열을 입력하여 전화 구성 XML 파일 (cfg.xml) 에서 이 매개변수를 구성할 수도 있어요.
|
|
XML 비밀번호 |
기본값: 비어 있어요 |
지정된 XML 사용자 이름의 XML 서비스 암호예요. 이 필드에 입력한 비밀번호는 구성 파일 (cfg.xml) 에 다음과 같이 표시돼요.
|
|
시스코 XML EXE 활성화 |
기본값: 아니요 옵션: 네, 아니요 |
XML 애플리케이션 서버에 액세스하는 데 인증이 필요한지 여부를 지정합니다. 다음 형식으로 문자열을 입력하여 전화 구성 XML 파일 (cfg.xml) 에서 이 매개변수를 구성할 수도 있어요.
|
|
시스코 XML EXE 인증 모드 |
기본값: 로컬 자격 증명 옵션: 신뢰, 로컬 자격 증명, 원격 자격 증명 |
시스코 XML EXE의 인증 모드를 지정해요.
다음 형식으로 문자열을 입력하여 전화 구성 XML 파일 (cfg.xml) 에서 이 매개변수를 구성할 수도 있어요.
|
소프트키에 XML 응용 프로그램 추가
사용자들이 서비스에 쉽게 접근할 수 있도록 자주 사용하는 애플리케이션을 소프트키에 추가해요.
시작하기 전에
XML 애플리케이션 서비스가 제대로 구성됐어요.
| 1 |
전화 관리 웹페이지에 접속해요. |
| 2 |
. |
| 3 |
프로그래밍 가능한 소프트키 섹션에서 프로그래밍 가능한 소프트키 활성화를 Yes로 설정하세요. 구성 파일 (cfg.xml) 에서도 이 매개변수를 구성할 수 있어요. 다음 형식으로 문자열을 입력하세요:
|
| 4 |
프로그래밍 가능한 소프트키 섹션에서 PSK1에서 PSK16 사이의 사용 가능한 필드를 다음 형식으로 편집하세요. fnc=xml;url=<xml_app_path>;nme=<app_name>
여기서
예
구성 파일 (cfg.xml) 에서도 이 매개변수를 구성할 수 있어요. 다음 형식으로 문자열을 입력하세요:
여기서 n은 소프트키 번호예요. |
| 5 |
변경사항 모두 저장을 클릭해요. |
라인 키에 XML 응용 프로그램 추가해요
사용자들이 서비스에 쉽게 접근할 수 있도록 자주 사용하는 애플리케이션을 라인 키에 추가해요.
시작하기 전에
XML 애플리케이션 서비스가 제대로 구성됐어요.
| 1 |
전화 관리 웹페이지에 접속해요. |
| 2 |
. |
| 3 |
라인 키 선택해요. |
| 4 |
확장 기능을 비활성화하려면 확장 프로그램 매개 변수를 사용 안 함으로 설정하세요. 직접 PLK 구성 기능이 비활성화되면 라인 키에 확장 기능을 추가하려면 확장을 비활성화해야 해요. 기능이 활성화되면 이 단계를 건너뛰어도 돼요. 자세한 내용은 직접 PLK 구성 활성화를 참조하십시오. |
| 5 |
확장 함수 매개변수에 다음 형식으로 문자열을 입력하세요. fnc=xml;url=<xml_app_path>;nme=<app_name>
여기서
예
구성 파일 (cfg.xml) 에서도 이 매개변수를 구성할 수 있어요. 다음 형식으로 문자열을 입력하세요:
여기서 n은 내선 번호예요. |
| 6 |
변경사항 모두 저장을 클릭해요. |
XML URL에서 지원되는 매크로 변수
XML URL에 매크로 변수를 사용할 수 있어요. 다음 매크로 변수가 지원돼요.
-
사용자 ID—UID1, UID2에서 UIDN으로
-
디스플레이 이름 - 디스플레이 이름 1, 디스플레이 이름으로 DISPLAYNAME2
-
인증 ID—AUTHID1, AUTHID2 - 인증 IDN
-
프록시—프록시1, PROXY2 대 프록신
-
소문자 16진수를 사용한 MAC 주소—MA
-
제품 이름—PN
-
제품 시리즈 번호—PSN
-
일련번호—일련_번호
| 매크로 이름 | 매크로 확장 |
|---|---|
| $ | $$ 형식은 단일 $ 문자로 확장돼요. |
| A부터 P까지 | 범용 매개변수 GPP_A~GPP_P로 대체됐어요. |
| SA부터 SD까지 | GPP_SA에서 GPP_SD까지의 특수 목적 매개변수로 대체됐어요. 이
매개변수에는 프로비저닝에 사용되는 키나 암호가 들어 있어요. $SA~$SD는 선택적 재동기화 URL 한정자 --key에 대한 인수로 인식돼요. |
| MA | 소문자 16진수 (000e08aabbcc) 를 사용하는 MAC 주소. |
| MAU | 대문자 16진수를 사용한 MAC 주소 (000E08AABBCC). |
| MAC | 16진수 쌍을 구분하기 위해 콜론과 함께 소문자 16진수를 사용하는 MAC 주소 (00:0 e:08:aa:bb:cc). |
| PN | 제품 이름; 예를 들면, 비디오 폰 8875, 탁상 전화 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 |
이전 업그레이드 시도의 결과 메시지 (오류), 예를 들어 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 구성 매개변수의 내용이에요. |