2014 Software Global Client Conference - …iom.invensys.com/EN/SoftwareGCC14Presentations/Technical Support... · 2014 Software Global Client Conference Agenda Overview Wonderware

2014 Software Global Client Conference

WW TSS-06

Getting to know

Wonderware

Application

Server Toolkits

Presented by:

Prerana Kulkarni


Agenda

●Overview

●Wonderware Application Server Toolkits:

● Concepts

● Requirements

● Workflow

● Integration with Application Server

● Compatibility

● Demo

● References


Wonderware Toolkits

DAS Toolkit 3.0

Historian SDK 2014

Alarm Toolkit

IntelaTrac SDK

• AOT 2014

• GRAccess 2014

• MxAccess 2014 Extensibility Toolkits

IDEA

InTouch QuickScript

Wizard

…


Wonderware Application Server Toolkits

Application Server

Toolkits

(AOT) Enables developers to extend the ArchestrA architecture with Objects that provide specific application functionality

Enables developers to create programmatic access to and interaction with System Platform Galaxy configuration data

Enables developers to create programmatic access to runtime data in a System Platform Galaxy


ArchestrA Object Toolkit

AOT


ArchestrA Object Toolkit - Concepts

ArchestrA Object Consists of:

● Top Level Primitive

● Child Primitives

● Attributes

● Editor

*** very simplistic view ***



Detailed look at Attributes / Primitives in an ArchestrA Object:

Attributes: are data items for data exchange

Primitives: are modules containing code and attributes

Local Primitive

ReUsable Primitive

*** Both local and reusable primitives can be made “virtual.” ***

Common Primitive common attributes and functionality that all objects need

hidden, and you can’t edit it in any way.



ArchestrA Object Code Modules:

● Dictionary

●Code files that define the object shape and attributes

● Configtime

●Code files for the object’s config time (“package”) code

● Editor

●Code files for the custom object editor UI and code

● Runtime

●Code files for the object’s run time code


ArchestrA Object Toolkit 2014 -

Requirements

Supported Application Server & Operating System

Application Server version 2014, 2014 P01 or

2014 R2 Integrated Development

Environment (IDE)

Windows 7 SP1 / Windows 2008 R2 SP1 /

Windows 2012 Standard / Windows 2012 R2

Development Visual Studio 2010 Sp1

Visual Studio 2012 Update 1 or later

Visual Studio 2013

ArchestrA Object Toolkit 4.0

`


ArchestrA Object Toolkit - Workflow

●Object Creation Workflow:

● Start Visual Studio, select ArchestrA Object Template

● Define Object Shape in Object Designer

● Add attributes and primitives on Editor

● Add Configtime logic

● Add Runtime logic

● Build the Object

●Output of Object build –

● .aaPDF file (object) and .aaPRI file (reusable primitive)


ArchestrA Object Toolkit – Workflow…


ArchestrA Object Toolkit – Integration

● Import .aaPDF file

● Create Derived Template

● Create Instance

● Open Editor


ArchestrA Object Toolkit - Compatibility

●AOT 3.1 App Server 3.1 and 3.1 SP1

●AOT 3.1 SP1 App Server 3.1 with SP2

●AOT 3.2 App Server 3.5

●AOT 4.0 Application Server version 2014, 2014 P01 or 2014 R2

Forward Compatibility – supported.

Backward Compatibility – not supported


ArchestrA Object Toolkit - Demo


ArchestrA Object Toolkit – References

AOT 1.0 FAQ Frequently Asked Questions 36

Tech Note 421 Using Methods from a C# Class Library in ArchestrA Object Toolkit

Runtime/Package Projects

Tech Note 394 Adding a Help File to an ArchestrA® Object

Tech Note 473 Troubleshooting Platform Install Manager (aaPIM) Errors

Tech Note 409 Implementation Details for Virtual Reusable Primitives

Tech Note 449 Adding an ActiveX® Control to an Application Object's Editor

ArchestrA Object Toolkit Object

Migration Guide Summary: Best Practices, Recommendations, and FAQs for Migrating your Older

ArchestrA Objects.

Tech Note 609 ArchestrA Object Toolkit 3.1 Tips and Tricks

Tech Note 1000 Wonderware Application Server Security Troubleshooting Essentials Part 3:

Attribute Category


GRAccess Toolkit


GRAccess - Concepts

GR Access Toolkit

Galaxy

Repository

Package

Framework IDE (Editor)

Methods &

Interfaces


GRAccess - Concepts

Ability to create and delete Galaxies.

Allows backup and restore of the Galaxy.

Supports import and export of objects.

Allows configuration of security settings for the Galaxy.

Object

Configuration

Galaxy

Management

Attribute

Modification


GRAccess - Concepts





Allows deployment and undeployment of objects.

Supports check out and check in operations.

Access to User-Defined Attributes and Extensions.

Object

Configuration

Galaxy

Management

Attribute

Modification


GRAccess - Concepts





Allows deployment and undeployment of objects.

Supports check out and check in operations.

Access to User-Defined Attributes and Extensions.

Exposes all the ArchestrA data types and categories.

Access to lock status and security classifications.

Supports single-element and array attributes.

Object

Configuration

Galaxy

Management

Attribute

Modification


GRAccess - Concepts

GRAccessApp

IGalaxies

IGalaxy

IToolsets

IToolset

IScriptLibraries

IScriptLibrary

IgObjects

IgObject

IAttributes

IAttribute

ICommandResults

ICommandResult

MxValue


GRAccess - Concepts

IgObjects

IGalaxySecurity

IGalaxyRoles

IGalaxyRole

IGalaxyUsers

IGalaxyUser

IGalaxyRoles

ISecurityGroups

ISecurityGroup

IPermissions

IPermission IPermissions

ISecurityGroup

IGalaxy


GRAccess 2014 - Requirements

Runtime

Wonderware System Platform 2014, 2014

P01, or 2014 R2

Integrated Development Environment (IDE)

Development license

Application Server 2014

Galaxy Repository (Local or Remote)

Development

Visual Studio 2010 Sp1

Visual Studio 2012

Visual Studio 2013

ArchestrA GRAccess Toolkit 4.0

`


GRAccess - Workflow

●Open Visual Studio Project,

and add ArchestrA.GRAccess.dll

to References:

●GRAccessApp m_gr = new GRAccessApp();

● m_gr object must be active when you want to use any of GRAccess

Objects. This means that it should not go out of scope from your code path.


GRAccess – Integration

●GRAccess can be used as:

● Standalone Application

● In Application Server Script

● .Net Client Control (then used in ArchestrA Symbol)

● Web Application


GRAccess - Compatibility

●GRAccess 3.0 App Server 3.0 and 3.1

●GRAccess 3.1 SP1 App Server 3.1 with SP2

●GRAccess 3.2 App Server 3.5 (System Platform 2012)

●GRAccess 4.0 App Server version 2014, 2014 P01 or 2014 R2




GRAccess - Demo

●System Platform 2014 Patch 01:

● Custom Property

● Element Style Animation

● Alarm Border Animation

● Trend Pen & Animation

● Client controls

● Alarm Client & Animation

● Trend Client & Animation

● Container Scripts

● Symbol Wizard

GRAccessDemo.wmv


GRAccess Toolkit WDN References

Tech Note 465 GRAccess Demo Applications Using Microsoft® Visual Studios 2003

Tech Note 526 Automating Object Configuration Tasks Using GRAccess: Configuring the OPCClient DIObject

Tech Note 528 Automating Object Configuration Tasks Using GRAccess: Creating and Configuring Field Attributes

Tech Note 537 Creating an Application Object Script Using GRAccess

Tech Note 544 Understanding GRAccess Licensing

Tech Note 727 Automating Object Configuration Tasks in the GRAccess Toolkit: Configuring Properties for Analog

FieldAttribute

Tech Note 728 Using GRAccess Toolkit to Determine Values and DataTypes for a Property

Tech Note 962 Automating Object Configuration Tasks in the GRAccess Toolkit: Configuring UDA Array


MxAccess Toolkit


MxAccess - Concepts

Fast, simple access to attributes values within the Galaxy.

Attributes are provided as notifications when the values changes.

Access to both, single-element and array attributes.

Real-Time

Data

Modification

Real-Time

Data

Retrieval

Integrated

ArchestrA

Security


MxAccess - Concepts

Allows for real-time writes to attributes within the Galaxy.

Single-element attributes do not have to be cast to the right data type.

Array attributes must be cast to the correct data type.




Real-Time

Data

Modification

Real-Time

Data

Retrieval

Integrated

ArchestrA

Security


MxAccess - Concepts

Allows for real-time writes to attributes within the Galaxy.

Single-element attributes do not have to be cast to the right data type.

Array attributes must be cast to the correct data type.




Real-Time

Data

Modification

Real-Time

Data

Retrieval

Implemented through authentication of users.

Supports SecuredWrite and VerifiedWrite security classifications.

Client application must handle the correct behavior

when user authentication is required.

Integrated

ArchestrA

Security


MxAccess 2014 - Requirements

Runtime

Windows 7 Sp1, 2008R2, 2012 , 2012R2

Application Server 2014, 2014 P01, 2014 R2

(deployed ArchestrA Platform)

MxAccess Runtime license

Development

Visual Studio 2010 Sp1

Visual Studio 2012 Update 1 or later

Visual Studio 2013

ArchestrA MX AccessToolkit 4.0

`


MxAccess - Workflow

●Open Visual Studio Project,

add ArchestrA.MxAccess.dll to

References

●Declare the LMXProxyServer object:

ArchestrA.MxAccess.LMXProxyServerClass LMX_Server;

● Instantiate an ArchestrA.MxAccess.LMXProxyServer

LMX_Server = new ArchestrA.MxAccess.LMXProxyServerClass();


MxAccess – Workflow

●Register() – Establish connection to LMX

●AddItem() - To access an ArchestrA Attribute, you must first add it to

the internal table of attribute references that LMX maintains for your

connection.

●Advise() – Subscribe to an attribute / Start receiving data updates

OR Write() – Writes data to an attribute

●UnAdvise() – Stops the Advise from the attribute

●RemoveItem() – removes attribute reference from internal table

●Unregister() – Disconnects / Release connection from LMX


MxAccess – Integration

● Standalone Application – Windows / Console Application

● Activex control

● .Net Client Control and used in ArchestrA Symbol

● Web Application

Or More…


MxAccess - Compatibility

●MxAccess 3.1 App Server 3.1

●MxAccess 3.1 SP1 App Server 3.1 with SP2

●MxAccess 3.2 App Server 3.5 (System Platform 2012)

●MxAccess 4.0 App Server version 2014, 2014 P01 or 2014 R2




MxAccess - Demo


MxAccess Toolkit WDN References

Tech Note 875 MxAccess Toolkit Application Might Throw an Exception on 64-bit Windows

42 Confidential Property of Schneider Electric

Related Support, Services, Training & Expo Demos

> [insert Support options here]

> [sample: Proactive System Monitoring]

> [sample: Software Asset Manager]

> [sample: …]

Support

Training

> [insert Training options here]

> [sample: Application Server 2012 R2 Web-

Based Training]

> [sample: InTouch Alarms Webinar]

> [sample:…]

> [insert Services options here]

> [sample: Project Mgmt Services]

> [sample:…]

> [sample:…]

Services

Expo Demos

> [insert related Expo Demos here]

> [sample: Control Room Console for

W&WW (booth #2)]

> [sample: Process Information with Historian

(booth #4)]

> [sample:…]

43 ©2014 Schneider Electric. All Rights Reserved.

All trademarks are owned by Schneider Electric Industries SAS or its affiliated companies or their respective owners.



Documents

2014 Software Global Client Conference - …iom.invensys.com/EN/SoftwareGCC14Presentations/Technical Support... · 2014 Software Global Client Conference Agenda Overview Wonderware