Page tree
Skip to end of metadata
Go to start of metadata

Through the GoodData APIs, you can perform project validation tasks to check for many common errors.

You should get into the habit of validating your project before making modifications or publishing new versions of your projects.

The project validation API checks for many types of errors, including the following:

  • Referential integrity issues. For example, an Employee dataset references a non-existent record in the Department dataset.
  • Missing attribute values. This check tries to find attribute values that are used in report or metric filters yet are no longer present in the data.
  • Ambiguous or transitive references between datasets. Report computation results are unpredictable when a report is computed in a project where there are multiple ways to traverse the project’s logical data model from an attribute A to an attribute B.
  • And various other checks.

Contents:

Prerequisites

Before you begin, you must acquire the internal identifier for the project, which can be extracted from the URL when you log into the GoodData Portal and select the project.

The user executing the validation must be logged in to GoodData and must have the Admin role in the project being checked.

Project validation via Gray Pages

Steps:

  1. In the gray pages, visit the Validate screen:

    https://secure.gooddata.com/gdc/md/{project-id}/validate
  2. The Validate screen is displayed:


  3. The following options are available:

     Option

    Description

    invalid_objectsCheck the project objects to see if they are invalid or have been corrupted.
    ldm

    Check the internal consistency and referential integrity of the logical data model.

    metric_filter

    Check the MAQL code for metrics for inconsistent metric filters.

    pdm

    Verify mappings between the logical data model and the physical data model, which defines how the data is actually stored in the datastore. Also, this check verifies referential integrity within the PDM.

  4. To execute the validation, click submit.
  5. The project validation may take a while:

  6. Click the poll link until a Status message is displayed:

Project validation via API

The project validation API can be invoked at the following URL:

https://secure.gooddata.com/gdc/md/{project-id}/validate

Before you publish your project or make additional modifications, please correct any reported errors in the validation.