Документация COREmanager

Описание структуры XML

 

COREmanager активно использует формат XML, как для взаимодействия с внешними приложениями, так и для передачи данных внутри системы. Очень часто возникает необходимость объединить несколько XML документов в один. Например, это происходит, если вы добавляете в панель свои XML файлы при написании плагинов. Для описания правил, по которым объединяются различные XML, был создан специальный файл — описывающий алгоритм слияния файлов. Объединятся не только узлы различных XML, если XML документ содержит узлы с одинаковым набором ключевых атрибутов, они тоже будут объеденены согласно правилам.

Файлы, описывающие правила должны быть расположены в каталоге /usr/local/mgr5/xmlschema/

Вот небольшая часть этих правил (полностью их можно посмотреть в указанном каталоге):

<?xml version="1.0" encoding="utf-8"?>
<schema xmlns="http://www.w3.org/1999/xhtml" xmlns:isp="http://ispsystem.com/schema">
  <metadata key="name" merge="xml" top="yes">
    <include key="name" merge="replace"/>
    <toolbar merge="xml">
      <toolsep merge="no"/>
      <toolbtn key="name" merge="xml" share="toolbtn">
        <show key="name value" merge="replace"/>
        <hide key="name value" merge="replace" share="toolbtn_hide"/>
      </toolbtn>
      <toolgrp key="name" merge="xml">
	 <isp:include name="toolbtn"/>
      </toolgrp>
    </toolbar>
</schema>

Внутри коренного узла schema располагаются узлы с теми же именами, которые используются в наших XML файлах. Атрибуты этих узлов задают правила, по которым они объединяются при объединении XML документов:

атрибут key задает перечень ключевых атрибутов (через пробел может быть перечислено несколько имен). Узлы с таким именем и совпадающими значениями ключевых атрибутов будут объеденены. В результате получается элемент имеющий объединенный набор атрибутов и дочерних элементов. Узлы добавляемые позже имеют приоритет. Например, при объединении следующих узлов с ключевым атрибутом @name, значение атрибута @value будет равно second, так как элемент с этим значением встретился позднее:

<toolbtn name="test" value="first"/>
<toolbtn name="test" value="second"/>

атрибут merge задает тип объединения. Возможные значения:

  • ignore — не объединять узлы с таким именем (атрибут @key в данном случае не анализируется). Такие узлы вставляются в результирующий XML документ без изменений.
  • no — не объединять узлы с таким именем (атрибут @key в данном случае не анализируется). Но, в отличии от ignore, дочерние узлы будут просмотрены и объеденены, если это необходимо.
  • text — объединить содержимое узлов. При объединении содержиммое дочерних узлов просто добавляется к уже существующим. Атрибуты так же объединяются.
  • replace — заменять узлы. Узлы встретившиеся в XML документе последними будут полностью заменять предыдущие версии.
  • xml — объединить. Будут объеденены значения атрибутов и содержимое узлов. Все дочерние текстовые узлы будут удалены.

атрибут root если его значение "yes". Элемент с таким именем может быть корневым узлом XML документа

атрибут share указывает на то, что данное правило может быть использовано позднее в другом контексте при помощи служебного узла isp:include

элемент isp include добавляет в текущий контекст правила помеченные как @share. В атрибуте @name данного узла необходимо указать значение, которое было использовано для атрибута @share. Элемент с соответствующим атрибутом @share должен быть расположен в XML раньше, чем его использование при помощи isp:include