Test machine allow to run all software of the QuiX-Tool Suite (QuiXPath, QuiXSLT, QuiXSchematron) on a remote machine. The QuiX-Proc Team provides comprehensive sample sets that you can adapt to your needs. Moreover, for dealing with your own large XML documents, upload them on the test machine.

How do I get a login?

To request a login, click here.

How to connect to the server?

To connect to ‘links-xml-streaming’ server you must first ssh to ‘links-xml-streaming.lille.inria.fr’

> ssh sshLogin@links-xml-streaming.lille.inria.fr

How to check that you are in your own folder?


>pwd
/home/sshLogin


How to execute QuiXPath ?

The quixpath executable must be invoke with two parameters: an xpath query and a xml file. Its result is the annotated stream.

In the following example, we run the query //a (select all node labeled by ‘a’) over the document: <a/>


> quixpath //a /share/example.xml
<a></a>


The quixpath executable must be invoke with two parameters: the query, the input document. The stepByStep option alows to see the innerworking of the algorithm.
<query> <input file> [–stepByStep] [–outPutMode subTree|quixEvent]

Troubleshooting:

Problem:
quixpath //a[not(b)] /share/example.xml
syntax error near unexpected token `(‘

Solution:
Protect your query with double quotes
quixpath “//a[not(b)]” /share/example.xml

How to execute QuiXSLT ?

The quixslt executable must be invoke with three parameters: the stylesheet, the input document and the output document:
<stylesheet> [<input file> [<output file>]]

In the following example, we run the xslt sheet that finds all the a-node over the document: <a/>

> quixslt /share/xslt/findA.xslt /share/example.xml
 <?xml version="1.0" encoding="UTF-8"?><template xmlns="">
  find a
 </template>
> less /share/xslt/findA.xslt
<?xml version="1.0"?>
 <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:template match="/">
   <template>
    <xsl:for-each select="a">
     find a
    </xsl:for-each>
   </template>
  </xsl:template>
</xsl:stylesheet>


How to execute XFun

The xfunexecutable must be invoke with three parameters: the stylesheet, the input document and the output document:
<xfun program> [<input file> [<output file>]]

In the following example, we run an xfun program that finds all the a-node over the document: <a/>


> xfun /share/xfun/findA.xfun /share/example.xml
Find an a-node.
> less /share/xfun/findA.xfun
<?xml version="1.0" encoding="UTF-8"?>
<xfun xmlns="http://x-fun.lille.inria.fr">
  <for xmlns=""
  node="context"
  from="root"
  select="descendant-or-self::a">
   <text>Find an a-node.</text>
  </for>
</xfun>


How to execute QuiXSchematron

The quixschematron executable must be invoke with two parameters:
<schema> <document>

In the following example, we run an schema that ckecks the structure of a list of persons.


> quixschematron /share/schematron/dataStructure.sch /share/listOfPersons.xml
The number of children should be more than 2: /list[1]/Person[1]
The person must have an Id attribute: /list[1]/Person[2]
The Name of Person should not be empty: /list[1]/Person[2]
The first child of a Persone should be a Name: /list[1]/Person[3]
The Name of Person should not be empty: /list[1]/Person[4]
The person must have an Id attribute: /list[1]/Person[7]
The first child of a Persone should be a Name: /list[1]/Person[7]
The Name of Person should not be empty: /list[1]/Person[7]


Two option are available: –numbering numbers the output message while –progress <frequence > outputs the ‘#’ symbol each frequence events.


>quixschematron --numbering --progress 50 /share/schematron/dataStructure.sch /share/listOfPersons.xml
1: The number of children should be more than 2: /list[1]/Person[1]
#
#
2: The person must have an Id attribute: /list[1]/Person[2]
3: The Name of Person should not be empty: /list[1]/Person[2]
#
4: The first child of a Persone should be a Name: /list[1]/Person[3]
#
5: The Name of Person should not be empty: /list[1]/Person[4]
#
#
#
6: The person must have an Id attribute: /list[1]/Person[7]
7: The first child of a Persone should be a Name: /list[1]/Person[7]
8: The Name of Person should not be empty: /list[1]/Person[7]


How to upload your own XML file?

The links-xml-streaming server supports SCP only. scp stands for secure cp (copy), which means that you can copy files across an ssh connection that will be encrypted.


> scp myDoc.xml $user@links-xml-streaming.lille.inria.fr:/home/$user


How to create a small XML file via command line?


> echo “<a><b/></a>” > smallXMLfile.xml


You can also use your favorit editor like vi, vim or emacs.

How do I install unstable releases

For each software of the QuiX Suite, QuiXProc team maintans two releases: stable and unstable. The unstable version in published every day by our automatic build system. The version==unstable option is the way to play with it:

> quixpath --version=unstable //a /share/example.xml
Unstable release of quixpath
START_SEQUENCE;false
START_DOCUMENT ;false
START_ELEMENT a;true
END_ELEMENT a;true
END_DOCUMENT ;false
END_SEQUENCE;false
> quixpath --version=unstable --version
Unstable release of quixpath
QuiXPath version "2_0_0" (build 13_10_07)


How to determine the behavior of my shell?

Edit the .bash_profile file that is on your home directory.