Editing a schema manually

You can export a data source schema that is used in a template and make modifications to it as necessary. Then, add the revised data source schema back to the template by replacing the previous version with the new version.

Before you begin

Important: Back up your template by saving a copy of it before making changes to your schema.

About this task

Changing the schema does not change the data that is used in the generated report. Changing the schema affects only how Rational® Publishing Engine uses the data. You cannot edit with the Schema discovery wizard, export, or replace data source schemas that contain custom attributes.
Tip: When a data source schema has a root and a child node with the same name, infinite recursion occurs. Infinite recursion is the process of document generation running infinitely. Avoid issues with infinite recursion by ensuring that all nodes have unique names.

Procedure

  1. In the Outline view, expand Data Source Schemas.
  2. Right-click a schema and select Export schema.
  3. Select a location to save the .xsd file in and click OK.
  4. Open the .xsd file with a text editor.
  5. Edit the schema.
  6. Save the changes.
  7. In the Document Studio Outline view, right-click the schema you exported and select Replace schema.
  8. Click Browse and select the .xsd file you modified.
  9. Click OK.

Results

When the schema is replaced, Rational Publishing Engine verifies that the new schema is compatible with the previous one. If the new schema is not compatible, there might be errors in your revisions.

What to do next

Verify that the schema is still synchronized with the data from the data provider. Generate a preview of your template to verify that the data is presented as expected. If there are errors in the schema that are affecting the output, you can review the error logs to identify the errors.

Feedback