개요

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

전화기에서 서비스에 가입한 후 사용자는 설정 >네트워크 및 서비스 > Cisco XML 서비스로 이동하여 전화기에 구성된 모든 서비스에 액세스할 수 있습니다. 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 서비스 섹션에 있는 XML 애플리케이션 매개 변수의 기능과 사용법을 정의합니다. 또한 전화기 구성 파일(cfg.xml)에 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 에서 지원되는 매크로 변수를 참조하세요.

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

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 파일(cfg.xml)에서 이 매개 변수를 구성할 수도 있습니다.

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

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

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

시작하기 전에

XML Application Service가 제대로 구성되었습니다.

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<구성 코드></PSK_n>

여기서 n 은 소프트키 번호입니다.

5

모든 변경 사항 저장을 클릭합니다.

회선 키에 XML 애플리케이션 추가

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

시작하기 전에

XML Application Service가 제대로 구성되었습니다.

1

전화기 관리 웹페이지 액세스.

2

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

3

회선 키를 선택합니다.

4

내선 번호 파라미터를 비활성화됨으로 설정하여 내선 번호를 비활성화합니다.

[직접 PLK 설정] 기능이 비활성화된 경우, 회선 키에 확장 기능을 추가하려면 내선 번호를 비활성화해야 합니다. 이 기능이 활성화된 경우, 이 단계를 건너뛸 수 있습니다. 자세한 내용은 Direct 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_>

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

표 2. 지원되는 매크로
매크로 이름매크로 확장
$$$ 형식은 단일 $ 문자를 확장합니다.
A~P일반 목적 매개변수 GPP_A ~ GPP_P로 대체됩니다.
SA ~ SD특수 목적 매개변수 GPP_SA ~ GPP_SD로 대체됩니다. 프로비저닝에서 사용되는 이러한 매개변수 보류 키 또는 암호입니다.
$SA ~ $SD는 선택 사항 URL 재동기화 한정자 --key로 간주됩니다.
MA소문자 16진수를 사용하는 MAC 주소(000e08aabbcc)입니다.
MAU대문자 16진수를 사용하는 MAC 주소(000E08AABBCC)입니다.
MAC16진수 쌍을 구분하기 위한 콜론과 소문자 16진수를 사용하는 MAC 주소(00:0e:08:aa:bb:cc)입니다.
PN제품 이름; 예를 들어 Video Phone 8875, Desk Phone 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

이전 업그레이드 시도의 결과 메시지(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 구성 매개변수의 내용입니다.