Please understand that the Schema Subset Generation Tool (SSGT) is in spiral development. Future enhancements and capabilities are being developed and will be added when they are stable. Therefore, the user interface and some features may change fairly often in subsequent builds. The Schema Subset Generation Tool subsumed the capabilities of the Global JXDM Viewer. Quick links are provided below.
Access the GJXDM Viewer from SSGT by using the Model Viewer link in the upper left corner of the SSGT main page. The Viewer also contains a link to SSGT.
Before using the SSGT you are strongly urged to read this page and the information it points to!
Users should familiarize with both the known issues and the current bug reports . Also, you should refer back to these from time to time as current issues and bugs may change.
There is currently no user manual or help menu for SSGT. If you are not familiar with Global JXDM schema subsets or this tool, we recommend that you review appropriate portions of the Global JXDM Developer's Workshop materials and audio/video streams.
The Global JXDM Schema Subset Tool creates Global JXDM schema subsets based on the previously published rules for schema subsets .
In generating a schema subset, there is one primary, overriding rule:
Instances that validate to a schema subset will validate to the full schema.
The wantlist is the xml file that SSGT uses to record and maintain the state of the user's schema subset. When the user generates a schema subset package (and it is assumed that the user is finished using the SSGT), a wantlist is also generated and saved with the user's work. The wantlist is a specification for the user's schema subset and can be reloaded into SSGT to continue editing. In some cases, the specification for the wantlist itself may be useful and it is provided here:
Although the tests we have performed have been successful, schema subsets generated by SSGT have not been mathematically verified for accuracy. If problems are discovered, this may require revisions or patches fairly often in the near term.
Known bugs exist in the Global JXDM 3.0 schema that the current version of SSGT does NOT replicate in the subsets it generates. Refer to Globa JXDM Bug #570 and Bug #624
Using the back button of your browser can cause the server to behave oddly because the old state is no longer contained on the server. It may seem to jump to the most recent page. As more state tracking is added to the tool this functionality should be improved.
Visit the bug tracking page to view or add bugs. To add bugs you must sign up for an account. The Global JXDM Schema Subset Generation Tool is the project named SSGT. Please check here for existing bugs before entering new ones.
Guidleines for Bug entry - Each bug reported should include the following information (as appropriate):
Guidelines for Feature Request - Each feature suggested should address or provide the following (as appropriate):
We define three types of feedback reports:
Before submitting a bug, feature, or UI report, please review (or search) the following so you do not duplicate reports of known bugs or planned functions:
Please use the feedback site. Reports will not be accepted by telephone or email. However, GTRI may need to contact submitters via email or telephone for clarifications or further discussion as necessary.
Prereleases of Global JXDM are NOT supported (i.e. versions 3.0.0.0, 3.0.0.1, and 3.0.0.3). Reports submitted that refer or apply to the use of prereleases will not be considered.
The SSGT is built on current W3C standards for HTML, XHTML, XML, XSL, etc. Do NOT submit bug reports or suggest features that would require the use of non-standard or deprecated browser capabilities (for example, capabilities that are only supported by a single vendor).
Feedback submitters must ensure that they have applied all the latest service packs and security patches/fixes for their operating system and browser. Also, they must be using adequate virus protection.
Submitters must ensure that reports contain enough detail to recreate the problem or understand the feature or capability suggested. Please use the guidelines provided above.
It is very difficult to refer to a specific problem or feature, to assign/track it, and to facilitate understanding by the assigned engineer if a number of them are lumped together in a single report. Please do NOT mix bug reports and feature suggestions together. Please do NOT bundle either multiple bug reports or multiple feature suggestions together unless they logically go together. We cannot work with illogically bundled reports.
GTRI will make every attempt to apply critical problem fixes before features and other non-critical issues. However, priorities will ultimately have to be ordered on the basis of current software configuration, time to fix, cost, risk, etc.
From the wantlist display it is not completely clear what components are inherited and if they are included as a requirement. An effort to display more clearly what is contained in the subset should help users create subsets more accurately reflecting their goals.
Error messages and help tips will help increase the usability of the tool and also make things clearer for new users.
An online user manual will contain common usage guides, solutions to common problems, and a step by step guide.
Currently adding components to a Global JXDM schema subset can be tedious for extremely large subsets. The ability to add or delete components recursively would alleviate this problem, but would introduce the problem of including too much because of the recursive nature of the data model.
The SSGT will be capable of setting constraints on components.