Create a validation configuration

If you have multiple active schemas, you can create Validation Configurations to let the user choose which set of standards to use. Also, Validation Configurations are the only way to let a user validate their content using Schematron.

You must have Administrator permissions to manage validation configurations.

Tips and tricks

  • If at least one Validation Configuration exists, selecting the Validate XML option prompts the user to choose a configuration.

  • If you aren't using Schematron and don't want to prompt the user to choose a schema, you don't need to create a Validation Configuration.
  • If there are no Validation Configurations, Inspire should use the Active schemas that are listed on the Component schema management screen. Refer to: Manage XML validation schemas in Inspire. (You may encounter an issue where the page never completely loads if there are no Validation Configurations.)

To create a validation configuration:

  1. From the Administration menu, select Advanced Settings, and then Validation Configuration Management.

  2. On the Validation configuration management tab, click Create.

    Result: The Create Validation Configuration screen opens.

  3. In Name, enter a user-friendly title that describes the validation standards it contains.
  4. Optionally, in Description, you can add more details for administrators.

    Users won't see these details when they are prompted to choose a validation configuration in the Components browser or a project.

  5. In Component Schema, select a schema that exists in Inspire.

    Tips:

    • By default, you will see DITA 1.2, DITA 1.3, DocBook 5.0
    • If you added a custom schema, it is also listed. If you want to add one, refer to: Use custom schemas.
  6. In Active, do one of the following:
    • If you want users to see this validation configuration on the Validate XML screen, select the Active option.
    • If you want to hide this validation configuration from the Validate XML screen, leave the Active option unselected.
  7. In Default, do one of the following:
    • Usually you select the Default option to ensure that this validation configuration is automatically selected when the Validate XML screen opens. However, the previously applied validation configuration is set by default.

      You must also select the Active option.

    • If you want this validation configuration to be shown in the list but not automatically selected when the Validate XML screen opens, leave the Default option unselected.
  8. Optionally, if you want to use Schematron, click Add to select the Schematron files you have already uploaded. For more information, refer to: Add a Schematron validation configuration.
  9. Click Create.

    Results:

    • You see your validation configuration listed on the Validation configuration management tab.
    • When using the right-click or context menu option in the Components browser or a project, and selecting Validate XML, users are prompted to select a validation configuration.

    • The configuration you just created is listed as an option if you selected Active.