메시지 레이아웃(Message Layout) 정의

넥사크로 프로토콜 어댑터에서 사용되는 메시지 레이아웃 정의 파일에 관해서 설명합니다.

넥사크로 클라이언트에 메시지를 전달하기 위해 메시지의 포맷을 정의해야 합니다. 정의된 layout에 따라 메시지를 공급하고 넥사크로 클라이언트에서는 수신한 메시지를 처리해야 합니다.

Message Layout 정의 파일

Message Layout을 XML 파일에 정의합니다. Message Layout 정의 파일은 하나 이상의 메시지를 기술하고 있습니다. 메시지는 그 구조를 필드 단위로 기술하고 이를 데이터셋에 바인딩할 때 사용합니다. 즉, 넥사크로 프로토콜 어댑터가 X-PUSH 메시지를 데이터셋에 바인딩할 때, 필드 ID와 같은 컬럼 ID의 값을 변경합니다.

Message Layout 정의 파일의 예는 다음과 같습니다.

<?xml version="1.0" encoding="utf-8"?>
<message_layout>
	<message type="Type1">
		<field id="column1" type="string" size="9" key="true"/>
		<field id="column2" type="long" size="12"/>
	</message>
	<message type="Type2">
		<field id="column1" type="string" size="9" key="true"/>
		<field id="column2" type="long" size="12"/>
	</message>
</message_layout>

각 element와 attribute의 의미는 다음과 같습니다.

Element 이름

Attribute 명

설명

message

type

메시지 타입. 메시지 타입은 메시지의 성격이나 그룹으로 생각하면 됩니다. 예를 들어 현재시가, 공시사항, 뉴스 등 각 메시지의 성격에 맞게 정의할 수 있습니다. 반드시 4byte여야 합니다.

field

id

필드의 ID

데이터셋의 같은 칼럼 ID에 바인딩됩니다.

type

필드의 type

데이터셋의 칼럼 type과 같은 의미를 가집니다.

size

필드의 사이즈

key

Key가 되는 필드의 경우, 이 속성을 "true"로 설정합니다.

바인딩 되는 데이터셋의 키가 되는 칼럼을 지정하는 것입니다.

check

X-PUSH 서버로부터 받은 데이터를 데이터셋에 반영할지를 판단하는 필드인 경우에 "true"로 설정합니다.

기본값은 "false"입니다.

프로토콜 어댑터 속성

정의한 Message Layout 정의 파일의 위치와 이름을 X-PUSH 프로토콜 어댑터 속성으로 설정합니다.

넥사크로 스튜디오 프로토콜 설정에서 다음과 같은 방법으로 등록합니다.

layouturl 속성에 정의된 파일이 없거나, 잘못되었을 경우, 넥사크로 클라이언트 스크립트의 command가 작동하지 않습니다.