AseptSoft Core Documentation

Equipment Module

An Equipment Module groups related Engineering Items into a reusable functional unit. Equipment Modules use a template-based system where you define a template with item slots, then create multiple configurations that assign different physical components to those slots.

💡 In pharmaceutical terms: An Equipment Module represents a group of Engineering Items that always work together — such as a tank inlet assembly (inlet valve + vent valve + pressure transmitter), a CIP supply manifold, or a transfer path between vessels. By grouping them, you can write your process logic once and reuse it across multiple physical configurations.

https://downloads.aseptsoft.ch/documentation/images/Module-Data/Equipment-Module/em-collection.png

🧩 Core Concepts

Template System

The Equipment Module system has three layers:

Layer

What It Is

Example

Configuration Template

Defines the structure — what item slots exist

"Transfer Path" template with 3 item slots

Configuration

A named instance — assigns specific items to slots

"Path A", "Path B", "Path C"

Configuration Item

An individual item slot within a template

"Inlet Valve", "Outlet Valve", "Return Valve"

How It Works

  1. Create a Template — define the item slots (e.g., "Inlet Valve", "Outlet Valve", "Drain Valve")

  2. Create Configurations — name each configuration (e.g., "Transfer to Tank 1", "Transfer to Tank 2")

  3. Assign Items — for each configuration, pick which actual Engineering Item from the P&ID fills each slot

https://downloads.aseptsoft.ch/documentation/images/Module-Data/Equipment-Module/config-template-form.png

The key benefit: Process logic references item slots by name (e.g., "Inlet Valve = Open") rather than specific item names, making the logic reusable across configurations.


📋 Properties

Equipment Module

Property

Type

Description

Name

Text

Unique identifier for the equipment module

Color

Color

Visual color for highlighting on the P&ID

Configuration Template

Reference

The template that defines the module's structure

Schema

Reference

The configuration schema

Configuration Template

Property

Type

Description

Name

Text

Template name (e.g., "Transfer Path", "CIP Manifold")

Color

Color

Visual color for the template

Configuration Items

List

Item slot definitions within the template

Configurations

List

Named configuration instances

Configuration

Property

Type

Description

Name

Text

Configuration name (e.g., "Path A", "Path B")

Template

Reference

Parent template reference

Configuration Item

Property

Type

Description

Name

Text

Item slot name (typically the Engineering Item name)

Color

Color

Visual color for this item

Template

Reference

Parent template reference


📖 How To: Create an Equipment Module

Method 1: Create from Selection (Interactive)

The fastest way to create one or more Equipment Modules, driven directly by a P&ID selection. The Create Equipment Module command opens an interactive review window where you can fine-tune templates, item names, and check names before anything is committed to the project.

https://downloads.aseptsoft.ch/documentation/images/Export-Import/Import-Equipment/create-equipment.png

Workflow

  1. Select the Engineering Items on the P&ID that belong together (valves, instruments, sources — any mix works).

  2. Run the Create Equipment Module command (from the Equipment Module Ribbon or by typing ASEPTSOFTCreateEquipmentModule). If no selection is active, the command prompts you to pick entities in the drawing.

  3. Review the proposed EM in the window that opens:

    • The Equipment Module gets an auto-generated name (e.g. Equipment Module 1) which is pre-selected in the editable name box at the top. Just start typing to rename it.

    • A new Configuration Template is pre-proposed with one item per selected valve, item names matching valve names.

    • Each valve-to-item link is shown in the grid and can be re-mapped via the dropdown.

  4. Optionally add more Equipment Modules in the same session by clicking ➕ Add another EM. The window hides, AutoCAD prompts for a fresh selection, and the window reopens with the new EM added — preserving all your choices on the first EM.

  5. Confirm by clicking 🧩 Create (or pressing Enter while the name box has focus). All selected EMs are created at once; the Equipment Modules ribbon gallery refreshes immediately so the new modules are available.

Per-EM adjustments in the window

Area

What You Can Do

Name box

Rename the EM. Auto-focused and fully selected on window open — just type.

Check box

Uncheck to skip this EM at Create time (keeps your other choices intact).

Template dropdown

Accept the auto-generated new template, type a different new name, or pick an existing template from the dropdown.

Item dropdowns

For each valve, accept the auto-suggested item name (which matches the valve name) or pick a different template item.

Suggestion radio buttons

Switch between Use existing templates, Create new and reuse, or Create new for each EM to regenerate suggestions.

💡 Zero-click path: After selection, if you are happy with the default name, template, and 1:1 valve→item mapping, simply press Enter to create the Equipment Module immediately. Press Esc at any time to cancel without creating anything.

Method 2: Manual Creation in Module Data

  1. Open Module Data — Navigate to the Data panel in the Module Ribbon.

  2. Go to the Equipment Modules tab — Select the Equipment Modules section.

  3. Create a new Equipment Module — Click "Create new" and name it.

  4. Define item slots — Add slots to the configuration template (e.g., "Inlet Valve", "Outlet Valve").

  5. Create configurations — Add named configurations (e.g., "Tank 1 Path", "Tank 2 Path").

  6. Assign items — For each configuration, pick which actual Engineering Item from the P&ID fills each slot.

Method 3: Bulk Import from Excel

For importing many Equipment Modules at once from an Excel workbook, see Import Equipment Modules from Excel. The same review window is used, with an additional Excel-driven data column for State values.


🛡️ Valve Exclusivity

Each valve can belong to at most one Equipment Module across the entire project. This rule is enforced consistently across all creation and import methods:

Creation method

What happens when a selected valve is already in another EM

Create from Selection

A warning dialog lists each conflicting valve with its owning EM. You can proceed with the remaining (non-conflicting) valves, or cancel.

Add another EM

Same warning, both for valves in the project's existing EMs and for valves you've already placed in EMs being created in the same session.

Excel Import

Conflicting valves are silently dropped from the import; a warning dialog lists all exclusions grouped by the EM that already owns each valve.

ℹ️ To move a valve between EMs: first remove it from its current EM (via Module Data or the Remove Item action on the Equipment Module ribbon), then add it to the target EM.


🎨 Equipment Module Highlighting

When an Equipment Module is active or selected, its components can be highlighted on the P&ID drawing. The highlighting uses the Equipment Module's color and automatically colors the grouped items.

The EM Ribbon provides controls for:

  • Selecting which Equipment Module to highlight

  • Toggling highlighting on/off

  • Managing Equipment Module configurations


🏭 Example: Tank Inlet Module (Pharma)

A typical pharmaceutical tank inlet module groups the Engineering Items at the top of a process vessel:

Template: "Tank Inlet Module"

Slot

Description

Typical Item

Inlet Valve

Controls fluid entry to the tank

Diaphragm valve

Vent Valve

Controls vent line for pressure equalization

Ball valve

Pressure Transmitter

Measures tank headspace pressure

Pressure sensor

Level Transmitter

Measures tank fill level

Radar level gauge

Configurations

Configuration

Inlet Valve

Vent Valve

Pressure Transmitter

Level Transmitter

Tank T-100

XV-101

XV-102

PT-101

LT-101

Tank T-200

XV-201

XV-202

PT-201

LT-201

Tank T-300

XV-301

XV-302

PT-301

LT-301

With this setup, a process step can reference "Inlet Valve = Open" and it will automatically apply to the correct physical item (XV-101, XV-201, or XV-301) depending on which configuration is active.


🏭 Example: CIP Supply Manifold

Slot

Description

WFI Supply Valve

Controls WFI supply to the CIP circuit

Acid Supply Valve

Controls acid dosing into the circuit

Caustic Supply Valve

Controls caustic dosing into the circuit

Return Valve

Controls the return line back to the CIP skid

Supply Pump

The CIP circulation pump

Temperature Sensor

Monitors CIP solution temperature


🛠️ Common Operations

Operation

Description

Create from Selection

Interactive multi-EM creation driven by P&ID selection (see Method 1 above)

Create in Module Data

Manual creation from the Module Data window (see Method 2 above)

Import from Excel

Bulk import from an Excel workbook (see Method 3)

Edit

Modify template slots, configurations, or item assignments

Rename

Change the name of a template, configuration, or item

Delete

Remove an Equipment Module, configuration, or item

Add Configuration

Create a new named configuration for an existing template

Add Item

Add a new item slot to a template


https://downloads.aseptsoft.ch/documentation/images/Module-Data/Equipment-Module/em-form-filled.png