Viz Channel Branding User Guide

Version 5.2 | Published June 05, 2024 ©

XML Translator

XML Translator is a command-line tool for transforming a schedule-file in XML (BXF) format to a format Playlist Importer can import. Content is not changed - the data format is only transformed so the Playlist Importer can process it.

Any third-party can define an XSLT (.xst) transformation to an importer-friendly structure, currently:

  • Ordered collections

  • Two (2) layers deep only

This section covers the following topics:

Using XML Translator

Open a command window (Windows-button+R CMD <enter>) to use the XML translator. If you need admin rights when using the tool, start CMD as Administrator. Next, right-click CMD and select Run as Administrator to start an elevated session. In the following, it is assumed that you have XML translator program in the Windows PATH. If not, you must provide the full path in order to use the tool.

XMLTranslator.exe -SourcePath %path% -DestinationPath %dpath% -SuccessPath %spath% -FailPath %fpath% -TranslationFile %tpath%\XSL.xslt

The example invocation above is on one line. All arguments are required. To get usage instructions, run the program with the help flag (-? or -h or):

XmlTranslator.exe –-help

Program argument definitions:

  • SourcePath the directory that contains the XML file to translate

  • DestinationPath a directory in which the translated XML file is created

  • SuccessPath a directory to which the source XML file is moved when translation succeeds

  • FailPath a directory to which the source XML file is moved if the translation fails

  • TranslationFile path to the XSL file defining the transformations

A typical run (the command must be entered on a single line) could be:

XMLTranslator.exe -SourcePath D:\Source -DestinationPath D:\Destination -SuccessPath D:\Success -FailPath D:\Fail -TranslationFile D:\BroadViewXML.xsl

External References

  • Wikipedia: Extensible Markup Language: XML

  • Wikipedia: Extensible Stylesheet Language Transformations: XSLT

  • Wikipedia: Broadcast Exchange Format: BXF