PI Interface for Universal File and Stream Loading …

PI Interface for Universal File and Stream Loading (UFL)

Version 3.3.12.x

OSIsoft, LLC 777 Davis St., Suite 250 San Leandro, CA 94577 USA Tel: (01) 510-297-5800 Fax: (01) 510-357-8136 Web:

OSIsoft Australia ? Perth, Australia OSIsoft Europe GmbH ? Frankfurt, Germany OSIsoft Asia Pte Ltd. ? Singapore OSIsoft Canada ULC ? Montreal & Calgary, Canada OSIsoft, LLC Representative Office ? Shanghai, People's Republic of China OSIsoft Japan KK ? Tokyo, Japan OSIsoft Mexico S. De R.L. De C.V. ? Mexico City, Mexico OSIsoft do Brasil Sistemas Ltda. ? Sao Paulo, Brazil

PI Interface for Universal File and Stream Loading (UFL) Copyright: ? 2013 OSIsoft, LLC. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, mechanical, photocopying, recording, or otherwise, without the prior written permission of OSIsoft, LLC.

OSIsoft, the OSIsoft logo and logotype, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, PI Asset Framework(PI-AF), IT Monitor, MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI BatchView, PI Data Services, PI Manual Logger, PI ProfileView, PI WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports and RtWebParts are all trademarks of OSIsoft, LLC. All other trademarks or trade names used herein are the property of their respective owners.

U.S. GOVERNMENT RIGHTS Use, duplication or disclosure by the U.S. Government is subject to restrictions set forth in the OSIsoft, LLC license agreement and as provided in DFARS 227.7202, DFARS 252.227-7013, FAR 12.212, FAR 52.227, as applicable. OSIsoft, LLC.

Published: 03/2013

Table of Contents

Chapter 1.

Introduction ............................................................................................................1 Related Manuals ......................................................................................................2

Chapter 2.

How UFL Works .....................................................................................................3

Interface Logic .........................................................................................................3 How Data is Processed ...........................................................................................3 How Data Sources are Handled ..............................................................................4 Logging ....................................................................................................................5

Chapter 3.

Installing the UFL Interface...................................................................................6

Prerequisites ............................................................................................................6 Upgrading From Pre-3.x Versions ...........................................................................6 Detailed Installation Procedure................................................................................8

Chapter 4.

Configuring Diagnostics .....................................................................................11

Health Monitoring Points........................................................................................11 I/O Rate Point ........................................................................................................13 Interface Status Point ............................................................................................13 Scan Class Performance Points ............................................................................14 Performance Counter Points .................................................................................15

Chapter 5.

Loading Data into PI ............................................................................................17

Defining the Configuration File ..............................................................................17 Performing Calculations Using Fields....................................................................33 Storing Data in PI Tags..........................................................................................36 Parsing Standard File Types .................................................................................37

Chapter 6. Configuring UFL Using UFLDesigner ................................................................42

Appendix A. Platform Details and Features ............................................................................44

Supported Features ...............................................................................................44 Platform .................................................................................................................. 46

Appendix B. Installation and Configuration Checklist...........................................................47

Appendix C. Command Line Parameters ................................................................................49

Appendix D. UFL Examples ......................................................................................................51

Calculation Examples ............................................................................................51 Action Examples ....................................................................................................57

PI Interface for Universal File and Stream Loading (UFL)

iii

Table of Contents Appendix E. Migrating from the Batch File Loader Interface ................................................61 Appendix F. Glossary................................................................................................................64 Appendix G. Technical Support and Resources.....................................................................65

iv

Chapter 1. Introduction

OSIsoft's Universal File and Stream Loading Interface (PI UFL interface) reads data from ASCII data sources and writes data to PI. The PI UFL interface can read text from ASCII files, a serial port, or a POP3 email server, parse and transform the incoming data, and update PI points. To specify how the incoming data is handled, you create a configuration (INI) file, which defines how data is filtered, parsed, manipulated and written to PI. The PI UFL interface is intended to replace the PI Batch File interface. For details about migration, see Appendix E.

NOTE:

The PI UFL interface can process XML files, but for applications that are best addressed using the OPC XML-DA specification, use the PI Interface for OPC DA XML.

PI Interface for Universal File and Stream Loading (UFL)

1

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download