Skip to main content
Version: I2023.1.0

Updating Project Definitions to Overwrite Projects

note

Note: This document applies to the new version of the Projects section in the Design Center. For details on how to perform the same actions in the classic version, see Managing Projects > Updating Project Definitions to Overwrite Projects.

You can update an existing project by overwriting its XML definition (and that of all of its contained cubes).

About this task​

Updating an existing project's definition overwrites that project with a new definition. If you want to create a new project from a project definition file, add a new project instead.

In this procedure, you will export the existing project's XML definition in order to edit it, then update the project with the edited XML definition. All of the cubes in the updated project will have the same security policies that they were exported with. In addition, you (as the creator of the updated definition) will have all permissions on the project.

Note that a project's cubes are identified by their Cube ID's and not their Names. This means you should take care of the following:

  • Keep the existing Cube ID

    To update the structure of an existing cube, in the edited XML definition you must keep the ID of this cube unchanged. If the update removes an existing Cube ID, then that cube's aggregates will be deactivated on publish.

  • Security for a new Cube

    If project's XML definition contains a new Cube ID, then that cube will receive the default, run-time security settings and will not have any aggregates when published. Cube ID's are likely to be different in Project files exported from different AtScale installations. Please verify that the Project definition contains the expected Cube ID's before proceeding with the project update.

Procedure​

  1. Choose Projects from the main Design Center navigation, and then choose the project you want to overwrite.
  2. In the right part of the screen, choose Settings below project's name.
  3. Choose Export XML from the project overview menu.
  4. In a text editor, edit the XML definition to reflect your planned updates.
  5. Return to the Settings page described in the previous steps (for the same project), and choose Update XML.
  6. Upload the edited XML file and choose Update.

Your project definition is now updated. You could change the name or other properties of the project as needed.