classic data access training compliance test tool (opcanalyzer) introduction to the opcanalyzer for...

Classic Data Access TrainingCompliance Test Tool (OpcAnalyzer)

Introduction to the OpcAnalyzerfor OPC Classic DA Client Testing

Press SPACE to advance through the slides.

• Introduction

• Familiarization of the User Interface

• Finding Help

• Test Tool Configuration

• Testing & Debugging

• Next Steps

OpcAnalyzer TrainingContents

© 2013 OPC Foundation 3

OpcAnalyzer TrainingIntroduction (1 of 3)

What is it? OpcAnalyzer is a middleware component for testing

a Classic DA Client for compliance

Where is it? www.opcfoundation.org/opcanalyzer

Who can get it? OPC Foundation Corporate Members

What is tested? Classic Data Access Clients

Coverage? Data Access 2.05a and 3.0 Interfaces

Extensible? Yes, you can add your own tests

Easy to use? Yes, once you’ve learned the basics.

01/04/2013

Opc Analyzer

Your Classic Server

Your Classic Client

You

© 2013 OPC Foundation 4

OpcAnalyzer TrainingIntroduction (2 of 3)

How it works: OpcAnalyzer is a DA Server/Client hybrid:

- Your Client will connect to OpcAnalyzer.

- OpcAnalyzer exposes a downstream Server.

- Clients calls are routed to downstream Server.

- Responses can be modified prior to Client delivery.

Testing Method: Each OPC Interface is tested manually to see:

a. if a service-call is made correctly

b. if the client handles valid responses correctly

c. if the client handles invalid responses correctly

Test authors? Compliance Working Group

01/04/2013

© 2013 OPC Foundation 5

OpcAnalyzer TrainingIntroduction (3 of 3)

How do I pass? Supported OPC Interfaces must be tested to verify behavior

matches the expected results from the test case document:

www.opcfoundation.org/ua/ctt/help/testcases/

Am I Certified? No, passing the tests in the OpcAnalyzer does not mean you

are certified by the OPC Foundation. It means that your product

is ready for certification in the Test Lab.

Tool used in Lab? The Certification Test Labs use the same version

available on the website: www.opcfoundation.org/opcanalyzer

Use When? The best time is during product development. All Classic DA

products must pass OpcAnalyzer testing prior to release.

Additional Help: A complete user guide is provided with the OpcAnalyzer.

01/04/2013

© 2013 OPC Foundation

6

Opc Analyzer Training - ClientLaunching Opc Analyzer (1 of 1)

Windows 8:Start > OpcAnalyzer

Windows Vista/7:Start > All Programs > OPC Foundation >Test Suite 1.0> OPC Analyzer> OpcAnalyzer

01/04/2013

© 2012 OPC Foundation 7

OpcAnalyzer TrainingFamiliarization (1 of 4)

4/19/2012

There are (by default) 3 options to get started:• Remote Machine Name: hostname or IP address of the machine where the OPC Server is

installed• Category Filter: DA20, DA30, or Both; filters the list of Servers in the Server options• Server: OPC Servers available for testing that match the filter criteria

© 2012 OPC Foundation 8

Opc Analyzer Training - ClientFamiliarization (2 of 4)

4/19/2012

There is (by default) 1 “widget” to the left:• MethodName: provides list of all the OPC methods, grouped by OPC Interface

OPC Interfaces

OPC Methods

© 2012 OPC Foundation 9

OpcAnalyzer TrainingFamiliarization (3 of 4)

4/19/2012

Powerful tracing capability shows OPC calls made between the Client and Server

See each OPC call in this list

View the parameter values in the Request

and Response

Options to control the behavior of the trace

log display

© 2012 OPC Foundation 10

OpcAnalyzer TrainingFamiliarization (4 of 4)

4/19/2012

Powerful error-injection scripts are accessible via the Injection tab. Select a script from the drop-down box, and then check the Script Enabled checkbox:

Check the script status for error messages that might occur if error injection fails; important for custom scripts

© 2012 OPC Foundation 11

OpcAnalyzer TrainingFinding Help

Complete documentation is available from: Start > All Programs > OPC Foundation > Test Suite 1.0 > OPC Analyzer > OPC Analyzer Documentation

01/04/2013

A real-world setup using the OPC Foundation DA Sample Server and DA Sample Client: (a) Client to OpcAnalyzer (b) OpcAnalyzer to Server

OpcAnalyzer TrainingTest Tool Configuration

© 2012 OPC Foundation 1201/04/2013

The DA Client application will connect to the OpcAnalyzer

The OpcAnalyzer will connect to the OPC Sample DA Server(which does not provide a user-interface)

© 2012 OPC Foundation 13

OpcAnalyzer TrainingTesting & Debugging (1 of 4)

4/19/2012

Step 1: Test the Client’s normal behavior for a Read operation etc…

Trace of OPC Calls made

Parameter values of the method call showing the Request and Response.

© 2012 OPC Foundation 14

Step 2: Inject an error and observe the response in the OpcAnalyzer:

OpcAnalyzer TrainingTesting & Debugging (2 of 4)

4/19/2012

Step 2. Select the test script

Step 3. Check “Script Enabled” option to inject

the error

Step 4a.Observe the trace in the OpcAnalyzer. A purple line

indicates the OpcAnalyzer has modified the original response

Step 1. Select the OPC interface and

method you would like to test

Step 4b. Modified response

© 2012 OPC Foundation 15

OpcAnalyzer TrainingTesting & Debugging (3 of 4)

4/19/2012

Step 3: Observe the behavior of the client after the error injection.Did the Client crash? Did it use the data even though its in error? Any error messages?

Client displays the result that was modified by the

Analyzer.This is GOOD behavior.

Modified response in the

OpcAnalyzer

© 2012 OPC Foundation 16

OpcAnalyzer TrainingTesting & Debugging (4 of 4)

4/19/2012

Verify the client behavior by referring to the interface, test-case Id and the expected result from the test case documentation:

www.opcfoundation.org/ua/ctt/help/testcases

© 2013 OPC Foundation 17

You can add your own scripts to an interface! Here’s how…

Opc Analyzer Training - ClientScript Customization

Your new script appears in the list of tests

Create your own script and your code here.

TIP: use the existing scripts for examples

01/04/2013

© 2013 OPC Foundation 18

OpcAnalyzer TrainingNext Steps…

Once your Classic DA Client passes all applicable tests:

• Conduct Interoperability Testing

• Conduct Behavior Testing

• Conduct Resource-efficiency Testing

• Request Certification in the Test Lab:

www.opcfoundation.org/Compliance-Certification/A1-Application.doc

x

Interoperability, Behavior, and Resource-efficiency test details

available online: www.opcfoundation.org/ua/ctt/help/testcases 01/04/2013

Download: www.opcfoundation.org/opcanalyzer

Certification: www.opcfoundation.org/certification

Lab Testing: www.opcfoundation.org/lab/signup

Bug Tracker: www.opcfoundation.org/mantis

Contact: compliance@opcfoundation.org

OpcAnalyzer TrainingThe End!