Adding Sample Definitions via Scripting

Sepasoft MES Module Suite

Adding Sample Definitions with Scripting

The SPC Sample Definition Manager is generally used to add Sample Definition Classes and Sample Definitions. However, there are situations where you may want to add these via scripting. The SPC module provides scripting functions to perform a variety of tasks, such as adding or modifying Sample Definition Classes and Sample Definitions. 

A sample definition (SPC definition) defines what to measure, where samples may be taken, and which control limits and rules apply. You can create and update definitions from script using system.mes.spc.definition, then persist the object with system.mes.saveMESObject. Run these scripts on the Gateway (or from the client in contexts that execute on the gateway) with Production and Quality modules available.

Before you begin

  • Use a unique definition name.

  • locationPath must be a valid MES equipment path to a location (for example Enterprise/Site/Area/Line/Location).

  • Sampling interval must match a configured interval name in your enterprise (for manual collection, Manual is typical).

  • Control limit and SPC rule (signal) names must already exist. Use the list functions below to see valid names in your system.

List valid limit and rule names

Copy Code
Python
limitNames = system.mes.spc.definition.getLimitNameList()
signalNames = system.mes.spc.definition.getSignalNameList()

Optional: list existing sample definitions

showDisabled=True includes disabled definitions; False returns only enabled definitions.
Copy Code
Python
defs = system.mes.spc.definition.getSampleDefinitionList(False, '*', '')

Create a new sample definition


  • Create the definition object

Call getSampleDefinition with an empty string for the name so the system creates a new definition. (Loading an existing definition uses the same function with a non-empty name.)
Copy Code
Python
sd = system.mes.spc.definition.getSampleDefinition('')

  • Set name, interval, and optional fields.

Copy Code
Python
sd.setName('Scripted Width SPC')
sd.setInterval('Manual')
sd.setDescription('Width monitoring from script')
sd.setDefaultSampleSize(1)
sd.setAutoApprove(False)
sd.setAutoEvaluateSignals(True)

  • Add one or more attributes

Use addAttribute with keyword arguments. attributeName is required; dataType defaults to REAL if omitted. Chart names (for example Individual, XBar) must match types configured in your system.

Copy Code
Python
system.mes.spc.definition.addAttribute(
    sampleDefinition=sd,
    attributeName='Width',
    dataType='REAL',
    defaultChart='Individual',
    measurementCount=1,
    units='mm'
)

Optional keywords also supported: format, min, max.

  • Add allowed location(s)

Copy Code
Python
system.mes.spc.definition.addLocation(
    sampleDefinition=sd,
    locationPath='Enterprise/Site/Area/Line/Location',
    autoApprove=True
)

  • Add control limits (optional)

Each name must appear in getLimitNameList().

Copy Code
Python
system.mes.spc.definition.addLimit(sd, 'Individual LCL')
system.mes.spc.definition.addLimit(sd, 'Individual UCL')

  • Add SPC rules / signals (optional)

Each name must appear in getSignalNameList().

Copy Code
Python
system.mes.spc.definition.addRule(sd, 'Western Electric Rule 1')

  • Save

Copy Code
Python
system.mes.saveMESObject(sd)

  • Verify (optional)

Copy Code
Python
loaded = system.mes.spc.definition.getSampleDefinition('Scripted Width SPC')

  • Update an existing definition

Load by name, change properties or add attributes, locations, limits, or rules, then save again.

Copy Code
Python
sd = system.mes.spc.definition.getSampleDefinition('Scripted Width SPC')
sd.setDescription('Updated from script')
system.mes.saveMESObject(sd)

Complete Jython Code Example

Replace paths, interval, limits, and rules with values that exist in your environment.

Copy Code
Python
# Optional: inspect configured names
# limits = system.mes.spc.definition.getLimitNameList()
# signals = system.mes.spc.definition.getSignalNameList()

sd = system.mes.spc.definition.getSampleDefinition('')
sd.setName('Scripted Width SPC')
sd.setInterval('Manual')
sd.setDescription('Example sample definition created from script')
sd.setDefaultSampleSize(1)

system.mes.spc.definition.addAttribute(
    sampleDefinition=sd,
    attributeName='Width',
    dataType='REAL',
    defaultChart='Individual',
    measurementCount=1,
    units='mm'
)

system.mes.spc.definition.addLocation(
    sampleDefinition=sd,
    locationPath='Enterprise/Site/Area/Line/Location',
    autoApprove=True
)
# Optional — use names from getLimitNameList()
system.mes.spc.definition.addLimit(sd, 'Individual LCL')
system.mes.spc.definition.addLimit(sd, 'Individual UCL')

# Optional — use names from getSignalNameList()
# system.mes.spc.definition.addRule(sd, 'Western Electric Rule 1')

system.mes.saveMESObject(sd)


Script functions used in this topic

Function

Purpose

system.mes.spc.definition.getSampleDefinition(name)

New definition if name is blank; otherwise load by name.

system.mes.spc.definition.addAttribute(...)

Add a measured attribute to the definition.

system.mes.spc.definition.addLocation(...)

Tie the definition to a location path.

system.mes.spc.definition.addLimit(sd, limitName)

Add a control limit by name.

system.mes.spc.definition.addRule(sd, ruleName)

Add an SPC rule by name.

system.mes.spc.definition.getLimitNameList()

List configured control limit names.

system.mes.spc.definition.getSignalNameList()

List configured signal/rule names.

system.mes.spc.definition.getSampleDefinitionList(showDisabled, nameFilter, locationPathFilter)

Query definitions as a dataset.

system.mes.saveMESObject(mesObject)

Persist the sample definition.


Related

  • system.mes.loadMESObject — Load MES objects by UUID or name and type when needed for other workflows.

  • system.mes.createMESObject — Alternative way to create a new object by type name (for example sample definitions) where supported by your scripting context.


Sepasoft MES Module Suite