TableStar | Version 3

TableStar Import: Documentation

The TableStar Import project provides a custom XML schema and library to import TableStar XML via the Sophora Importer.

Archived documentation for Sophora 3. End-of-support date for this version: 7/25/21

Documentation for Sophora 4

XML Schema

The TableStar XML schema describes the XML structure of the TableStar XML for matches and data tables.
The following table leads to the documentation of the different schema versions.

Table Schema VersionDocumentationChanges
1.0https://www.subshell.com/tablestar-import/1.0/index.html-
1.1https://www.subshell.com/tablestar-import/1.1/index.htmlAllows the import of data tables.

Import of matches

Via the import of matches you can add matches to an existing match round in an automated manner. Please see the following examples with explanations for further information.

Examples:

  • https://www.subshell.com/tablestar-import/1.0/matches_example-1_v-1.0.0.xml
  • https://www.subshell.com/tablestar-import/1.0/matches_example-2_v-1.0.0.xml
  • https://www.subshell.com/tablestar-import/1.0/matches_example-3_v-1.0.0.xml

Import of data tables

Via the import of data tables you can replace content rows of an existing data table in an automated manner. Please see the following example with explanations for further information.

Example: https://www.subshell.com/tablestar-import/1.1/data-table_v-1.1.0.xml

The usual work flow would be to prepare a data table document with a data table containing just the header row, e.g.:

ToreNameName [KURZ]VereinVerein [KURZ]

You also have to specify an import ID in the appropriate property on the 'Import' tab of the data table document. The ID must match the ID in the incoming XML in order for the import process to decide which data table contents will be replaced by the incoming content rows.

Installation

For the installation of the Sophora Importer, please visit its appropriate documentation.

In order to use the TableStar schema and transformations you will have to do the following steps:

  • Include the tablestar-import-shaded.jar into your Sophora Importer installation (see sophora.importer.additionalClasspath in the Sophora Importer documentation). The JAR already contains the schema files.
  • Copy the TableStar Import transformation files (xsl folder) to a place of your choice and declare its path in your Sophora Importer instance configuration (see sophora.importer.directory.xsl in the Sophora Importer documentation). The folder structure within the xsl folder must be retained!

Last modified on 3/9/20

The content of this page is licensed under the CC BY 4.0 License. Code samples are licensed under the MIT License.

Icon