Rozhraní dodacích listů a převodek Lekis XML

XML schéma, dokumentace, příklady, validátory

Seznamy změn a release verze

🟩 Release sekce 🟩 tohoto repository obsahuje označené release verze rozhraní a seznam změn pro každou z těchto verzí.

XML schéma (XSD)

Jde o nejaktuálnější verze XML schématu z vybrané branch tohoto repository. Nemusí odpovídat označeným release verzím rozhraní.

• RozhraniDL-Lekis-XML-v4.xsd (preferováno)
• RozhraniDL-Lekis-XML-v3.xsd
• RozhraniDL-Lekis-XML-v1+v2.xsd

Dokumentace

Adresář Documentation obsahuje skripty pro vygenerování HTML dokumentace výše uvedených XSD souborů pomocí xs3p XSLT transformace s použitím různých XSLT SW. Uvnitř každého skriptu jsou popsány jeho další požadavky.

🟩 Vygenerovaná dokumentace k aktuálním verzím XSD souborů 🟩

Příklady

Několik příkladů je k dispozici v adresáři Examples.

Jsou rozdělené na adresáře pro jednotlivé verze schématu. V každém adresáři jsou dále rozdělené na korektní (Good) a nekorektní (Bad), které neprojdou (a nemají projít) validací pomocí schématu dané verze.

Validátory

Jde o velmi základní validátory příkladových XML souborů, zda odpovídají danému XML schématu. Oba validátory mají v sobě zadané pevné relativní cesty a jsou tedy spustitelné pouze v rámci adresářové struktury tohoto repository. Další omezení validátorů jsou popsána níže.

Validátor NodeJS

Používá libxmljs.

Neumí pracovat se vstupními soubory v jiném kódování než UTF-8. Mezi příklady jsou také vstupní soubory v kódování Windows-1250, ty nebudou validovány správně.

Instalace balíčků a spuštění

Na Windows platformě je nutné umožnit kompilaci nativních částí použitých balíčků. K tomu lze pohodlně použít například balíček windows-build-tools.

npm install --global --production windows-build-tools

Předpokládá se spuštění v kořenovém adresáři daného validátoru.

npm install
node index.js

Validátor .NET

Validátor běží pod .NET 4.5 a používá XML funkčnost .NET frameworku.

Kompilace a spuštění

Lze zkompilovat ve Visual Studio 2015/2017 nebo pomocí command-line nástrojů instalovaných s Visual Studio 2015/2017, případně s .NET Framework prostředím a podobně. Předpokládá se spuštění v kořenovém adresáři daného validátoru.

msbuild.exe XmlSchemaValidator.DotNet.sln /t:Rebuild /p:Configuration=Debug
pushd Bin\Debug
XmlSchemaValidator.DotNet.exe
popd

Užitečný software, odkazy

• xs3p JM verze | přepracovaná verze | původní verze
  • generování dokumentace s dílčími diagramy
• XSD Digram
  • zobrazení diagramu a interaktivní procházení
  • generování diagramu
  • generování dokumentace s dílčími diagramy
• XML Grid online validace
  • validace XML zadaným XSD
• XML Grid online vizualizace
  • zobrazení diagramu a interaktivní procházení (v prohlížeči jako SVG)
• WM Help XmlPad
  • editor, validátor
  • zobrazení diagramu a interaktivní procházení
  • generování dokumentace s dílčími diagramy
  • sice jde o starší SW, ale je zadarmo a umí toho poměrně hodně
• XsdVi
  • zobrazení diagramu a interaktivní procházení (v prohlížeči jako SVG)