AseptSoft Core Documentation

Equipment Module

An Equipment Module groups related Engineering Items — valves and instruments — into a reusable functional unit. Equipment Modules use a template-based system: you define a template with named item slots, then describe the operating modes of that equipment as Configurations (resting snapshots) and Equipment Phases (transitions between snapshots). Process logic references the slots by name, so the same logic reuses across every physical instance of the template.

💡 In pharmaceutical terms: an Equipment Module represents a group of Engineering Items that always work together — a tank inlet assembly (inlet valve + vent valve + pressure transmitter), a CIP supply manifold, or a transfer path between vessels. Grouping them lets you 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

The four layers

Layer

What it is

Example

Configuration Template

Defines the structure — which item slots exist (valves and instruments)

"CIP Manifold" template with 4 valve slots + 1 instrument slot

Configuration Item

An individual item slot within a template, carrying a type (Valve / Tank / Pump / Heat Exchanger)

"Supply Valve", "Return Valve", "TIC (temperature controller)"

Configuration

A named resting snapshot — each cell sets a slot's state, percent, attributes, or instrument control

"Idle", "WFI Pre-Rinse", "Caustic Recirculation"

Equipment Phase

A trajectory of control steps that carries the equipment from one Configuration to another

"Caustic Wash", "Drain"

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

The configuration template form

The Configuration Template form is the table view of a module's definition. Item slots are rows, Configurations are columns, and each cell shows the full operating specification for that item in that configuration — not just a state name.

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

Each cell renders as a scannable summary: a coloured bullet for the state, the state name, the percent (when the state is percentual), a yellow tag pill carrying the count of in-state attributes, and a blue gear pill carrying the controlling instrument's nickname or short code. Click any cell once to open the Configuration Cell Editor.

For the full anatomy of a rich cell, the cell editor's state-versus-control modes, typed attributes, and how Configurations and Equipment Phases are built and applied, see Equipment Module Configurations & Phases. For the graphical Overview and per-phase canvases, see Equipment Module Workspace & SFC Editors.


📖 How to: create an Equipment Module

Method 1: Create from a drawing 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 fine-tune the template, item names, and instrument nicknames before anything is committed.

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. Both valves and instruments are picked up — any mix works.

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

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

    • The module gets an auto-generated name, pre-selected in the editable name box at the top — just type to rename it.

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

    • Detected instruments appear in their own list, each with an editable nickname box (defaulting to the instrument name) — so the instrument-item slots are named the way you want at the moment of creation, not as a separate later step.

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

  4. Optionally add more modules in the same session with ➕ Add another EM. The window hides, AutoCAD prompts for a fresh selection, and the window reopens with the new module added — preserving all earlier choices.

  5. Confirm with 🧩 Create (or press Enter while the name box has focus). All selected modules are created at once and the ribbon gallery refreshes immediately.

Per-module adjustments in the window

Area

What you can do

Name box

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

Check box

Uncheck to skip this module at Create time while keeping your other choices.

Template dropdown

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

Valve item dropdowns

For each valve, accept the auto-suggested slot name (matching the valve name) or pick a different template slot.

Instrument nickname boxes

Edit the nickname for each detected instrument's slot before creation.

Suggestion radio buttons

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

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

Method 2: Manual creation in Module Data

  1. Open Module Data from the Module Ribbon Data panel.

  2. Go to the Equipment Modules tab.

  3. Create a new Equipment Module and name it.

  4. Define item slots — add valve slots and instrument slots to the template.

  5. Create configurations — add named configurations and fill in each cell.

  6. Assign items — for each configuration, pick which physical Engineering Item fills each slot.

Method 3: Bulk import from Excel

To import many Equipment Modules at once from a workbook, see Import Equipment Modules from Excel. The same review window is used, with an additional Excel-driven data column for cell values.


⚙️ Configurations and Equipment Phases

Each template carries two kinds of definition for the same equipment:

  • A Configuration is a resting snapshot — the complete set of cell values describing the equipment in one operating mode.

  • An Equipment Phase is a trajectory — an ordered sequence of control steps that carries the equipment from a Start configuration to a Result configuration.

Both can be plugged into a process step. The crossing of a process step and an Equipment Module in the Valve Phase Matrix is a single assignable cell: choose a Configuration to apply a snapshot, or an Equipment Phase to apply the trajectory's destination. The cell dropdown interleaves each Configuration with the Phases that end in it, so you can read snapshot-versus-trajectory at a glance.

📋 Full detail — rich cells, the cell editor, building phases with start/result/end-step, the matrix dropdown, and Excel round-trip — lives on Equipment Module Configurations & Phases.


🖼️ The Workspace & SFC editors

The graphical home for an Equipment Module is the combined Workspace: the Overview (all Configurations and Phases as a sequential function chart) on the left, and the per-phase control-step editor on the right. Open it from the SFC Editor button on the Equipment Module Ribbon, or the Overview button on the module / template forms.

The canvases support snap-to-grid dragging, clean orthogonal edge routing, distinct START/END configuration cards bracketing a phase's steps, inline edge-condition editing with intellisense, and one-click PDF export. See Equipment Module Workspace & SFC Editors for the full tour.


📋 Properties

Equipment Module

Property

Type

Description

Name

Text

Unique identifier for the equipment module

Color

Color

Visual colour for highlighting on the P&ID

Configuration Template

Reference

The template that defines the module's structure

Schema

Reference

The mapping of template slots (valve and instrument) to physical items

Configuration Template

Property

Type

Description

Name

Text

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

Color

Color

Visual colour for the template

Configuration Items

List

Valve slot definitions within the template

Instrument Items

List

Instrument slot definitions used for control relationships

Configurations

List

Named resting snapshots

Equipment Phases

List

Named trajectories between configurations

Configuration Item

Property

Type

Description

Name

Text

Item slot name (typically the Engineering Item name)

Type

Choice

Valve, Tank, Pump, or Heat Exchanger — controls which states a cell offers

Color

Color

Visual colour for this item


🛡️ Valve exclusivity

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

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 module. Proceed with the remaining valves, or cancel.

Add another EM

Same warning — both for valves in the project's existing modules and for valves already placed in modules being created in the same session.

Excel Import

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

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


🎨 Highlighting on the P&ID

When an Equipment Module is active or selected, its components can be highlighted on the drawing using the module's colour. The toggle and appearance settings live on the Equipment Module Ribbon. For the full highlighting workflow, see Equipment Module Highlighting.


🏭 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 applies 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 (an instrument slot, used to drive valves under control)


🛠️ Common operations

Operation

Description

Create from Selection

Interactive multi-module creation driven by P&ID selection (Method 1)

Create in Module Data

Manual creation from the Module Data window (Method 2)

Import from Excel

Bulk import from a workbook (Method 3)

Edit cells

Click a cell to set state / percent / attributes / instrument control

Add Configuration

Create a new resting snapshot column

Add Equipment Phase

Create a trajectory with Start and Result configurations

Open Workspace

Edit the module graphically (Overview + per-phase SFC)

Export PDFs

Produce printable SFC decks for the module

Rename / Delete

Manage templates, configurations, phases, and items


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