Приложение А. Описание XML-схемы, используемой для формирования XML-документов

Приложение А.
Описание XML-схемы, используемой для формирования XML-документов

Структура состоит из строк, содержащих элементы и атрибуты, а также их значения. Реквизиты могут быть элементами или атрибутами.

Элемент - составная часть XML-документа, представляющая собой некоторую законченную смысловую единицу. Элемент может содержать один или несколько вложенных элементов и/или атрибутов.

Атрибут представляет собой составную часть элемента, задающую его параметры.

Имена элементов и атрибутов являются регистрозависимыми и должны совпадать с шаблоном XML. В сообщениях атрибуты с одинаковым именем должны иметь один и тот же смысл и структуру. Порядок следования элементов должен совпадать с шаблоном.

Все XML документы должны иметь единственный корневой элемент.

Описание информационных объектов приводится в табличной форме.

Таблица А.1

Код элемента	Содержание элемента	Тип	Формат	Наименование	Дополнительная информация
<наименование элемента>

В таблицах используются следующие обозначения.

В графе "Код элемента" записывается условное обозначение элемента сообщения.

В графе "Содержание элемента" записывается условное обозначение атрибута или другого элемента, входящего в состав элемента.

В графе "Тип" записывается один из символов О, Н, ОА, НА. У. Символы имеют следующий смысл:

О - обязательный реквизит;

Н - необязательный реквизит;

ОА - обязательный атрибут;

НА - необязательный атрибут;

У - условно-обязательный реквизит, может добавляться к указанным выше символам.

Обязательный реквизит - это реквизит, который должен обязательно присутствовать в файле.

Необязательный реквизит - это реквизит, который может как присутствовать, так и отсутствовать в файле.

Обязательный атрибут - это атрибут, который должен обязательно присутствовать в элементе.

Необязательный атрибут - это атрибут, который может как присутствовать, так и отсутствовать в элементе.

Условно-обязательный реквизит - это реквизит, присутствие которого в структуре обусловлено значениями, наличием или отсутствием других реквизитов этой же структуры. В случае выполнения условия присутствия (УП) условно-обязательный реквизит по всем своим свойствам приравнивается к обязательному, а в случае невыполнения - к необязательному.

В графе "Формат" для каждого атрибута указывается символ формата, а вслед за ним в круглых скобках максимальная длина атрибута. Если круглых скобок нет, то длина атрибута произвольна.

Символы формата соответствуют вышеописанным обозначениям:

Т - <текст>;

N - <число>;

D - <дата>;

ID - <идентификатор>;

URI - <универсальный идентификатор ресурса>;

S - <элемент>; составной элемент, описывается отдельно;

SA - <элемент>; составной элемент, содержащий атрибут, описывается после описания основного элемента;

Если значением атрибута является дробное десятичное число, то в графе "Формат" указывается формат его представления в виде N(m.k), где m - максимальное количество знаков в числе, включая целую и дробную часть числа, десятичную точку и знак "-" (минус), а k - число знаков дробной части числа.

Если элемент содержит атомарное значение, то в графе "Формат", после элемента формата указывается символ соответствующего формата.

В графе "Наименование" указывается наименование элемента или атрибута. Если атрибут имеет в рамках данного формата ограниченное количество возможных значений, то в графе "Дополнительная информация" указывается список этих значений.

А.1 Местоположение пользовательского оборудования

Таблица А.2 - Описание корневого элемента

Код элемента	Содержание элемента	Тип	Формат	Наименование	Дополнительная информация
Корневой элемент
presence					Рисунок А.1
	device	O	SA	Содержит информацию о пользовательском оборудовании
	entity	O	URI	Содержит телефонный номер абонента
device					Рисунок А.2
	geopriv	O	S	Содержит данные места нахождения пользовательского оборудования
	devicelD	O	S, URI
	timestamp	O	S, D	Содержит время определения места нахождения пользовательского оборудования в формате ISO 8601 (YYYY-MM-DDThh:mm:sshh)
	id	OA	ID	Уникальный идентификатор
geopriv					Рисунок А.3
	location-info	O	S
location-info					Рисунок А.3
	location	O	S
location					Рисунок А.4
	Point	ОУ	S	Данные места нахождения пользовательского оборудования в виде точки
	Circle	ОУ	S	Данные места нахождения пользовательского оборудования в виде круга
	ArcBand	ОУ	S	Данные места нахождения пользовательского оборудования в виде сектора
	civicAddress	ОУ	S	Адрес установки пользовательского оборудования
Point					Рисунок А.5
	pos	O	S, T(17)	Координаты точки в системе WGS84. Порядок следования
				координат: Долгота, Широта
Circle					Рисунок А.6
	pos	O	S, T(17)	Координаты центра круга в системе WGS84. Порядок следования координат: Долгота, Широта
	radius	O	S, N	Радиус круга, в целых метрах
ArcBand					Рисунок А.7
	pos	O	S, T(17)	Координаты центра сектора в системе WGS84. Порядок следования координат: Долгота, Широта
	innerRadius	O	S, N	Внутренний радиус сектора в целых метрах
	outerRadius	O	S, N	Внешний радиус сектора в целых метрах
	startAngle	O	S, N	Начальный угол сектора в целых градусах
	openingAngle	O	S, N	Угол раскрытия сектора в целых градусах
civicAddress					Рисунок А.8
	HOUSE	УО	S	Адрес установки пользовательского оборудования в формате ФИАС
	HOUSEINT	УО	S, T(36)	Идентификатор интервала домов в формате ФИАС
	LANDMARK	УО	S, T(36)	Идентификатор ориентира в формате ФИАС
	ROOM	УО	S, T(36)	Глобальный уникальный идентификатор помещения в формате ФИАС
	ADDRESSTEXT	H	S,T	Адрес установки пользовательского оборудования в виде строки
HOUSE					Рисунок А.9
	HOUSEGUID	O	S, T(36)	Идентификатор дома в формате ФИАС
	ENTRANCE	H	SST	Номер подъезда
	LEVEL	H	S,T	Номер этажа
	ROOM	H	S,T	Номер квартиры

Рисунок А.1 - Общая структура XML-документа, содержащего данные места нахождения пользовательского оборудования

Рисунок А.2 - Структура XML-документа, содержащего информацию о пользовательском оборудовании и данные места нахождения пользовательского оборудования

Рисунок А.3 - Вложенные структуры XML-документа, содержащего данные места нахождения пользовательского оборудования

Рисунок А.4 - Возможные варианты представления данных места нахождения пользовательского оборудования в XML-документе

Рисунок А.5 - Структура XML-документа, содержащего представление места нахождения пользовательского оборудования в виде точки

Рисунок А.6 - Структура XML-документа, содержащего представление места нахождения пользовательского оборудования в виде круга

Рисунок А.7 - Структура XML-документа, содержащего представление места нахождения пользовательского оборудования в виде сектора

Рисунок А.8 - Представление информации о месте установки пользовательского оборудования в виде адресного объекта в формате ФИАС

Рисунок А.9 - Структура XML-документа, содержащего представление информации о месте установки пользовательского оборудования в виде адресного объекта "HOUSE" с дополнительной информацией

А.2 Дополнительная информация, необходимая для реагирования

Таблица А.3

Код элемента	Содержание элемента	Тип	Формат	Наименование	Дополнительная информация
Корневой элемент
Abonentlnfo				Содержит дополнительную информацию, необходимую для реагирования	Рисунок А.10
	person	УО	S	Дополнительная информация абонента физического лица
	organization	УО	S	Дополнительная информация абонента юридического лица
person				Дополнительная информация абонента физического лица	Рисунок А.11
	name	H	S,T	Имя абонента
	secondName	H	S,T	Отчество абонента
	surname	H	S,T	Фамилия абонента
	address	H	S,T	Адрес регистрации абонента
	birthDate	H	S,D	Дата рождения абонента
organization					Рисунок А.12
	name	H	S,T	Название абонента юридического лица
	address	H	S,T	Адрес регистрации абонента юридического лица

Рисунок А.10 - Структура XML-документа, содержащего дополнительную информацию

Рисунок А.11 - Структура XML-документа, содержащего информацию об абоненте физическом лице

Рисунок А.12 - Структура XML-документа, содержащего информацию об абоненте юридическом лице

А.3 Структура ответа ИС оператора связи на запрос о месте нахождения пользовательского оборудования

Таблица А.4

Код элемента	Содержание элемента	Тип	Формат	Наименование	Дополнительная информация
Корневой элемент
response					Рисунок А.13
	resultCode	О	S, N	Результат обработки запроса информационной системой оператора связи
	resultDescription	О	S, T	Описание ошибки в случае невозможности предоставить информацию о месте нахождения абонентской станции
	presence	H	S	Данные местоположения мобильного терминала или адрес установки телефонного аппарата	Описание элемента приведено в подразделе А.1
	Abonentlnfo	H	S	Дополнительная информация, необходимая для реагирования	Описание элемента приведено в подразделе А.2

Рисунок А.13 - Структура XML-документа, содержащего ответ от ИС оператора связи