XML súbor má nasledujúcu štruktúru:

Poznámka: Informácia o kódovaní dát a CVS tagy nie sú povinné.

Kódovanie dát


Ak XML súbor obsahuje informáciu o kódovaní, musí sa v ňom nachádzať práve raz a to hneď na jeho začiatku. Pred touto informáciou nie sú povolené ani prázdne znaky.

Dáta XML súboru sú v kódovaní:

  • windows-1250
    • ak obsahuje informáciu o kódovaní v tvare <?xml version="1.0" encoding="windows-1250"?>,
    • alebo neobsahuje informáciu o kódovaní a na začiatku súboru sa nenachádza BOM pre utf-8
  • utf-8
    • ak obsahuje informáciu o kódovaní v tvare <?xml version="1.0" encoding="utf-8"?>,
    • alebo neobsahuje informáciu o kódovaní a na začiatku súboru sa nachádza BOM pre utf-8

Poznámka: BOM (Byte Order Mark) pre utf-8 je postupnosť znakov (hexa) EF, BB, BF na začiatku súboru. Tieto znaky nie sú viditeľné pri zobrazení textu.

Upozornenie: Pokiaľ užívateľ ručne prepíše typ kódovania v hlavičke XML súboru, hoci obsah súboru je zakódovaný inak, vystavuje sa riziku, že budú problémy s čítaním znakov s diakritikou!

CVS tagy


CVS tagy sa po exporte objektu do XML súboru v dátach:

  • nenachádzajú, ak bol objekt exportovaný nižšou verziou systému D2000 ako V7.02.011.
  • nachádzajú bez hodnôt, ak bol exportovaný objekt s nedefinovanými hodnotami CVS atribútov.
  • nachádzajú s hodnotami, ak bol exportovaný objekt s definovanými hodnotami CVS atribútov.

Príklad bez hodnôt: <!--$Date $ $Revision $ $Author $ $ExpSubDir $-->
Príklad s hodnotami: <!--$Date: 2009/10/07 14:19:07 $ $Revision: 1.2 $ $Author: jstafen $ $ExpSubDir: Common\Planner $-->

Hodnoty CVS tagov predstavujú CVS informácie o:

  • verzii objektu - hodnota tagu CVS Revision
  • dátume tejto verzie - hodnota tagu CVS Date
  • autorovi tejto verzie - hodnota tagu CVS Author

Ak sa CVS tagy v XML súbore nenachádzajú, môžu byť pridané ručne, ale len v tvare bez hodnôt!
Akékoľvek iné ručné zásahy do CVS tagov sú neprípustné a narušujú funkčnosť XML Repository.

Posledný tag ExpSubDir nie je CVS tagom. V tomto tagu je uchovaný parameter "Exportovací podadresár" daného objektu. Hodnota tohto tagu naplní výlučne XML Export.

Využitie CVS tagov je bližšie popísané v XML Repository.

Štruktúra XML dát


Dáta XML súboru sú obalené v koreňovom <ROOT> elemente, pre ktorý platí:

  • musí sa v súbore nachádzať práve raz (je povinný)
  • jeho vynechanie má za následok neplatnosť dát
  • všetky ostatné elementy sú v ňom vnorené

V prvej úrovni vnorenia sú XML dáta rozdelené do rezervovaných sekcií, pre ktoré platí:

Rezervované sekcie sa podľa ďalšieho vnárania delia na:

  • rezervované sekcie REFERENCES, CFGRECORDS a OBJLIFELOGS, ktoré obsahujú vnorené štruktúry s hodnotami atribútov
  • rezervované sekcie MEMBEROFLOGGROUP a MEMBEROFRESGROUP, ktoré obsahujú hodnoty umiestnené v pomocných member elementoch
  • rezervovaná sekcia CRC, ktorá obsahuje priamo CRC hodnotu

Popis obsahu jednotlivých sekcií je v špecifikácii XML dát.

Okrem uvedených rezervovaných sekcií sa môžu v dátach XML súboru vyskytovať aj užívateľom nadefinované sekcie. Ich poradie a vnáranie je voliteľné. Ich názov nesmie byť zhodný s názvom rezervovaných sekcií. Tieto voliteľné sekcie však nie sú súčasťou spracovania XML dát a ich význam môže spočívať v dodatočnom riadení iných funkcií pre programátora alebo užívateľa.

Súčasne platí, že ak v rámci spracovania rezervovaných sekcií bude identifikovaný neznámy element, ktorý do rezervovanej sekcie alebo vnorenej štruktúry tejto sekcie nepatrí, objaví sa varovanie.
V rezervovaných sekciách môžu existovať iba jednoduché neznáme elementy, čo znamená, že neznámy element, vyskytujúci sa v rezervovanej sekcii, nesmie obsahovať vnorené elementy.

Write a comment...