Creating, Editing, and Deleting an Attribute

After creating your extensions, you can create, edit, and delete attributes associated to the extensions.

Important: 3DSpace is delivered with more than 400 Dimensions and their corresponding units by default. Do not change these dimensions as the Data Model Customization, Administrate Data Model, and 3DSpace Configuration Center customization tools rely on them. Any change could introduce discrepancies between the client and the server, and corrupt data. Therefore, only Dassault Systèmes can update 3DSpace dimensions, that is, dimensions prefixed by DSDim_.

This task shows you how to:

Before you begin: You must have created an extension.

Create a Simple Attribute

You can create an attribute stored in database.

Note: Attributes names can contain alphanumeric characters and the underscore _ character only.

  1. Click the type/extension to which you want to add an attribute.
    The line corresponding to the selected type/extension turns pink.
  2. In the Attributes List frame, click New Simple .
    The Create New Attribute window opens.
  3. Define the attribute.
    1. In the Name box, enter its name.

      The Package prefix is automatically added at deployment.

    2. Select its type in the Type list.

      When using magnitudes, use the Magnitude chooser. For an attribute with a magnitude, the default value is expressed in the preferred unit. If you change this unit, the default value is reset.

    3. Select the unit if need be.
    4. In the Multivaluated list, select true or false.

      • Multivaluated attributes are available for IRPC modelers only.
      • A multivaluated attribute can have authorized values.

    5. If need be, enter the authorized values. If you want to add multiple values, enter the first value into the Authorized values box and click + to display additional boxes.

      • This field is disabled if you work with Boolean attributes. You can remove a value by clicking -.
      • The Add an authorized empty value option lets you add an empty value to the authorized values when working with String attributes. When you define this option, the default value is automatically the empty value.
      • Depending on the database, the authorized values you have entered may appear in a different order on your Data Model Customization app and on the end-user apps. They may also appear in a different order when you export/import the packages that contain them. If you want the authorized values to appear in a specific order on the native end-user apps, use a mask.
        Note: You cannot control the order of display of authorized values on dashboard and web apps.
        For more information, see Installation and Setup > Customize > 3DEXPERIENCE Platform: 3DSpace > Security Management > Security Mask Configuration > Mask Syntax.

    6. Enter its value in the Default Value box. If authorized values are defined, your default value must be one of them.

      If you want to enter a date, use the Date Picker .

    7. In the Length box, enter the maximal length of the attribute.

      Leaving this box blank or entering 0 means no limit.

      This box only makes sense for attributes of String type.

      Recommendation: To optimize the storage resources, define a length that is less than 1000.

    8. Select the User Access in the scrolling list:

      • ReadWrite - the attribute value can be modified.
      • ReadOnly - the attribute value can only be modified through a business rule.
      • None - the attribute is never displayed and can only be valuated by a business rule.

    9. In the Reset when Duplicated scrolling list, select true if you want the attribute value to be reset when the object owning the attribute is duplicated.
    10. In the Reset when versioned box, select true if the attribute value must be reset when a new object version is created.
    11. In the Integrate in 3DXML box, select true if you want to add the type and the attribute to a 3D XML file. You also need to define the CustoTool_3DXML_Exportable variable.
    12. In the V6/XPDM Exportable box, select true if you want to flag an attribute exportable by default during V6/V6, V6/XPDM data exchanges in briefcases.
  4. Click Done when you are done with the attribute creation.
    Notes:
    • To display the attribute in the list, click the type it is related to:
      • The Nature column indicates if the attribute is of Simple or of Transient type.
      • The Deployed column indicates if the attribute is deployed (yes), not deployed (no), or partially deployed (partial), which means that the attribute has already been deployed at least once but has been modified since its deployment.
      • The Type column displays the attribute type.
      • The Default Value column displays the value.
      • The Keys (Package) column shows the keys that constrain the extensions.

Create a Transient Attribute

You can define a transient attribute. This attribute is not stored in database. A transient attribute is characterized by:

  • Its name,
  • Its type (basic type, magnitude, but also a feature to enable the computation of attributes that are return objects).
  • The fact that it can be multivaluated, have a preferred unit, and can be in read-only or Read/Write mode.
Note: If you want to display transient attributes on the client side, you must implement the INFRAComputedAttribute opening for the type/attribute_name couple.

  1. Click the type or extension to which you want to add the attribute.
    The line corresponding to the selected type/extension turns pink.
  2. In the Attributes List frame, click New Transient .
    The Create New Attribute window opens.
  3. Define the attribute.
    1. In the Name box, enter its name.

      The Package prefix is automatically added at deployment.

    2. Select its type from the Type list.

      • When using magnitudes, use the Magnitude chooser. For an attribute with a magnitude, the default value is expressed in the preferred unit. If you change this unit, the default value is reset.
      • When using a PLM Type, select one from the list.

    3. Select the unit if need be.
    4. From the Multi-Valuated list, select true or false.
    5. Select the Access Mode in the scrolling list:

      • ReadWrite - the attribute value can be modified.
      • ReadOnly - the attribute value can only be modified through a business rule.
      • None - the attribute is never displayed and can only be valuated by a business rule.

    6. In the Reset when Duplicated scrolling list, select true if you want the attribute value to be reset when the object owning the attribute is duplicated.
  4. Click Done when you are done with the attribute creation.
    Notes: To display the attribute in the list, click the type it is related to:
    • The Nature column indicates if the attribute is of Simple or of Transient type.
    • The Deployed column indicates if the attribute is deployed (yes), not deployed (no) or partially deployed (partial), which means that the attribute has already been deployed at least once but has been modified since its deployment.
    • The Type column displays the attribute type.
    • The Default Value column displays the value.

The transient attribute is created.

Defining a 6W Tag on an Attribute

You can associate a 6W predicate with a new or an existing attribute.

  1. Click the type/extension to which you want to add an attribute.
    The line corresponding to the selected type/extension turns pink.
  2. In the Attributes List frame, click New Simple .
    The Create New Attribute window opens.
  3. Define the attribute.
    1. In the Name box, enter its name.
    2. Click ... next to the 6W Predicate box to select the predicate and click Submit when done.
    3. Select the other attribute characteristics as described in Create a Simple Attribute.
    4. Select true in the Indexation list for your attribute to be indexed. If true is not selected, the attribute cannot be used in the 6WTags.
  4. Click Done when you are done with the attribute creation.

Edit an Attribute

You can edit an attribute after creating it.

  1. Click located at the end of the attribute line.
    The Attribute Properties window opens.
  2. Click Edit.
    The window turns edit mode.
  3. Edit the boxes you want to modify.
    Note: The only boxes you can modify are the following:
    • Multivaluated
    • Default value
    • User Access
    • Reset when Duplicated
    • Reset when Versioned
    • 6W Predicate
    Note: You cannot modify a value if it is of Date type.
  4. Click Done and Cancel when you are done with the edition.

Delete an Attribute from the User Interface

You can delete attributes which are not constrained by unique keys.

Recommendation: To massively delete attributes, use the CustoDataTool2 tool.

  1. Click the attribute you want to delete.
  2. Select Delete .
    The attribute is deleted.

Delete an Attribute Using a Shell Script

You can delete attributes which are not constrained by unique keys using the CustoDataTool2.sh shell script.

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 and CustoDataTool2.bat on Windows.
For example, enter CustoDataTool2.sh –password creatorPassword -file /tmp/CustoPackage.zip –deleteAbsent.