WW TSS 20 MES 4.5 Advanced Use (API Stateless)

Transcription

1 Slide 1

2 WW TSS 20 MES 4.5 Advanced Use (API Stateless) Presenters: Andrea Sartori Oliver Varosanec / #SoftwareRevolution /InvensysVideos /Wonderware /company/wonderware 2013 Invensys. All Rights Reserved. The names, logos, and taglines identifying the products and services of Invensys are proprietary marks of Invensys or its subsidiaries. All third party trademarks and service marks are the proprietary marks of their respective owners.

3 Agenda Introduction API General Overview.NET Controls Stateful API Stateless API Stateless API Workshop Sample Scenario Manage Sessions Manage Work Orders Manage Inventory Slide 3

4 MES 4.x Components MES Reports MES Client (Configuration) Operator Client Custom Client Operations Capability Object EMB Information Server Stateful/Stateless API Engine Platform Middleware MES Middleware Host MES Service Database Server MES Database Slide 4

5 What is an API? From Wikipedia Generally speaking, an application programming interface (API) is a specification of how some software components should interact with each other. In practice in most of the cases an API is a library that usually includes specification for routines, data structures, object classes, and variables. An API specification can take many forms, including an International Standard such as POSIX, vendor documentation such as the Microsoft Windows API, the libraries of a programming language, e.g., Standard Template Library in C++ or Java API. Slide 5

6 Which MES APIs Wonderware Provide?.NET Controls Stateful API Stateless API Slide 6

7 1. MES.NET Controls Provides graphical functionalities that enable to interact with clients like InTouch Custom Application Slide 7

8 2. MES Stateful API The stateful API is designed for client applications that allows users to log on to entities and make transactions. It contains various pop up methods for user interaction. Therefore, the stateful API must be used within a client application, such as ArchestrA graphics displayed within an InTouch application. The stateful API requires a client session, which is created for each executable, to access the MES database. The client session allows you to access zero or multiple entities to make transactions. It also maintains the current entity, current job for each entity, and other information in the MES database. This information is used while passing parameters to a method call of the stateful API. Slide 8

9 3. MES Stateless API The stateless API is designed for more complex applications that require access to all the calls that are available in the Wonderware MES application. The stateless API maintains no information and provides direct access to calls through the middleware. There can be multiple sessions within one application or a common shared session across multiple applications. Since there is no information maintained in memory, the stateless API calls require more parameters than the corresponding stateful API call. The stateless API supports multi threading. Therefore, the stateless API should be used in background applications such as Application Server Object scripting. Slide 9

10 Differences between Stateful and Stateless API Stateful API Stateless API Manages Session Have pop ups embedded interacts with a UI No multi-threading support Less parameters needed Session not always needed Can be run in a script no UI needed Supports multi-threading More parameters needed Slide 10

11 An example of Stateful call: AddConsumption public void AddCons( int BOMPos, double qtycons, object reascd, string lotno, string fglotno, object fromentid, string itemid, string extref, string spare1, string spare2, string spare3, string spare4 ) Slide 11

12 the same via Stateless call public static void AddCons( int sessionid, Nullable<DateTime> eventtime, string userid, string entname, string sitename, string woid, string operid, int seqno, int bompos, double qtycons, Nullable<int> reascd, string lotno, string fglotno, string sublotno, string fgsublotno, string fromentname, string fromsitename, ) string itemid, string extref, Nullable<bool> applyscalingfactor, string genealogyid, string upstreameventid, string segmentrequirementid, string segmentresponseid, string comments, DBString spare1, DBString spare2, DBString spare3, DBString spare4, out int rowid Slide 12

13 MES API Hands-On Slide 13

14 Sample Scenario The Orange Juice Plant Water Orange Syrup Orange Juice Mix Orange Juice Storage Shipping Refrigerator Slide 14

15 LAB 1 Session management 20 min Slide 15

16 LAB 2 Receive material 30min Slide 16

17 LAB 3 Create a Work Order 15 min Slide 17

18 LAB 4 Start and end a Job 15 min Slide 18

19 LAB 5 Consume material 15 min Slide 19

20 LAB 6 Produce Material 15 min Slide 20

21 LAB 7 Transfer Material 15 min Slide 21

22 Optional exercise Shipping production 30 min Slide 22

23 Question/ feedbacks/ request Thanks!!! Slide 23

24 Slide 24