Tech Note 593 Converting InBatch Tags to AppServer Objects All Tech Notes, Tech Alerts and KBCD documents and software are provided "as is" without warranty of any kind. See the Terms of Use for more information. Topic#: 002349 Created: April 2009 Introduction This Tech Note describes the steps for converting InBatch tags to AppServer Objects using the ArchestrA Bulk Import Utility. Use this procedure when InBatch/InTouch tags must be translated to AppServer Objects. This procedure avoids building objects manually in AppServer, which may take lot of time, depending upon how many units/phases etc. you've configured in InBatch. Application Versions: InBatch 9.0 Wonderware Application Server 3.1 ArchestrA Bulk Import Utility 1.0 Prerequistes InBatch tags from InBatch Demo Application were utilized for conversion. IDE, Galaxy Repository and ArchestrA Bulk Import Utility installed on Node A. InBatch Server installed on Node B. Procedure 1. From the InBatch Environment Display, export InBatch Tags from TagLinker using File/Export Tags as CSV file. 2. Open the CSV file in Excel and update the file as shown in Figure1 (below) and save it as CSV file. 3. Make the following modifications to this file: Tagnames* column containing.value fields are replaced with blanks. For example, SSM1.Mix.Time.Act.Value is replaced with SSM1.Mix.Time.Act. Under DataAccess* column readonly changed to input and readwrite to inputoutput. This file contains only three columns. The other columns such as Item, Access, Export, Link Type are not required, because the objects attributes in AppServer are memory and not linked to Input Output Extensions. https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 1/24
FIGURE 1: MODIFIED CSV FILE COLUMN VALUES 4. Create a new galaxy called BatchObjects in the IDE. Your Galaxy name can be anything that meets your requirements and the Galaxy naming convention. 5. Open the ArchestrA Bulk Import Utility by clicking Start/Programs/Wonderware/ArchestrA Bulk Import Utility (Figure 2 below). 6. Click Create a new project in the right-hand Getting Started panel. https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 2/24
FIGURE 2: ARCHESTRA BULK IMPORT UTILITY 7. The UI display appears (Figure 3 below). https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 3/24
FIGURE 3: NEW PROJECT 8. Click Run Import Wizard and browse to the CSV file you modified. The Tag Import Wizard appears (Figure 4 below): https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 4/24
FIGURE 4: TAG IMPORT WIZARD - STEP 1: SELECT MAPPING 9. Click Next. the Step 2 Wizard appears (Figure 5 below). https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 5/24
FIGURE 5: STEP 2: SELECT HEADER 10. Click Heading > TagName as shown in Figure 5, then click Next. The Step 3: Drag Attributes to Headings Wizard appears (Figure 6 below). https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 6/24
FIGURE 6: STEP 3: DRAG ATTRIBUTES TO HEADINGS 11. Drag-drop the following attributes to the Column headings: Name > TagName* DataType > DataClass* AccessMode > DataAccess*. The drag-drop results are shown in Figure 7 (below). https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 7/24
FIGURE 7: DRAG-DROP ARCHESTRA ATTRIBUTES TO COLUMN HEADINGS 12. Click Next. The Step 4: Assign Data Types wizard appears (Figure 8 below). https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 8/24
FIGURE 8: STEP 4: ASSIGN DATA TYPES 13. Change the following ArchestrA data types using the drop-down list for each data type. String > MxString Discrete > MxBoolean Enumeration > MxString Analog > MxDouble Note that the Enumeration data type is defined as MxString under ArchestrA data type. There is no appropriate selection for Enumeration. This has to be corrected in AppServer, once the objects are constructed. Figure 9 (below) shows the updated ArchestrA data types. https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 9/24
FIGURE 9: UPDATED DATA TYPES 14. Click Next. The Tag Import Wizard Final Step appears (Figure 10 below). https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 10/24
FIGURE 10: FINAL STEP 15. Click Finish to save the mapping. 16. Click Filter and Organize Data in the right panel of the Bulk Import Utility. Figure 11 (below) shows the window. https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 11/24
FIGURE 11: FILTER AND ORGANIZE DATA 17. Change the Delimiter value to a period (. ). and click the Left to Right option. Figure 12 (below) shows the configuration changes. 18. Click Apply. https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 12/24
FIGURE 12: SELECTION CRITERIA CHANGES The Selection Criteria panel appears (Figure 13 below). https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 13/24
FIGURE 13: APPLY SELECTION CRITERIA 19. Click the Define Object button. Figure 14 (below) shows the Object Definitions. https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 14/24
FIGURE 14: OBJECT DEFINITION 20. Click Close. Click Connect to Galaxy (Figure 15 below) and connect to the BatchObjects Galaxy you created in a previous step. https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 15/24
FIGURE 15: CONNECT TO GALAXY 21. After you connect, click Download Templates. The Download Templates window appears (Figure 16 below). 22. Click the User Defined Objects item, then click Download. FIGURE 16: DOWNLOAD TEMPLATES WINDOW Figure 17 (below) shows the Data and Objects panels that appear. https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 16/24
FIGURE 17: OBJECTS PANEL 23. Drag-drop the $NewTemplate object to the $UserDefined item in the Objects panel (Figure 17 above). Figure 18 (below) shows the window after moving the $NewTemplate to $UserDefined. 24. Click Upload Objects (Figure 18 below). https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 17/24
FIGURE 18: UPLOAD OBJECTS The Upload Objects window appears (Figure 19 below). https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 18/24
FIGURE 19: UPLOAD OBJECTS WINDOW 25. Click the User Defined Objects item as shown in Figure 19 (above). All child items are checked (Figure 20 below). https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 19/24
FIGURE 20: CHILD OBJECTS CHECKED FOR DOWNLOAD 26. Click Validate, then Upload. https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 20/24
FIGURE 21: VALIDATE AND UPLOAD OBJECTS After the objects are uploaded, the Upload completed status message appears (Figure 22 below). FIGURE 22: UPLOAD TO GALAXY COMPLETED https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 21/24
Figure 23 (below) shows the objects uploaded to the Galaxy in Model View. FIGURE 23: CONVERTED OBJECTS UPLOADED TO THE GALAXY Figure 24 (below) shows the UDAs Tab in the SSM1 Object Editor. https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 22/24
FIGURE 24: SSM1 UDAS IN OBJECT EDITOR Click the following icon to view this file in.pdf format: S. Mariyala Tech Notes are published occasionally by Wonderware Technical Support. Publisher: Invensys Systems, Inc., 26561 Rancho Parkway South, Lake Forest, CA 92630. There is also technical information on our software products at Wonderware Technical Support. For technical support questions, send an e-mail to support@wonderware.com. Back to top 2013 Invensys Systems, Inc. All rights reserved. No part of the material protected by this copyright may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying, recording, broadcasting, or by anyinformation storage and retrieval system, without permission in writing from Invensys Systems, Inc. Terms of Use. https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 23/24
https://wdnresource.wonderware.com/support/kbcd/html/1/t002349.htm 24/24