S95 EM Site Class

Site objects are hierarchical elements, representing the ISA-95 equipment level of the same name in the ISA-95 Equipment Model of the system.

Underneath the abstract Enterprise object (representing the complete business organization) 'Site' objects represent the different geo locations of the enterprise.

Each 'Site' object is further divided into multiple Areas.

Quick Configuration

  1. In the ISA-95 Equipment Model panel right-click on the Enterprise object and select Admin  New  Site from the context menu.

  2. Code Execution and Visibility Configuration
    For Autonomous Site Operation the S95 EM Site object can be linked to a Local Core object in the I/O Model to provide local Code Execution capabilities for its child items.

    This property can only be configured in DataStudio at the moment of creation. It will be grayed out and non-configurable in the Object Properties panel after creation.
    Only one core per branch! If a Local Core is assigned to a S95 EM Site object, NO further Local Cores can be assigned to child objects of this Site object. Multiple Local Cores can be used for a Site in the ISA-95 Equipment Model if they are assigned on S95 EM Area level.

    To specify the component which executes the for the objects in the branch underneath this Site object, …​

    1. Go to the Execution and Visibility property section and click on the …​ icon for the Code Execution property to open the object picker dialog.

    2. In the dialog select the component where the code is going to be executed, from the I/O Model.

    3. Click OK to close the object picker dialog.

  3. Click Create to create the object in the ISA-95 Equipment Model.

Object Properties

Common

ID

The unique identification.

Description

Additional information.

Asset Code

The code which is used to identify the asset in the ERP system.

MES Name

The name of this object in the MES world.

Lua Script Body

Script editor to enter an advanced Lua script.

Dedicated Thread Execution

When set, the item executes in a thread not shared with other items.

Criticality

Criticality.

Attachments

File attachments stored in MongoDB file store.

Script Library

The script library compound contains Lua-Script libraries.

Module Name

The Lua module name of the library that will be used to reference the library by its users.

Lua Script Body

Script editor to enter an advanced Lua script.

Mandatory Execution

Execute the script library when initializing the Lua environment for child objects.

Location

The location of the object.

Strategy

Definition of the location strategy.

  • No location: This object is not interpreted in a location context.

  • Static (or manually changed) location: You may set the location data manually, by Engineering Script or by selecting the location visually using the Location Finder feature.

  • Inherited location: The object inherits the location from the owning object in the system hierarchy.

  • Dynamic location: The object location is supplied by other I/O Items. You may drop other I/O items into the location fields of this object.

  • Location properties: The endpoint server has distinct properties for I/O item location data. Please note, that this option works only for I/O items .

Name

The optional name of a location.

Latitude

The north-south position of a point on the Earth’s surface.

Longitude

The east-west position of a point on the Earth’s surface.

Altitude

The height above sea level of the location.

Track Location

Enables historization of Location data.

Execution and Visibility

Property group to configure the code execution and object visability scope.

Code Execution

This determines in which service component the object executes its code (logic). It will only be visible in this component and its parent components. If the property is not configured then the object inherits the property from its ancestors. If no ancestors have the property configured then the code execution is assigned to the Master Core.

Custom Options

Compound to hold various structures to customize the object and to be read and written to by Lua-Script code or external interfaces.

Custom String

A generic string buffer to be used programmatically for custom purposes.

Custom Properties

This is an extensible set of named strings which can be used programmatically for custom purposes.

Property Name

A custom property name which can be used programmatically.

Property Value

The value of the custom property which can be read and written programmatically.

Custom Tables

This is an extensible set of named tables which can be used programmatically for custom purposes.

Table Name

A custom table name which can be used programmatically.

Table Data

Handles an entire table organized in columns and rows. The data can easily (cut, copy and paste) be exchanged with table-oriented data of other software products, e.g. MS Excel.