Форум Сообщества Аналитиков

×


Документирование XML структур(Прочитано 8072 раз)
Добрый день!

Хотел обсудить вопрос описания XML данных в документе ТЗ.

Есть ли у кого-нибудь практический опыт / ссылки на "best practices" - как в документе для широкого круга читателей, таком как ТЗ, в простом и понятном виде описать элементы и атрибуты XML-структуры, при этом отразить вложенность элементов, принадлежность атрибутов конкретному элементу?

Не хочется "изобретать велосипед", если есть какие-нибудь стандартные нотации / шаблоны.



Re: Документирование XML структур Ответ #1 : 11 Мая 2012, 16:12:23
Добрый день.

Изобретать велосипед не надо, но мало ли Вы что-то грандиозное и эффективное придумаете.
Теперь желательно уточнить цели:
- Вам надо описать структуру XML документа? Или что?
 Прошу уточнить что значит "описания XML данных"

Например, есть следующие описания
- Технические требования к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия - сам приказ
- Или Требования к методу передачи данных на яндексе

И еще. Вы в ТЗ хотите закрепить структуру XML? А если что-то измениться. Все по ТЗ систему не сдать?

Почему не написать что-то вроде
При разработке дополнительных адаптеров, внешний поставщик должен соблюдать следующие условия:
- использование XML в качестве описания форматов передаваемых данных

Как урезанный пример -  во вложении - описание в виде таблички.
«Сделай первый шаг, и ты поймешь, что не все так страшно.»
-- L. A. Seneca --



Re: Документирование XML структур Ответ #2 : 11 Мая 2012, 16:55:18
Thyestes, Ваш пример в прикрепленном файле - как раз то что мне нужно: то есть описание элементов определённого XML-документа. Спасибо! Буду ориентироваться на него как на возможный вариант.

А не подскажете, данный табличный формат описания где-то утверждён? Является каким-либо стандартом?
Такой же вопрос по графической нотации в примере - иногда встречаю её в документах, но не нашел - есть ли у неё название и кто её разрабатывает: w3c или кто-то ещё?



Re: Документирование XML структур Ответ #3 : 11 Мая 2012, 17:11:51
Такой же вопрос по графической нотации в примере - иногда встречаю её в документах, но не нашел - есть ли у неё название и кто её разрабатывает: w3c или кто-то ещё?
Вообще это XML Scheme



Re: Документирование XML структур Ответ #4 : 11 Мая 2012, 17:32:28
Вообще это XML Scheme
Вопрос был именно по ГРАФИЧЕСКОЙ нотации для XSD. Нет ли ссылки, где она определена? Спасибо.



Re: Документирование XML структур Ответ #5 : 12 Мая 2012, 12:05:57
По поводу табличного формата описания -  обычно утверждается на уровне министерства.
Например, УТВЕРЖДЕН приказом Роснедвижимости от 28 октября 2008 г. № П/0389

По поводу графической нотации, на счет именно утверждения не могу подсказать, но поищите, например, продукт Altova XMLSpy или другие
«Сделай первый шаг, и ты поймешь, что не все так страшно.»
-- L. A. Seneca --




 

Sitemap 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19