Create New Revision Sequences in the 3DEXPERIENCE Platform

PC 2023-05-02

If the pre-defined revision sequences in the 3DEXPERIENCE platform are too restrictive or don’t meet the needs of your business requirements, help has now arrived. 23x FD01 gives you the ability to define your own revision sequences in the platform through a functionality called Extended Revision Sequences. This is available for both on prem and on the cloud.

Creating Extended Revision Sequences

Extended Revision Sequences are configured in the Revision Naming Rules section of the Collaborative Spaces Configuration Center.

One or more extended revision sequences can be defined in a json file and uploaded to the platform. The json file of extended revision sequence definitions is uploaded in the Extended Revision Sequences Declaration tab.

Once uploaded, your new extended revision sequences are displayed with the pre-defined revision sequences in the Naming Rules tab.

Extended revision sequences are applied to the following types of content:

Engineering Definition types: physical product, functional reference, logical reference, manufacturing assembly, manufacturing product, etc.
Engineering Evaluation types: review, interference simulation, physics simulation, functional simulation, logical simulation, manufacturing simulation, human, etc.
Engineering Resource types: AEC elements, templates, etc.

When you use an extended revision sequence, the primary revision of the object will follow the rules defined in the sequence definition when it is created, duplicated or revised.

Extended revision sequences are supported in these apps:

Lifecycle commands in dashboard apps
Native apps
Collaborative Design apps

Extended Revision Sequence Definition Syntax and Example

The revision sequence definition is extremely flexible with the ability to define prefixes, padding, character length, and more.

Here is a simple example:

[
     {
          "name": "AlphabetInit",
          "title": "A to Z starting with ---",
          "mode": "alphabet",
          "alphabet": "[A-Z]",
          "init": [
               "---"
          ]
     }
]

This will create a revision sequence of: ---, A, B, C, D, …

See this page for the extended revision sequence json file syntax. It includes five great examples as a reference.

The breadcrumb trail for this page in the online documentation is:

Installation and Setup > 3DEXPERIENCE Platform > 3DEXPERIENCE Platform Administration > 3DSpace > Collaborative Spaces Control Center > Configuring Context for the 3DEXPERIENCE Platform > Defining Naming Conventions for Content > Extended Revision Sequence JSON Syntax

Deleting Extended Revision Sequences

To delete extended revision sequences you just upload a json file with an empty list of revision sequences such as:

[]

Note that you cannot remove an extended revision sequence that is used by one or more policies.

Important Note about Extended Revision Sequences and EKL Opening IDs

Please note that according to the documentation, if extended revision sequences are uploaded the following opening IDs are not called during lifecycle operations: PLMPreCheckClone, PLMActionClone, PLMPostCheckClone, PLMPreCheckNewVersion, PLMActionNewVersion, and PLMPostCheckNewVersion.

If you have deployed Enterprise Knowledge Languages scripts that use these opening IDs you’ll need to modify your configuration.

Additional Help

For more information, see About Revision Sequences, Creating, Updating, and Uploading an Extended Revision Sequence and Extended Revision Sequence JSON Syntax.

The breadcrumb trails for these pages in the online documentation are: