Intergraph Webinar Series 9_22_09 SP Instrumentation Webinar slides.pdf

Process, Power and Marine Division

Getting More Mileage out of your SmartPlant Instrumentation Solution

Intergraph

September 22, 2009

© 2009. Intergraph Corporation. All Rights Reserved.

Agenda

Objective of the sessionThe TopicsConclusions

Objectives

Provide information on the use of the SP Instrumentation capabilities to increase the efficiency using the solutionProvide a platform to ask question to the SPI teamIncrease the understanding of existing and new features

The PresentersDoron Goshen, Development IISDCGina Outlaw, Support HuntsvilleAlex Koifman, Product Manager Huntsville


The Topics

For this session the two main topics are:

The new specification sheetsThe external function


Opportunities

Learn about the new capabilitiesBetter utilize the products capabilitiesIncrease the productivityLearn about the better and easier ways (tips and tricks)Learn about possibilities to customizeLearn about optimizing the workflowsAsk the experts at the Intergraph teamAnd more………….


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.


Requirement Skills

Knowledge of SPI data model.Knowledge of SPI Items and their relationsIntermediate level of .NET (C# or VB.NET)


Understanding External FunctionsExternal 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, orassociate 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.


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.


Syntax of the Validation Function

bool spiExtendedService.CustomValidation(string AttrName, string AttrValue,bool AttrModified, string ItemType,string PrimaryAttr, string PrimaryValue,long LowerPBSID)


Argument Type DescriptionAttrName 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 TypeReturn Value

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 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.



– Assign the new rule to the instrument item type.



– Define the details of the external function.



Write the relevant # or VB .NET code.



If the validation results have to show error messages, the SmartPlant Instrumentation users will see the following (the inconsistency message originates from spiExtendederice.ErrDesc):


DEMO of External Validation


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.


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


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


DEMO of External Update


DEMO of New Specification sheets


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


Q&A


Process, Power and Marine Division

The Future of

Engineering –

Today

Documents

Intergraph Webinar Series 9_22_09 SP Instrumentation Webinar slides.pdf