PLM Integration

Now reading version 1.1. For the latest, read: PLM Integration for version 5.0

Nexus Server Message

This documentation page references NEXUS Server (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer and a connected Altium 365 Workspace. Check out the FAQs page for more information.

 

The Altium NEXUS Server can be hooked up to one or more PLM instances, with direct support for Windchill PLM and Arena PLM. Interface configuration is performed through the NEXUS Server's browser interface, with most configuration defined within an XML-based configuration file (uploaded to the Server). With the interface set up and working, features and functionality are provided when working in the following distinct areas:

  • Library (components) - catering for the uni- or bi-directional synchronization of your components, component parameters, and part choices, between your NEXUS Server and your PLM instance. Configuration allows you to specify which parameters are mastered in which system. In addition, Item parameters enable you to update properties in the NEXUS Server (configurable per field), without having to formally release a new revision of that Component Item. A dedicated Part Request workflow is also available that supports the automatic creation of a Component in your PLM instance, and then propagation of the generated part number back to the component in NEXUS.
  • Design (projects) - a dedicated Project Creations workflow is available that supports the automatic creation of part numbers in your PLM instance, and then propagation of these as Server Parameters of the NEXUS Managed Project. Such parameters can be used in special strings (e.g. for sheet border annotations). You have the ability to publish your design to your PLM instance, as part of running the Project Releaser in Altium NEXUS. The publishing operation uses a publishing template - defined as part of the PLM instance integration configuration - to control how data should be propagated to the PLM. And if you're publishing for the first time and part numbers (on the PLM side) are not yet associated with the managed project, those part numbers will be created in the PLM and associated to the project as part of that initial publication. You also have the ability to define component entries for NEXUS managed components in the PLM instance, as part of the publishing operation (optional, based on configuration). And you'll always be able to see exactly what has been created, such as part numbers in the PLM instance, as part of the process workflow's history (History tab).

PLM Support

The Altium NEXUS Server provides direct support for the following PLM systems:

  • Windchill PLM (11.0 M030)
  • Arena PLM

There is also a Filesystem driver that allows you to perform integration testing without a PLM instance available.

Due to API limitations, library synchronization with Manufacturer Part/Part Choices is not yet supported when working with an integrated Windchill PLM instance.

Connecting to Your PLM Instance

Connection to your PLM instance is performed from the Admin - PLM Integration page of the NEXUS Server's browser interface. This involves uploading the applicable XML-based configuration file and publishing template, and enabling/configuring synchronization of your PLM components with those in the NEXUS Server.

To create a new PLM interface instance, click the  button. As many instances can be defined as required, to interface your Altium NEXUS Server to various different PLM instances. For example, your components might reside in one PLM instance, with the generated output from released design projects in another, or perhaps different divisions are using different instances (of the same or differing PLM system). Each instance must be uniquely named, have a configuration file and one or more defined publishing templates. To test the connection for a defined instance, click the  button.

Sample configuration files and publishing templates are provided as part of the installation - click on the sections below for more information:

Add and configure the interface to your company's PLM system. With a valid connection, you can then publish project release data to the PLM system (using defined process definitions)
in accordance with an active publishing template for the instance, and also schedule synchronization of components between that PLM and your NEXUS Server.

Component Synchronization

Synchronization of components between the NEXUS Server and the connected PLM instance - or to be more specific, their parametric data - involves the following:

  1. Configuring the synchronization for each component type. This involves:
    1. Determining the direction of synchronization.
    2. Determining which components are involved, and where new components are to be created.
    3. Configuring parameter mapping.
  2. Performing the synchronization.

The first item is handled in the configuration file used for the connected PLM instance. The synchronization itself can be performed on-demand, from the PLM Integration page of the NEXUS Server's browser interface, and/or can be scheduled - automated synchronization at periodic intervals, defined when configuring the connection to the PLM instance.

Configuring Synchronization

Within the configuration file, you define a section for synchronization mapping for each dedicated part type. On the NEXUS Server side, this is the component of type altiumType (and is the name you see through the Explorer panel when creating an Item of that particular type). On the PLM side, a part is created of type plmType. This is declared as an Entity in the file, an example of which might be, for capacitors:

<Entity altiumType="Capacitor" plmType="Capacitor">

.

.

</Entity>

The plmType value may vary, depending on the particular PLM instance you are using.

Within the Entity, two sections are used to control and configure synchronization from the NEXUS Server to the PLM instance, and the PLM instance to the NEXUS Server - allowing for uni- or bi-directional synchronization. Use the following sections, in conjunction with the comments available in the sample configuration files, to learn more. Ultimately, what gets defined in the configuration file will vary, depending on your specific needs.

Performing Component Synchronization

Synchronization itself is performed from the PLM Integration page of the NEXUS Server's browser interface. Click the  control, associated with the PLM instance that you wish to synchronize. The synchronization process will proceed, in accordance with the settings defined in the associated configuration file.

Synchronization will involve only those components that have been modified since the last synchronization was run (i.e. their timestamp is later than the last synchronization date), and which pass the synchronization criteria in the configuration file. This is referred to as Incremental Synchronization.

Component synchronization in progress between the NEXUS Server and the indicated PLM instance.Component synchronization in progress between the NEXUS Server and the indicated PLM instance.

The control changes to . If you want to stop the synchronization process, click this control. A confirmation window will appear, click  to stop the synchronization - all components already synchronized will remain so, but no further synchronization beyond that point will occur.

You also have the ability to schedule automated synchronization. To do so, edit the PLM instance (from the main PLM Integration page, click on its name, or the associated  control) and enable the Synchronize PLM Components with NEXUS option. Use the Synchronize every controls to set up the automated sync schedule as required. The system is very flexible and allows you to:

  • Set up scheduled synchronization every 15/30/45/60/75/90 minutes.
  • Set up scheduled synchronization every x hours.
  • Set up scheduled daily synchronization, to be performed at a nominated time.

The schedule you define will be reflected back on the main PLM Integration page, in the Sync scheduled column.

Setting up a synchronization schedule.Setting up a synchronization schedule.

To set up scheduled synchronization requires you to provide valid credentials (for your PLM system). Click the  button and enter your User name and Password into the subsequent PLM Credentials window. Without valid credentials, scheduled synchronization will remain in the OFF state. On-demand synchronization will also not be possible.

You can also run the synchronization process on-demand. Click the  button and choose which mode of sync you need:

  • Incremental - in this mode, only those components that have been modified since the last synchronization was run (i.e. their timestamp is later than the last synchronization date), and that pass the synchronization criteria in the configuration file, will be included in the sync, with changes propagated accordingly. This is the default mode, and is the same mode that is run by clicking the  control for a PLM instance, on the main PLM Integration page.
  • Full - this mode forces a full synchronization. All components that pass the synchronization criteria in the configuration file will be be included in the sync, with changes propagated accordingly.

Process Workflows

The following process definitions (and underlying workflows) are available, in support of PLM integration:

These process definitions cannot be activated and used as is. Each of these is therefore more like a 'template' - edit to suit your company's requirements, name, and save as a new process definition, which you can then activate and use, along with all other definitions in the respective process theme.
  • Part Requests process theme:
    • Part Request with PLM Part Create - supporting the automatic creation of a Component in your PLM instance, and then propagation of the generated part number back to the component in NEXUS. The workflow diagram is shown below.

One important thing to note is that when you modify this sample definition to create your own, you must specify the PLM instance into which parts are to be created. Select the Create Part in PLM entity in the workflow diagram and choose the PLM instance from the drop-down menu associated with the PLM Instance field. This menu lists all currently defined PLM instances (as defined on the PLM Integration page of the interface).

  • Project Activities process theme:
    • Publish to PLM (latest) - standard publish of released managed project outputs to the integrated PLM instance. The workflow diagram is shown below.

  • Publish to PLM (User selects) - publish of released managed project outputs to the integrated PLM instance, but with the user able to select exactly which outputs get published. The workflow diagram is shown below.

  • Project Releaser with Publish - publish to the integrated PLM instance as an additional stage of the Project Releaser. The workflow diagram is shown below.

  • Project Creations process theme:
    • Project with initialise in PLM - supporting the automatic creation of part numbers in your PLM instance, and then propagation of these as Server Parameters of the NEXUS Managed Project. The workflow diagram is shown below.

Accessing PLM-related Processes

The following sections highlight where to access activated PLM-related processes. And since the samples cannot be used out-of-the-box, the following were created from them, for the purpose of illustration:

  • PR with PLM Part Create - created from the sample process definition: Part Request with PLM Part Create.
  • Publish to Company PLM - created from the sample process definition: Publish to PLM.
  • Publish to Company PLM - Choose Data - created from the sample process definition: Publish to PLM (User selects).
  • Project Releaser with Publish to Company PLM - created from the sample process definition: Project Releaser with Publish.
  • Create Project with PLM Initialise - created from the sample process definition: Project with Initialise in PLM.
Remember that Administrators for the Altium NEXUS Server can start a new instance of any activated process definition - directly from the corresponding process theme tab within the Processes area of the NEXUS Server's browser interface - by clicking the  control.

Part Requests

Access from within Altium NEXUS from the Explorer panel, after having conducted a search, or from within the Part Search panel, with a search item selected.

From the Altium NEXUS Server's browser interface, the activated process definition can be accessed from the Part Requests page, by clicking the  button at the top-right of the page.

Project Activities

Standard Publishing Processes

Standard publish to PLM processes (with or without user selection) can be accessed from within Altium NEXUS from the Project » Project Activities sub-menu for the active project.

Also accessible from the Project Activities context sub-menu, accessed by right-clicking on the entry for the design project in the Projects panel.

From the Altium NEXUS Server's browser interface, the activated process definition can be accessed from the detailed view for a managed project, by clicking the  button.

Publishing with the Project Releaser

The process for publishing to a PLM instance as part of the Project Releaser can be accessed from within Altium NEXUS from the Project » Project Releaser sub-menu for the active project.

Also accessible from the Project Releaser context sub-menu, accessed by right-clicking on the entry for the design project in the Projects panel.

The Project Releaser will appear, with an additional stage - Stage 7 Publish to PLM. In addition, a command is available from the menu associated to the  button - Prepare & Release & Publish to PLM - should you wish to run the Project Releaser without stopping to review the generated data, and execution report.

If you run the Project Releaser with the standard Prepare command, after reviewing and releasing the data, the  button will be presented at the Execution Report stage. Click this to continue the underlying workflow for the process, to publish to the PLM. The Login Credentials dialog will appear. Enter the Username and Password for your PLM instance, and select the PLM Template you want to use (which appears in the form <PLMInstance>:<PublishingTemplate>).

If you chose to use the Prepare & Release & Publish to PLM command, you will ultimately be presented with the Login Credentials dialog directly. The Project Releaser will not pause at the Execution Report stage, and no  button will be presented.
Note that your PLM instance login credentials are only required for the first time you publish to that instance. These will then be stored with the NEXUS Server. After that, any publishing of that project to that same PLM instance will proceed directly, in accordance with the defined workflow and chosen publishing template.

Click on the Diagram tab to see the underlying workflow for the process.

Click the  button to proceed with the publishing process, in accordance with that workflow.

If you're publishing for the first time and part numbers (on the PLM side) are not yet associated with the managed project, those part numbers will be created in the PLM and associated to the project as part of that initial publication. You also have the ability to define component entries for NEXUS managed components in the PLM instance, as part of the publishing operation - to get a BOM of components within the PLM (optional, based on the publishing template defined and used when publishing the project to the PLM instance).

Check the status of the publish to PLM process through the NEXUS Server's browser interface, from the Activities tab within that project's detailed view.

You will always be able to see exactly what has been created, such as part numbers in the PLM instance, as part of the process workflow's history (History tab).

Project Creations

Access from within Altium NEXUS from the main File » New » Managed Project sub-menu.

Also accessible from the Add New Project » Managed Project context sub-menu, accessed by right-clicking on the entry for the design workspace (*.DsnWrk) in the Projects panel. And from the Convert to Managed Project context sub-menu, accessed by right-clicking on the entry for the unmanaged project in the Projects panel.

From the Altium NEXUS Server's browser interface, the activated process definition can be accessed from the main Projects page of the interface, by clicking the  button.

And also from the detailed view for a managed project, by clicking the  button.

The process workflow will proceed, with a dialog to enable you to define the project, in terms of its name, description, type, and any Project Template Item that should be used in its creation. After clicking Start, the Login Credentials dialog will appear. Enter the Username and Password for your PLM instance, and select the PLM Template you want to use (which appears in the form <PLMInstance>:<PublishingTemplate>). Then click Submit to proceed with the workflow.

The relevant part numbers will be automatically created for the project in your PLM instance, and then propagated back to the NEXUS Server as Server-level parameters of the NEXUS Managed Project. These parameters will be available to use as special strings - access from the Properties panel with a placed text string selected in the design workspace. Server parameters defined for the project can also be viewed on the Server Parameters tab of the Project Options dialog (Project » Project Options).

 

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Content