개요

XSI(XML Services Interface)는 애플리케이션과 전화기 시스템 간의 통신을 허용하는 프로토콜입니다. 지원되는 XML 개체 및 URI를 사용하여 전화기에 자신의 XSI 서비스를 추가할 수 있습니다.

서비스에 전화기를 가입하면 사용자는 설정 > 네트워크 및 서비스 > Cisco XML 서비스를 탐색하여 전화에서 구성된 모든 서비스에 액세스할 수 있습니다. 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 응용프로그램 파라미터의 기능과 사용법을 정의합니다. 또한 XML 코드를 사용하여 전화기 구성 파일(cfg.xml)에 추가된 문자열의 구문을 정의하여 매개 변수를 구성합니다.

표 1. XML 서비스에 대한 매개 변수

파라미터

기본 및 옵션

설명

XML 애플리케이션 서비스 이름

기본값: 비어 있음

XML 애플리케이션의 이름입니다. 전화기에 웹 애플리케이션 선택으로 이름이 표시됩니다.

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

<XML_Application_Service_Name ua="na">XML 앱 이름</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에서 지원되는 매크로 변수를 참조하십시오.

HTTP 또는 HTTP 프로토콜만 URL에서 지원됩니다.

XML 사용자 이름

기본값: 비어 있음

인증을 위한 XML 서비스 사용자 이름입니다.

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

<XML_User_Name ua="na">사용자 이름</XML_User_Name>

XML 비밀번호

기본값: 비어 있음

지정된 XML 사용자 이름에 대한 XML 서비스 암호입니다.

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

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

CISCO XML EXE 활성화

기본값: 아니요

옵션: 예, 아니요

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

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

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

CISCO XML EXE 인증 모드

기본값: 로컬 자격 증명

옵션: 신뢰할 수 있는, 로컬 자격 증명, 원격 자격 증명

Cisco XML EXE에 대한 인증 모드를 지정합니다.

  • 신뢰할 수 있음 - 로컬 자격 증명과 관계없이 인증이 수행되지 않습니다.

  • 로컬 자격 증명 - 설정된 경우 로컬 자격 증명을 사용하는 다이제스트 인증을 기반으로 인증됩니다. 로컬 자격 증명이 설정되지 않은 경우 인증이 수행되지 않습니다.

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

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

<CISCO_XML_EXE_Auth_Mode ua="na">로컬 자격 증명</CISCO_XML_EXE_Auth_Mode>

소프트키에 XML 애플리케이션 추가

사용자가 서비스에 쉽게 액세스할 수 있도록 자주 사용되는 애플리케이션을 소프트키에 추가합니다.

시작하기 전에

XML 애플리케이션 서비스가 올바르게 구성되었습니다.

1

전화기 관리 웹 페이지에 액세스합니다.

2

음성 > 전화를 선택합니다.

3

프로그래밍 가능한 소프트키 섹션에서 프로그래밍 가능한 소프트키 활성화를 예로 설정합니다.

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

<Programmable_Softkey_Enable ua="na">예</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<configuration code></PSK_n>

여기서 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<configuration code></Extended_Function_n_>

여기서 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

표 2. 지원되는 매크로
매크로 이름매크로 확장
$$$ 형식은 단일 $ 문자로 확장됩니다.
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 구성 매개 변수의 내용입니다.