TestCase3

$ cd $TXSCHEMA/src/test_cases/squash/testcase3

The output TempData_1.xml is the output of squash; it is known as the Temporal Data document. This is the document that later gets passed to the TemporalValidator tool. Opening this document will reveal over 300 lines data formatted with time varying (tv) and rep (rep) tags..

After xmllint completes, the last line printed to standard output should read:

We can now perform some sanity checks to make sure everything is working correctly. (Note: the following is not required for squash to run; it is simply included here for completeness.)

• Verify that the Temporal Bundle is formatted properly (i.e., validates against the Temporal Bundle Schema):

• Verify that the Temporal Annotation is formatted properly:

• Verify that the Physical Annotation is formatted properly:

• Verify that the Configuration file is formatted properly:

As the ls shows us, a set of input files has already been created. These are the files that the user creates; they are:

• The Configuration File document that is the actual input into squash; it references the Temporal Bundle and the Non-Temporal Data documents (config.xml)

This tutorial describes how to run one of the more complicated test cases that comes with the standard distribution.

Scenario: We have created some documents that keep track of our company. We keep track of suppliers and products. Over time, we make refinements to our list of suppliers and products. In total, we have changed our database (i.e., XML file) 10 times, and thus have 10 versions of the same file.

We can now perform some sanity checks to make sure everything is working correctly. (Note: the following is not required for squash to work correctly; it is simply included here for completeness.)

At this point, if all has gone according to plan, everything is setup correctly and we are ready to run.

Running Squash

To run squash:

$ squash config.xml

The result will be a few new files in the current directory.

Viewing output

The output TempData_1.xml is the output of squash; it is known as the Temporal Data document. This is the document that later gets passed to the TemporalValidator tool.

You will also notice a couple of other new files with the prefix "TempData"; these are mostly debugging output and are not as important as the file mentioned above. Future versions of tXSchema may no longer output these files.

Back to the Tutorials index.

As the ls shows us, a set of input files have already been created. These are the files that the user creates; they are:

• The Physical Annotation document that describes where the timestamps will be placed (company_phy_anno.xml)

• The Configuration Filedocument that is the actual input into squash; it references the Temporal Bundle and the Non-Temporal Data documents (config.xml)

We can now perform some sanity checks to make sure everything is working correctly.

• Verify that the Temporal Bundle is formatted correctly (i.e., validates against the Temporal Bundle Schema):

$ xmllint --schema ../../../../etc/TBSchema.xsd company_bundle.xml

The last line printed to standard output should read:

company_bundle.xml validates

• Verify that the Temporal Annotation is formatted correctly:

$ xmllint --schema ../../../../etc/TXSchema.xsd company_temp_anno.xml

• Verify that the Physical Annotation is formatted correctly:

$ xmllint --schema ../../../../etc/PXSchema.xsd company_phy_anno.xml

• Verify that the Configuration file is formatted correctly:

$ xmllint --schema ../../../../etc/ConfigSchema.xsd config.xml

Running Squash

Let's navigate to the test directory in question.

$ cd $TXSCHEMA/src/test_cases/squash/testcase2

As the ls shows us, a set of input files have already been created. These are the files that the user will normally create; they are:

• The Snapshot Schema document that describes the company*.xml files (company.xsd)
• The Temporal Annotation document that describes how the data changes (company_temp_anno.xml)
• The 'Physical Annotation document that describes where the timestamps will be placed (company_phy_anno.xml)

• The Temporary Bundle document that simply lists the Snapshot Schema, Temporal Annotation, and Physical Annotation documents (company_bundle.xml)

CVS/ company2.xml company7.xml company_temp_anno.xml company.xml company3.xml company8.xml config.xml company.xsd company4.xml company9.xml company0.xml company5.xml company_bundle.xml company1.xml company6.xml company_phy_anno.xml

Just as we did in the first tutorial, let's assume that we have created:

• the Snapshot Schema document that describes the company*.xml files (company.xsd)
• the Temporal Annotation document that describes how the data changes (company_temp_anno.xml)
• the 'Physical Annotation document that describes where the timestamps will be placed (company_phy_anno.xml)
• The Non-Temporal Data files that hold the actual versioned data (company*.xml)

Scenario: We have created some documents that keep track of our small company (which is named "Company"). We keep track of suppliers and products. We have changed our database (i.e., XML file) 10 times, and thus have 10 versions of the same file.

$ cd src/test_cases/squash/testcase2

CVS/ company_tv.xml company.xml company_tv_102_10_10_102_10_11.xml company.xsd company_tv_102_10_11_102_10_12.xml company0.xml company_tv_102_10_12_102_10_13.xml company1.xml company_tv_102_10_13_102_10_14.xml company2.xml company_tv_102_10_14_102_10_15.xml company3.xml company_tv_102_10_15_102_10_16.xml company4.xml company_tv_102_10_16_102_10_17.xml company5.xml company_tv_102_10_17_102_10_18.xml company6.xml company_tv_102_10_18_102_10_19.xml company7.xml company_tv_102_10_19_102_10_21.xml company8.xml config.xml company9.xml snapshot.xml company_bundle.xml snapshot2002-11-10.xml company_bundle.xml.orig testcase_tv.xml company_phy_anno.xml testcase_tv_102_10_10_102_10_11.xml company_temp_anno.xml testcase_tv_102_10_11_102_10_12.xml

Note: don't worry if you don't have the CVS directory, as listed above.

This tutorial describes how to run one of the more complicated "test cases" that comes with the standard distribution.

Scenario:

// //

Getting our ducks in a row

Work in progress.

// //

Running Squash

// //

Viewing output

$ ls

@]

Work in progress.

$ cd src/test_cases/squash/testcase3
$ xmllint --schema company.xsd company0.xml