To Replace the Content of a Project from a Package

You might need to upload a newer version of the customization project that has been modified outside the system on which you are working, or upload the project from a backup copy.

You can replace the content of a customization project from a deployment package in the following ways:
Note: The platform does not verify the content of a deployment package before replacing a customization project in the database.

Replacing a Customization Project from a File by Using the Customization Projects Form

To replace the content of a customization project from a file by using the Customization Projects (SM204505) form, perform the following actions:
  1. In the project list, click the row of the customization project to be updated.
  2. On the More menu (under Import), click Replace Highlighted Project Content.
  3. In the Open Package dialog box, which opens, click Choose File.
  4. In the Open dialog box, which opens, select the deployment package file to be uploaded.

    The name of the selected file is displayed in the File path text box of the Open Package dialog box.

  5. In the Open Package dialog box, click Upload.
The platform uploads the selected package and replaces in the database the content of the selected project with the content of the deployment package.

Replacing the Customization Project Opened in the Customization Project Editor from a File

To replace the content of a customization project that is currently opened in the Customization Project Editor, perform the following actions:
  1. Click File > Replace from Package on the editor menu.
  2. In the Open Package dialog box, which opens, click Choose File.
  3. In the Open dialog box, which opens, select the deployment package file to be uploaded.

    The name of the selected file is displayed in the File path text box of the Open Packagedialog box.

  4. In the Open Package dialog box, click Upload.
The platform uploads the selected package and replaces in the database the content of the selected project with the content of the deployment package.
Also, you can replace the content of the customization project by using the Project XML Editor of the Customization Project Editor. To do this, perform the following actions:
  1. In the Customization Project Editor, click File > Edit Project XML to open the Project XML Editor for the current customization project.
  2. On the toolbar of the Project XML Editor, click Choose File.
  3. In the Open dialog box, which opens, select the deployment package file to be uploaded.

    The name of the selected file is displayed in the text box right of the toolbar buttons instead of the No file chosen string (which is shown in the screenshot below).

  4. On the editor toolbar, click Upload Package.
    Figure 1. Replacing the content of a customization project from the Project XML Editor


    The platform uploads the selected package and displays its XML code in the Project XML Editor.
  5. Explore the content of the uploaded package to ensure that this is the needed one.
  6. To replace the content of the project that is currently opened in the Customization Project Editor with the content of the uploaded package, click Save to Database on the page toolbar.

By using this approach, you can explore the content of the package before replacing the content of the customization project that is currently opened in the Customization Project Editor.