Microsoft Dynamics® AX

Setting up RFID for Microsoft Dynamics AX 2009
DECEMBER, 2008

................................................................................................................ 7 Adding SQL Server components .............................................................................................................................................................. 3 Part I: Manual set up of BizTalk RFID with Microsoft Dynamics AX .................................................................................................................................................................................... devices......................................................................................................................................................................... 11 Part II: Automated setup of BizTalk RFID with Microsoft Dynamics AX ................................................................................................ 9 To bind a component to a process..................... 4 To add multiple devices ................................... 6 Creating and setting up a process .. 6 Creating and binding logical devices to a process ............................................................... 10 To start the Contoso device........................... 9 Using the RFID infrastructure with Microsoft Dynamics AX ........................................................................ 3 To start the Contoso Device Simulator ............... 3 Simulating a single device or multiple Devices .................................................................. 10 To create an RFID server in Micosoft Dynamics AX ................................................................................................................................................................. 6 To create and set up a process ........ 14 Tag length check causes an error ................................................................................................................................... 4 To add a single device ................................................ 3 Adding providers......................................... 14 To remove the tag length dheck in the Contoso provider source code .......................................................... and processes ........... 15 2 SETTING UP RFID IN DYNAMICS AX 2009 ....... 3 Running RFID simulation software............................................ 12 Part III: Known issues and workarounds ..................................................................................................... 4 To add the Contoso provider ......................... 15 A timeout error occurs when starting the Contoso provider .......... 7 To create and bind logical devices to a process ................. 3 To prepare for multiple device simulation .......................................Table of Contents Introduction .......................................

You do not need to change the IP address. a unique device name. Note Each section should have a unique name.0.xml file in the ContosoDeviceSimulator folder. and it uses the Contoso provider that is provided with this sample. and a unique port number. 3 SETTING UP RFID IN DYNAMICS AX 2009 . To simulate multiple devices using the Contoso Device Simulator you need to modify the file ContosoSimulatorConfig. 3. The first part of the document provides a detailed overview of the manual setup process and the second part of document provides instructions for applying a script to automate the setup tasks. Right-click the ContosoSimulatorConfig. refer to Part III in this document for a description of how to resolve a known error.Introduction This document describes how to set up Microsoft® BizTalk® RFID Server for Microsoft Dynamics® AX 2009 to run a radio frequency identification (RFID) simulation.0. Running RFID simulation software The Contoso Device Simulator that is delivered together with BizTalk Server RFID allows you to start working with BizTalk RFID without having a physical device connected to BizTalk RFID. Click the runContosoSimulator. 2. Simulating a single device or multiple Devices The device information is contained in the ContosoSimulatorConfig. and then select XML Editor or any other editor to edit the file. To simulate a single device you do not need to make any changes in the ContosoSimulatorConfig.xml file.xml. Part III provides references to known errors and descriptions of solutions to the errors.cmd file to start the simulator. To prepare for multiple device simulation 1. To start the Contoso Device Simulator 1. For an overview of the setup requirements to run Microsoft BizTalk RFID with Microsoft Dynamics AX 2009 or earlier versions.0 and port 6666. Open My Computer and select the hard disk drive where BizTalk RFID is installed. Specify the number of devices to apply under NumberOfDevices using the following convention: <section name="NumberOfDevices"> <entry name="DeviceCount">1</entry> </section> <entry name="DeviceCount">2</entry> </section> 3. see Setting up Dynamics AX with the Microsoft BizTalk RFID Server. select Open With. Add an entry for each additional device to simulate. 2. Part I: Manual set up of BizTalk RFID with Microsoft Dynamics AX Follow the guidelines below to start and manually set up the Contoso Device Simulator or learn more about the steps involved in the automated setup process. Go to Program Files\Microsoft BizTalk RFID\Samples\Device Service Provider\Contoso\ContosoEndToEnd\ContosoDeviceSimulator.xml file. This sample file contains a single device called ContosoTestDevice that is configured at IP Address 0. Note: Before you start the Contoso Device Simulator.

To add a single device 1. 4 SETTING UP RFID IN DYNAMICS AX 2009 . Select the Start the Provider check box to start the provider as soon as the Add Provider dialog box closes.xml</entry> <entry name="DeviceTranslatorAssemblyPath">Microsoft.dll. Right-click the Devices node under Processes in RFID Manager. 6. 4.Rfid.ContosoDeviceTranslator.0</entry> <entry name="PortNumber">6667</entry> <entry name="ProviderId">Contoso</entry> <entry name="NotificationDataFile">ContosoNotificationConfig.0. Click Start > Microsoft BizTalk RFID > RFID Manager to open RFID Manager. type Contoso Provider. Tip: You can add devices to the BizTalk RFID server regardless of whether the device status is online or offline. Click OK to install the Contoso Device Provider. In the File name(s) field in the Add Provider dialog box. and select New Provider. and click Browse to locate the file titled Microsoft. and processes To add the Contoso provider 1. 5. 2.ContosoDeviceProvider.Example: <section name="DeviceInformation_2"> <entry name="DeviceName">ContosoTestDevice2</entry> <entry name="ConnectionType">TCPIP</entry> <entry name="IpAddress">0.dll</entry> <entry name="DeviceTranslatorConfigFile"></entry> </section> Adding providers.Test. and select New Device. 3.0. Right-click the Device Providers node under Device Groups in RFID Manager. Click Register to add the provider to BizTalk RFID.Rfid. devices.

you need to specify the IP address and port number information of the device. 6. Note Do not specify anything when asked to enter user name and password for authentication. In the Connect using list. 5. For example. The default option is RootDeviceGroup. Optionally. which is the root of the hierarchy. 4. 5 SETTING UP RFID IN DYNAMICS AX 2009 . you can change the device group that this device should be added under. Provide the remaining connection information for the connection type. select the connection type that BizTalk RFID should use to connect to the device. if you specified TCP. If you do not succeed in creating a connection. Select Add single device. and select a provider in the Add Device Wizard. select Add device to the RFID server and enter a name in the Name field to activate the device in offline mode.2. 3.

in the Description field. The default option is RootDeviceGroup. which is the root of the hierarchy. logical devices. select a mode for the process you are creating. 5. and event handlers to create a task. define them. Select Add multiple devices and select a provider in the Add Device Wizard. 2. 4. 4. you can create RFID processes. You must set up one process in the RFID infrastructure for each business process that is required in Microsoft Dynamics AX. Right-click the Devices node under Processes in the RFID Manager form and select New Device. For example. select the Add device automatically check box if devices found in the range that you specified should be added automatically. Optionally. 2. Creating and setting up a process A process brings together logical sources. and store them in a database. you can change the device group that this device should be added under.To add multiple devices 1. Right-click the Processes node in RFID Manager. You will be connected to devices in the range that you specified. and run the processes to obtain intelligent data. and one business process for devices that will only be used for real time reads. Note Do not specify anything when asked to enter user name and password for authentication. In the Process Name field in New Process dialog box. Clear the Start Bind Wizard check box. 3. 6 SETTING UP RFID IN DYNAMICS AX 2009 . To create and set up a process 1. In the Tag processing mode list. 3. 5. type a brief note that describes the new process. Specify a range of addresses and provide the remaining connection information. As an RFID administrator. the task could be set up to process the tags read by the devices that are bound to the process. enter the name of the new process. Optionally. and then click New Process. filter out the relevant tag reads. Optionally.

Creating and binding logical devices to a process A logical device is an entity that contains devices or device groups. Note: Before you create a logical device for a process. In the Logical Device Name field in the Add Logical Device dialog box.A logical set that maps to physical devices at the shipping entry/exit point of a warehouse Shelf device . 2. Click OK to create the new process. Select a process under the Processes node in RFID Manager. An RFID administrator can create a logical device to provide a business context to a set of physical devices.6. type the name of the new logical device. and select Stop to stop a process.A logical set that maps to physical devices monitoring in-house inventory in a warehouse To create and bind logical devices to a process 1. 3. Right-click the process. 7 SETTING UP RFID IN DYNAMICS AX 2009 . Right-click Device Bindings on the Browse tab in the results pane. and then click New Logical Device. you must stop the process. Examples of logical devices are:   Shipping device .

and then click Bind. 8 SETTING UP RFID IN DYNAMICS AX 2009 . On the Browse tab in the results pane. right-click the logical device. Click OK to create the device and close the Add Logical Device dialog box. 5. The Bind Logical Device dialog box appears.4.

Select the device groups or devices from Devices and groups to bind to the logical device. Click OK. Select a component under the Processes node in the RFID Manager form. To bind a component to a process 1. Right-click Component Bindings on the Browse tab in the results pane. Adding SQL Server components Tag reads from a device must be stored in a SQL database by the RFID infrastructure. so a database component must be bound to the process. 2. 7. 9 SETTING UP RFID IN DYNAMICS AX 2009 . A job in Microsoft Dynamics AX gets the tag reads from this database. and select Add New Component.6.

and close the Add Component dialog box to add more new components.OobComponents. 6. Ignore this error and close the windows. Using the RFID infrastructure with Microsoft Dynamics AX To use the RFID infrastructure with Microsoft Dynamics AX you must be sure that the Contoso device is turned on and that an RFID server in Microsoft Dynamics AX is synchronized with the RFID infrastructure.dll file is already registered. 10 SETTING UP RFID IN DYNAMICS AX 2009 . In the Processes pane. right-click the process. Select the SqlServerSinkWithChronologicalReads component in the Add Component dialog box and click Add.dll file. Note: If the file Microsoft. To start the Contoso device 1.Rfid. Click Register in the Add Component dialog box and select the file Microsoft.OobComponents. 4. 2. Select the Processes node in RFID Manager.Rfid.3. an error occurs saying that the file is already registered. 5. and click Start. Name the instance SQLServerSink.

Note: To be sure that the status of the Contoso device is Open. If you work in a three-tier architecture. 3. Click Devices and Processes to synchronize with the RFID infrastructure. click the General tab. right-click the Devices node. click Inventory management > Setup > RFID > RFID Servers. 4. 2. and enter the domain name in the Domain name field. Press Ctrl+N to create a new server record. To create an RFID server in Micosoft Dynamics AX 1. In Microsoft Dynamics AX. and type the name localhost in the Host field. 11 SETTING UP RFID IN DYNAMICS AX 2009 .

Rfid.Dspi" i:nil="true" /> <d3p1:deviceInformation> <connectionInformation xmlns="http://schemas.microsoft.Rfid.org/2004/07/MS.w3.xml "%RFIDINSTALLDIR%\bin\rfidclientconsole. the type of connection is TCP.org/2004/07/Microsoft.SensorServices.exe" StartProcess ContosoTestProcess  An XML file titled device.1</host> <port>6666</port> </transportSettings> </connectionInformation> <providerData xmlns:d5p1="http://schemas.Rfid.Rfid.ContosoDeviceProvider "%RFIDINSTALLDIR%\bin\rfidclientconsole.datacontract. if the name of the device is ContosoTestDevice. the same tasks can be achieved from the command prompt by using the RFID Client Console.0.1.0.datacontract.SensorServices.com/2003/10/Serialization/Arrays" i:nil="true" /> <host>127. and process manually as described earlier in this document.ClientUtilities"> <DeviceComplete> <m_deviceDefinition xmlns:d3p1="http://schemas.Design"> <d3p1:authenticationInfo xmlns:d4p1="http://schemas.xml that contains the device information.datacontract. a command line utility that ships with BizTalk RFID.SensorServices. Create a new directory and create and add the following three files:  Command file titled setup.Rfid. the XML file will be as shown below: <ArrayOfDeviceComplete xmlns:i="http://www.datacontract.Dspi" /> </d3p1:deviceInformation> <d3p1:name>ContosoTestDevice</d3p1:name> </m_deviceDefinition> 12 SETTING UP RFID IN DYNAMICS AX 2009 .org/2004/07/Microsoft. For example.SensorServices. and the port is 6666.ContosoDeviceProvider.org/2001/XMLSchema-instance" xmlns="http://schemas.Rfid.Internal.dll" "%RFIDINSTALLDIR%\bin\rfidclientconsole.cmd with the following commands: "%RFIDINSTALLDIR%\bin\rfidclientconsole.microsoft. device. 1.exe" RegisterProvider Contoso Microsoft.Dspi"> <provider>Contoso</provider> <transportSettings i:type="TcpTransportSettings"> <m_vendorSpecificData xmlns:d7p1="http://schemas.Part II: Automated setup of BizTalk RFID with Microsoft Dynamics AX Instead of creating the device provider.exe" ImportProcesses processbinding.com/2003/10/Serialization/Arrays" i:nil="true" xmlns="http://schemas. the IP address is 127.exe" ImportDevices device.exe" DeployProcess ContosoTestProcess "%RFIDINSTALLDIR%\bin\rfidclientconsole.org/2004/07/Microsoft.0.Rfid.exe" CopyProviderFile Contoso "%RFIDINSTALLDIR%\bin\Microsoft.xml false true "%RFIDINSTALLDIR%\bin\rfidclientconsole.0.exe" StartProvider Contoso "%RFIDINSTALLDIR%\bin\rfidclientconsole.org/2004/07/Microsoft.datacontract. the name of the provider is Contoso.

0.Rfid.Rfid.6.org/2001/XMLSchema" i:type="d8p1:string">ContosoTestDevice</d4p1:anyType> </d3p1:deviceList> <d3p1:sourceBindingList /> </d4p1:Value> </d4p1:KeyValueOfstringDeviceBinding_Pyox4B_P_S> </d3p1:deviceBindings> </m_processBinding> <m_rfidProcess xmlns:d3p1="http://schemas.com/2003/10/Serialization/Arrays" /> <d3p1:ErrorPercentageThreshold>0</d3p1:ErrorPercentageThreshold> <d3p1:MaxComponentInitializationTime>600000</d3p1:MaxComponentInitializationTime> <d3p1:MaxHungEvents>0</d3p1:MaxHungEvents> <d3p1:SingleEventProcessingTimeout>60000</d3p1:SingleEventProcessingTimeout> <d3p1:deviceBindings xmlns:d4p1="http://schemas.com/2003/10/Serialization/Arrays" i:nil="true" /> </DeviceComplete> </ArrayOfDeviceComplete>  An XML file called ProcessBinding.SqlServerSink</d3p1:class Name> <d3p1:description i:nil="true" /> </d3p1:eventHandlerInfo> </d3p1:EventHandlerDefinition> </d3p1:componentList> 13 SETTING UP RFID IN DYNAMICS AX 2009 . the name of the process is ContosoTestProcess.SensorServices.datacontract.IO.Rfid. the name of the logical device is mylogicaldevice.org/2004/07/Microsoft. Version=3.microsoft.datacontract.Rfid.Internal.OobComponents.org/2004/07/MS.datacontract.org/2004/07/System.SensorServices.SensorServices. Culture=neutral.Design"> <d3p1:ComponentBindingsForXml xmlns:d4p1="http://schemas.Rfid.Client" i:nil="true" /> <m_sourcePropertyProfile xmlns:d3p1="http://schemas.microsoft.Design"> <d3p1:description i:nil="true" /> <d3p1:logicalSource> <d3p1:componentList> <d3p1:EventHandlerDefinition> <d3p1:componentName>SqlServerSink</d3p1:componentName> <d3p1:eventHandlerInfo> <d3p1:assembly>Microsoft. For example.w3.0. PublicKeyToken=31bf3856ad364e35</d3p1:assembly> <d3p1:className>Microsoft. if the name of the device is ContosoTestDevice.w3.microsoft.datacontract.<m_propertyProfile xmlns:d3p1="http://schemas.SensorServices.Rfid.org/2001/XMLSchema-instance" xmlns="http://schemas.com/2003/10/Serialization/Arrays"> <d4p1:KeyValueOfstringDeviceBinding_Pyox4B_P_S> <d4p1:Key>mylogicaldevice</d4p1:Key> <d4p1:Value> <d3p1:RegexCollectionForXml /> <d3p1:deviceGroupList /> <d3p1:deviceList> <d4p1:anyType xmlns:d8p1="http://www.xml that contains information about the process and binding. the XML file will be as shown below: <ArrayOfProcessComplete xmlns:i="http://www. and the name of the component instance is SQLServerSink.org/2004/07/Microsoft.ClientUtilities"> <ProcessComplete> <m_processBinding xmlns:d3p1="http://schemas.ProcessComponents.

ContosoTestDevice. 14 SETTING UP RFID IN DYNAMICS AX 2009 .cmd. Imports a device to the root device group from the device. ContosoProvider. and this check causes an error when running the Contoso device simulator. under the Device Providers node. 4. Tip: If RFID Manager is already running. Type setup. device. ContosoTestProcess.dll file.cmd and press ENTER.ContosoDeviceProvider.     5. Contoso. Resolution: Remove the check for the tag length in the ContosoReaderLayer. Go to the directory where you saved the three files. refresh the RFID Manager Console. 3. Imports binding information from the processbinding.cs file using the following instructions.xml file by using RFID Client Console. The following information is displayed. under the Processes node with the status appearing as Started.<d3p1:logicalDeviceList> <d3p1:LogicalDevice> <d3p1:description>all the devices that I am interested in</d3p1:description> <d3p1:name>mylogicaldevice</d3p1:name> </d3p1:LogicalDevice> </d3p1:logicalDeviceList> <d3p1:logicalSourceList /> </d3p1:logicalSource> <d3p1:messageHandlingReliability>Transactional</d3p1:messageHandlingReliability> <d3p1:name>ContosoTestProcess</d3p1:name> </m_rfidProcess> </ProcessComplete> </ArrayOfProcessComplete> 2.xml. setup. Starts the process by using RFID Client Console. A new provider. Imports a process from the processbinding. and processbinding. The following activities take place:  Loads the provider. A new device. under the Devices node and under the All Devices Group node.xml file by using RFID Client Console. by using RFID Client Console from the following location: C:\Program Files\Microsoft BizTalk RFID \bin\ Microsoft.Rfid. Click Start > Programs > Microsoft BizTalk RFID > RFID Manager to open RFID Manager. Part III: Known issues and workarounds Tag length check causes an error Problem: The Contoso provider source code contains a check for tag length of or above eight characters. Click Start and then Run and type cmd to open the Command Prompt window.xml. and redeploy the file.xml to the process by using RFID Client Console.    A new process.

3.Length <= 8) //{ Notification notification = new Notification(tagReadEvent).To remove the tag length dheck in the Contoso provider source code 1. m_ContosoReader. 15 SETTING UP RFID IN DYNAMICS AX 2009 . 2.cs under %RFIDINSTALLDIR%Samples\Device Service Provider\Contoso\Contoso Provider Source Code.ToString()).csproj. Recompile the project ContosoDeviceProvider. assign SharePoint a port number other than 80 and restart the default Web site. a timeout error might occur. This can be verified in Internet Information Services (ISS).Info("invalid tag id " + tagReadEvent. Resolution: If SharePoint is currently installed on the machine that hosts the RFID server. If this turns out to be case.raiseNotificationEvent(new NotificationEventArgs(notification)).GetId(). Open the file ContosoReaderLayer. A timeout error occurs when starting the Contoso provider Problem: When you try to start the Contoso provider. //} //else //{ // //} } logger. it can result in SharePoint taking over port 80. Comment out the tag length section of the code as follows: private void handleAsynchronousReadDetect(TagReadEvent tagReadEvent) { //if (tagReadEvent.

adaptable business management solutions that enables you and your people to make business decisions with greater confidence. or transmitted in any form or by any means (electronic. or other intellectual property.microsoft.S. mechanical. without the express written permission of Microsoft Corporation. This document is for informational purposes only. recording. Complying with all applicable copyright laws is the responsibility of the user. trademarks. Microsoft Dynamics works like and with familiar Microsoft software.Microsoft Dynamics is a line of integrated. patent applications. and Microsoft cannot guarantee the accuracy of any information presented after the date of publication. All rights reserved. Microsoft® BizTalk® Server. copyrights. MICROSOFT MAKES NO WARRANTIES. EXPRESS. 16 SETTING UP RFID IN DYNAMICS AX 2009 . © 2008 Microsoft Corporation. photocopying. trademarks. automating and streamlining financial. OR STATUTORY. U. and Windows® are either registered trademarks or trademarks of Microsoft Corporation.com/dynamics The information contained in this document represents the current view of Microsoft Corporation on the issues discussed as of the date of publication. the Microsoft Dynamics Logo. and Canada Toll Free 1-888-477-7989 Worldwide +1-701-281-6500 www. or other intellectual property rights covering subject matter in this document. customer relationship and supply chain processes in a way that helps you drive business success. Because Microsoft must respond to changing market conditions. copyrights. this document should not be interpreted to be a commitment on the part of Microsoft. Without limiting the rights under copyright. Except as expressly provided in any written license agreement from Microsoft. stored in or introduced into a retrieval system. or for any purpose. or otherwise). Microsoft. AS TO THE INFORMATION IN THIS DOCUMENT. the furnishing of this document does not give you any license to these patents. IMPLIED. Microsoft may have patents. no part of this document may be reproduced.

Sign up to vote on this title
UsefulNot useful