Creating and Deleting a Deployment Extension

You can create and edit deployment extensions, which can extend types located in different DS packages as far as they are of the same nature.

This task shows you how to:

Before you begin: You must have created a deployment package.
See Also
Creating, Editing, and Deleting an Attribute
Modifying the Scope of an Extension

Create a Deployment Extension

You can create a deployment extension by selecting a DS type or another customer specialization type from the current package. Such extensions are used by apps to add behaviors and attributes to objects.

  1. Click the package in the List of Deployment Packages.
  2. In the Extensions tab, click New Deployment Extension .
  3. In the Create New Deployment Extension window, define the extension as follows:
    1. Enter the extension name in the Name box.

      Note: Deployment Extensions names shall contain alphanumeric characters and the "_" character only.

    2. In the Types box, click ... to display the Types list. This list shows the types the extension can be applied to.
      The Types List window opens.
    3. Click one of the types or instances and click Submit.

      Note: You can either select a type (even a specialized one) or an instance.

    4. From the Automatic addition list, select one of the following options:

      Option Description
      true

      When you create a new object that uses the type or a sub type of the type you selected in step c, the deployment extension is automatically added to this object.

      Notes:
      • A type can be associated with several deployment extensions. As a result, when you create a new object that uses the type or a sub type of the type you selected in step c, this object is automatically extended by all the automatic deployment extensions that are associated with the type.
      • Existing objects that use the type or a sub type of the type you selected in step c are not automatically updated with the new deployment extension. For information on how to manually extend existing objects with the new deployment extension, see Installation and Setup: Administrate: 3DEXPERIENCE Platform: 3DSpace: Collaborative Spaces Control Center: Configuring Content for the 3DEXPERIENCE Platform: Deploying a Configuration: Propagating Attributes for New Extensions.
      • Formerly created deployment extensions can become automatic by changing the property Automatic addition to true in the edit extension panel.
      false

      When you create a new object that uses the type or a sub type of the type you selected in step c, the deployment extension is not automatically added to this object.

      You must implement a business rule for the Deployment Extension Choice (INFRADeploymentExtensionComputation) opening as described in the Getting Started.

      For more information about this opening, see Installation and Setup: Customize: 3DEXPERIENCE Platform: Behavior: Data Setup: List of Resource Set IDs: Infrastructure Business Logics: Business Logic for Object Typing : Deployment Extension Choice (INFRADeploymentExtensionComputation).

    5. Optional: Enter a comment.
    6. Optional: When working with references and representations, you can select the instance to be used from the Instance name scrolling list.
    7. Click Done when you are finished with the extension creation.

The extension is created and appears in the List of Extensions window:

  • Name corresponds to the extension name.
  • Scopes corresponds to the list of types the extension can be applied to. You can select all public types and relations including specialized types.
  • Deployed shows the deployment information (yes, no, or partial).
  • Attributes shows the number of attributes.
  • Comment shows the comments you entered.
Note: Existing objects using the associated types or sub types are never automatically updated with the new extension, regardless of the Automatic addition option you selected. For more information, see 3.d. above.

Delete a Deployment Extension From the Interface

You can delete any deployment extension that is not used by any object.

  1. Click the extension.
  2. Click Delete .
    The extension is deleted as well as its attributes, if any.

Delete a Deployment Extension Using a Shell Script

You can use the CustoDataTool2.sh shell script to delete any deployment extension that is not used by any object.

Note: When the -deleateAbsent argument is declared, the metadata file is imported and all missing entities are deleted.

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