RFID Anywhere™ Location
 Information System Guide




                    June 2008

                   Version 3.5
Copyright and trademarks
Copyright © 2008 iAnywhere Solutions, Inc. Portions copyright © 2008 Sybase, Inc. All rights rese...
Contents

About this book ............................................................................................ v
 ...
iv
About this book
Subject
    This book describes RFID Anywhere's Location Information System (LIS). Using RFID Anywhere and...
About this book



RFID Anywhere documentation
     This book is part of the RFID Anywhere documentation set. This section...
Finding out more and providing feedback



Finding out more and providing feedback
Finding out more
     Additional inform...
viii
Part I. Getting Started with LIS
This part provides an introduction to LIS and its usage.
CHAPTER 1

Getting started with LIS

  Contents
  Introduction to LIS .......................................................
Getting started with LIS



Introduction to LIS
     This section provides a high-level introduction to Location Informati...
Introduction to LIS




LIS components and concepts
   This section outlines the various components and concepts that are ...
Getting started with LIS


Engines
     The engine management provides the mechanism for choosing which engines the LIS ne...
Introduction to LIS


Maps
   Maps can be imported from either a position engine or they can be created from scratch. When...
Getting started with LIS


     Both types of reports can have a refresh interval specified on the results screen that all...
Part II. Installing LIS
This part provides instructions for installing LIS.
CHAPTER 2

Installing LIS

  Contents
  Installation instructions for LIS ...................................................
Installing LIS



Installation instructions for LIS
     This section outlines how to install LIS. LIS is distributed as a...
Installation instructions for LIS


   h. Click OK to close the properties of the RFIDAnywhere virtual directory.
4. Log b...
Installing LIS



Installation instructions for the LIS Control Panel
prerequisites
     This section outlines how to inst...
Part III. Using LIS
This part contains detailed instructions for using LIS to enable context-aware location tracking appli...
CHAPTER 3

Using LIS

  Contents
  Using the LIS Control Panel ..............................................................
Using LIS



Using the LIS Control Panel
     This section describes how to use LIS to enable context-aware location track...
Using the LIS Control Panel




Admin page
   The LIS Control Panel Admin page lists all administrative and configuration ...
Using LIS


Area alerts
     Area alerts are used to generate alerts when a specific tag, or any tag belonging to a specif...
Using the LIS Control Panel


   To delete an existing DPP Router, highlight the specific DPP Router and click the Delete ...
Using LIS


     ● the position engine used to track the mobile device
     ● a flag indicating whether or not the mobile ...
Using the LIS Control Panel


    location of items. After configuring reports, an administrator can test the report to ve...
Using LIS


     To exit the Sensors configuration screen to return to the Admin page, click Close.
     When creating a s...
Using the LIS Control Panel


   New themes can be created using the New Theme icon in the Themes configuration title bar....
Using LIS



Accessing LIS through web services
     The Location Information System exports web services that can then be...
Accessing LIS through web services


  ● LIS.asmx Used for interacting with the features of LIS that interact with positio...
28
about, 4
Index                                                   accessing, 26
                                           ...
Index


     LIS, 12

W
Web Services Interface
  RTLS INCITS, 27
Web Services Interfaces
  LIS administraiton, 26
  LIS us...
RFID Anywhere™ Location Information System Guide
RFID Anywhere™ Location Information System Guide
RFID Anywhere™ Location Information System Guide
Upcoming SlideShare
Loading in...5
×

RFID Anywhere™ Location Information System Guide

1,423

Published on

Published in: Business, Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
1,423
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
9
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Transcript of "RFID Anywhere™ Location Information System Guide"

  1. 1. RFID Anywhere™ Location Information System Guide June 2008 Version 3.5
  2. 2. Copyright and trademarks Copyright © 2008 iAnywhere Solutions, Inc. Portions copyright © 2008 Sybase, Inc. All rights reserved. This documentation is provided AS IS, without warranty or liability of any kind (unless provided by a separate written agreement between you and iAnywhere). You may use, print, reproduce, and distribute this documentation (in whole or in part) subject to the following conditions: 1) you must retain this and all other proprietary notices, on all copies of the documentation or portions thereof, 2) you may not modify the documentation, 3) you may not do anything to indicate that you or anyone other than iAnywhere is the author or source of the documentation. iAnywhere®, Sybase®, and the marks listed at http://www.sybase.com/detail?id=1011207 are trademarks of Sybase, Inc. or its subsidiaries. ® indicates registration in the United States of America. All other company and product names mentioned may be trademarks of the respective companies with which they are associated.
  3. 3. Contents About this book ............................................................................................ v RFID Anywhere documentation ................................................................................ vi Finding out more and providing feedback .............................................................. vii I. Getting Started with LIS ............................................................................ 1 1. Getting started with LIS .......................................................................................... 3 Introduction to LIS .................................................................................................. 4 II. Installing LIS ............................................................................................. 9 2. Installing LIS .......................................................................................................... 11 Installation instructions for LIS ............................................................................. 12 Installation instructions for the LIS Control Panel prerequisites .......................... 14 III. Using LIS ................................................................................................ 15 3. Using LIS ................................................................................................................ 17 Using the LIS Control Panel ................................................................................ 18 Accessing LIS through web services ................................................................... 26 Index ............................................................................................................ 29 Copyright © 2008, iAnywhere Solutions, Inc. iii
  4. 4. iv
  5. 5. About this book Subject This book describes RFID Anywhere's Location Information System (LIS). Using RFID Anywhere and LIS, businesses can track assets from a range of data collection points (such as passive RFID, active RFID, real- time location systems (RTLS), barcode, global positioning systems (GPS) and environmental sensors), and can also dramatically enhance the value of this data by associating environmental inputs (for example, temperature) along with the location data. In addition, the RFID Anywhere Location Information System exposes its complete feature set via a rich service oriented architecture (SOA) web services layer, allowing organizations to easily transform static business information into business-aware intelligence. Audience This manual is for administrators of RFID Anywhere, and developers using LIS. Before you begin This manual assumes a familiarity with RFID Anywhere and its associated tasks, such as building business logic, provisioning connectors and product updates, and configuring RFID Anywhere components. Copyright © 2008, iAnywhere Solutions, Inc. v
  6. 6. About this book RFID Anywhere documentation This book is part of the RFID Anywhere documentation set. This section describes the materials in the documentation set and how you can use them. The RFID Anywhere documentation set The RFID Anywhere documentation set consists of the following components: ● RFID Anywhere Getting Started Guide This book describes RFID Anywhere, a platform for building RFID solutions. It provides instructions on installing and configuring RFID Anywhere, as well as tutorials that demonstrate how you can use RFID Anywhere to administer and test your RFID network. ● RFID Anywhere Developer's Guide This book introduces common development tasks often undertaken when working with RFID Anywhere. It describes the RFID Anywhere Visual Studio Extension for creating custom business modules, introduces commonly-used interfaces for hardware and component interaction, and outlines how to write Data Protocol Processors (DPPs). ● RFID Anywhere Enterprise Manager Guide This book describes RFID Anywhere Enterprise Manager, a standalone management tool providing dynamic, standards-based management for distributed RFID Anywhere networks. ● RFID Anywhere Mobile Support Guide This manual outlines RFID Anywhere's mobile device support and development model. ● RFID Anywhere Location Information System Guide This book describes RFID Anywhere's Location Information System (LIS). Using RFID Anywhere and LIS, businesses can not only track assets from a range of data collection points [such as passive RFID, active RFID, real-time location systems (RTLS), barcode, global positioning systems (GPS) and environmental sensors], but can dramatically enhance the value of this data by associating environmental inputs (e.g., temperature) along with the location data. In addition, the RFID Anywhere Location Information System exposes its complete feature set via a rich service oriented architecture (SOA) web services layer allowing organizations to easily transform static business information into business-aware intelligence. ● RFID Anywhere Label Designer Guide This book describes RFID Anywhere's printing capabilities and its Label Designer, a graphical tool used to design the layout of RFID and barcode labels. Visit http://www.ianywhere.com/developer/product_manuals/rfid_anywhere/index.html to obtain the latest version of the RFID Anywhere documentation. vi Copyright © 2008, iAnywhere Solutions, Inc.
  7. 7. Finding out more and providing feedback Finding out more and providing feedback Finding out more Additional information and resources, including the RFID Anywhere Developer Community, are available at http://www.sybase.com/products/rfidsoftware/rfidanywhere. Feedback We would like to receive your opinions, suggestions, and feedback on this documentation. You can email comments and suggestions to the RFID Anywhere documentation team at iasdoc@ianywhere.com. Although we do not reply to emails sent to this address, we read all suggestions with interest. Copyright © 2008, iAnywhere Solutions, Inc. vii
  8. 8. viii
  9. 9. Part I. Getting Started with LIS This part provides an introduction to LIS and its usage.
  10. 10. CHAPTER 1 Getting started with LIS Contents Introduction to LIS ......................................................................................................... 4 Copyright © 2008, iAnywhere Solutions, Inc. 3
  11. 11. Getting started with LIS Introduction to LIS This section provides a high-level introduction to Location Information System (LIS) and explains how it is used to create applications with context-aware location data that leverage a variety of technologies. For more information about the features and benefits of the entire RFID Anywhere infrastructure, see the online resources at http://www.sybase.com/RFID. LIS overview The ability to enhance location information with business context is desired in applications, including asset tracking, asset control, and resource management across vertical solutions in healthcare, logistics, cold-chain, and warehouse management environments. For example: ● A produce distributor can correlate the temperature of its goods, along with location and time data, to know exactly where and for how long a given item was exposed to certain environmental conditions such as temperature or humidity. This information allows these organizations to make real-time decisions regarding the distribution of the goods to reduce spoilage, thereby increasing profits. ● A hospital admission system can be enhanced to allow tracking of patients with contagious diseases and the ability to identify other patients and staff with whom the infected patients may have recently come in contact with. This would help a hospital prevent the transmission of the disease. ● A handheld inventory management system in a pharmaceutical distribution center can now not only determine how much inventory is on hand, but can also identify the physical location of the asset and determine which pharmaceuticals expire first. By having the handheld device provide the location element of the data, the system can incorporate location information while leveraging the existing barcode or passive RFID network, thereby reducing overall project costs. RFID Anywhere's (LIS) has been designed from the ground up to leverage RFID Anywhere's edge processing capabilities and broad device support to enable a new breed of context-aware location tracking applications. LIS offers the following capabilities: ● Integrates and combines a variety of sensor technologies to locate and track assets ● Calibrates locations and associates fixed data sources with coordinates to provide location data ● Stores, queries, and represents the location of assets graphically or via reports ● Service Oriented Architecture (SOA) allows information to be accessed by any application via web services ● Alerting capability enables information to be pushed when user-defined alert conditions are met 4 Copyright © 2008, iAnywhere Solutions, Inc.
  12. 12. Introduction to LIS LIS components and concepts This section outlines the various components and concepts that are useful to understand before using LIS. Sensor Selection Before processing data, you need to select the sources that you are interested in collecting data from. Begin by selecting the sensor types, such as MultiProtocol Controller, Barcode Controller, and so on, after which you can select the specific sensor corresponding to the selected type that you want to activate in the LIS. This allows the LIS to filter out only events coming from the chosen sensors. The sensor can correspond to either a specific connector or to a source of that connector, such as RfidMPSimulatorDefault or EPEConnector1. DPP Routing The DPP Routing functions involve selecting which DPPs are going to be used to process an incoming event. The routing can be defined by choosing a specific sensor or by choosing an event type: ● Sensor This allows data coming from a sensor to be processed by a specific DPP. ● Event Type This allows data belonging to the same event type to be processed by the selected DPP. RFID Anywhere provides two default DPPs: ● RTLS_DPP Provides basic decoding capabilities for events coming from the position engines. ● RA_DPP Provides encoding and decoding capabilities for EPC tags. Copyright © 2008, iAnywhere Solutions, Inc. 5
  13. 13. Getting started with LIS Engines The engine management provides the mechanism for choosing which engines the LIS needs to collect and process information from. It also gives you the capability to import elements and various settings specified in the external engine’s configuration. Importing from the engine allows the LIS to retrieve the elements, such as the maps, areas/zones, tags, devices, and so on. Once these elements have been imported, you can then manipulate or modify them for use in the LIS. Also, an element modified in the LIS can then be exported and configured in the external position engine, provided that the engine supports this functionality. Once all of the elements have been imported from a position engine, the Lock procedure has to be performed. This ensures that the LIS and the position engine are in sync with regards to the registered elements. If at any time the synchronization is broken, you can re-import or modify the elements in the LIS, and Lock the engine to reestablish the synchronization. The position engine can also be reset using the Reset function, which cleans up and purges all elements that have been synchronized or set in the LIS. For example, this can be useful if the model used in the Ekahau position engine has been removed, which necessitates cleaning up the corresponding connector in RFID Anywhere. Themes A theme is a collection of attributes common to a group of items. These attributes are used to identify a specific item based on the value of the attribute. For instance, if a group of tags represents personnel in a company, then these tags can then be assigned to a common theme that contains attributes such as last name, first name, or job title. This information can then be used for querying items for inclusion in reports. A theme is initially created based on a DPP and one of the DPP's defined schemas. This schema provides a base set of attributes for the theme. These DPP attributes represent the values that are encoded in the events received from RFID Anywhere. These attributes can then be augmented by adding your own custom attributes. Theme Filters provide you with a way to specify criteria that determines which items are considered a valid part of the theme. For example, a theme that consists of doctors may also have a filter which excludes all items except those that have Doctor as part of a Profession attribute provided by the DPP. The items in a theme is purged periodically based on an expiration time that is associated with a theme. This can be configured to anywhere from a matter of minutes to days. Once this time has lapsed for an item, any position data associated with this item that is older than the expiration is removed. A theme has the option to have a user-defined icon that provides a visual identification for items that belong to that theme when those items are represented in a map. 6 Copyright © 2008, iAnywhere Solutions, Inc.
  14. 14. Introduction to LIS Maps Maps can be imported from either a position engine or they can be created from scratch. When creating a map from scratch, you must import an image that represents your map and then calibrate the map by defining a scale for the map. Once the map has been created, either by importing or by starting from a blank map, you can then begin to place items on the map. There are three basic types of items that you can place on a map; an area/zone, a device, or a sensor. Areas/Zones are polygonal regions defined within the map. You create them by drawing them onto the map using the Area tool and giving the new area a name. An area may not overlap the boundaries of an existing area; however you can create an area inside of another area. Once an area is defined, and saved, you can begin using it within other functions of the LIS, such as alerts. These areas also become a part of the reported position of an item. Sensors can be placed graphically on a map as well, and, once they are positioned, these sensors have a static location within that map. After that point, you can begin receiving events from these sensors that give you the location of an item as it passes by a sensor, such as a barcode scanner. This allows you to locate and track the flow of items, such as barcoded items, that are not traditionally associated with location systems, and have these items treated in the same respect as active RFID tags. Devices can be located in the map as well. Devices can consist of items such as exciters or access points, and work in a practically identical manner as sensors. Reports The report functionality of the LIS provides you with the ability to query, display, and analyze the data that is collected by the LIS. The reporting features consist of two basic types of reports: location and data. Location reports allow you to select a set of criteria for which items that you want to display. The location reports, when executed, then display the items that meet the provided criteria on the map in their specified X and Y positions. Location reports also handle results that span multiple maps and give you the capabilities to review results across multiple maps. Results that belong to a specific theme can also be represented by an icon that was designated for that theme. Data reports allow you to define which specific information you would like to see within a report and to display it in a tabular format. When defining a data report, you can specify precisely which attributes you would like to include in the results and specify the criteria by which data is filtered. The LIS also provides the ability to control how the Data report results are displayed. The results are formatted for HTML output, and an HTML template can be provided by you that displays the results with any of the various formatting options that you would like to set for the report. Once a report has been defined, it can be executed in one of two ways. The first is by double-clicking the report on the main screen of the Control Panel. The bottom half of this screen is reserved for reports. The second method is by entering the Reports section of the Control Panel, selecting a report from the list and clicking the Run button. Copyright © 2008, iAnywhere Solutions, Inc. 7
  15. 15. Getting started with LIS Both types of reports can have a refresh interval specified on the results screen that allow the report to be re-executed after the specified amount of time has passed. This gives you the ability to maintain up-to-the- minute status reports of the items that are contained within the report. Alerts Alerts provide a way to notify an external application that certain conditions have been met. The alerts can be established for a single tag, a group of tags, or an entire theme. There are three types of supported alerts: ● By Area/Zone An alert is triggered when a tag enters or leaves a specific area/zone. ● By Distance An alert is triggered when a tag moves more than the specified distance. ● By Attribute An alert is triggered when one of the attributes meets a certain criteria. For example, when a tag that contains a temperature attribute reports a value exceeding the set value. Once an alert has been triggered, any of the supported messaging connectors provided by RFID Anywhere can be used to deliver the alert message. Messaging connectors supported by RFID Anywhere include TCP, UDP, MSMQ, JMS, and file system. Web interface The Location Information System exports two different web services that can then be consumed by external applications. The two web services are: ● Control Panel Web Services Interface Provides all of the necessary methods to set, configure, and maintain the Location Information System, including map retrieval, theme definition, tag commissioning, report definition and execution. ● RTLS INCITS T20 Provides a superset of the standard interface for interacting with a location system. 8 Copyright © 2008, iAnywhere Solutions, Inc.
  16. 16. Part II. Installing LIS This part provides instructions for installing LIS.
  17. 17. CHAPTER 2 Installing LIS Contents Installation instructions for LIS ..................................................................................... 12 Installation instructions for the LIS Control Panel prerequisites .................................. 14 Copyright © 2008, iAnywhere Solutions, Inc. 11
  18. 18. Installing LIS Installation instructions for LIS This section outlines how to install LIS. LIS is distributed as an RFID Anywhere package that can be deployed using the Provisioning page of the RFID Anywhere Administrator Console or through Enterprise Manager. System requirements You need the following to install LIS: ● RFID Anywhere 3.1, installed in Site Manager or Group Manager mode. Installing LIS into RFID Anywhere LIS can be installed on an RFID Anywhere Site Manager or Group Manager node. To install LIS on a Site Manager or Group Manager node 1. Install RFID Anywhere 3.1 in Site Manager or Group Manager mode. See “Installing RFID Anywhere” [RFID Anywhere Getting Started Guide]. 2. From the Configuration » Server page of the RFID Anywhere Administrator Console, make the IIS Settings properties editable: a. Click the Edit icon in the IIS Settings title bar. b. Change the value of the SOAP Message Size property to have a value of 8192. c. Save the change. The IIS web server restarts. Note If you do not perform this step, and instead leave the SOAP Message Size property at 4092, the RFID Anywhere Administrator Console displays an error or refreshes the Provisioning page and does not deploy the Location Information System package. 3. If the RFID Anywhere installation was upgraded from a 2.x version, do the following: a. Open Internet Information Services from Control Panel » Administrative Tools. b. Expand the local computer, expand Default Web Site, and right-click the RFIDAnywhere virtual directory. c. Select Properties. d. On the Virtual Directory tab, click the Configuration button. e. On the Mappings tab of the Application Configuration window, select the .exe entry and click Edit. f. Select the Script Engine option, and then click OK. g. Click OK to close the Application Configuration window. 12 Copyright © 2008, iAnywhere Solutions, Inc.
  19. 19. Installation instructions for LIS h. Click OK to close the properties of the RFIDAnywhere virtual directory. 4. Log back in to the RFID Anywhere Administrator Console and navigate to the Provisioning page. From the Provisioning page, deploy the LIS setup package (LIS-3.1.0.37.msi), which can be found in the LIS directory of your download package. For more information about deploying packages using provisioning, see “Deploying packages” [RFID Anywhere Getting Started Guide]. For information about deploying packages using Enterprise Manager, see “Installing new packages” [RFID Anywhere Enterprise Manager Guide]. All of the components required to use LIS, including the LIS business module, web services interface, data repository, and Control Panel application, are installed via this package. 5. Verify the user permissions of the ASP.NET Machine Account by navigating to your Windows folder, typically C:Windows. This account needs full permission to the Windows Temp folder: a. Right-click the Temp folder and choose Properties. b. On the Security tab, select the ASP.NET Machine Account user. If the user is not in the list, add the account by clicking Add. c. In the Locations field, select your PC name, then enter ASPNET in the Object Names field. d. Press Check Names before clicking Add. e. With the ASPNET user selected, select the Full Control option under Allow, and then click OK. Copyright © 2008, iAnywhere Solutions, Inc. 13
  20. 20. Installing LIS Installation instructions for the LIS Control Panel prerequisites This section outlines how to install the LIS Control Panel prerequisites on a computer that will be used to access the LIS Control Panel, which is an application hosted by the RFID Anywhere server. Installing the LIS Control Panel prerequisites To install the LIS Control Panel prerequisites 1. Log in to the RFID Anywhere Administrator Console and browse to the Local Services page. 2. From the Local Services list, click LISModule, the Location Information System business module. 3. Click the >> link beside the Launch Control Panel property to open the Location Information System page. 4. Click the Install Location Information System Prerequisites link to download and install a trust application called SetupRATrustDeployment.msi. Accept the installation. This needs to be done on any computer that accesses the LIS Control Panel, but it only needs to be done once per computer. 5. Once the trust application is installed, click the Location Information System link to open the LIS Control Panel. 14 Copyright © 2008, iAnywhere Solutions, Inc.
  21. 21. Part III. Using LIS This part contains detailed instructions for using LIS to enable context-aware location tracking applications.
  22. 22. CHAPTER 3 Using LIS Contents Using the LIS Control Panel ........................................................................................ 18 Accessing LIS through web services ........................................................................... 26 Copyright © 2008, iAnywhere Solutions, Inc. 17
  23. 23. Using LIS Using the LIS Control Panel This section describes how to use LIS to enable context-aware location tracking applications. It discusses the use of the LIS Control Panel and the web services interface provided by LIS. Access the LIS Control Panel The LIS Control Panel can be accessed from any computer that can communicate with RFID Anywhere. To access the LIS Control Panel as an administrator 1. Log in to the RFID Anywhere Administrator Console and browse to the Local Services page. 2. From the Local Services list, click LISModule, the Location Information System business module. 3. Click the >> link beside the Launch Control Panel property to open the Location Information System page. 4. If you have not previously installed the LIS Control Panel prerequisites, click the Install Location Information System Prerequisites link to download and install a trust application called SetupRATrustDeployment.msi. Accept the installation. This needs to be done on any computer that accesses the LIS Control Panel, but it only needs to be done once per computer. 5. Once the trust application is installed, click the Location Information System link to open the LIS Control Panel. To access the LIS Control Panel as a user 1. In a new browser window, browse to http://ip-address-of-RA-server/RFIDAnywhere/LIS/LIS.aspx. 2. If you have not previously installed the LIS Control Panel prerequisites, click the Install Location Information System Prerequisites link to download and install a trust application called SetupRATrustDeployment.msi. Accept the installation. This needs to be done on any computer that accesses the LIS Control Panel, but it only needs to be done once per computer. 3. Once the trust application is installed, click the Location Information System link to open the LIS Control Panel. The LIS Control Panel opens, with icons for the available features along the left side of the LIS Control Panel window. 18 Copyright © 2008, iAnywhere Solutions, Inc.
  24. 24. Using the LIS Control Panel Admin page The LIS Control Panel Admin page lists all administrative and configuration functions of the LIS Control Panel, and is only accessible if you have accessed the LIS Control Panel as an administrator. To access a specific admin function, double-click the associated icon. Alerts configuration screen The Alerts configuration screen allows an administrator to create, edit, and delete various alerts. At a high level, alerts are configured to monitor specific tags or tags of a certain theme as they move around a location and undergo changes in their business context. Alerts are delivered using configured messaging connectors on the RFID Anywhere server. Existing alerts can be edited or deleted by selecting the alert in the Alert list and clicking the appropriate icon. New alerts can be created using the icons in the Alerts configuration title bar. To exit the Alerts configuration screen to return to the Admin page, click the Close button in the lower right- hand corner. When creating or editing an alert, the administrator specifies the following alert options: ● a unique name for the alert ● a flag indicating whether or not the alert is active ● a description of the alert ● the message text to send with the alert ● an importance level (Low, Normal, or High) ● the alert type (Area, Distance, Attribute) ● the messaging transport (configured messaging connector) to use to deliver the alert Alerts fall into one of three categories, each with their own unique configuration options in addition to the standard alert options above. Copyright © 2008, iAnywhere Solutions, Inc. 19
  25. 25. Using LIS Area alerts Area alerts are used to generate alerts when a specific tag, or any tag belonging to a specific theme, moves in or out of an area as defined by a specific map. The Items tab of the Area Alert configuration allows an administrator to select specific tags or themes the alert applies to. The Incidents tab allows an administrator to view past incidents of the alert, including the time, message, and messaging connector used to deliver the alert. The Area tab allows the administrator to specify the map name, area name, and movement condition. Here, the movement condition is whether to alert on an item leaving the area, entering the area, or either. Distance alerts Distance alerts are used to generate alerts when a specific tag, or any tag belonging to a specific theme, moves a certain distance, regardless of the initial map or area. The Items tab of the Distance Alert configuration allows an administrator to select specific tags or themes the alert applies to. The Incidents tab allows an administrator to view past incidents of the alert, including the time, message, and messaging connector used to deliver the alert. The Distance tab allows the administrator to specify the distance, in meters, the item must move to trigger the distance alert. Attribute alerts Attribute alerts are used to generate alerts based on the changing values of an item's business context, or attributes of the item. The Items tab of the Attribute Alert configuration allows an administrator to select specific tags or themes the alert applies to. The Incidents tab allows an administrator to view past incidents of the alert, including the time, message, and messaging connector used to deliver the alert. The Attribute tab allows the administrator to specify the specific attribute of interest, and a value to test the attribute against. Alerts can be generated when an item's attribute is the same as the specified value, or when it differs. DPP Routing configuration screen The DPP Routing configuration screen allows an administrator to specify which Data Protocol Processor (DPP) the LIS business module should use when handling events from hardware connectors. To add a new DPP Router, click the New DPP Router icon. When creating a DPP Router, the administrator specifies: ● if the router applies to a specific source (configured hardware connector) or to a specific event type regardless of hardware connector ● which of the currently installed DPPs should be used by the router ● which source or event type supported by the DPP should have the filter applied To exit the DPP Routing configuration screen to return to the Admin page, click Close. 20 Copyright © 2008, iAnywhere Solutions, Inc.
  26. 26. Using the LIS Control Panel To delete an existing DPP Router, highlight the specific DPP Router and click the Delete Selected DPP Router icon. Maps configuration screen The Maps configuration screen allows an administrator to create, edit, and delete maps used by LIS. Existing maps can be edited or deleted by highlighting the map in the Map list and clicking the appropriate icon. New maps can be created using the Add New Map icon in the Maps configuration title bar. To exit the Maps configuration screen to return to the Admin page, click Close. When creating or editing a map, the administrator specifies the following map properties: ● a unique name for the map. ● a description of the map. ● the image file of the map, set by browsing to an image file. ● the map's scale, in pixels per meter, set by drawing a line on the displayed map and then entering the actual distance in meters the line represents. The pixels per meter calculation is done and populated automatically. Once a map is created, an administrator can highlight the map in the Map list and click the Edit Map icon to perform a number of additional administrative tasks on the map using the Map Editor. Available administrative options of the Map Editor include: ● define an area by clicking around the map to create a highlighted polygon. Double clicking your mouse ends the area definition and prompts for an area name and description. ● add a sensor by clicking a point on the map and selecting from a list of sensors that have been configured on the Sensors configuration tab. ● calculate a distance by clicking two points on the map. ● zoom in and out on the map image. Click Save Changes in the Map Editor to save changes, and the Close Map Editor icon to close the Map Editor and return to the Maps configuration screen. Mobile Device configuration screen The Mobile Device configuration screen allows an administrator to create, edit, and delete mobile devices that are to be tracked using LIS to provide coordinates of items located with the mobile device. In this scenario, the mobile device is tracked with a configured position engine, and the device's coordinates are associated with the items it reads. Existing mobile devices can be edited or deleted by highlighting the device in the Mobile Device list and clicking the appropriate icon. New mobile devices can be configured using the Add New Mobile Device icon in the Mobile Device configuration title bar. To exit the Mobile Device configuration screen to return to the Admin page, click Close. When creating or editing a mobile device, the administrator specifies the following mobile device properties: Copyright © 2008, iAnywhere Solutions, Inc. 21
  27. 27. Using LIS ● the position engine used to track the mobile device ● a flag indicating whether or not the mobile device is active ● a unique name for the mobile device ● a description of the mobile device ● the mobile device's MAC address ● the sensor, or configured hardware connector in RFID Anywhere, for the mobile device as configured on the Sensors configuration screen ● the mobile device's tag ID that uniquely identifies it to the positioning engine Position Engines configuration screen The Position Engines configuration screen allows an administrator to interact with configured position engines to import and export configurations and other components. When the Position Engines configuration screen is opened, the Position Engines list is populated with configured connectors of position engines. This list provides a summary of the different position engines available for LIS to communicate with, and summarizes whether or not the connector is active, its status, and the name, description, and number of maps associated with each position engine. When a position engine connector is correctly configured and running in RFID Anywhere, an administrator can highlight the connector in the Position Engines list to get access to the administrative capabilities of the Position Engine configuration screen via icons. Available administrative options include: ● view engine properties ● import maps ● import tags ● import devices ● export mobile devices ● lock engine ● reset engine ● delete engine To exit the Position Engines configuration screen to return to the Admin page, click Close. Reports configuration screen The Reports configuration screen allows an administrator to create, edit, copy, and delete XML and map reports generated by LIS. Existing reports can be edited, copied, or deleted by highlighting the report in the Report list and clicking the appropriate icon. New reports can be created using the New Report icon in the Reports configuration title bar. To exit the Reports configuration screen to return to the Admin page, click Close. When creating or editing a report, the administrator first specifies if the report is a Data report, where the result is an XML document, or a Location report, where the result is a map with icons representing the 22 Copyright © 2008, iAnywhere Solutions, Inc.
  28. 28. Using the LIS Control Panel location of items. After configuring reports, an administrator can test the report to verify the expected output against the current and past system activity. Data reports Data reports generate XML documents to be processed by other systems. When configuring a Data report, the administrator specifies the report properties. From the Report Options tab: ● a unique name for the report. ● the theme(s) that the report uses to identify items of interest. ● the fields to include in the report. ● the report formatting. By default, an HTML report template is created. From the Criteria tab: ● the filtering criteria. An administrator uses the provided interface to define the filter criteria using a variety of properties, operands, and criteria values. Location reports Location reports generate maps with icons that can be viewed by an administrator. When configuring a Location report, the administrator specifies the report properties. From the Report Options tab: ● a unique name for the report. ● the theme(s) that the report uses to identify items of interest. ● the item property to display when an administrator hovers over the icon of a specific item on the report. Available properties include DateRead, TagDescription, TagID, or X, Y or Z position. Note that only one property can be displayed. From the Criteria tab: ● the filtering criteria. An administrator uses the provided interface to define the filter criteria using a variety of properties, operands and criteria values. Sensors configuration screen The Sensors configuration screen allows an administrator to define sensors that can be placed on a map as a way to associate a fixed data collection source with positioning coordinates. It also allows the creation of mobile sensors for use in conjunction with the Mobile Devices configuration screen for associating data from a moving mobile device with positioning coordinates. New sensors can be created using the New Sensor and New Mobile Sensor icons in the Sensors configuration title bar. Existing sensors can be deleted by highlighting a specific sensor and selecting the Delete Sensor icon. Copyright © 2008, iAnywhere Solutions, Inc. 23
  29. 29. Using LIS To exit the Sensors configuration screen to return to the Admin page, click Close. When creating a sensor, the administrator specifies the following sensor properties: ● the sensor type, which is selected from a drop down list of installed controllers ● the actual sensor, which is selected from a drop down list of configured hardware connectors of the type specified by the sensor type field Once sensors have been configured, they can be added to maps using the Map Editor accessible from the Maps configuration page. Once a sensor is added to a maps, the Map column of the sensor's entry on the Sensor list displays the map to which the sensor is associated. Tags configuration screen The Tags configuration screen allows an administrator to associate tags with themes and specify additional data about the tag. Once imported from a position engine or defined by an administrator, tags are displayed in the Tag list for review and editing. To locate a specific tag easily, the Tag list can be filtered by theme. Mobile devices that are to be tracked with position engines can also be added and edited from the Tag configuration screen. New tags can be created using the New Tag icon in the Tags configuration title bar. Existing tags can be deleted by highlighting a specific sensor and selecting the Delete Tag icon. To exit the Tags configuration screen to return to the Admin page, click Close. When creating or editing a tag or mobile device, the administrator specifies the following properties: ● the tag ID, which is the unique identifier for the tag. ● a description of the tag. ● the tag type. ● the theme to which the tag belongs, selected from a drop-down list of currently configured themes. ● any attribute values required by the theme that are not part of the DPP (for example, not derivable from the data on the tag). To set theme-specific attribute values, double click the attribute name, enter the value, and click OK. Once tags have been configured, the tags and their attributes can be tracked using LIS. Themes configuration screen The Themes configuration screen allows an administrator to create themes, which are collections of attributes common to a group of items to be tracked. Once created, themes are used as the basis for creating tags and populating their unique attributes to allow tracking and configurable reporting. The Themes configuration screen is divided into two sections. At the top, the Current Themes section presents a list of currently configured themes. Below, the Selected Theme Attributes section lists the attributes of the theme currently selected in the Current Themes section. To exit the Themes configuration screen to return to the Admin page, click Close. 24 Copyright © 2008, iAnywhere Solutions, Inc.
  30. 30. Using the LIS Control Panel New themes can be created using the New Theme icon in the Themes configuration title bar. Existing themes can be deleted by highlighting a specific theme and selecting the Delete Theme icon. When creating or editing a theme, the administrator specifies the following properties: ● the Data Protocol Processor (DPP) to be used to decode tags that are part of this theme ● the theme template, which presents a list of tag formats supported by the DPP. Highlighting a tag format presents a list of attributes that are populated by the DPP when a particular tag is decoded. ● a unique name for the theme. ● a description of the theme. ● an expiration time, which controls how long location data for a tag in the theme should be persisted in the LIS data store. ● the icon graphic file to use for the theme when theme members are displayed on a map. ● any additional attributes that an administrator wants to be part of the theme that are not populated by the DPP. To add an attribute, an administrator defines the attribute details (such as name, description, type, length, if nulls are allowed, or if the value must be unique) and and then clicks Add. Once themes have been configured, tags can be created and associated with the available themes. Reports page The Reports page provides a log of all available reports and provides a simple way to execute reports. If you are not logged in to the LIS Control Panel as an administrator, this is the screen used to execute and view available reports. Alerts page The Alerts page provides a log of all past alerts that have been generated. Users can filter by alert or by date. Logout The Logout icon exits the LIS Control Panel. Copyright © 2008, iAnywhere Solutions, Inc. 25
  31. 31. Using LIS Accessing LIS through web services The Location Information System exports web services that can then be consumed by external applications. The web services are: ● Control Panel Web Services Interfaces Set of web services that provides all of the necessary methods to set, configure, and maintain the Location Information System, including map retrieval, theme definition, tag commissioning, report definition, and execution. These interfaces are used by the LIS Control Panel, but are also exposed for developers. ● RTLS INCITS T20 Provides a superset of the standard interface for interacting with a location system. Web Services Interfaces for LIS administration and usage The WSDLs for the Web Services Interfaces used by the LIS Control Panel and exposed to allow incorporation of LIS administration and usage functions within custom applications can be found as .asmx files in the LIS folder of your RFID Anywhere installation. To view the interfaces, navigate to http:// localhost/RFIDAnywhere/LIS/interface.asmx, where interface.asmx is one of the specific interfaces below. You can view the WSDL files by appending ?WSDL to the interface URL. Available interfaces are: ● Alert.asmx Used for interacting with the Alert features of LIS. Available methods include Enumerate, EnumerateIncidents, Modify, Delete, and ClearIncidents. ● Device.asmx Used for interacting with the Mobile Device features of LIS. Available methods include AddMobile, ModifyMobile, Enumerate, EnumerateMobile, and RemoveMobile. ● DPP.asmx Used for interacting with the DPP features of LIS. Available methods include RemoveRouting, AddRouting, Enumerate, EnumerateRouting, and Get. ● Engine.asmx Used for interacting with the features of LIS that interact with positioning engines. Available methods include GetDevices, GetMap, ImportMap, ImportTag, AddMobileDevice, GetImportedTags, and Reset. ● Map.asmx Used for interacting with maps in LIS. Available methods include Get, SaveChanges, Remove, Add, Edit, Enumerate, and GetAreas. ● Report.asmx Used for interacting with the features of LIS that enable location and data reports. Available methods include Delete, TestDataReport, TestLocationReport, RunDataReport, RunLocationReport, Add, Edit, and Enumerate. ● Sensor.asmx Used for interacting with sensors in LIS. Available methods include Delete, Enumerate, and Add. ● Tag.asmx Used for interacting with the tag features of LIS. Available methods include Enumerate, Delete, Modify, and Add. ● Theme.asmx Used for interacting with the theme features of LIS. Available methods include AssignTag, GetTagPosForTheme, Remove, GetTagData, Add, Edit, Enumerate, RemoveTag, and GetTagsForTheme. 26 Copyright © 2008, iAnywhere Solutions, Inc.
  32. 32. Accessing LIS through web services ● LIS.asmx Used for interacting with the features of LIS that interact with positioning engines. Available methods include GetDevices, GetMap, ImportMap, ImportTag, AddMobileDevice, GetImportedTags, and Reset. For more information about building web services applications to communicate with components running in RFID Anywhere, including this interface, see “Accessing RFID Anywhere using web services” [RFID Anywhere Developer's Guide]. RTLS INCITS T20 Web Services Interface The WSDL for the RTLS INCITS T20 Web Services Interface can be found by clicking the WSDL document link beside the RTLSService in the Local Services list of the RFID Anywhere Administration Console. Available methods include: ● GetMapImage ● GetEngines ● GetEngineElements ● TagCommand For more information about building web services applications to communicate with components running in RFID Anywhere, including this interface, see “Accessing RFID Anywhere using web services” [RFID Anywhere Developer's Guide]. Copyright © 2008, iAnywhere Solutions, Inc. 27
  33. 33. 28
  34. 34. about, 4 Index accessing, 26 alerts, 8 components, 5 A concepts, 5 accessing LIS DPP Routing, 5 web, 26 engines, 6 admin page installing, 11, 12 alerts configuration screen, 19 maps, 7 DPP Routing configuration screen, 20 overview, 4 LIS Control Panel, 19 product description, 4 maps configuration screen, 21 reports, 7 Mobile Device configuration screen, 21 sensor selection, 5 position engines configuration screen, 22 system requirements, 12 reports configuration screen, 22 themes, 6 sensors configuration screen, 23 using, 17 tags configuration screen, 24 using the control panel, 18 themes configuration screen, 24 web interface, 8 alerts page LIS adminstration LIS Control Panel, 25 Web Services Interfaces, 26 LIS Control Panel D access, 18 documentation admin page, 19 providing feedback, vii alerts page, 25 RFID Anywhere, vi logout page, 25 reports page, 25 LIS control panel F using, 18 feedback LIS Control Panel prerequisites documentation, vii installation instructions, 14 providing, vii LIS usage Web Services Interfaces, 26 G logout page getting started with LIS LIS Control Panel, 25 about, 3 R I reports page installing LIS Control Panel, 25 LIS, 12 RFID Anywhere LIS Control Panel prerequisites, 14 documentation, vi installing LIS RFID Anywhere Location Information System Guide, about, 11 v instillation instructions RTLS INCITS T20 LIS Control Panel prerequisites, 14 Web Services Interface, 27 L S LIS system requirements Copyright © 2008, iAnywhere Solutions, Inc. 29
  35. 35. Index LIS, 12 W Web Services Interface RTLS INCITS, 27 Web Services Interfaces LIS administraiton, 26 LIS usage, 26 30 Copyright © 2008, iAnywhere Solutions, Inc.

×