Getting More Mileage out of your SmartPlant Instrumentation Solution

Size: px

Start display at page:

Download "Getting More Mileage out of your SmartPlant Instrumentation Solution"

Claire Stone
5 years ago
Views:

1 Process, Power and Marine Division Getting More Mileage out of your SmartPlant Instrumentation Solution Intergraph September 22, 2009

2 Agenda Objective of the session The Topics Conclusions

3 Objectives Provide information on the use of the SP Instrumentation capabilities to increase the efficiency using the solution Provide a platform to ask question to the SPI team Increase the understanding of existing and new features The Presenters Doron Goshen, Development IISDC Gina Outlaw, Support Huntsville Alex Koifman, Product Manager Huntsville

4 The Topics For this session the two main topics are: The new specification sheets The external function

5 Opportunities Learn about the new capabilities Better utilize the products capabilities Increase the productivity Learn about the better and easier ways (tips and tricks) Learn about possibilities to customize Learn about optimizing the workflows Ask the experts at the Intergraph team And more.

6 External Functions - Introduction The SmartPlant Instrumentation External Function is an extension of the Rule Manager which allows you to create custom design validation rules and automate data entries from external sources, using one of the following: logic code. third party applications. This external programming enables two types of external function Update (data entry based on custom rules and from external sources or programs) Validate (data verification based on custom rules and from external sources or programs) The underlying principle of the external functions is that your SmartPlant Instrumentation administrator can define additional validation and update rules in SPI using the Rule Manager. SPI will utilize these rules at runtime. In order for that, you will have to write additional code that will activate these rules. You can use both Microsoft Visual Basic.NET and Microsoft C# with the SPI software to implement internal validation and modification routines.

7 Requirement Skills Knowledge of SPI data model. Knowledge of SPI Items and their relations Intermediate level of.net (C# or VB.NET)

8 Understanding External Functions External functions are controlled by SmartPlant Instrumentation Rule Manager. External functions are the implementation of the spiextendedservice Interface, which is part of SPIExternalService.dll file supplied with SmartPlant Instrumentation v2009. SmartPlant Instrumentation Rule engine interfaces with SmartPlant Instrumentation core objects. These objects are called business object. At runtime, these objects use the rule engine. By creating rules which are defined as external functions, the rule engine can invoke your customization code at runtime, every time you create, modify, or associate an item in SmartPlant Instrumentation. The rule engine invokes your assembly component based on its signature which is the C# or VB.NET Assembly name and class name.

9 The External Custom Validation Function The external custom validation function enables you to extend the core validation of SmartPlant Instrumentation. You can do this by writing your own logic code using C# or VB.NET or trigger a third party application, and then attaching it to SmartPlant Instrumentation Rule Manager using your Assembly Project signature. The rule engine functions according to the Boolean value returned by the CustomValidation function. In case of 'False', the rule engine rejects the modifications made by SmartPlant Instrumentation users. In case of 'True', the rule engine accepts the user modifications.

10 Syntax of the Validation Function bool spiextendedservice.customvalidation(string AttrName, string AttrValue, bool AttrModified, string ItemType, string PrimaryAttr, string PrimaryValue, long LowerPBSID) Argument Type Description AttrName string The attribute name that was selected in the rule definition. AttrValue string The value of the attribute name that was selected in the rule definition. AttrModified boolean Indicates if the selected attribute has been modified by a SmartPlant Instrumentation user. Item Type string Represents the main SmartPlant Instrumentation object that triggers the Rule engine. PrimaryAttr string Represents the primary attribute name. PrimaryValue string Represents the primary attribute value. LowerPBSID long Represents the lowest level plant hierarchy item <Unit ID> Argument Return Value Type boolean

External Validation Function Example The following is an example that shows how to define a rule that validates loop uniqueness not just on the level of the current unit but also on

11 External Validation Function Example The following is an example that shows how to define a rule that validates loop uniqueness not just on the level of the current unit but also on the plant level including all the cables and panels. You can find the example solution in your SmartPlant Instrumentation folder > Examples > SPIExternalExample.sln Create a new rule.

12 External Validation Function Example Assign the new rule to the instrument item type.

13 External Validation Function Example Define the details of the external function.

14 External Validation Function Example Write the relevant # or VB.NET code.

15 External Validation Function Example If the validation results have to show error messages, the SmartPlant Instrumentation users will see the following (the inconsistency message originates from spiextendederice.errdesc):

16 DEMO of External Validation

17 External Custom Update Function The external custom update function enables you to extend the core update of SmartPlant Instrumentation. You can do this by writing your own logic code using C# or VB.NET or trigger a third party application. Both of those options can return a value which will be entered in the SPI database using the rule engine. The external update function lets you control and modify the attribute values of a new, modified, and related items that are triggered by the relevant custom update rule that is defined in the Rule Manager. Attaching the External Update function to SmartPlant Instrumentation Rule Manager is done using your Assembly Project signature.

18 External Update Function Example In this example you want the software to open a custom dialog box to update a service. The software will open this dialog box after a SmartPlant Instrumentation user modifies an instrument. You can find the example solution in your SmartPlant Instrumentation folder > Examples > SPIExternalExample.sln

19 External Update Function Example In this example you want the software to open a custom dialog box to update a service. The software will open this dialog box after a SmartPlant Instrumentation user modifies an instrument. You can find the example solution in your SmartPlant Instrumentation folder > Examples > SPIExternalExample.sln

20 DEMO of External Update

21 DEMO of New Specification sheets

22 Conclusion The new specification sheets Meet industry needs Includes 91 specification forms The external function Custom rules to verify design Automate data entry with validated data Increase productivity and data quality Better and earlier data for down stream use

23 Q&A

24 Process, Power and Marine Division The Future of Engineering Today

UK I&E Technical User Forum SPI Calibration Module and Fluke integration. Name: Alex Koifman Company: Intergraph Date: September 23, 2008

UK I&E Technical User Forum SPI Calibration Module and Fluke integration Name: Alex Koifman Company: Intergraph Date: September 23, 2008 Discussion topics Calibration Module role and position Integration