An Overview of the Workflow Process

This document is no longer available beyond version 3.2. Information can now be found here: Interactive Process Workflows for version 5

Nexus message

This documentation page references Altium NEXUS/NEXUS Client (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.

 

Parent page: More about Collaborative Design

Human error, poor design decisions, incomplete supply chain checks – there are many issues that can, and do, occur during the design and development of an electronic product. To avoid errors such as these validation check points are needed; such as design reviews and sign-off check lists.

Every organization that develops electronic products has systems in place to manage the flow of work through their organization. For a sole operator it could be following a sequence of steps that have been learned through experience. In a small company it might be informal peer-to-peer design reviews at agreed points in the development cycle. For a larger company it might be a series of review checklists that are signed off at critical stages, or request forms that are filled out when a new component needs to be added to the company database, using in-house developed forms and databases to manage and store the results.

The challenge with using a separate workflow management system is keeping it connected and in-sync with the design data. Ideally, the workflow management process will be tightly coupled to the design process, reducing the chance for human error and ensuring that the history it captures can be reviewed against the history of the design documents.

Modeling the Workflow Processes in Electronic Design

An excellent way to model any workflow process is as a diagram. A good diagram will show all of the steps in that process and their sequence, it will include key decision points, and the paths to follow for all possible outcomes.

What a flat diagram, like a Visio® diagram lacks, is a way of capturing the detail behind each step, or a way of connecting into the broader company systems and design tools. It also lacks a way of building accountability into the process, unlike a checklist that must be signed off before the design can proceed. Another big challenge with capturing a process in a diagram is that the detail that is considered to be important, is often different from one organization to the next. To satisfy these requirements you need to move beyond the Visio diagram and the checklist typed up in Word®.

Altium NEXUS solves these challenges using diagram-based workflows. Each Workflow that is used to implement a particular design process is created as part of a Process Definition. It can therefore be referred to as that process's underlying Workflow, or simply a Process Workflow. By using a diagram approach – capturing the workflow graphically – you are able to see, at-a-glance, where in the workflow a process currently sits, and who now has the next task in order to continue the progress of that process.

Behind each Task element in that diagram, the diagram creator builds user-interaction by crafting user forms. The forms can be used to: provide information to the designer about the purpose of this workflow diagram; require information to be entered, or files attached; select an option from a dropdown list; and so on.

A workflow diagram can capture:

  • Who is involved (e.g. admin, design engineer, anyone from the librarian group, etc)
  • What actions need to be taken, and in which order
  • What data needs to be provided (name, description, attachments, etc)
  • What are the decision points (e.g. approvals, assignments, etc)

The User Form presents as a dialog in Altium NEXUS when the designer starts a workflow process, such as a part request or design review, or when they are specifically tasked with an action in a workflow process. The images below show the form design for initiating a design review (on the left), as it is designed in the NEXUS Server, and that form as it presents as a dialog in Altium NEXUS.

The user form for a design review shown on the left, designed in the NEXUS Server as part of the initiated process's underlying workflow definition. It presents in Altium NEXUS as a dialog (on the right) for the designer to complete when that design review process is initiated.The user form for a design review shown on the left, designed in the NEXUS Server as part of the initiated process's underlying workflow definition. It presents in Altium NEXUS as a dialog (on the right) for the designer to complete when that design review process is initiated.

Creating and Editing Processes

Main articles: Creating & Managing Processes

Processes, and their Workflows, are created and managed through the Processes area (Admin – Processes) of the Altium NEXUS Server's browser interface.

You must be signed in as an Administrator for your Altium NEXUS Server, in order to see the Processes area of the interface.

Accessing the Processes area of the NEXUS Server's browser interface – command central for working with processes and their associated workflows.Accessing the Processes area of the NEXUS Server's browser interface – command central for working with processes and their associated workflows.

Processes are listed in the interface under three category tabs – Part Requests, Project Activities and Project Creations – while any that are currently active (running) are found under the Browser tab. With a category tab selected, use the button associated with an enabled process entry (indicated by the icon) to start the initial phase of that process. See Using Processes below for more information on running a process from the NEXUS Server or the NEXUS design Client.

As well as the supplied template process definitions, user-defined process definitions can also be created, allowing you to model that process to the depth and detail required by your organization. To help organize and manage processes, they are grouped into themes. A theme is a set of processes that model the same type of workflow, for example: new Project Creation, new Part Requests, or Design Reviews.

Existing processes are edited and new ones created using a powerful Process Workflow Editor – affording the flexibility for you to build processes with workflows that can be as simple, or as complex as needed, and in-line with your company's requirements. To access the editor and create a new process definition, make active the tab for the theme in which you want to create your new process, then click the button at the top-right of the page.

Accessing the Process Workflow Editor. Ensuring the desired process theme is made active before access will ensure the new process definition will be set to the right theme type.Accessing the Process Workflow Editor. Ensuring the desired process theme is made active before access will ensure the new process definition will be set to the right theme type.

Any Administrator can modify any user-defined process definition, irrespective of who originally created that definition, and save and deploy it as the next version. To do so, click the control for the process definition you wish to modify. The workflow diagram for this version of the process definition will be presented in the Process Workflow Editor, as a starting point from which to work.

Give your new process definition a meaningful name, then build the workflow graphically from the elements available in the upper palette, and then define the required aspects of each element in that flow.

For user tasks (the rounded rectangle object) , a User Form Editor is used to fashion the required form that will be presented to the user. Once built up, saved and available in the workflow, this form will take a user's input when they are given a task at the relevant point along the workflow.

The powerful Process Workflow Editor provides the flexibility for you to build processes with workflows that can be as simple, or as complex as needed, and in line with your
company's requirements.

Once a process has been defined as required, click the button to have it added to the list of available processes for that process theme. The new process definition will be enabled ready for use.

The Editor will flag any issues with your workflow diagram that are preventing it from being saved and deployed – for example a diagram must have a Start event, and at least one End event defined. And a User Task must have at least one Form field and an Assignee.
Each time a process is edited and saved, a new version is created. Use the Latest/All dropdown to access an older version. To abort editing a process, click the browser back button, or reselect the main Processes entry in the left-hand navigation tree.

The Elements of a Process Workflow Diagram

Main article: Defining a Process Workflow – The Workflow Diagram

The workflow diagram presents like a flow-chart, drawn from a set of shaped objects, called elements. Each element represents a type of action or event that is to occur at a point in time. The sequence of events is from left to right, apart from the output from a decision Branch, which can flow from right to left.

These elements are available from the palette at the top of the main editor workspace.

The palette of elements that displays at the top of the Process Workflow Editor.The palette of elements that displays at the top of the Process Workflow Editor.

Refer to the Defining a Process Workflow elements table for a detailed description of each element, as well as information and animations about placing them.

Capturing the Data and Events in the Workflow Diagram

Main article: Defining a Process Workflow – Building a Form

Once the process workflow has been designed, the data required to fully detail that process is captured in one or more User Forms. The User Form can carry information about that stage of the process, require the user to select an option or enter feedback, link to related information (such as a datasheet), and so on.

User Forms are created for the Start element and for each of the Task elements. When one of these types of elements is clicked on in the diagram, the current user form settings are displayed in the pane to the right, or if the form has not yet been defined, a button is displayed.

A User Form is created for the Start element and each Task element in a process diagram.A User Form is created for the Start element and each Task element in a process diagram.

When data is added to a Form, that data becomes available for use in other Forms created in that workflow process.

Using a Process

Related pages: Publishing to a PLM, Requesting a New Managed Part

Once the required set of process definitions for each available process theme are crafted as required for your company, those definitions that are activated will be available for use by all users once they are signed into the Altium NEXUS Server. The following sections take a look at where a designer can access, and start these active processes – both through Altium NEXUS, as well as the Altium NEXUS Server's browser interface.

Administrators for the Altium NEXUS Server can start a new instance of any activated process definition from the browser interface Process Management page (Admin » Processes) by clicking the control associated with its entry.

Part Requests

Related page: Requesting a New Managed Part

From within the Altium NEXUS design client, activated process definitions that are part of the Part Requests theme can be accessed in three places.

  • From the Components panel, using the Submit request link at the bottom of the component listing.

If the Legacy Part Request function has been activated in the NEXUS Server, the option will be available from the button in the Explorer panel. This request option is assigned to a nominated Librarian Role and is not based on an accessible process workflow.
  • From within the Manufacturer Part Search panel with a component entry selected, from the button menu, or from the button menu if component models are not available.

In all the above cases, the action will present the active part request process definitions available to choose from. Requesting a part through the Manufacturer Part Search panel provides the added benefit that it will auto-fill key information for you, including all data sheets and parametric information.

If no active process definitions are available for the Part Requests process theme, the Part Request options will not be shown. If their active status has been changed in the NEXUS Server, you may need to sign out of the NEXUS client and back in again to refresh.

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

Accessing activated Part Requests definitions from the Part Requests page of the NEXUS Server's browser interface.Accessing activated Part Requests definitions from the Part Requests page of the NEXUS Server's browser interface.

If no active process definitions are available for the Part Requests process theme, the button will be unavailable. If only one process definition exists, the button will not appear with drop-down functionality, and will start that process immediately upon being clicked.

Project Activities

Related pages: Performing Design Reviews, Publishing to a PLM

Activated process definitions that are part of the Project Activities theme can be accessed in various places.

Design Review and Standard PLM Publishing

From within the Altium NEXUS design client, activated design review and standard PLM publishing process definitions – that are part of the Project Activities theme – can be accessed in two places.

  • From the Project » Project Activities sub-menu for the active project.

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

If no active design review and standard PLM publishing process definitions are available for the Project Activities process theme, the menus will not be visible.
  • From the Altium NEXUS Server's browser interface, activated design review and standard PLM publishing process definitions – that are part of the Project Activities theme – can be accessed in the Projects view by clicking the Activities button (). A process selected from the menu will be invoked for the currently selected project.

Accessing activated Project Activities definitions (design review and standard PLM publishing) from the Projects area of the NEXUS Server's browser interfaceAccessing activated Project Activities definitions (design review and standard PLM publishing) from the Projects area of the NEXUS Server's browser interface

PLM Publishing through the Project Releaser

From within the Altium NEXUS design client, the process for publishing to a PLM instance as part of the Project Releaser can be accessed from the Project » Project Releaser sub-menu for the active project, or from the project name's right-click context menu in the Projects panel.

► See Publishing to a PLM and Working with the Project Releaser for more information.

Project Creations

From within Altium NEXUS, activated process definitions that are part of the Project Creations theme can be accessed in several places:

  • From the main File » New » Project in <server name> sub-menu.

  • From the Convert to Managed Project context sub-menu, accessed by right-clicking on the entry for an unmanaged project in the Projects panel.

  • From the Clone context sub-menu, accessed by right-clicking on a project's entry in the Open Project dialog.

  • From the button in the Explorer panel, when viewing a opened project in the (default) Project View.

Note that when at least one process definition for the Project Creations process theme is active, you cannot create a new managed project through the Create Project dialog (File » New » Project) because access to the connected Server is disabled – you must use one of the processes available from the File » New » Managed Project command. Regular and VCS type projects can be created as normal through this dialog.

A Project Creation process opens a <process name> dialog derived from, and named as, the selected Process Definition.

If no active process definitions are available for the Project Creations process theme – which is the default case for a fresh installation of the Altium NEXUS Server – the above menus will not be visible, and you will be able to create a managed project through the Create Project dialog as usual.

From the Altium NEXUS Server's browser interface, activated process definitions that are part of the Project Creations theme can be accessed from menu in the main Projects page. Note that the menu button reverts to a single option button (Add Project) when active Project Creation processes are not available.

Accessing activated Project Creations definitions from the main Projects area of the NEXUS Server's browser interface.Accessing activated Project Creations definitions from the main Projects area of the NEXUS Server's browser interface.

Active Project Creation processes are also applied to the project Clone function, which is available for the selected project from both the main and project-specific ellipsis menus ().

Accessing activated Project Creations definitions from the Projects area of the NEXUS Server's browser interface.

  • Or, as mentioned above, a new instance of any enabled process definition can be started from the Process Management page (Admin » Processes) by clicking the control associated with its entry.

Monitoring and Actioning the Tasks

Related pages: Working with Tasks, Tasklist panel

When a user is signed into the Altium NEXUS Server through the Altium NEXUS design client, their current list of tasks (or unassigned tasks which they can claim as a candidate) will be available through the Tasklist panel. Clicking on a task's entry will access a dialog containing the form and diagram (under the Diagram tab) of the associated process workflow – use the form to fulfill the task and submit, so that the process can flow to the next relevant stage.

Tasks that you have been assigned are distinguished by the icon, while unassigned tasks for which you are a candidate are distinguished with the icon. When you click on an unassigned task, the subsequent form provides a button – click this to take on the task, without having to go to the browser interface to claim it.

Example form for a user task associated with a design review process (Milestone Review), when accessed from the Tasklist panel in Altium NEXUS.Example form for a user task associated with a design review process (Milestone Review), when accessed from the Tasklist panel in Altium NEXUS.

Process workflow activities that apply to a specific design project can be viewed in the Explorer panel under the Activities tab for a selected (opened) project. Sub tabs allow you to view a process Diagram, its related workflow Data, and the sequential History of actions.

Tasks also can be browsed from the Tasks page of the Altium NEXUS Server's browser interface. The page presents active (outstanding) tasks for the signed-in user, or tasks that have not yet been assigned, but for which they are a candidate (e.g. are part of a role that has been specified for the assignee).

For a standard (non-admin) user, the list of tasks is automatically filtered so that only tasks requiring their attention, or which they can claim as a candidate, are listed. Each task is a specific stage reached within an associated process workflow. For an administrative user, a filter control is available at the top of the listing of tasks. Use this to quickly switch between viewing all your tasks (My tasks) and all tasks across all users (All tasks). An administrator can also browse all outstanding tasks – from a process workflow perspective – from the Browser tab of the Processes page.

Accessing the Tasks area of the NEXUS Server's browser interface, from where you can see instantly what tasks require your attention.Accessing the Tasks area of the NEXUS Server's browser interface, from where you can see instantly what tasks require your attention.

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