Importing Packages

You can import a zip file containing metadata and I18N files (for translation purposes). After the import operation, you can view all published elements (Package, Type, Extension, Uniquekey, and Attribute).

An import operation is similar to a deployment. It updates the administrative vault with the content of the metadata files.

Notes:
  • Only the differences compared to the administration vault are imported.
  • The content of an imported package cannot be modified using the tool.
  • An imported package is considered to be the slave of the master server.
  • The changes, if any, must be performed on the master. After the import, the index specifications are updated directly in the database.
  • The lists of authorized values, if any, of imported attributes may appear in a different order on Data Model Customization and on the native app panel. If you want the authorized values to appear in the same order, you must use a mask. For more information, see Installation and Setup > Customize > 3DEXPERIENCE Platform: 3DSpace > Security Management > Security Mask Configuration > Mask Syntax.

This task shows you how to:

Import Packages Using the Import Packages Command

You can import packages manually using the Import Packages command.

  1. From the Compass, click Social and Collaborative Apps , Data Model Customization, and select Manage Packages.
  2. Click Import Package.
  3. Click Browse in the Import Package tab, navigate to the zip file you want to import, and select it.
  4. Click Import.
    The packages you imported as well as their content are now displayed in the List of Specialization and Deployment Packages window.
    Note: You can select more than one package to import.

Import Packages Using a Shell Script

You can import packages using a shell script called CustoDataTool. This script has the following arguments:

  • -user: specify the user if you are not the creator.
  • -password: enter the password
  • -file: enter a zip name (compulsory).

Open a command window and enter the following command: <intall_directory>/server/scripts/CustoDataTool2.sh - file on Unix andCustoDataTool2.bat on Windows.
For example, to import /tmp/CustoPackage.zip using creator with the creatorPassword password, enter: CustoDataTool2.sh –password creatorPassword -file /tmp/CustoPackage.zip.