P. 1
AAWorkflowWithMES_Dec2012

AAWorkflowWithMES_Dec2012

|Views: 52|Likes:
Published by javiertdzo

More info:

Published by: javiertdzo on Jan 31, 2013
Copyright:Attribution Non-commercial

Availability:

Read on Scribd mobile: iPhone, iPad and Android.
download as PDF, TXT or read online from Scribd
See more
See less

01/31/2013

pdf

text

original

Sections

  • Documentation Conventions
  • Technical Support
  • Configuring MES and ArchestrA Workflow Software Users
  • Configuring MES-Workflow Connector
  • Configuring the ArchestrA Workflow Software Repository Database
  • Logging in to ArchestrA Workflow Software’s Enterprise Console
  • Adding a Job
  • Creating the Workflow
  • Creating an ArchestrA Workflow Software Form
  • Binding the Form to the Workflow
  • Adding a Variable for the DateTime Input
  • Linking the Workflow Variables to Form Controls
  • Publishing the Form
  • Testing the Workflow
  • Sample Test Data and Expected Results
  • Adding an Attribute
  • Adding an Item Class
  • Creating a Work Order from a Process
  • Adding Variables for the DateTime Inputs
  • Starting a Job
  • Adding Production to a Job
  • Setting the Current Lot Information for a Job
  • Verifying DateTimes with Different Regional Settings
  • Prerequisites for Performing the Tests
  • Adding an Item Class—MES SQL Database
  • Adding a Job—Oracle Database
  • Prerequisites for Performing This Test
  • Creating the MES Event
  • Starting the Workflow
  • Verifying the Data
  • DateTime
  • Regional Settings
  • Asynchronous Methods in the MES Stateless API Libraries
  • MES Quality Modules
  • Class Arrays in the List of Parameters
  • Intermittent Failures on Reporting Status
  • Index

Wonderware

Guide to Using ArchestrA Workflow with Wonderware MES

12/11/12

All rights reserved. No part of this documentation shall be reproduced, stored in a retrieval system, or transmitted by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of Invensys Systems, Inc. No copyright or patent liability is assumed with respect to the use of the information contained herein. Although every precaution has been taken in the preparation of this documentation, the publisher and the author assume no responsibility for errors or omissions. Neither is any liability assumed for damages resulting from the use of the information contained herein. The information in this documentation is subject to change without notice and does not represent a commitment on the part of Invensys Systems, Inc. The software described in this documentation is furnished under a license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of these agreements.

© 2012 by Invensys Systems, Inc. All rights reserved.
Invensys Systems, Inc. 26561 Rancho Parkway South Lake Forest, CA 92630 U.S.A. (949) 727-3200 http://www.wonderware.com For comments or suggestions about the product documentation, send an e-mail message to ProductDocumentationComments@invensys.com. All terms mentioned in this documentation that are known to be trademarks or service marks have been appropriately capitalized. Invensys Systems, Inc. cannot attest to the accuracy of this information. Use of a term in this documentation should not be regarded as affecting the validity of any trademark or service mark. Alarm Logger, ActiveFactory, ArchestrA, Avantis, DBDump, DBLoad, DT Analyst, Factelligence, FactoryFocus, FactoryOffice, FactorySuite, FactorySuite A2, InBatch, InControl, IndustrialRAD, IndustrialSQL Server, InTouch, MaintenanceSuite, MuniSuite, QI Analyst, SCADAlarm, SCADASuite, SuiteLink, SuiteVoyager, WindowMaker, WindowViewer, Wonderware, Wonderware Factelligence, and Wonderware Logger are trademarks of Invensys plc, its subsidiaries and affiliates. All other brands may be trademarks of their respective owners.

3

Contents

Documentation Conventions ......................................................... 10 Technical Support .......................................................................... 10

Chapter 1

Getting Started.......................................... 11
Prerequisites for Performing the Tests ......................................... Initial Setup ................................................................................... Configuring MES and ArchestrA Workflow Software Users .... Configuring MES - Workflow Connector ................................... Configuring the ArchestrA Workflow Software Repository Database .................................................................................. Logging in to ArchestrA Workflow Software’s Enterprise Console .................................................................................... 11 12 12 12 12 12

Guide to Using ArchestrA Workflow with Wonderware MES

...................... Creating the Workflow ....................... Linking the Workflow Variables to Form Controls ......................................................................................................... Adding a Variable for the DateTime Input ....................................... Testing the Workflow .. Binding the Form to the Workflow ..... Testing the Workflow ......................................... Publishing the Form ........ Sample Test Data and Expected Results .................. 13 14 18 21 23 26 31 32 33 35 35 35 36 36 36 36 37 Chapter 3 Verifying Minimum and Maximum Data ....4 Contents Chapter 2 Verifying Datatype Compatibility ...................................................................................... Binding the Form to the Workflow .......... Linking the Workflow Variables to Form Controls ....................................................................................... Creating an ArchestrA Workflow Software Form .................................................................................................................. Creating an ArchestrA Workflow Software Form ......................... Creating an ArchestrA Workflow Software Form ................................................................. 40 40 40 41 41 41 41 42 42 42 43 43 44 44 45 45 45 Guide to Using ArchestrA Workflow with Wonderware MES ................ Sample Test Data and Expected Results ...................................................... Sample Test Data and Expected Results .......................................................................................................................................................................... Linking the Workflow Variables to Form Controls .............. Creating a Work Order from a Process ................................................................. Linking the Workflow Variables to Form Controls ....................... Creating the Workflow ....... Creating the Workflow .............. Binding the Form to the Workflow ...................................... Creating an ArchestrA Workflow Software Form .................................................. Creating the Workflow ........................................................................ Testing the Workflow .............................. Testing the Workflow ......................... Publishing the Form ........ Binding the Form to the Workflow ....................................................... 13 Adding a Job ......................................................................................... Sample Test Data and Expected Results ........................................... 39 Adding an Item Class ................. Adding Variables for the DateTime Inputs .............. Publishing the Form ................................................................ Adding an Attribute ............... Publishing the Form ..................................................................

.................................... Testing the Workflow ..................... Publishing the Form ............................................................ Binding the Form to the Workflow ..... Publishing the Form ........................................... Binding the Form to the Workflow ...................... Creating an ArchestrA Workflow Software Form ..... Binding the Form to the Workflow ........................ Sample Test Data and Expected Results ................ Creating an ArchestrA Workflow Software Form .................................................................................................................. Testing the Workflow .................................. Creating the Workflow ........... Starting a Job .............................................................................................................. Creating the Workflow ................................................................ Testing the Workflow ................................................................................................ 55 Setting the Current Lot Information for a Job ........................................... Adding Production to a Job ................................................ Linking the Workflow Variables to Form Controls ............................... Sample Test Data and Expected Results ........................................................................................................................... Linking the Workflow Variables to Form Controls ...................................... Testing the Workflow ......................................................................... Linking the Workflow Variables to Form Controls ........ Linking the Workflow Variables to Form Controls ........................................Contents5 Starting a Job ..... Sample Test Data and Expected Results . Adding a Variable for the DateTime Input ................................. Publishing the Form ........................... Sample Test Data and Expected Results ........ Binding the Form to the Workflow .................................................. Publishing the Form ............................................................................................................................. 46 46 46 47 47 48 48 48 49 49 49 50 50 50 51 52 52 52 Chapter 4 Verifying Complex Event Types .................................. Creating an ArchestrA Workflow Software Form .... Creating an ArchestrA Workflow Software Form .................... Adding a Variable for the DateTime Input .................. Creating the Workflow .............................................................. 55 56 56 56 57 57 57 57 58 58 58 59 59 60 60 60 61 Guide to Using ArchestrA Workflow with Wonderware MES ................................................................................... Adding a Variable for the DateTime Input ............................................... Creating the Workflow ..................................

.. Creating the Workflow ..................................................... Sample Test Data and Expected Results ......................6 Contents Chapter 5 Verifying DateTimes with Different Regional Settings............. Creating an ArchestrA Workflow Software Form ......................................... Adding Variables for the DateTime Inputs ........... Sample Test Data and Expected Results ................. Starting a Job ........ Testing the Workflow ..................................................................................................................................... Sample Test Data and Expected Results ........................................................ Binding the Form to the Workflow .................. Creating an ArchestrA Workflow Software Form ................... Testing the Workflow ..................... Linking the Workflow Variables to Form Controls ................................. 63 64 64 64 65 65 66 67 67 67 68 68 68 69 69 69 70 70 70 Chapter 6 Verifying Localization of Datatypes ........................ Publishing the Form ........................................................................ 73 Adding an Item Class—MES SQL Database .......... Creating the Workflow ..................... Creating an ArchestrA Workflow Software Form .......................................... Binding the Form to the Workflow .................................................... Creating the Workflow ................................................... Adding a Variable for the DateTime Input ......................... Publishing the Form .......................................... Linking the Workflow Variables to Form Controls .................................................................................... Testing the Workflow ............................................................ Creating an ArchestrA Workflow Software Form ........ Adding a Variable for the DateTime Input ............................................................................ Linking the Workflow Variables to Form Controls ......... 63 Prerequisites for Performing the Tests .................................... Creating a Work Order from a Process ....... Prerequisites for Performing This Test ............................. Binding the Form to the Workflow ......................... 73 74 74 74 75 75 75 75 77 78 78 78 79 79 80 80 81 81 Guide to Using ArchestrA Workflow with Wonderware MES .............................................. Linking the Workflow Variables to Form Controls . Publishing the Form ..... Sample Test Data and Expected Results ......................................................................................................................................................................... Testing the Workflow ..................................... Creating the Workflow ..................................................................................................................................................................................... Binding the Form to the Workflow ............................ Publishing the Form ....................................... Adding a Job—Oracle Database ....................................................................

........................................................................................ 91 Starting the Workflow ....................... Linking the Workflow Variables to Form Controls ................................................................ Asynchronous Methods in the MES Stateless API Libraries ....................... Sample Test Data and Expected Results ...................... 97 Sample Test Data and Expected Results ...................... Binding the Form to the Workflow ........................................................................................................................................................................................... 90 Creating the MES Event .............................. 98 Creating the MES Event .............. 100 Appendix A Potential Issues and Resolutions ................................................. Regional Settings .............................. MES Quality Modules . 83 83 83 84 84 84 86 86 86 Chapter 7 Verifying Data Passing from Wonderware MES to an ArchestrA Workflow .......................... 100 Sample Test Data and Expected Results ............................................................................................................................ 101 DateTime ............................................ 99 Starting the Workflow ............. 90 Creating the Workflow .............................. 98 Creating the Workflow ................................................. Class Arrays in the List of Parameters .................................................................................Contents7 Adding Production to a Job ....................... Creating an ArchestrA Workflow Software Form .. Creating the Workflow ............. 101 105 105 105 106 106 Index......................... Testing the Workflow ............. Publishing the Form ........ 107 Guide to Using ArchestrA Workflow with Wonderware MES .......................................................................... 89 Adding an Item Class ................. Intermittent Failures on Reporting Status .......................................................................................................................... Adding a Variable for the DateTime Input ................................................................. 97 Verifying the Data ..................................................................................................................................... 99 Verifying the Data ......................................... 98 Creating a Work Order from a Process ..............................

8 Contents Guide to Using ArchestrA Workflow with Wonderware MES .

All items listed on this menu are available as items on the main menus. The document also includes an appendix that describes how to resolve issues that could occur when running the test workflows. you can also right-click to open a menu. moving from application to application. This document applies to the following software versions: • Wonderware MES 2012 • ArchestrA Workflow Software’s MES . including navigating menus. If you need help with these tasks. in part or whole.9 Welcome This document describes generic ArchestrA Workflow Software workflows that use the ArchestrA Workflow Software’s MES .Workflow Connector to test the communication between the workflows and Wonderware MES Middleware. Guide to Using ArchestrA Workflow with Wonderware MES . The items listed on this menu change.Workflow Connector v1. This guide assumes you know how to use Microsoft Windows. depending on where you are in the product. and moving objects on the screen. In some areas of the MES . see the Microsoft Online Help. You can use these tests to gain an understanding of how to set up and use the MES .Workflow Connector application.6 You can view this document online or you can print it. by using the print feature in Adobe Acrobat Reader.Workflow Connector to transfer data between an ArchestrA Workflow Software workflow and the Wonderware MES database and activities via the MES Middleware.

refer to the relevant section(s) in this documentation for a possible solution to the problem. • The exact wording of the error messages you saw. If you need to contact technical support for help. • Details of what you did to try to solve the problem(s) and your results. Menus. commands. if this is an ongoing problem. the Wonderware Technical Support case number assigned to your problem. and dialog box options. dialog box names. • If known. Technical Support Wonderware Technical Support offers a variety of support options to answer any questions on Wonderware products and their implementation. Code samples and display text. • Any relevant output listing from the Log Viewer or any other diagnostic applications. have the following information ready: • The type and version of the operating system you are using. Before you contact Technical Support. Wonderware MES Client User’s Guide . • Details of how to recreate the problem.10  Documentation Conventions This documentation uses the following conventions: Convention Used for Initial Capitals Bold Monospace Paths and file names.

For a complete description of the MES . a reliable data script can be used to populate the MES database. Guide to Using ArchestrA Workflow with Wonderware MES .Workflow Connector package is installed.Workflow Connector User Guide. or you can populate the database with data of your own choice.11 Chapter 1 Getting Started The MES . • ArchestrA Workflow Software and MES . • You can start with a new MES database or with a pre-populated database to test the workflow–MES integration.Workflow Connector provides an integration layer to make connections between ArchestrA Workflow Software workflows and Wonderware MES Middleware. Prerequisites for Performing the Tests The following prerequisites are required before the tests can be performed: • MES Client and the MES database are installed. For example. refer to the ArchestrA Workflow Software MES .Workflow Connector. • The test procedures provided here assume that the user has some knowledge about MES software and ArchestrA Workflow Software.

com/System Platform User Guide/ index. Guide to Using ArchestrA Workflow with Wonderware MES . Refer to the MES Client User’s Guide and the ArchestrA Workflow Software Administrator Guide for details.html?ConfiguringTheMiddleware Configuring the ArchestrA Workflow Software Repository Database Create an ArchestrA Workflow Software Repository database.Workflow Connector: http://sun. Logging in to ArchestrA Workflow Software’s Enterprise Console To log in to ArchestrA Workflow Software’s Enterprise Console 1 2 3 4 Launch Internet Explorer. Login using the user name and password configured in the MES database. Click Enterprise Console on the Favorites tab. Configuring MES . and configure the repository in ArchestrA Workflow Software.skelta.Workflow Connector Refer to the web site below to configure the MES . Click MES Users.12  Chapter 1 Getting Started Initial Setup Configuring MES and ArchestrA Workflow Software Users Users must be configured in MES and ArchestrA Workflow Software.

Job.13 Chapter 2 Verifying Datatype Compatibility The following stateless MES API methods can be used from the MES .Job.Add. The following datatypes used in the job table are tested using the workflow forms to supply the job information to add a new job in the database: • tfloat • int32 • logical • notes • string20 • string40 Guide to Using ArchestrA Workflow with Wonderware MES . which adds a job • Core.Add stateless API method.Workflow Connector to verify that the datatypes used in MES are compatible with the datatypes used in the MES .Add. Adding a Job This test procedure calls the Prod.Workflow Connector: • Prod.Attr. which adds an attribute Note: Other stateless API methods can also be used to verify this functionality.

click Workflows. and then click Save and Continue. 4 Type the title (e. log in to the Enterprise Console as an MES user. The Workflow Options window appears. Job. On the Ribbon. On the Enterprise Console menu.Add). Guide to Using ArchestrA Workflow with Wonderware MES .g. click the Workflow icon..14  Chapter 2 Verifying Datatype Compatibility • string80 • string254 • string1700 • tdatetime Creating the Workflow To create a workflow for the Add a Job test procedure 1 2 3 From Internet Explorer. The Workflows window appears. The option on the workflow tasks defaults to Design the workflow now. A New Workflow window appears.

Adding a Job15 5 6 7 Click Finish. Guide to Using ArchestrA Workflow with Wonderware MES . Click and drag the MESXMLCommand activity onto the window to the right of the UpdateVariable activity. It includes a Start activity by default. A workflow window appears. click MES. 8 9 On the Activities menu. Click and drag the Update Variable activity onto the window to the right of the Start activity. In the Activities list. click Engine Activities.

The Generate Command window appears.Add until that entry appears in the list. click the Generate Command box button. mes40). click the Link icon and create a link from the Start activity to the UpdateVariable1 activity. MESDB_MES). 16 In the Middleware Connection list.16  Chapter 2 Verifying Datatype Compatibility 10 On the tool bar. 13 Right-click the MESXMLCommand1 activity and click Activity Properties. select the Middleware connection (for example. Guide to Using ArchestrA Workflow with Wonderware MES . begin typing Prod. 18 Select the Generate Input XML Variable check box and type job_input in the box. select the environment (for example. 14 In the Configuration section of the Activity Properties pane. 11 Create another link from the UpdateVariable1 activity to the MESXMLCommand1 activity. 12 Right-click the link between the UpdateVariable1 and MESXMLCommand1 activities and click Updated. select it. 15 In the Unique Environment Name list. and then press the ENTER key. 17 In the Stateless API/SP Reference box.Job.

20 Click the Generate Input/Output XML Variable(s) button. Guide to Using ArchestrA Workflow with Wonderware MES . click Save and close the workflow window. 21 At the bottom of the Activity Properties pane.Adding a Job17 19 Select the Generate Output XML Variable check box and type job_output in the box.

A New Form window appears. and click Save & Continue. Job.18  Chapter 2 Verifying Datatype Compatibility Creating an ArchestrA Workflow Software Form To create a form in ArchestrA Workflow Software for the Add a Job procedure 1 On the Enterprise Console menu. click Form. and then click Manage Forms. The Manage Forms window appears. You are prompted to select a forms task. 2 On the Ribbon.Add). 3 In the Title box. Guide to Using ArchestrA Workflow with Wonderware MES . point to Tools. type a title for the form (for example.

click Add New. a On the tool bar. Guide to Using ArchestrA Workflow with Wonderware MES .Adding a Job19 4 Select the Design this form option and click Finish. On the Basic tab. The control’s properties window appears. select the control type and then click Next.Add form listed. 5 Perform the following steps to add each of the controls and set their properties. see the table that follows these steps. b c In the radio button list. For a list of the controls and their properties. enter the control’s properties as specified in the table. A prompt to select the control type appears. The Forms Designer window appears with the Job.

d When you have finished entering the control’s properties. The control is added to the form. Control Type TextInput TextInput TextInput DateInput Number Number Number Number Boolean Tag Name Work Order ID Operation ID Sequence Number Required Finish Time Initial Sched Entity ID Target Sched Entity ID Quantity Required Quantity At Start Rework Mapped XML Node wo_id oper_id seq_no req_finish_time_local init_sched_ent_id target_sched_ent_id qty_reqd qty_at_start rework Mandatory Y Y Y Y Y Y Y Y N Other Parameters Decimal Places: 12 Decimal Places: 12 Guide to Using ArchestrA Workflow with Wonderware MES . click Save.20  Chapter 2 Verifying Datatype Compatibility Note: The control properties included in the Basic tab can vary based on the control type.

select Bind to an existing workflow. Guide to Using ArchestrA Workflow with Wonderware MES . On the Ribbon. Select the Job. The Bind window appears. click Associate. Binding the Form to the Workflow To bind the form to the workflow 1 2 3 On the Enterprise Console menu. Two list boxes appear to the right of the option. click the Finish button at the bottom right of the Forms Designer window. 4 For the Select Task option.Adding a Job21 Control Type TextInput TextInput TextInput Number Tag Name Spare1 Last Edit Comment Item Estimated Production Rate Mapped XML Node spare1 last_edit_comment item_id est_prod_rate Mandatory Y Y Y Y Other Parameters Decimal Places: 12 6 When you have finished adding all of the controls.Add form. and then click Manage Forms. point to Tools.

Add). On the Ribbon. The Workflow Options window appears. click the workflow name (that is.22  Chapter 2 Verifying Datatype Compatibility 5 In the first list. 11 Select the Design the Workflow now check box and then click Finish to close the window. for the Add a Job procedure.Add). click Workflows. Job. Job. On the Enterprise Console menu. 10 Click Save & Continue. In the second list. Guide to Using ArchestrA Workflow with Wonderware MES . Select the appropriate workflow (that is. The Edit Form window appears. The Job. click Latest. 6 7 8 9 Click Save and then click Close to close the window. click Edit.Add workflow window appears.

To address the DateTime issue for this input. right-click the Start activity and click Activity Properties. Guide to Using ArchestrA Workflow with Wonderware MES . On the Activity Properties pane. To add the reqfinishtimevar variable to the Start activity 1 With the Job. click the Variables box button.Adding a Job23 Adding a Variable for the DateTime Input Because of a difference in how ArchestrA Workflow Software and MES stateless API methods treat DateTime inputs. enter reqfinishtimevar. In the Type list. The Update Variable window appears. click date. click the Initialize box button. 2 3 4 5 6 Click Update to save the entries and close the window.Add workflow opened. In the Workflow Variables box. In the Activity Properties pane. The Activity Properties pane appears. refer to "DateTime" on page 101. you must create a DateTime variable to convert any DateTime input values from the workflow form from UTC time to local time. This test procedure includes a required finish time input in the workflow form. the DateTime variable called reqfinishtimevar will be added to the Start activity. The Variables window appears. For additional information about this issue.

Guide to Using ArchestrA Workflow with Wonderware MES . A list box appears in the Value column. 10 Click the list box button. 11 Click the Build Expression link. A row for the reqfinishtimevar variable is added to the table in the Update Variable window. Expand the Variables branch and click the Variable. hover the pointer over Select and click the list box that appears. and SKRootDefinition branches. SFFormData. expand the Workflow Instance. A navigation tree appears.reqfinishtimevar entry. XmlVariables.24  Chapter 2 Verifying Datatype Compatibility 7 8 In the Condition column. 9 Click the Tree icon under the Actions column. The Variable Editor window appears. A navigation tree appears. 12 In the navigation tree.

14 Complete the entry in the Editor pane so that the full entry is as follows: Convert.Adding a Job25 13 Click and drag the entry req_finish_time_local to the Editor pane. ToLocalTime() Guide to Using ArchestrA Workflow with Wonderware MES . SKRootDefinition.SFFormData.CultureInfo.ToDateTime(XmlVariables. System. The XML variables object is added to the Editor pane.InvariantCulture).req_finish_time_local.Globalization.

The Update Variable window appears. The Activity Properties pane appears. The completed reqfinishtimevar variable definition appears in the Update Variable window. 17 Click the Save button at the bottom of the Activity Properties pane to save the reqfinishtimevar variable.26  Chapter 2 Verifying Datatype Compatibility 15 Click OK and then click Close to close the Variable Editor window. see the table that follows these steps. For a list of the workflow variable-to-form control link mapping. In the Activity Properties pane. 16 Click the OK to close the Update Variable window. click the Set Variable box button. 2 Perform the following steps to link each variable to its corresponding form control. Guide to Using ArchestrA Workflow with Wonderware MES . Linking the Workflow Variables to Form Controls To link the workflow variables to their corresponding form controls 1 In the workflow window. right-click the UpdateVariable1 activity and click Activity Properties.

Adding a Job27

a

In the Condition column, hover the pointer over Select and click the list box that appears. A navigation tree appears.

-

b

Drill down to the variable to be linked and click it. The variable is added to the Condition column.

c

In the Value column, hover the pointer over Enter value and click the text box that appears.

Guide to Using ArchestrA Workflow with Wonderware MES

28  Chapter 2 Verifying Datatype Compatibility

d

In the text box, enter the name of the corresponding form control.

See to the table below for a list of the Job.Add form control names.
Variable
XmlVariables…request.job.wo_id XmlVariables…request.job.oper_id XmlVariables…request.job.seq_no XmlVariables…request.job.req_finish_time_local XmlVariables…request.job.init_sched_ent_id XmlVariables…request.job.target_sched_ent_id XmlVariables…request.job.qty_reqd XmlVariables…request.job.qty_at_start XmlVariables…request.job.rework XmlVariables…request.job.spare1 XmlVariables…request.job.last_edit_comment XmlVariables…request.job.item_id XmlVariables…request.job.est_prod_rate

Form Control Name
SKFormData.SKRootDefinition.wo_id SKFormData.SKRootDefinition.oper_id SKFormData.SKRootDefinition.seq_no Variable.reqfinishtimevar* SKFormData.SKRootDefinition.init_sched_ent_id SKFormData.SKRootDefinition.target_sched_ent_id SKFormData.SKRootDefinition.qty_reqd SKFormData.SKRootDefinition.qty_at_start SKFormData.SKRootDefinition.rework SKFormData.SKRootDefinition.spare1 SKFormData.SKRootDefinition.last_edit_comment SKFormData.SKRootDefinition.item_id SKFormData.SKRootDefinition.est_prod_rate

* DateTimes are set to workflow variables created to ensure that they are sent as localtime to the MES database.

Guide to Using ArchestrA Workflow with Wonderware MES

Adding a Job29

The list of all of the Job.Add links is shown in the following figure.

3 4 5

When all of the workflow variable-to-form control links have been entered, click the OK button to close the Update Variable window. Click the Save button at the bottom of the Activity Properties pane to save the links. Close the workflow window.

Guide to Using ArchestrA Workflow with Wonderware MES

Add workflow and click Publish. Guide to Using ArchestrA Workflow with Wonderware MES . right-click the Job. A message appears indicating the status of the publish operation. 7 Click Close to close the message.30  Chapter 2 Verifying Datatype Compatibility 6 In the Workflows window.

3 Click Close to close the message. The Manage Forms window appears.Adding a Job31 Publishing the Form To publish the form 1 2 On the Enterprise Console menu.Add form and click Publish. Right-click the Job. Guide to Using ArchestrA Workflow with Wonderware MES . A message appears indicating the status of the publish operation. point to Tools. and then click Manage Forms.

2 Click the Job. A list of available forms appears. To test the workflow 1 On the Enterprise Console menu.Add form appears. The Job. Guide to Using ArchestrA Workflow with Wonderware MES .32  Chapter 2 Verifying Datatype Compatibility Testing the Workflow Now that the form has been created. you can test the procedure by completing the form and then checking to see if the data was entered correctly in the MES database. click Fill Form.Add form entry.

click Finish. A message appears indicating the status of the form submission. 4 5 6 When the form is completed. Click OK to close the message. and the expected results in the MES database. Sample Test Data and Expected Results Two sets of sample test data that could be entered in the form. are listed in the following tables. Verify that the test data was correctly entered in the MES database.Adding a Job33 3 Complete the form with test data. Control Name Database Data Type Data Input Data Expected in MES Database Wo_ID Oper_Id Seq_No Req_Finish_Time_Local Init_Sched_Ent_Id Target_Sched_Ent_Id String80 String80 Int32 TDatetime Int32 Int32 Wo1 Oper1 12345 10/26/2012 15:16:17 15 15 Wo1 Oper1 12345 10/26/2012 15:16:17 15 15 Guide to Using ArchestrA Workflow with Wonderware MES .

987654 Guide to Using ArchestrA Workflow with Wonderware MES .987654 True Test Spare1 Test Last Edit Comment QA-Case24 987654321.12345 1234567890123.987654 Yes (True) Test Spare1 Test Last Edit Comment QA-Case24 987654321.12345 No (False) Test Spare1 Test Last Edit Comment QA-Case24 1234567890123.12 Column Name Database Data Type Data Input Data Expected in MES Database Wo_ID Oper_Id Seq_No Req_Finish_Time_Local Init_Sched_Ent_Id Target_Sched_Ent_Id Qty_Reqd Qty_At_Start Rework Spare1 Last_Edit_Comment Item Est_Prod_Rate String80 String80 Int32 TDatetime Int32 Int32 TFloat TFloat Logical String80 String254 String80 TFloat Wo1 Oper2 12345 10/29/2012 18:19:20 15 15 987654321.987654 Wo1 Oper2 12345 10/29/2012 18:19:20 15 15 987654321.987654 987654321.12345 1234567890123.987654 987654321.34  Chapter 2 Verifying Datatype Compatibility Control Name Database Data Type Data Input Data Expected in MES Database Qty_Reqd Qty_At_Start Rework Spare1 Last_Edit_Comment Item Est_Prod_Rate TFloat TFloat Logical String80 String254 String80 TFloat 1234567890123.12 False Test Spare1 Test Last Edit Comment QA-Case24 1234567890123.12 1234567890123.

Add. with the following exceptions: • For the workflow title.Adding an Attribute35 Adding an Attribute This test procedure calls the Core. Creating the Workflow Perform the procedure in "Creating the Workflow" on page 14. use Attr. with the following exceptions: • For the form title.Add. use Core.Add stateless API method. use attr_input • For the Generate Output XML Variable. • In the Generate Command window: • For the stateless API.Attr. • Specify the following controls for the form: Control Type Boolean Number Tag Name Predefined Data Type Mapped XML Node predefined data_type Mandatory Other Parameters Y Decimal Places: 0 Min Value: 0 Max Value: 12 TextInput Attribute Description attr_desc Y Guide to Using ArchestrA Workflow with Wonderware MES .Add • For the Generate Input XML Variable. use Attr.Attr. use attr_output Creating an ArchestrA Workflow Software Form Perform the procedure in "Creating an ArchestrA Workflow Software Form" on page 18. with exceptions as noted in the following topics. The following datatypes used in the ent table are tested using the workflow forms to supply the attribute information to add a new attribute in the database: • int32 • logical • string80 • string254 • tdatetime The process for creating the Add an Attribute test procedure is the same as that described in "Adding a Job" on page 13.

attr_grp XmlVariables…request.last_edit_at Publishing the Form Perform the procedure in "Publishing the Form" on page 31.SKRootDefinition.SKRootDefinition.attr.SKRootDefinition. attr. Testing the Workflow Perform the procedure in "Testing the Workflow" on page 32.attr_grp SKFormData.SKRootDefinition.SKRootDefinition. Linking the Workflow Variables to Form Controls Perform the procedure in "Linking the Workflow Variables to Form Controls" on page 26.last_edit_at SKFormData. with the following exceptions: • Link the following workflow variables to their corresponding form controls: Variable Form Control Name XmlVariables…request.attr_desc SKFormData.data_type XmlVariables…request.attr_id XmlVariables…response.predefined XmlVariables…request.predefined SKFormData.datatype SKFormData.filtr SKFormData.attr_desc XmlVariables…request.SKRootDefinition. attr.attr_id SKFormData.filtr XmlVariables…response.SKRootDefinition.36  Chapter 2 Verifying Datatype Compatibility Control Type Number Tag Name Attribute Group Mapped XML Node attr_group Mandatory Y Other Parameters Decimal Places: 0 Min Value: 0 Max Value: 11 TextInput TextInput TextInput Filter Attribute ID Last Edit At filtr attr_id last_edit_at Y N Y Decimal Places: 12 Binding the Form to the Workflow Perform the procedure in "Binding the Form to the Workflow" on page 21. attr. Guide to Using ArchestrA Workflow with Wonderware MES . attr.

Adding an Attribute37 Sample Test Data and Expected Results Sample test data that could be entered in the form. Column Name Database Data Type Data Input Data Expected in MES Database Predefined Data_Type Attr_Desc Attr_Grp Filtr Logical Int32 String80 Int32 String254 True 4 Test Attribute 7 Test Filter True 4 Test Attribute 7 Test Filter Guide to Using ArchestrA Workflow with Wonderware MES . and the expected results in the MES database. are listed in the following table.

38  Chapter 2 Verifying Datatype Compatibility Guide to Using ArchestrA Workflow with Wonderware MES .

CreateWoFromProcess.StartJob.Workflow Connector to verify that data is passed correctly from the workflow to the MES database when calling API methods with only a few number of parameters that affects only one table in the MES database.39 Chapter 3 Verifying Minimum and Maximum Data The following stateless API methods can be used from the MES .ItemClass. and when calling API methods with a larger number of parameters of different datatypes that affect multiple tables in the database: • Prod.JobExec. which adds an item class • Prod.JobExec. which starts a job • Prod.Add. which adds production to a job Note: Other stateless API methods can also be used to verify this functionality. Guide to Using ArchestrA Workflow with Wonderware MES . which creates a work order from a process • Prod.AddProd.JobExec.

use Prod. use itemclass_output Creating an ArchestrA Workflow Software Form Perform the procedure in "Creating an ArchestrA Workflow Software Form" on page 18.ItemClass. use ItemClass.Add.40  Chapter 3 Verifying Minimum and Maximum Data Adding an Item Class This test procedure calls the Prod. Creating the Workflow Perform the procedure in "Creating the Workflow" on page 14. with the following exceptions: • For the workflow title. use itemclass_input • For the Generate Output XML Variable. • In the Generate Command window: • For the stateless API. with exceptions as noted in the following topics. with the following exceptions: • For the form title. The process for creating the Add an Item Class test procedure is the same as that described in "Adding a Job" on page 13.Add stateless API method to verify that a few parameters that affect only one database table can be passed correctly from the MES .Add.Workflow Connector and be recorded in the MES database.Add • For the Generate Input XML Variable. use ItemClass. • Specify the following controls for the form: Control Type TextInput TextInput Boolean Boolean Boolean Boolean Boolean Tag Name New Item Class Item Class Description Produced Consumed Obsolete Purchased Sold Mapped XML Node item_class_id item_class_desc produced consumed obsolete purchased sold Mandatory Y Y Other Parameters Label Position: Top Label Position: Top Label Position: Top Label Position: Top Label Position: Top Guide to Using ArchestrA Workflow with Wonderware MES .ItemClass.

request.Add form controls.Add form.item_class_input.item_class_input. purchased XMLVariables.Add workflow variables to the ItemClass. Variable Form Control Name XMLVariables. sold SKFormData.request.SKRootDefinition.consumed SKFormData.Add workflow. item_class_id XMLVariables.Adding an Item Class41 Binding the Form to the Workflow Perform the procedure in "Binding the Form to the Workflow" on page 21 to bind the ItemClass.item_class_input.SKRootDefinition.SKRootDefinition.item_class_id SKFormData.request. Guide to Using ArchestrA Workflow with Wonderware MES .Add form to the ItemClass.item_class_input.produced SKFormData. Testing the Workflow Perform the procedure in "Testing the Workflow" on page 32 to test the ItemClass.request. produced XMLVariables.obsolete SKFormData. Linking the Workflow Variables to Form Controls Perform the procedure in "Linking the Workflow Variables to Form Controls" on page 26 to link the ItemClass.sold Publishing the Form Perform the procedure in "Publishing the Form" on page 31 to publish the ItemClass.request.purchased SKFormData.SKRootDefinition.Add workflow.request.SKRootDefinition. as listed in the following table.item_class_input.SKRootDefinition.item_class_desc SKFormData. consumed XMLVariables. item_class_desc XMLVariables.item_class_input.item_class_input. obsolete XMLVariables.SKRootDefinition.request.

and the expected results in the MES database. use JobExec. use cwfp_output Guide to Using ArchestrA Workflow with Wonderware MES .Workflow Connector and be recorded in the MES database. use JobExec. are listed in the following table. use cwfp_input • For the Generate Output XML Variable. Creating the Workflow Perform the procedure in "Creating the Workflow" on page 14. with the following exceptions: • For the workflow title. The process for creating the Create a Work Order from a Process test procedure is the same as that described in "Adding a Job" on page 13.42  Chapter 3 Verifying Minimum and Maximum Data Sample Test Data and Expected Results Sample test data that could be entered in the form. Column Name Database Data Type Data Input Data Expected in MES Database ItemClass Id Item Class Desc Produced Consumed Obsolete Purchased Sold String80 String80 Logical Logical Logical Logical Logical TestItemClass TestItemClass Yes (True) Yes (True) No (False) No (False) No (False) TestItemClass TestItemClass True True False False False Creating a Work Order from a Process This test procedure calls the Prod.CWFP.JobExec.CreateWoFromProcess • For the Generate Input XML Variable. with exceptions as noted in the following topics. • In the Generate Command window: • For the stateless API.CreateWoFromProcess stateless API method to verify that a large number of parameters of different datatypes that affect multiple database tables can be passed correctly from the MES .

click Next Tag Name Create Work Order for Product Use Production Process Product Specification Work Order ID Description User Name BOM Version Release Date/Time Due Date/Time Required Quantity Start Quantity Priority OK Mapped XML Node item_id process_id spec_ver_id wo_id wo_desc user_id bom_ver_id release_time req_finish_time req_qty start_qty priority ok Mandatory Y Y N Y N N N Y Y Y Y N Other Parameters Minimum Value: 0 Minimum Value: 0 Button Type: Submit Text: OK Is Form Level Button: Yes Button. with the following exceptions: • For the form title. use JobExec. • Specify the following controls for the form: Control Type TextInput or Lookup TextInput or Lookup TextInput or Lookup TextInput TextInput TextInput or Lookup TextInput or Lookup DateInput DateInput Number Number Number Button. Guide to Using ArchestrA Workflow with Wonderware MES . click Next Cancel cancel Button Type: Cancel Text: Cancel Is Form Level Button: Yes Binding the Form to the Workflow Perform the procedure in "Binding the Form to the Workflow" on page 21 to bind the JobExec.CWFP.CWFP workflow.Creating a Work Order from a Process43 Creating an ArchestrA Workflow Software Form Perform the procedure in "Creating an ArchestrA Workflow Software Form" on page 18.CWFP form to the JobExec.

request. System. To address the DateTime issue for these inputs.SKRootDefinition. Variable Form Control Name XMLVariables. This test procedure includes Release Date/Time and Due Date/Time inputs in the workflow form.spec_ver_id SKFormData.CultureInfo. refer to "DateTime" on page 101.SFFormData.SFFormData.req_finish_time.Globalization.ToLocalTime() • The variable Due DateTime Local of type date and with the expression: Convert.wo_id SKFormData.ToDateTime (XmlVariables.InvariantCulture) . as listed in the following table. wo_id XMLVariables. process_id XMLVariables.request. you must create a DateTime variable to convert any DateTime input values from the workflow form from UTC time to local time.cwfp_input.SKRootDefinition.request.request. System.cwfp_input.wo_desc * DateTimes are set to workflow variables created to ensure that they are sent as localtime to the MES database.cwfp_input.cwfp_input. perform the procedure in "Adding a Variable for the DateTime Input" on page 23 to add the following variables: • The variable Release DateTime Local of type date and with the expression: Convert. Guide to Using ArchestrA Workflow with Wonderware MES .Globalization.CWFP form controls.SKRootDefinition. For additional information about this issue.process_id SKFormData.item_id SKFormData.SKRootDefinition.CWFP workflow variables to the JobExec.cwfp_input.release_time.request. spec_ver_id XMLVariables.SKRootDefinition.44  Chapter 3 Verifying Minimum and Maximum Data Adding Variables for the DateTime Inputs Because of a difference in how ArchestrA Workflow Software and MES stateless API methods treat DateTime inputs.ToLocalTime() Linking the Workflow Variables to Form Controls Perform the procedure in "Linking the Workflow Variables to Form Controls" on page 26 to link the JobExec. item_id XMLVariables.CultureInfo.ToDateTime (XmlVariables. wo_desc SKFormData.SKRootDefinition.SKRootDefinition.InvariantCulture) .

start_qty SKFormData.Due DateTime Local* SKFormData. Column Name Database Data Type Data Input Data Expected in MES Database Item Id Process Id Spec Version Id Work Order Id Work Order Description String80 String80 String 80 String 80 String80 Item-A Process_001 NULL TestWO Work_Order_TestWO Item-A Process_001 NULL TestWO Work_Order_TestWO Guide to Using ArchestrA Workflow with Wonderware MES .req_qty SKFormData.cwfp_input.cwfp_input.request.user_id SKFormData. are listed in the following table.CWFP form. req_qty XMLVariables.SKRootDefinition.request. release_time_local XMLVariables.request.CWFP workflow.SKRootDefinition. wo_priority SKFormData.request.SKRootDefinition.cwfp_input.cwfp_input.bom_ver_id Variables.SKRootDefinition. start_qty XMLVariables.cwfp_input. bom_ver_id XMLVariables.cwfp_input.priority * DateTimes are set to workflow variables created to ensure that they are sent as localtime to the MES database. Publishing the Form Perform the procedure in "Publishing the Form" on page 31 to publish the JobExec. Sample Test Data and Expected Results Sample test data that could be entered in the form.Creating a Work Order from a Process45 Variable Form Control Name XMLVariables.request.request. user_id XMLVariables. req_finish_time_local XMLVariables.Release DateTime Local* Variables. and the expected results in the MES database.SKRootDefinition.request.cwfp_input. Testing the Workflow Perform the procedure in "Testing the Workflow" on page 32 to test the JobExec.

JobExec. use startjob_input • For the Generate Output XML Variable.1 11/01/2012 04:00:00 11/16/2012 14:00:00 40 50 2 Starting a Job This test procedure calls the Prod. Creating the Workflow Perform the procedure in "Creating the Workflow" on page 14.1 11/01/2012 04:00:00 11/16/2012 14:00:00 40 50 2 Ww V.StartJob.46  Chapter 3 Verifying Minimum and Maximum Data Column Name Database Data Type Data Input Data Expected in MES Database User Id BOM Version Id Release Time Local Required Finish Time Local Required Quantity Start Quantity Priority String 80 String80 DateTime DateTIme Int32 Int32 Int32 Ww V. Guide to Using ArchestrA Workflow with Wonderware MES . use JobExec.StartJob stateless API method to verify that a large number of parameters of different datatypes that affect multiple database tables can be passed correctly from the MES .StartJob • For the Generate Input XML Variable.Workflow Connector and be recorded in the MES database.A. use Prod. use JobExec. use startjob_output Creating an ArchestrA Workflow Software Form Perform the procedure in "Creating an ArchestrA Workflow Software Form" on page 18.A. with the following exceptions: • For the workflow title. with exceptions as noted in the following topics.JobExec. The process for creating the Start a Job test procedure is the same as that described in "Adding a Job" on page 13.StartJob. • In the Generate Command window: • For the stateless API. with the following exceptions: • For the form title.

perform the procedure in "Adding a Variable for the DateTime Input" on page 23 to add the following variable: • The variable Event DateTime Local of type date and with the expression: Convert. This test procedure includes an Event Time input in the workflow form.ToLocalTime() Guide to Using ArchestrA Workflow with Wonderware MES .StartJob form to the JobExec.SFFormData. you must create a DateTime variable to convert any DateTime input values from the workflow form from UTC time to local time. System.InvariantCulture) .Globalization.SKRootDefinition. Adding a Variable for the DateTime Input Because of a difference in how ArchestrA Workflow Software and MES stateless API methods treat DateTime inputs. refer to "DateTime" on page 101.CultureInfo.ToDateTime (XmlVariables.Starting a Job47 • Specify the following controls for the form: Control Type Number or Lookup TextInput or Lookup TextInput TextInput Number Number TextInput Boolean Boolean DateInput Tag Name Entity ID User Name Work Order ID Operation ID Sequence Number Job Position Status Notes Check Privileges Check Certifications Event Time Mapped XML Node ent_id user_id wo_id op_id seq_no job_pos status_notes check_privs check_certs event_time Mandatory Y Y Y Y Y N N Y Y N Other Parameters Minimum: 0 Minimum: 0 Minimum: 0 Mode of Text: Multiple Binding the Form to the Workflow Perform the procedure in "Binding the Form to the Workflow" on page 21 to bind the JobExec.StartJob workflow.event_time. For additional information about this issue. To address the DateTime issue for this input.

seq_no SKFormData.SKRootDefinition.cwfp_input.StartJob workflow.cwfp_input.job_pos SKFormData.SKRootDefinition.request.SKRootDefinition.StartJob form. check_privs XMLVariables.check_privs SKFormData.cwfp_input.cwfp_input.request.SKRootDefinition.StartJob form controls.cwfp_input. status_notes XMLVariables. Variable Form Control Name XMLVariables.cwfp_input.SKRootDefinition.cwfp_input.request.user_id SKFormData. event_time_local SKFormData.check_certs Variables.48  Chapter 3 Verifying Minimum and Maximum Data Linking the Workflow Variables to Form Controls Perform the procedure in "Linking the Workflow Variables to Form Controls" on page 26 to link the JobExec.SKRootDefinition. job_pos XMLVariables. wo_id XMLVariables.wo_id SKFormData.StartJob workflow variables to the JobExec. oper_id XMLVariables.request.request.SKRootDefinition. ent_id XMLVariables.cwfp_input.request. Publishing the Form Perform the procedure in "Publishing the Form" on page 31 to publish the JobExec.oper_id SKFormData.cwfp_input.ent_id SKFormData.cwfp_input.request. seq_no XMLVariables.status_notes SKFormData.Event DateTIme Local* *DateTime is set to workflow variable created to ensure that it is sent as localtime to the MES database.SKRootDefinition.SKRootDefinition.request. as listed in the following table.request. check_certs XMLVariables. user_id XMLVariables.request. Guide to Using ArchestrA Workflow with Wonderware MES . Testing the Workflow Perform the procedure in "Testing the Workflow" on page 32 to test the JobExec.

with the following exceptions: • For the workflow title.AddProd stateless API method to verify that a large number of parameters of different datatypes that affect multiple database tables can be passed correctly from the MES .JobExec.Workflow Connector and be recorded in the MES database. with exceptions as noted in the following topics.AddProd.Adding Production to a Job49 Sample Test Data and Expected Results Sample test data that could be entered in the form. are listed in the following table. The process for creating the Add Production to a Job test procedure is the same as that described in "Adding a Job" on page 13. use Prod. use JobExec. and the expected results in the MES database. use addprod_output Guide to Using ArchestrA Workflow with Wonderware MES . use addprod_input • For the Generate Output XML Variable.AddProd • For the Generate Input XML Variable. Creating the Workflow Perform the procedure in "Creating the Workflow" on page 14. Column Name Database Data Type Data Input Data Expected in MES Database Ent Id User Id Work Order Id Operation Id Sequence No Job Position Status Notes Check Privileges Check Certifications Event Time Int32 String 80 String 80 String80 Int32 Int32 String256 Logical Logical datetime 4 ww TestWO OP-001 0 0 Testing start job Yes (True) No (False) 11/08/2012 5:00:00 4 ww TestWO OP-001 0 0 Testing start job True False 11/08/2012 5:00:00 Adding Production to a Job This test procedure calls the Prod.JobExec. • In the Generate Command window: • For the stateless API.

AddProd. with the following exceptions: • For the form title. Guide to Using ArchestrA Workflow with Wonderware MES .50  Chapter 3 Verifying Minimum and Maximum Data Creating an ArchestrA Workflow Software Form Perform the procedure in "Creating an ArchestrA Workflow Software Form" on page 18. • Specify the following controls for the form: Control Type Number DateInput TextInput or Lookup Number or Lookup Number Number TextInput TextInput Number or Lookup TextInput or Lookup Number TextInput TextInput Number Tag Name Session ID Event Time User Name Entity ID Qty Produced Reason Code Lot No Sublot No Storage Entity ID Produced Item BOM Position Seqment Requirement ID Seqment Response ID Job Position Mapped XML Node session_id event_time user_id ent_id qty_prod reas_cd lot_no sublot_no to_ent_id item_id bom_pos seg_req_id seg_res_id job_pos Mandatory Y N Y Y Y N N N N N N N N N Other Parameters Minimum: 0 Minimum: 0 Minimum: 0 Minimum: 0 Minimum: 0 Binding the Form to the Workflow Perform the procedure in "Binding the Form to the Workflow" on page 21 to bind the JobExec. use JobExec. For additional information about this issue.AddProd workflow.AddProd form to the JobExec. you must create a DateTime variable to convert any DateTime input values from the workflow form from UTC time to local time. refer to "DateTime" on page 101. Adding a Variable for the DateTime Input Because of a difference in how ArchestrA Workflow Software and MES stateless API methods treat DateTime inputs.

sublot_no XMLVariables.request. perform the procedure in "Adding a Variable for the DateTime Input" on page 23 to add the following variable: • The variable Event DateTime Local of type date and with the expression: Convert.SKRootDefinition.ent_id SKFormData.SKRootDefinition.addprod_input.request. as listed in the following table. To address the DateTime issue for this input.addprod_input.request.item_id *DateTime is set to workflow variable created to insure that it is sent as localtime to the MES database.SKRootDefinition.reas_cd SKFormData.sublot_no SKFormData.event_time.ToDateTime (XmlVariables.request.add_prod_input.AddProd workflow variables to the JobExec.SKRootDefinition.session_id Variables.addprod_input.user_id SKFormData.request.lot_no SKFormData. item_id SKFormData. Guide to Using ArchestrA Workflow with Wonderware MES .request. qty_prod XMLVariables. reas_cd XMLVariables.SFFormData. session_id XMLVariables.addprod_input. event_time_local XMLVariables.InvariantCulture) .request.addprod_input.addprod_input.request.ToLocalTime() Linking the Workflow Variables to Form Controls Perform the procedure in "Linking the Workflow Variables to Form Controls" on page 26 to link the JobExec. Variable Form Control Name XMLVariables.addprod_input.SKRootDefinition.qty_prod SKFormData. storage_ent_id XMLVariables.Adding Production to a Job51 This test procedure includes an Event Time input in the workflow form.request. user_id XMLVariables. System.AddProd form controls.Globalization.CultureInfo.SKRootDefinition. lot_no XMLVariables.SKRootDefinition.SKRootDefinition.SKRootDefinition.addprod_input.SKRootDefinition.addprod_input. ent_id XMLVariables.storage_ent_id SKFormData.Event DateTime Local* SKFormData.request.

seg_res_id SKFormData.AddProd workflow. and the expected results in the MES database. are listed in the following table.AddProd form.SKRootDefinition.SKRootDefinition.addprod_input.job_pos *DateTime is set to workflow variable created to insure that it is sent as localtime to the MES database. seq_res_id XMLVariables. Testing the Workflow Perform the procedure in "Testing the Workflow" on page 32 to test the JobExec.SKRootDefinition. Publishing the Form Perform the procedure in "Publishing the Form" on page 31 to publish the JobExec. seg_req_id XMLVariables.seg_req_id SKFormData.request.SKRootDefinition.request. Sample Test Data and Expected Results Sample test data that could be entered in the form. bom_pos XMLVariables.addprod_input. job_pos SKFormData.addprod_input. Column Name Database Data Type Data Input Data Expected in MES Database Session Id Event Time User Id Ent Id Qty Prod Reason Code Lot No Sublot No Storage Ent Id Produced Item Int32 datetime String 80 Int32 Double Int32 String80 String80 Int32 String80 114 11/08/2012 5:00:00 ww 4 4 1 1 Null 4 Item-A 114 11/08/2012 5:00:00 ww 4 4 1 1 Null 4 Item-A Guide to Using ArchestrA Workflow with Wonderware MES .request.bom_pos SKFormData.request.addprod_input.52  Chapter 3 Verifying Minimum and Maximum Data Variable Form Control Name XMLVariables.

Adding Production to a Job53 Column Name Database Data Type Data Input Data Expected in MES Database Bom Position Segment Requirement ID Segment Response ID Job Position Int32 String80 String80 Int32 Null Null Null 0 Null Null Null 0 Guide to Using ArchestrA Workflow with Wonderware MES .

54  Chapter 3 Verifying Minimum and Maximum Data Guide to Using ArchestrA Workflow with Wonderware MES .

JobExec. Setting the Current Lot Information for a Job This test procedure calls the overloaded method for the JobExec. which adds current lot information to a job • Prod.SetCurLotData in the stateless API to verify that the workflow connector calls the correct overload method to record data in the MES database. which starts a job Note: Other stateless API methods can also be used to verify this functionality.SetCurLotData.StartJob.55 Chapter 4 Verifying Complex Event Types The following stateless API methods can be used from the MES . with exceptions as noted in the following topics. Guide to Using ArchestrA Workflow with Wonderware MES . The process for creating the Set Current Lot Information for a Job test procedure is the same as that described in "Adding a Job" on page 13.Workflow Connector • JobExec.Workflow Connector to verify that complex event types used in MES are compatible with the event types used in the MES .

• Specify the following controls for the form: Control Type Number Number Number TextInput TextInput TextInput Number Number Boolean Boolean Tag Name Entity ID Job Pos BOM Pos Default Current Item ID Default Current Lot Number Default Current SubLot Number Default Reason Code Current Storage Entity IDs Backflush Update Inventory Mapped XML Node ent_id job_pos bom_pos cur_item_id cur_lot_no cur_sublot_no cur_reas_cd cur_storage_ent_id cur_backflush cur_update_inv Mandatory Y Y Y Y Y Y Y Y Other Parameters Binding the Form to the Workflow Perform the procedure in "Binding the Form to the Workflow" on page 21 to bind the JobExec. with the following exceptions: • For the form title.SetCurLotData. use setcurlotdata_input • For the Generate Output XML Variable. • In the Generate Command window: • For the stateless API. use setcurlotdata_output Creating an ArchestrA Workflow Software Form Perform the procedure in "Creating an ArchestrA Workflow Software Form" on page 18.56  Chapter 4 Verifying Complex Event Types Creating the Workflow Perform the procedure in "Creating the Workflow" on page 14. Guide to Using ArchestrA Workflow with Wonderware MES . with the following exceptions: • For the workflow title.SetCurLotData form to the JobExec.SetCurLotData workflow. use JobExec. use JobExec.SetCurLotData. use JobExec.SetCurLotData • For the Generate Input XML Variable.

Setting the Current Lot Information for a Job57 Linking the Workflow Variables to Form Controls Perform the procedure in "Linking the Workflow Variables to Form Controls" on page 26 to link the JobExec. cur_item_id XmlVariables…request.SKRootDefinition.SKRootDefinition. Column Name Database Data Type Data Input Data Expected in MES Database Ent_Id Job_Pos Bom_Pos DefaultCurrentLotNo Int32 Int32 Int32 String80 16 0 0 Test Default Current Lot No 16 0 0 Test Default Current Lot No Guide to Using ArchestrA Workflow with Wonderware MES .SKRootDefinition.cur_update_inv Publishing the Form Perform the procedure in "Publishing the Form" on page 31 to publish the JobExec. Variable XmlVariables…request.SKRootDefinition.cur_lot_no XmlVariables…request.cur_sublot_no SKFormData.SetCurLotData form.SetCurLotData form controls.cur_update_inv Form Control Name SKFormData.SKRootDefinition.cur_reas_cd XmlVariables…request. are listed in the following table. Sample Test Data and Expected Results Sample test data that could be entered in the form.ent_id XmlVariables…request.cur_backflush XmlVariables…request.bom_pos SKFormData.SKRootDefinition.cur_backflush SKFormData.SetCurLotData workflow.SKRootDefinition.cur_storage_ent_id XmlVariables…request.cur_storage_ent_id SKFormData.job_pos SKFormData. job_pos XmlVariables…request.cur_sublot_no XmlVariables…request.SKRootDefinition.cur_lot_no SKFormData.ent_id SKFormData.cur_reas_cd SKFormData. as listed in the following table. bom_pos XmlVariables…request.SetCurLotData workflow variables to the JobExec.SKRootDefinition. and the expected results in the MES database. Testing the Workflow Perform the procedure in "Testing the Workflow" on page 32 to test the JobExec.SKRootDefinition.cur_item_id SKFormData.

use JobExec.StartJob stateless API method to verify that the MES .JobExec. Creating the Workflow Perform the procedure in "Creating the Workflow" on page 14. • In the Generate Command window: • For the stateless API.StartJob • For the Generate Input XML Variable. use startjob_output Creating an ArchestrA Workflow Software Form Perform the procedure in "Creating an ArchestrA Workflow Software Form" on page 18.58  Chapter 4 Verifying Complex Event Types Column Name Database Data Type Data Input Data Expected in MES Database DefaultCurrentSubLotNo DefaultCurrentItemId DefaultCurrentReasCd CurrentStorageEntId UpdateInventory Backflush String80 String80 Int32 Int32 Logical Logical Test Default Current Sub Lot No QA-Case24 1 4 No (False) No (False) Test Default Current Sub Lot No QA-Case24 1. with the following exceptions: • For the workflow title. use JobExec.StartJob.Workflow Connector calls the correct overload method to send data to the MES database. use startjob_input • For the Generate Output XML Variable. with the following exceptions: • For the form title. use Prod.StartJob.12 4 False False Starting a Job This test procedure calls the Prod. The process for creating the Start a Job test procedure is the same as that described in "Adding a Job" on page 13.JobExec. Guide to Using ArchestrA Workflow with Wonderware MES . with exceptions as noted in the following topics.

For additional information about this issue.Globalization.StartJob form to the JobExec.SKRootDefinition.InvariantCulture) . you must create a DateTime variable to convert any DateTime input values from the workflow form from UTC time to local time. System.SFFormData.CultureInfo. perform the procedure in "Adding a Variable for the DateTime Input" on page 23 to add the following variable: • The variable Event DateTime Local of type date and with the expression: Convert.ToDateTime (XmlVariables. refer to "DateTime" on page 101. This test procedure includes an Event Time input in the workflow form.StartJob workflow.Starting a Job59 • Specify the following controls for the form: Control Type Number or Lookup TextInput or Lookup TextInput TextInput Number Number TextInput Boolean Boolean DateInput Tag Name Entity ID User Name Work Order ID Operation ID Sequence Number Job Position Status Notes Check Privileges Check Certifications Event Time Mapped XML Node ent_id user_id wo_id op_id seq_no job_pos status_notes check_privs check_certs event_time Mandatory Y Y Y Y Y N N Y Y N Other Parameters Minimum: 0 Minimum: 0 Minimum: 0 Mode of Text: Multiple Binding the Form to the Workflow Perform the procedure in "Binding the Form to the Workflow" on page 21 to bind the JobExec.ToLocalTime() Guide to Using ArchestrA Workflow with Wonderware MES . Adding a Variable for the DateTime Input Because of a difference in how ArchestrA Workflow Software and MES stateless API methods treat DateTime inputs.event_time. To address the DateTime issue for this input.

request.request.request.cwfp_input.cwfp_input.cwfp_input.SKRootDefinition. check_certs XMLVariables.cwfp_input.wo_id SKFormData.request.cwfp_input.60  Chapter 4 Verifying Complex Event Types Linking the Workflow Variables to Form Controls Perform the procedure in "Linking the Workflow Variables to Form Controls" on page 26 to link the JobExec.cwfp_input.cwfp_input.job_pos SKFormData.cwfp_input.Event DateTIme Local* *DateTime is set to workflow variable created to ensure that it is sent as localtime to the MES database. as listed in the following table.request.user_id SKFormData.SKRootDefinition. wo_id XMLVariables.oper_id SKFormData.SKRootDefinition.StartJob workflow.status_notes SKFormData.StartJob form controls.check_privs SKFormData.request.StartJob workflow variables to the JobExec.SKRootDefinition. oper_id XMLVariables. Variable Form Control Name XMLVariables. user_id XMLVariables. job_pos XMLVariables.request.check_certs Variables.SKRootDefinition.cwfp_input. event_time_local SKFormData. ent_id XMLVariables. Testing the Workflow Perform the procedure in "Testing the Workflow" on page 32 to test the JobExec.SKRootDefinition.requrest.cwfp_input.SKRootDefinition.SKRootDefinition. Publishing the Form Perform the procedure in "Publishing the Form" on page 31 to publish the JobExec.SKRootDefinition. seq_no XMLVariables.request.StartJob form. check_privs XMLVariables. status_notes XMLVariables.seq_no SKFormData.request.ent_id SKFormData. Guide to Using ArchestrA Workflow with Wonderware MES .

and the expected results in the MES database. Column Name Database Data Type Data Input Data Expected in MES Database Ent Id User Id Work Order Id Operation Id Sequence No Job Position Status Notes Check Privileges Check Certifications Event Time Int32 String 80 String 80 String80 Int32 Int32 String256 Logical Logical datetime 4 ww TestWO OP-001 0 0 Testing start job Yes (True) No (False) 11/08/2012 5:00:00 4 ww TestWO OP-001 0 0 Testing start job True False 11/08/2012 5:00:00 Column Name Database Data Type Data Input Data Expected in MES Database Ent Id User Id Work Order Id Operation Id Sequence No Job Position Status Notes Check Privileges Check Certifications Event Time Int32 String 80 String 80 String80 Int32 Int32 String256 Logical Logical datetime 4 ww TestWO OP-001 0 0 Testing start job Yes (True) No (False) Null 4 ww TestWO OP-001 0 0 Testing start job True False Current date and time Guide to Using ArchestrA Workflow with Wonderware MES .Starting a Job61 Sample Test Data and Expected Results Two sets of sample test data that could be entered in the form. are listed in the following table.

62  Chapter 4 Verifying Complex Event Types Guide to Using ArchestrA Workflow with Wonderware MES .

Workflow Connector to verify that data is sent correctly when the workflow is on a machine with a different regional setting then the machine that the MES Middleware and database are on. Guide to Using ArchestrA Workflow with Wonderware MES . Set the regional settings to Pacific Time. use the Middleware Proxy Configuration Editor to change the Host Proxy to point to the second machine. For this machine.JobExec. • Prod.63 Chapter 5 Verifying DateTimes with Different Regional Settings The following stateless API methods can be used from the MES . which creates a work order from a process • Prod. set the regional settings to Eastern Time.CreateWoFromProcess. which starts a job Note: Other stateless API methods can also be used to verify this functionality.JobExec. Also. Prerequisites for Performing the Tests Two machines are necessary for these test processes: • The client machine should have Workflow and MES Client installed. • The host machine should have MES Middleware and the MES database installed.StartJob.

Creating the Workflow Perform the procedure in "Creating the Workflow" on page 14. use JobExec. use JobExec.JobExec. with exceptions as noted in the following topics.CWFP. with the following exceptions: • For the form title. with the following exceptions: • For the workflow title.CWFP.CreateWoFromProcess stateless API method to verify that the date fields entered on the client machine are correctly stored in the MES database on the host machine when they have different regional settings.CreateWoFromProcess • For the Generate Input XML Variable. • Specify the following controls for the form: Control Type TextInput or Lookup TextInput or Lookup TextInput or Lookup TextInput TextInput TextInput or Lookup TextInput or Lookup DateInput Tag Name Create Work Order for Product Use Production Process Product Specification Work Order ID Description User Name BOM Version Release Date/Time Mapped XML Node item_id process_id spec_ver_id wo_id wo_desc user_id bom_ver_id release_time Mandatory Y N N Y N N N Y Other Parameters Guide to Using ArchestrA Workflow with Wonderware MES . use JobExec. use cwfp_output Creating an ArchestrA Workflow Software Form Perform the procedure in "Creating an ArchestrA Workflow Software Form" on page 18. The process for creating the Create a Work Order from a Process test procedure is the same as that described in "Adding a Job" on page 13. use cwfp_input • For the Generate Output XML Variable. • In the Generate Command window: • For the stateless API.64  Chapter 5 Verifying DateTimes with Different Regional Settings Creating a Work Order from a Process This test procedure calls the Prod.

release_time.InvariantCulture) . Adding Variables for the DateTime Inputs Because of a difference in how ArchestrA Workflow Software and MES stateless API methods treat DateTime inputs.ToDateTime (XmlVariables.CultureInfo. refer to "DateTime" on page 101. System. click Next Cancel cancel Button Type: Cancel Text: Cancel Is Form Level Button: Yes Binding the Form to the Workflow Perform the procedure in "Binding the Form to the Workflow" on page 21 to bind the JobExec.Creating a Work Order from a Process65 Control Type DateInput Number Number Number Button. For additional information about this issue.SKRootDefinition. click Next Tag Name Due Date/Time Required Quantity Start Quantity Priority OK Mapped XML Node req_finish_time req_qty start_qty priority ok Mandatory Y Y Y N Other Parameters Minimum Value: 0 Minimum Value: 0 Button Type: Submit Text: OK Is Form Level Button: Yes Button.SFFormData. you must create a DateTime variable to convert any DateTime input values from the workflow form from UTC time to local time.CWFP form to the JobExec. perform the procedure in "Adding a Variable for the DateTime Input" on page 23 to add the following variables: • The variable Release DateTime Local of type date and with the expression: Convert. To address the DateTime issue for these inputs.CWFP workflow.ToLocalTime() Guide to Using ArchestrA Workflow with Wonderware MES .Globalization. This test procedure includes Release Date/Time and Due Date/Time inputs in the workflow form.

ToLocalTime() Linking the Workflow Variables to Form Controls Perform the procedure in "Linking the Workflow Variables to Form Controls" on page 26 to link the JobExec. as listed in the following table.cwfp_input. release_time_local XMLVariables.cwfp_input.request.req_finish_time.item_id SKFormData.req_qty SKFormData. bom_ver_id XMLVariables.SKRootDefinition. wo_id XMLVariables.CWFP workflow variables to the JobExec.request.request.Release DateTime Local* Variables. System.request.spec_ver_id SKFormData.Due DateTime Local* SKFormData. wo_priority SKFormData.cwfp_input.SFFormData. start_qty XMLVariables.cwfp_input. process_id XMLVariables.CultureInfo.CWFP form controls.SKRootDefinition. item_id XMLVariables.SKRootDefinition. user_id XMLVariables.Globalization.SKRootDefinition.request.SKRootDefinition.SKRootDefinition.cwfp_input.priority * DateTimes are set to workflow variables created to ensure that they are sent as localtime to the MES database.cwfp_input.process_id SKFormData.cwfp_input.user_id SKFormData.request.wo_id SKFormData. req_finish_time_local XMLVariables. Variable Form Control Name XMLVariables.SKRootDefinition.SKRootDefinition. Guide to Using ArchestrA Workflow with Wonderware MES .cwfp_input. req_qty XMLVariables.cwfp_input.66  Chapter 5 Verifying DateTimes with Different Regional Settings • The variable Due DateTime Local of type date and with the expression: Convert.bom_ver_id Variables.request.request.request.ToDateTime (XmlVariables.InvariantCulture) . spec_ver_id XMLVariables. wo_desc XMLVariables.cwfp_input.SKRootDefinition.request.SKRootDefinition.wo_desc SKFormData.SKRootDefinition.cwfp_input.request.start_qty SKFormData.cwfp_input.request.

Testing the Workflow Perform the procedure in "Testing the Workflow" on page 32 to test the JobExec. are listed in the following table. Column Name Database Data Type Data Input Data Expected in MES Database Item Id Process Id Spec Version Id Work Order Id Work Order Description User Id BOM Version Id Release Time Local Required Finish Time Local Required Quantity Start Quantity Priority String80 String80 String 80 String 80 String80 String 80 String80 DateTime DateTIme Int32 Int32 Int32 Item-A Process_001 NULL TestWO Work_Order_TestWO Ww V.1 11/01/2012 04:00:00 11/16/2012 14:00:00 40 50 2 Guide to Using ArchestrA Workflow with Wonderware MES .A.CWFP form.CWFP workflow. and the expected results in the MES database.A. Sample Test Data and Expected Results Sample test data that could be entered in the form.1 11/01/2012 04:00:00 11/16/2012 14:00:00 40 50 2 Item-A Process_001 NULL TestWO Work_Order_TestWO Ww V.Creating a Work Order from a Process67 Publishing the Form Perform the procedure in "Publishing the Form" on page 31 to publish the JobExec.

use startjob_input • For the Generate Output XML Variable. with the following exceptions: • For the form title.StartJob.JobExec. • Specify the following controls for the form: Control Type Number or Lookup TextInput or Lookup TextInput TextInput Number Number TextInput Boolean Tag Name Entity ID User Name Work Order ID Operation ID Sequence Number Job Position Status Notes Check Privileges Mapped XML Node ent_id user_id wo_id op_id seq_no job_pos status_notes check_privs Mandatory Y Y Y Y Y N N Y Other Parameters Minimum: 0 Minimum: 0 Minimum: 0 Mode of Text: Multiple Guide to Using ArchestrA Workflow with Wonderware MES . The process for creating the Start a Job test procedure is the same as that described in "Adding a Job" on page 13. • In the Generate Command window: • For the stateless API. use Prod.StartJob • For the Generate Input XML Variable.StartJob stateless API method to verify that a date entered on an ArchestrA form on a machine with one regional setting is correctly recorded in an MES database on a machine with a different regional setting for the *. use startjob_output Creating an ArchestrA Workflow Software Form Perform the procedure in "Creating an ArchestrA Workflow Software Form" on page 18.68  Chapter 5 Verifying DateTimes with Different Regional Settings Starting a Job This test procedure calls the Prod.StartJob. and *_utc fields.JobExec. use JobExec. use JobExec. with the following exceptions: • For the workflow title. with exceptions as noted in the following topics. *_local. Creating the Workflow Perform the procedure in "Creating the Workflow" on page 14.

refer to "DateTime" on page 101.StartJob form controls. ent_id XMLVariables.event_time. To address the DateTime issue for this input. For additional information about this issue. System.StartJob workflow.Starting a Job69 Control Type Boolean DateInput Tag Name Check Certifications Event Time Mapped XML Node check_certs event_time Mandatory Y N Other Parameters Binding the Form to the Workflow Perform the procedure in "Binding the Form to the Workflow" on page 21 to bind the JobExec.SKRootDefinition. This test procedure includes an Event Time input in the workflow form. Variable Form Control Name XMLVariables. user_id SKFormData. you must create a DateTime variable to convert any DateTime input values from the workflow form from UTC time to local time.ToLocalTime() Linking the Workflow Variables to Form Controls Perform the procedure in "Linking the Workflow Variables to Form Controls" on page 26 to link the JobExec. perform the procedure in "Adding a Variable for the DateTime Input" on page 23 to add the following variable: • The variable Event DateTime Local of type date and with the expression: Convert.user_id *DateTime is set to workflow variable created to ensure that it is sent as localtime to the MES database.cwfp_input. Adding a Variable for the DateTime Input Because of a difference in how ArchestrA Workflow Software and MES stateless API methods treat DateTime inputs.StartJob form to the JobExec.CultureInfo.SKRootDefinition.SFFormData.request.Globalization.cwfp_input. as listed in the following table.request.ToDateTime (XmlVariables.SKRootDefinition.StartJob workflow variables to the JobExec.InvariantCulture) .ent_id SKFormData. Guide to Using ArchestrA Workflow with Wonderware MES .

cwfp_input.cwfp_input.70  Chapter 5 Verifying DateTimes with Different Regional Settings Variable Form Control Name XMLVariables.oper_id SKFormData.SKRootDefinition.SKRootDefinition.Event DateTime Local* *DateTime is set to workflow variable created to ensure that it is sent as localtime to the MES database. are listed in the following table. Testing the Workflow Perform the procedure in "Testing the Workflow" on page 32 to test the JobExec. status_notes XMLVariables. check_certs XMLVariables.request.request.StartJob workflow.SKRootDefinition.request.request.SKRootDefinition.request.seq_no SKFormData.request.cwfp_input.check_privs SKFormData.SKRootDefinition.request.request. check_privs XMLVariables. oper_id XMLVariables.cwfp_input.cwfp_input.cwfp_input.job_pos SKFormData. Column Name Database Data Type Data Input Data Expected in MES Database Ent Id User Id Work Order Id Int32 String 80 String 80 4 ww TestWO 4 ww TestWO Guide to Using ArchestrA Workflow with Wonderware MES .SKRootDefinition. event_time_local SKFormData.cwfp_input. job_pos XMLVariables.status_notes SKFormData. seq_no XMLVariables. wo_id XMLVariables.wo_id SKFormData.check_certs Variables.cwfp_input.SKRootDefinition. Publishing the Form Perform the procedure in "Publishing the Form" on page 31 to publish the JobExec. and the expected results in the MES database. Sample Test Data and Expected Results Sample test data that could be entered in the form.StartJob form.

Starting a Job71 Column Name Database Data Type Data Input Data Expected in MES Database Operation Id Sequence No Job Position Status Notes Check Privileges Check Certifications Event Time String80 Int32 Int32 String256 Logical Logical datetime OP-001 0 0 Testing start job Yes (True) No (False) 11/08/2012 5:00:00 OP-001 0 0 Testing start job True False Actual_start_time_local: 11/08/2012 5:00:00 Actual_start_time_utc: 11/08/2012 13:00:00 Actual_start_time: 11/08/2012 2:00:00 Guide to Using ArchestrA Workflow with Wonderware MES .

72  Chapter 5 Verifying DateTimes with Different Regional Settings Guide to Using ArchestrA Workflow with Wonderware MES .

Workflow Connector to verify that the localization of datatypes is being passed correctly from the Workflow to the MES database: • Prod.ItemClass. which adds production to a job Note: Other stateless API methods can also be used to verify this functionality.ItemClass. Adding an Item Class—MES SQL Database This test procedure calls the Prod.Workflow Connector and be recorded in an MES SQL database. The process for creating the Add an Item Class test procedure is the same as that described in "Adding a Job" on page 13. which adds an item class • Prod.AddProd.73 Chapter 6 Verifying Localization of Datatypes The following stateless API methods can be used from the MES .Add. with exceptions as noted in the following topics. Guide to Using ArchestrA Workflow with Wonderware MES .JobExec.Add stateless API method to verify that strings of different languages can be passed correctly from the MES .

• Specify the following controls for the form: Control Type TextInput TextInput Boolean Boolean Boolean Boolean Boolean Tag Name New Item Class Item Class Description Produced Consumed Obsolete Purchased Sold Mapped XML Node item_class_id item_class_desc produced consumed obsolete purchased sold Mandatory Y Y Other Parameters Label Position: Top Label Position: Top Label Position: Top Label Position: Top Label Position: Top Binding the Form to the Workflow Perform the procedure in "Binding the Form to the Workflow" on page 21 to bind the ItemClass. use itemclass_input • For the Generate Output XML Variable. Guide to Using ArchestrA Workflow with Wonderware MES . use ItemClass.74  Chapter 6 Verifying Localization of Datatypes Creating the Workflow Perform the procedure in "Creating the Workflow" on page 14.Add. with the following exceptions: • For the workflow title. • In the Generate Command window: • For the stateless API.Add form to the ItemClass. with the following exceptions: • For the form title. use ItemClass. use itemclass_output Creating an ArchestrA Workflow Software Form Perform the procedure in "Creating an ArchestrA Workflow Software Form" on page 18. use Prod.Add workflow.ItemClass.Add • For the Generate Input XML Variable.Add.

SKRootDefinition. obsolete XMLVariables. Testing the Workflow Perform the procedure in "Testing the Workflow" on page 32 to test the ItemClass. sold SKFormData.Add form controls. produced XMLVariables.Add workflow variables to the ItemClass.item_class_input.SKRootDefinition. Guide to Using ArchestrA Workflow with Wonderware MES .item_class_input.consumed SKFormData. consumed XMLVariables.item_class_id SKFormData.purchased SKFormData.Adding an Item Class—MES SQL Database75 Linking the Workflow Variables to Form Controls Perform the procedure in "Linking the Workflow Variables to Form Controls" on page 26 to link the ItemClass.SKRootDefinition.item_class_input.produced SKFormData. item_class_desc XMLVariables.request.Add workflow.item_class_input.SKRootDefinition. and the expected results in the MES database.item_class_input. Sample Test Data and Expected Results Sample test data for several languages that could be entered in the form.item_class_input.request. are listed in the following tables.SKRootDefinition.item_class_input.sold Publishing the Form Perform the procedure in "Publishing the Form" on page 31 to publish the ItemClass. item_class_id XMLVariables. Variable Form Control Name XMLVariables.request.Add form.request.request.item_class_desc SKFormData.request.SKRootDefinition.obsolete SKFormData.request. purchased XMLVariables. as listed in the following table.SKRootDefinition.

76  Chapter 6 Verifying Localization of Datatypes Chinese Column Name Database Data Type Data Input Data Expected in MES Database Item Class Id Item Class Desc Produced Consumed Obsolete Purchased Sold String80 String80 Logical Logical Logical Logical Logical 测试类 测试 Yes (True) Yes (True) No (False) No (False) No (False) 测试类 测试 True True False False False Spanish Column Name Database Data Type Data Input Data Expected in MES Database Item Class Id Item Class Desc Produced Consumed Obsolete Purchased Sold String80 String80 Logical Logical Logical Logical Logical Clase de prueba mañana mañana Yes (True) Yes (True) No (False) No (False) No False) Clase de prueba mañana mañana True True False False False French Column Name Database Data Type Data Input Data Expected in MES Database Item Class Id Item Class Desc Produced Consumed Obsolete Purchased Sold String80 String80 Logical Logical Logical Logical Logical Catégorie de l'élément Catégorie de l'élément Yes (True) Yes (True) No (False) No (False) No (False) Catégorie de l'élément Catégorie de l'élément True True False False False Guide to Using ArchestrA Workflow with Wonderware MES .

Job.Add stateless API method to verify that strings that contain multi-byte characters (Chinese. with exceptions as noted in the following topics. The process for creating the Add an Job test procedure is the same as that described in "Adding a Job" on page 13. Russian) can be passed correctly from the MES . Guide to Using ArchestrA Workflow with Wonderware MES .Workflow Connector and be recorded in an MES Oracle database that accepts multi-byte characters. Japanese.Adding a Job—Oracle Database77 Japanese Column Name Database Data Type Data Input Data Expected in MES Database Item Class Id Item Class Desc Produced Consumed Obsolete Purchased Sold String80 String80 Logical Logical Logical Logical Logical テスト項目クラス 日本でのテスト Yes (True) Yes (True) No (False) No (False) No (False) テスト項目クラス 日本でのテスト True True False False False Russian Column Name Database Data Type Data Input Data Expected in MES Database Item Class Id Item Class Desc Produced Consumed Obsolete Purchased Sold String80 String80 Logical Logical Logical Logical Logical Проверьте пункт класса Тест в Российской Yes (True) Yes (True) No (False) No (False) No (False) Проверьте пункт класса Тест в Российской True True False False False Adding a Job—Oracle Database This test procedure calls the Prod.

Add. use Prod.78  Chapter 6 Verifying Localization of Datatypes Prerequisites for Performing This Test For each language that uses multi-byte characters that you are testing. use Job. use Job. • Specify the following controls for the form: Control Type TextInput or Lookup TextInput TextInput DateInput Number Tag Name Work Order ID Operation ID Sequence No Required Finish Date/Time Rework Mapped XML Node wo_id op_id seq_no req_finish_time rework Mandatory Y Y Y Y Y Other Parameters Minimum: 0 Maximum: 1 Number Number Initial Sched Entity ID Target Sched Entity ID int_sched_ent_id target_sched_ent Y Y Minimum: 0 Minimum: 0 Guide to Using ArchestrA Workflow with Wonderware MES . Note: This test will also work using an MES SQL database on an operating system in the multi-byte language being tested.Job. use jobadd_output Creating an ArchestrA Workflow Software Form Perform the procedure in "Creating an ArchestrA Workflow Software Form" on page 18. you must: • Create an MES Oracle database on the machine that is loaded with an operating system in the language you are testing. with the following exceptions: • For the workflow title.Add. • In the Generate Command window: • For the stateless API. Creating the Workflow Perform the procedure in "Creating the Workflow" on page 14. • Create a Workflow connection to this MES database. with the following exceptions: • For the form title.Add • For the Generate Input XML Variable. use jobadd_input • For the Generate Output XML Variable.

perform the procedure in "Adding a Variable for the DateTime Input" on page 23 to add the following variable: • The variable RequiredFinish DateTime Local of type date and with the expression: Convert. Adding a Variable for the DateTime Input Because of a difference in how ArchestrA Workflow Software and MES stateless API methods treat DateTime inputs.Add workflow.Adding a Job—Oracle Database79 Control Type Number Number TextInput TextInput TextInput Number Tag Name Quantity Required Quantity At Start Spare1 Last Edit Comment Item ID Estimated Production Rate Mapped XML Node req_qty start_qty spare1 last_edit_comment item_id est_prod_rate Mandatory Y Y Y Y Y Y Other Parameters Minimum: 0 Minimum: 0 Binding the Form to the Workflow Perform the procedure in "Binding the Form to the Workflow" on page 21 to bind the Job. For additional information about this issue.CultureInfo.ToLocalTime() Guide to Using ArchestrA Workflow with Wonderware MES .InvariantCulture) .SFFormData. refer to "DateTime" on page 101.ToDateTime (XmlVariables.req_finish_time_ local.Globalization. To address the DateTime issue for this input.Add form to the Job. This test procedure includes a Required Finish Date/Time input in the workflow form.SKRootDefinition.System. you must create a DateTime variable to convert any DateTime input values from the workflow form from UTC time to local time.

est_prod_rate *DateTimes are set to workflow variables created to ensure that they are sent as localtime to the MES database.target_sched_ ent_id SKFormData.request.jobadd_input. last_edit_comment XMLVariables.last_edit_ comment SKFormData.request.jobadd_input.oper_id SKFormData.init_sched_ent_ id SKFormData.item_id SKFormData. init_sched_ent_id XMLVariables. Variables Form Control Name XMLVariables. spare1 XMLVariables.jobadd_input.SKRootDefinition.request.jobadd_input. as listed in the following table.SKRootDefinition.request.Add form controls.SKRootDefinition.rework SKFormData.jobadd_input.request. jobadd _input.start_qty SKFormData.jobadd_input.SKRootDefinition.request. item_id XMLVariables.SKRootDefinition.request. req_finish_time_local XMLVariables. est_prod_rate SKFormData. req_qty XMLVariables.request.wo_id SKFormData. jobadd _input.request.Add workflow variables to the Job.request.request.req_qty SKFormData.request. Guide to Using ArchestrA Workflow with Wonderware MES .jobadd_input.SKRootDefinition.SKRootDefinition.SKRootDefinition. seq_no XMLVariables.SKRootDefinition. target_sched_ent_id XMLVariables.jobadd_input.SKRootDefinition. start_qty XMLVariables. wo_id XMLVariables. oper_id XMLVariables.RequiredFinish DateTime Local* SKFormData.request.80  Chapter 6 Verifying Localization of Datatypes Linking the Workflow Variables to Form Controls Perform the procedure in "Linking the Workflow Variables to Form Controls" on page 26 to link the Job. rework XMLVariables.jobadd_input. Publishing the Form Perform the procedure in "Publishing the Form" on page 31 to publish the Job.Add form.jobadd_input.seq_no Variables.jobadd_input.spare1 SKFormData.SKRootDefinition.SKRootDefinition.

and Japanese that could be entered in the form. Russian. are listed in the following tables.12345 Wo1 新的操作 12345 10/26/2012 15:16:17 15 15 1234567890123.12345 1234567890123.12 0 测试工作流程 测试工作流程 QA-Case24 1234567890123. Sample Test Data and Expected Results Sample test data for Chinese. Chinese Column Name Database Data Type Data Input Data Expected in MES Database Wo_ID Oper_Id Seq_No Req_Finish_Time_Local Init_Sched_Ent_Id Target_Sched_Ent_Id Qty_Reqd Qty_At_Start Rework Spare1 Last_Edit_Comment Item Est_Prod_Rate String80 String80 Int32 TDatetime Int32 Int32 TFloat TFloat Logical String80 String254 String80 TFloat Wo1 新的操作 12345 10/26/2012 15:16:17 15 15 1234567890123. and the expected results in the MES database.12 Russian Column Name Database Data Type Data Input Data Expected in MES Database Wo_ID Oper_Id Seq_No Req_Finish_Time_Local Init_Sched_Ent_Id String80 String80 Int32 TDatetime Int32 Wo1 Новой операции 12345 10/26/2012 15:16:17 15 Wo1 Новой операции 12345 10/26/2012 15:16:17 15 Guide to Using ArchestrA Workflow with Wonderware MES .Add workflow.Adding a Job—Oracle Database81 Testing the Workflow Perform the procedure in "Testing the Workflow" on page 32 to test the Job.12 1234567890123.12345 No (False) 测试工作流程 测试工作流程 QA-Case24 1234567890123.

12 0 Проверка рабочего процесса Проверка рабочего процесса QA-Case24 1234567890123.12345 1234567890123.12 0 テストのワークフロー テストのワークフロー QA-Case24 1234567890123.12 1234567890123.82  Chapter 6 Verifying Localization of Datatypes Column Name Database Data Type Data Input Data Expected in MES Database Target_Sched_Ent_Id Qty_Reqd Qty_At_Start Rework Spare1 Last_Edit_Comment Item Est_Prod_Rate Int32 TFloat TFloat Logical String80 String254 String80 TFloat 15 1234567890123.12 1234567890123.12 Japanese Column Name Database Data Type Data Input Data Expected in MES Database Wo_ID Oper_Id Seq_No Req_Finish_Time_Local Init_Sched_Ent_Id Target_Sched_Ent_Id Qty_Reqd Qty_At_Start Rework Spare1 Last_Edit_Comment Item Est_Prod_Rate String80 String80 Int32 TDatetime Int32 Int32 TFloat TFloat Logical String80 String254 String80 TFloat Wo1 新しい動作 12345 10/26/2012 15:16:17 15 15 1234567890123.12345 Wo1 新しい動作 12345 10/26/2012 15:16:17 15 15 1234567890123.12345 No (False) Проверка рабочего процесса Проверка рабочего процесса QA-Case24 1234567890123.12345 15 1234567890123.12345 No (False) テストのワークフロー テストのワークフロー QA-Case24 1234567890123.12 Guide to Using ArchestrA Workflow with Wonderware MES .12345 1234567890123.

JobExec.AddProd. • Specify the following controls for the form: Control Type Number DateInput Tag Name Session ID Event Time Mapped XML Node session_id event_time Mandatory Y N Other Parameters Date Format: MM/dd/yyyy Time Format: HH:mm:ss TextInput or Lookup Number or Lookup Number Number TextInput User Name Entity ID Qty Produced Reason Code Lot No user_id ent_id qty_prod reas_cd lot_no Y Y Y N N Minimum: 0 Minimum: 0 Minimum: 0 Guide to Using ArchestrA Workflow with Wonderware MES . with exceptions as noted in the following topics.AddProd • For the Generate Input XML Variable. use addprod_output Creating an ArchestrA Workflow Software Form Perform the procedure in "Creating an ArchestrA Workflow Software Form" on page 18. Creating the Workflow Perform the procedure in "Creating the Workflow" on page 14. • In the Generate Command window: • For the stateless API. use Prod. use JobExec.Adding Production to a Job83 Adding Production to a Job This test procedure calls the Prod. use addprod_input • For the Generate Output XML Variable.AddProd stateless API method to verify that strings of different DateTime formats can be passed correctly from the MES .AddProd. with the following exceptions: • For the workflow title. use JobExec.JobExec. with the following exceptions: • For the form title.Workflow Connector and be recorded in the MES database. The process for creating the Add Production to a Job test procedure is the same as that described in "Adding a Job" on page 13.

AddProd form controls. To address the DateTime issue for this input.AddProd workflow variables to the JobExec.ToLocalTime() Linking the Workflow Variables to Form Controls Perform the procedure in "Linking the Workflow Variables to Form Controls" on page 26 to link the JobExec. Guide to Using ArchestrA Workflow with Wonderware MES .84  Chapter 6 Verifying Localization of Datatypes Control Type TextInput Number or Lookup TextInput or Lookup Number TextInput TextInput Number Tag Name Sublot No Storage Entity ID Produced Item BOM Position Segment Requirement ID Seqment Response ID Job Position Mapped XML Node sublot_no to_ent_id item_id bom_pos seg_req_id seg_res_id job_pos Mandatory N N N N N N N Other Parameters Minimum: 0 Minimum: 0 Binding the Form to the Workflow Perform the procedure in "Binding the Form to the Workflow" on page 21 to bind the JobExec.SFFormData.InvariantCulture) .SKRootDefinition.Globalization. This test procedure includes an Event Time input in the workflow form. Adding a Variable for the DateTime Input Because of a difference in how ArchestrA Workflow Software and MES stateless API methods treat DateTime inputs. System. you must create a DateTime variable to convert any DateTime input values from the workflow form from UTC time to local time.ToDateTime (XmlVariables.AddProd form to the JobExec. as listed in the following table.CultureInfo. perform the procedure in "Adding a Variable for the DateTime Input" on page 23 to add the following variable: • The variable Event DateTime Local of type date and with the expression: Convert. refer to "DateTime" on page 101. For additional information about this issue.event_time.AddProd workflow.

user_id XMLVariables. ent_id XMLVariables.addprod_input.Adding Production to a Job85 Variables Form Control Name XMLVariables.request.job_pos *DateTime is set to a workflow variable created to ensure that it is sent as localtime to the MES database. qty_prod XMLVariables.SKRootDefinition.ent_id SKFormData. lot_no XMLVariables.SKRootDefinition.SKRootDefinition. reas_cd XMLVariables.SKRootDefinition. seg_req_id XMLVariables.reas_cd SKFormData. bom_pos XMLVariables.bom_pos SKFormData.add_prod_input.SKRootDefinition.request.Event DateTime Local* SKFormData. event_time_local XMLVariables.SKRootDefinition. job_pos SKFormData. item_id XMLVariables. seg_res_id XMLVariables.SKRootDefinition.request.item_id SKFormData.SKRootDefinition.SKRootDefinition.storage_ent_id SKFormData. storage_ent_id XMLVariables.seg_res_id SKFormData.addprod_input.request.addprod_input.addprod_input.addprod_input.sublot_no SKFormData.request.addprod_input.request. sublot_no XMLVariables.request.addprod_input.SKRootDefinition.request.request.request.addprod_input.user_id SKFormData.lot_no SKFormData.session_id Variables.addprod_input.SKRootDefinition.addprod_input.request.request.SKRootDefinition.SKRootDefinition.addprod_input.qty_prod SKFormData.seg_req_id SKFormData.addprod_input. session_id XMLVariables.request.request.addprod_input. Guide to Using ArchestrA Workflow with Wonderware MES .

are listed in the following tables. Testing the Workflow Perform the procedure in "Testing the Workflow" on page 32 to test the JobExec.86  Chapter 6 Verifying Localization of Datatypes Publishing the Form Perform the procedure in "Publishing the Form" on page 31 to publish the JobExec.AddProd form. Sample Test Data and Expected Results Sample test data that could be entered in the form for various DateTime formats. DateTime Format 1 • Date Format: MM/dd/yyyy • Time Format HH:mm:ss Column Name Database Data Type Data Input Data Expected in MES Database Session Id Event Time User Id Ent Id Qty Prod Reason Code Lot No Sublot No Storage Ent Id Produced Item Bom Position Segment Requirement ID Segment Response ID Job Position Int32 datetime String 80 Int32 Double Int32 String80 String80 Int32 String80 Int32 Null Null Int32 114 11/08/2012 5:00:00 ww 4 4 1 1 Null 4 Item-A Null Null Null 0 114 11/08/2012 5:00:00 ww 4 4 1 1 Null 4 Item-A Null 0 Guide to Using ArchestrA Workflow with Wonderware MES . and the expected results in the MES database.AddProd workflow.

Adding Production to a Job87 DateTime Format 2 • Date Format: yyyy-MM-dd • Time Format hh:mm:ss tt Column Name Database Data Type Data Input Data Expected in MES Database Session Id Event Time User Id Ent Id Qty Prod Reason Code Lot No Sublot No Storage Ent Id Produced Item Bom Position Segment Requirement ID Segment Response ID Job Position Int32 datetime String 80 Int32 Double Int32 String80 String80 Int32 String80 Int32 Null Null Int32 114 2012-11-08 5:00:00 AM ww 4 4 1 1 Null 4 Item-A Null Null Null 0 114 11/08/2012 5:00:00 ww 4 4 1 1 Null 4 Item-A Null 0 DateTime Format 3 • Date Format: dd-mm-yyyy • Time Format hh:mm:ss tt Column Name Database Data Type Data Input Data Expected in MES Database Session Id Event Time User Id Ent Id Qty Prod Reason Code Lot No Int32 datetime String 80 Int32 Double Int32 String80 114 08-11-2012 5:00:00 PM ww 4 4 1 1 114 11/08/2012 17:00:00 ww 4 4 1 1 Guide to Using ArchestrA Workflow with Wonderware MES .

yyyy • Time Format hh:mm:ss tt Column Name Database Data Type Data Input Data Expected in MES Database Session Id Event Time User Id Ent Id Qty Prod Reason Code Lot No Sublot No Storage Ent Id Produced Item Bom Position Segment Requirement ID Segment Response ID Job Position Int32 datetime String 80 Int32 Double Int32 String80 String80 Int32 String80 Int32 Null Null Int32 114 08.Nov.88  Chapter 6 Verifying Localization of Datatypes Column Name Database Data Type Data Input Data Expected in MES Database Sublot No Storage Ent Id Produced Item Bom Position Segment Requirement ID Segment Response ID Job Position String80 Int32 String80 Int32 Null Null Int32 Null 4 Item-A Null Null Null 0 Null 4 Item-A Null 0 DateTime Format 4 • Date Format: dd.MMM.2012 5:00:00 PM ww 4 4 1 1 Null 4 Item-A Null Null Null 0 114 11/08/2012 17:00:00 ww 4 4 1 1 Null 4 Item-A Null 0 Guide to Using ArchestrA Workflow with Wonderware MES .

Add.CreateWoFromProcess.ItemClass.JobExec. which creates a work order from a process Note: Other stateless API methods can also be used to verify this functionality.Workflow Connector to verify that the data of an MES activity is being correctly passed to an ArchestrA Workflow Software workflow: • Prod.89 Chapter 7 Verifying Data Passing from Wonderware MES to an ArchestrA Workflow The following stateless API methods can be used from the MES . which adds an item class • Prod. Guide to Using ArchestrA Workflow with Wonderware MES .

Add stateless API method to verify that the data of an MES activity is correctly passed to the MES Workflow. 3 4 In the list.Add. click Prod. To create the MES event 1 2 Open MES Workflow Event Creator. In the box at the upper left.ItemClass. Click the Process button. enter Prod.Add event for this test procedure. Guide to Using ArchestrA Workflow with Wonderware MES .ItemClass.90  Chapter 7 Verifying Data Passing from Wonderware MES to an ArchestrA Workflow Adding an Item Class This test procedure calls the Prod. A list of stateless APIs that match the entry appears.ItemClass. Creating the MES Event You have to create a Prod. The parameter grid appears.ItemClass.

and indicating that the MES Middleware services need to be restarted. A message appears that confirms the successful provisioning of the event. Click OK to close the message. Click OK to close the message. click Workflows. select item_class_id. log in to the ArchestrA Workflow Software’s Enterprise Console as an MES user. Click the Provision Post Hook button.Adding an Item Class91 5 In the parameter grid lists. Guide to Using ArchestrA Workflow with Wonderware MES . then item_class_desc. On the Enterprise Console menu. 6 Click the Provision events in all connected Workflow Repositories button. 7 8 9 10 Close the MES Workflow Event Creator window and restart the Creating the Workflow To create a workflow for the Add an Item Class test procedure 1 2 From Internet Explorer. and then produced. The Workflows window appears. A message appears that confirms the successful provisioning of the event. MES Middleware Host and MES Service.

92  Chapter 7 Verifying Data Passing from Wonderware MES to an ArchestrA Workflow 3 On the Ribbon. Click Next and then click Save & Continue. Type item_class. ItemClass. Select the MES Middleware connection (e. 4 Complete the fields and options in the window as follows: Description Field/Option Title Description Unique Environment Name MES Middleware Machine Name Event Name Pre/Post Hook Object Name 5 The workflow title (e. The Workflow Options window appears.Add Select Post Hook.Add). mes40).. Guide to Using ArchestrA Workflow with Wonderware MES . A description of the workflow. Select the event that was created.g.g. MESDB_MES). A New MES Workflow window appears.g.. click the MES workflow icon. The option on the workflow tasks defaults to Design the workflow now. Prod..ItemClass. Select the environment name (e.

A workflow window appears. In the Activities list. Click and drag the Information activity onto the window to the right of the Start activity. click Human Activities. 10 Right-click the Information1 activity and click Activity Properties. Guide to Using ArchestrA Workflow with Wonderware MES . 9 On the tool bar. It includes a Start activity by default. click the Link icon and create a link from the Start activity to the Information1 activity.Adding an Item Class93 6 7 8 Click Finish.

12 Click the User option. type an MES user and select user_name. click the Assign Actor(s) box button. The Assign Actor(s) window appears.user_id in the list.94  Chapter 7 Verifying Data Passing from Wonderware MES to an ArchestrA Workflow 11 In the Actors section of the Activity Properties pane. 15 Click Search. 14 In the search box. Guide to Using ArchestrA Workflow with Wonderware MES . 13 In the list at the upper right. The user appears in the Available Resources box. The User Lookup window appears. select MES Users.

18 Click Update to save the assigned actor and close the Assign Actor(s) window. select XML Variables. type New Item Class Created and press ENTER. 21 In the first field list. 17 Click Update. Guide to Using ArchestrA Workflow with Wonderware MES . The Subject window appears. 20 In the main box. The user appears in the Assign Actor(s) window. select MESEventData.Adding an Item Class95 16 Select the user and click the right arrow button to add the user to the Selected Resources box. click the Subject box button. 22 In the second field list. 19 In the Notification Contents section of the Activity Properties pane.

A tree of available XML variables appears. 25 Press ENTER to create a new line and then click the Append button. 26 Use the same procedure to add the following variables to the main box: • item_class_desc • produced 27 In the second field list. The variable is added to the main box. The tree closes and the variable is entered in the third list. Guide to Using ArchestrA Workflow with Wonderware MES . 24 Click the item_class_id variable.96  Chapter 7 Verifying Data Passing from Wonderware MES to an ArchestrA Workflow 23 Click the third list’s button. select MESSPHookXmlData.

Select the Produced check box. 32 Click Close to close the message. click Dashboard. 30 At the bottom of the Activity Properties pane. Verifying the Data To verify the data 1 2 From Internet Explorer. and produced variables from the MESSPHookXmlData tree. A message appears indicating the status of the publish operation. On the Enterprise Console menu. 29 Click the Update button. Click Item Classes. just as you did for the three MESEventData variables. The Dashboard window appears. 31 In the Workflows window. Starting the Workflow To start the workflow 1 2 3 4 5 6 7 Log in to MES Client. right-click the ItemClass. Save the new item class.Add workflow and click Publish. Guide to Using ArchestrA Workflow with Wonderware MES . item_class_description. log in to the ArchestrA Workflow Software’s Enterprise Console as an MES user. The Subject window closes. Click Production Definition. click Save and close the workflow window.Adding an Item Class97 28 Select and append the item_class_id. An new item class row appears in the grid. Type the item class ID and description. Right-click the Item Class grid and click New.

Creating the MES Event Perform the procedure in "Creating the MES Event" on page 90. Guide to Using ArchestrA Workflow with Wonderware MES .JobExec. then release_time. and produced value for the values being sent into the Post Hook.JobExec. They should agree with the values entered in MES Client when creating the item class. item_class_desc. select wo_id. with the following exceptions: • In MES Workflow Event Creator. item_class_desc. and then req_finish_time.CreateWoFromProcess stateless API method to verify that data with dates correctly passed from the MES Middleware to the MES .98  Chapter 7 Verifying Data Passing from Wonderware MES to an ArchestrA Workflow 3 Open the inbox information for the MES workflow you created with a Subject of “New Item Class Created”. The data in the body of the email should show the item_class_id. with exceptions as noted in the following topics. The process for creating the Create a Work Order from a Process test procedure is similar to that described in "Adding an Item Class" on page 90. select Prod. Database Data Type Data Expected in MESEventData and MESSPHookData Column Name Data Input ItemClass Id Item Class Desc Produced String80 String80 Logical TestItemClass Test Item Class True TestItemClass Test Item Class True Creating a Work Order from a Process This test procedure calls the Prod.CreateWoFromProcess as the stateless API for the event. • In the parameter grid lists.Workflow Connector. and produced value for the values coming into the event. and the item_class_id. Sample Test Data and Expected Results Sample test data and the expected results in MESEventData and MESSPHookData are listed in the following table.

append the following XML variables: • MESEventData: request.CreateWoFromProcess.Creating a Work Order from a Process99 Creating the Workflow Perform the procedure in "Creating the Workflow" on page 91.req_finish_time • MESSPHookData: request. type New • In the Subject window main box. Select the environment name (e. JobExec.g. Select the event that was created. mes40).release_time • MESSHookData: request. A description of the workflow. The workflow title (e.g. • In the Subject window.wo_id • MESEventData: request. Type job_exec.release_time • MESEventData: request. with the following exceptions: • Complete the fields and options in the New MES Workflow window as follows: Field/Option Description Title Description Unique Environment Name MES Middleware Machine Name Event Name Pre/Post Hook Object Name WO Created. Click Process Extension.req_finish_time Starting the Workflow To start the workflow 1 2 3 4 5 Log in to MES Client.wo_id • MESSPHookeData: request.. Click Production Definition... Click Apply Filters. Right-click one of the processes and click Create Work Order. Select the MES Middleware connection (e. Prod. MESDB_MES). JobExec.CWFP). Select Post Hook.g. in the first line of the main box. Guide to Using ArchestrA Workflow with Wonderware MES .

Click OK. They should agree with the values entered in MES Client when creating the work order from the process. Open the inbox information for the MES workflow you created with a Subject of “New WO Created”. the required quantity. Database Data Type Data Expected in MESEventData and MESSPHookData Column Name Data Input Work Order Id Release Time Local Required Finish Time Local String 80 DateTime DateTIme TestWO 11/01/2012 04:00:00 11/16/2012 14:00:00 TestWO 11/01/2012 04:00:00 11/16/2012 14:00:00 Guide to Using ArchestrA Workflow with Wonderware MES . the start quantity. release_time. On the Enterprise Console menu. Sample Test Data and Expected Results Sample test data and the expected results in MESEventData and MESSPHookData are listed in the following table.100  Chapter 7 Verifying Data Passing from Wonderware MES to an ArchestrA Workflow 6 7 Enter the wo_id. The Dashboard window appears. release_time. click Dashboard. and the due date/time. and wo_id. the release date/time. The data in the body of the email should show the wo_id. and req_finish_time value for the values coming into the event. and req_finish_time value for the values being sent into the Post Hook. Verifying the Data To verify the data 1 2 3 From Internet Explorer. log in to the ArchestrA Workflow Software’s Enterprise Console as an MES user.

certain issues can occur. if 6a PDT is entered in the workflow form. DateTime By default. • Convert the input value from the workflow form for each time DateTime variable from UTC time to local time. it is converted to UTC time and passed as 1p to the MES stateless API method. This situation can cause incorrect times to be stored in the MES database. To avoid this issue. This resolution is demonstrated in the example procedures in this document. Guide to Using ArchestrA Workflow with Wonderware MES . These issues and their resolutions are addressed here.101 Appendix A Potential Issues and Resolutions When executing the test procedures. ArchestrA Workflow Software converts any time inputs in a workflow form to UTC time. The time is then incorrectly recorded in the MES database as 1p local time and 8p UTC time. you must: • Create a DateTime variable in the Start activity for each DateTime variable in the MES XML. However. For example. the MES stateless API methods assume that times are in local time. Following is a general description of the resolution. • Have the DateTime variables in MES receive values from these internal variables.

To create a DateTime variable for a Start activity 1 2 3 With the workflow opened. In the Workflow Variables box. as shown in the following example. Guide to Using ArchestrA Workflow with Wonderware MES . Next.102  Appendix A Potential Issues and Resolutions First. The Variables window appears. enter a name for the DateTime variable. include form controls for the DateTime variables in the Workflow form. The entries for these fields will be sent as parameters to the MES stateless API. right-click the Start activity and click Activity Properties. The Activity Properties pane appears. click the Variables box button. On the Activity Properties pane. create a DateTime variable for the Start activity.

DateTime103

4

In the Type list, click date.

5 6

Click Update to save the entries and close the window. In the Activity Properties pane, click the Initialize box button. The Update Variable window appears.

7 8

In the Condition column, hover the pointer over Select and click the list box that appears. A navigation tree appears. Expand the Variables branch.

9

Click the entry for the DateTime variable you just created. A row for the DateTime variable is added to the table in the Update Variable window.

Guide to Using ArchestrA Workflow with Wonderware MES

104  Appendix A Potential Issues and Resolutions

10 Click the Tree icon under the Actions column. A list box appears in

the Value column.
11 Click the list box button. A navigation tree appears. 12 Click the Build Expression link. The Variable Editor window

appears.
13 In the navigation tree, expand the Workflow Instance,

XmlVariables, SFFormData, and SKRootDefinition branches.
14 Click and drag the corresponding XML variable entry to the Editor

pane. The XML variables object is added to the Editor pane.
15 Complete the entry in the Editor pane so that the full entry is

similar to the following example:

16 Click OK and then click Close to close the Variable Editor window.

The completed DateTime variable definition appears in the Update Variable window.
17 Click the OK to close the Update Variable window. 18 Click the Save button at the bottom of the Activity Properties

pane to save the DateTime variable.

Guide to Using ArchestrA Workflow with Wonderware MES

Regional Settings105

Finally, make sure that you link the DateTime variables to their workflow form controls. The following sample Update Variable window shows two DateTime variables mapped to their workflow form controls.

Regional Settings
When the MES Client and Middleware are in different time zones, the DateTimes do not work correctly between the two zones unless the workaround described in "DateTime" on page 101 is implemented on all the DateTime variables in the workflow forms.

Asynchronous Methods in the MES Stateless API Libraries
The Async methods (e.g., AddProdAsync, StartJobAsync, etc.) exposed in the stateless API libraries are not listed in MES - Workflow Connector. Therefore, a workflow cannot use the Async methods to initiate MES transactions.

MES Quality Modules
MES - Workflow Connector does not list the MES quality modules. Therefore, workflows are not tested against the MES quality module.

Guide to Using ArchestrA Workflow with Wonderware MES

Therefore.StartJob. these methods are not tested from MES .MoveInventory method.JobExec.. etc. There was no indication given in the executing or waiting events in Workflow. MES . such as with JobExec. attempting to start a job took awhile. ExtendedAttribute [ ] extendedAttrs in Prod. Intermittent Failures on Reporting Status When testing maximum amounts.StorageExec.g.AddPEMData.Workflow Connector ignores the methods that contain class arrays. on a slow system. When the bandwidth for the VPN caused it to run slowly.106  Appendix A Potential Issues and Resolutions Class Arrays in the List of Parameters When the stateless API methods contain class arrays (e.). but a Completed message was never received in workflow.Workflow Connector. InvTransferSource[ ] sourceList in EnProd. It was later found using MES Client that the job was started. there is no indication given in Workflow after MESXMLCommand is finished. Guide to Using ArchestrA Workflow with Wonderware MES . those methods are not exposed/accessible in MES .Workflow Connector.

testing localization of 73 Guide to Using ArchestrA Workflow with Wonderware MES . 64. 90 C class arrays 106 creating a work order 42. 98 J job adding 13. publishing 30 workflow. configuring 12 workflow.107 Index A adding a job 13. 68 D datatypes. 58. 83 setting lot information for 55 starting 46. linking to workflow variables 26 forms binding to workflow 21 creating 18 publishing 31 I item class. binding to workflow 21 form. 77 adding production to 49. 90 adding production to a job 49. creating 18 form. configuring 12 asynchronous methods 105 attribute. adding 35 DateTimes testing with different regional settings 63 UTC/local time issue 101 document conventions 10 E event types. 77 adding an attribute 35 adding an item class 40. 73. publishing 31 linking variables to form controls 26 logging in 12 users. adding 40. 73. testing 32 ArchestrA Workflow Repository database. 83 ArchestrA Workflow form. testing 55 F form controls.

initial 12 Start activity. 58. configuring 12 testing complex event types 55 data from MES to Workflow 89 data of various types and amounts 39 datatype compatibility 13 DateTimes with different regional settings 63 localization of datatypes 73 U UTC/local time issue with DateTime inputs 101 P prerequisites for performing tests 11 V variables adding to Start activity 23 linking to form controls 26 R regional settings 105 testing 63 reporting status failures 106 W work order.Workflow Connector. adding a variable to 23 starting a job 46. setting for a job 55 M MES . 64. creating 42. configuring 12 MES quality modules 105 MES users. 98 workarounds to test procedure issues 101 workflows creating 14 linking variables to form controls 26 publishing 30 testing 32 S setup. testing 73 lot information. 68 T technical support 10 Guide to Using ArchestrA Workflow with Wonderware MES .108Index L local time/UTC issue with DateTime inputs 101 localization of datatypes.

You're Reading a Free Preview

Download
scribd
/*********** DO NOT ALTER ANYTHING BELOW THIS LINE ! ************/ var s_code=s.t();if(s_code)document.write(s_code)//-->