To use Cognos product documentation, you must enable JavaScript in your browser.

Verify a Model or Package

At any point in the modeling process, you can check the validity of the whole model, or selected objects in the model such as a package. We recommend that you first verify the model and repair any problems, and then verify each package within a model individually. By verifying a package, you can find and remove invalid objects that can cause a query to fail.

Verification Categories

When you verify a model or package, Framework Manager looks for messages in the following categories:

CategoryDescription
Internal Model InconsistenciesVerifies that objects are properly defined and that duplicate names are not used. We recommend that you always run this group of tests.
Invalid or Incomplete Object ReferencesChecks for dangling references or references to missing objects.
Determinant CompletenessVerifies that determinants are completely defined with keys and attributes, and that all query items are accounted for in a determinant.
Dimension CompletenessVerifies that dimensions are fully defined with level member captions and business keys.
Query Status

Verifies that the evaluation status for query subjects and dimensions is valid and is not set to "needs reevaluation" or "invalid".

Query status does not verify shortcut objects. For example, you create a shortcut to an object. The object becomes invalid for some reason. If you verify the object, a message is shown because it is invalid. When you verify the shortcut, no message is shown.

Backward CompatibilityInforms you that a model contains features from a previous release that have been maintained but will be deprecated in a future release.
Verify Relationship CardinalityWarns when many-to-many relationships are found.

Each category can generate multiple messages for an object. For each message, the severity, object icon, object ID, description of the message, explanation of how to correct the problem, and possible actions that can be performed on the object are provided. You may be able to correct a problem immediately by modifying the object that caused the problem or by asking Framework Manager to repair the problem.

Steps
  1. Choose one of the following:

    GoalAction
    Verify a modelFrom the Project menu, click Verify Model.
    Verify a packageIn the Project Viewer, right-click a package, and click Verify Selected Objects.
    Verify selected objectsIn the Project Viewer, select one or more objects, right-click, and click Verify Selected Objects.

  2. On the Options tab, select the message severity levels that you want to see in the results.

    By default, all message severity level check boxes are selected. Clear the ones that you do not want.

  3. Select the categories that you want to verify.

    By default, all category check boxes are selected. Clear the ones that you do not want.

  4. Click Verify Model.

    The Verify Model Results tab shows the results.

  5. To sort the messages, click Sort in the severity, object type, or name column heading.

  6. To see the object that is related to the message, under the Actions heading, click Find in Project Viewer .

  7. To group the messages, select a grouping criteria from the list. If you group the messages, you can repair problems based on the grouping.

  8. Select the check box beside each message for the problem that you want to repair.

    Tips:

  9. Click Repair Selected.

    Framework Manager repairs the problems in the following order:

    You can also repair problems by clicking the Edit Definition icon under the Actions heading for the message. In the dialog box, modify the definition of the object as required.

When the repair process is finished, a summary of the repair results appears. The model or package is verified again and the results are shown in the Verify Model Results tab.

Tip: Problems that cannot be repaired during the verification of a package may be repaired using verify model.

For stand-alone filters, if the underlying objects might not be valid, a "needs reevaluation" message appears. The Repair option does not work for stand-alone filters. To ensure that the stand-alone filters are valid, open each filter and save it.