RFDDTAG - TagList

Binding Function	RFDDTAG
Binding ID	DYNAMIC_TAG_LIST
Binding Description	Dynamic Content List of Tags
Purpose	This binding will allow a user to configure an event payload that posts data to a specified HTTP/HTTPS endpoint using a number of supplied XSL style sheets to format the data into XML. This will enable a TagNet customer to send data to an endpoint without requiring any code changes to TagNet. Essentially this is a non-programmatic method to send a configurable XML payload to an HTTP endpoint. This data would then be parsed by the customers application and integrated with an ERP, MES or other similar system-of-record. There are two variants of the RFDDTAG Binding: 1.Individual tag Info - for every tag seen during the read event cycle, a separate XML payload will be sent to the endpoint, so if (4) tags are read then (4) XML POSTs will take place. This variant is documented here. 2.Multiple Tag List - the taglist XML contains all tags within the event cycle. So if (4) tags are read then (1) XML POST will take place. This variant is documented within this topic. The Style Sheets should be copied out of TagNet/Integrator/JSMInstance/RFID/ folder into a user defined folder (e.g. Custom-xsl) within the as they will be overwritten upon subsequent updates to TagNet. The folder path for the modified style sheets would then be TagNet/Integrator/JSMInstance/Custom-xsl
Logic	Collects whatever tags are seen during a read event cycle from a given portal and performs the following logic: üResolves each tag to its mapped object attributes (Product, Asset, or Person) and pushes them in real time to the PEV display Client. üProcesses IMOVE rules is so specified in Binding properties and automatically transfers inventory from location A to Location B. Sends out email if IMOVE has [EMAIL] keyword anywhere in description. üSupports full GPIO script as a result of standard MATCH / NOMATCH/ NOTAG variables. üTriggers Camera support if so configured in the Physical Reader profile üSupports all Filter keywords (including RSSI, PRODTYPE, *ANTENNA) üSupports Binding Email Exceptions. Email notification is sent when an error is encountered. üSends out Tag Event data as listed below via an HTTP post to the user defined endpoint ❖Read Point attributes (Logical/Physical reader, antenna, RSSI, timestamp, etc.) ❖Base Item attributes ❖Asset attributes ❖Tag Mapping attributes ❖Tag Inventory attributes ❖UDA's (both Asset and Tag Inventory via UDA Group) ❖Parent/Child attributes ❖Employee attributes üThe chart below shows what attributes are sent in the XML payload üCan be used in RSSI zone configurations and supports system logging. üCombines features from RFDPEVG and RFDPOST üCan be run synchronously as an event binding or in Batch functions.
Restrictions
Comments	A video tutorial of setting up this binding is accessible from this link This binding can be tested with the EF Dynamic Tag Event test utility
Files Updated	RFDTAGVS
Program Name	URI set to RFDDTAG
Binding Setup
Binding Properties

	Email Notification
	The email address to send binding specific alerts. Note: This overrides the default SMTP Recipient value under System Settings

	UDA Grouping
	UDA's at both the Asset instance level and Tag Inventory level instance can be included in the Dynamic XML by grouping them in a UDA Group Name

	Dwell Time
	Dwell time prevents the tag from being included in the web service request when seen again at the same gate when vehicle dwells there. Refer to the the Binding Change for detailed explanations of this directive.

	IMOVE Rules
	These directives specify the name and location of the XML. Refer to the the Binding Change for detailed explanations of each directive.

	Data Layout & Style Sheets
	This section specifies the content type (XML today with JSON in future), the Data layout, and the style sheet names that have been edited to included your specific attributes. Note that these style sheets are for the individual tag transaction payloads as denoted by the *TAGLIST Data Layout selection.

Binding Properties

Shown below are the required binding properties and descriptions that should be included in the event:

Field	Status	Description	Sample Data
Ip Address	Existing	The endpoint IP	https://myapp.com
URI	Existing	The binding name and endpoint url	RFDXSL-/rfidendpoint
Email Recipient	Existing	Will send error emails to this address	user@myapp.com
UDA Grouping	Existing	Allows the user to define UDA attributes to send	PART_GROUP
Dwell	Existing	The dwell time in minutes	1
Dwell Option	Existing	LOCATION or GLOBAL	GLOBAL
IMOVE Rules	Existing	YES/NO/RESULTSET if IMOVE rules are enabled	YES
Move Children	Existing	YES/NO if child tags are moved	NO
Log Result Set	Existing	YES/NO if result set enabled	NO
Content Type	New	Specifies the HTTP POST content type	Application/xml
XSL Location	New	The location of the XSL file	C:\TagNet\rfid.xsl
XSL UDA Location	New	The location of the UDA XSL file	C:\TagNet\uda.xsl

Data Fields

Field	Description
LocationID	Logical Reader Name
ReaderID	Physical Reader Name
Antenna	Antenna Name
RSSI	RSSI Value (if enabled)
Binding	The name of binding executed
RFDTGMAP	All tag mapping fields from RFDTGMAP for the tag scanned
UCCRCIM	All Product Master fields for the item linked with the tag
RFDASSM	All Asset data linked with the tag
RFDLOCIN	All Location data linked with the tag
RFDLOCEX	UDAs based on the groupings
RFDASSEX	UDAs based on the groupings
RFDLOCIA	Any child tags
RFDPHLOG	Additional log data (sequence, timestamps, etc.)

Shown below are the configuration Style Sheets and resulting XML transaction sets:

Group

XSL Stylesheets

dynamic-taglist.xsl

<?xml version="1.0" encoding="UTF-8"?>

<xsl:transform version="1.0" exclude-result-prefixes="rdml" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:rdml="http://www.lansa.com/2000/XML/Function" xmlns:xalan="http://xml.apache.org/xslt">

<xsl:output method="xml" omit-xml-declaration="no" indent="yes" xalan:indent-amount="4"/>

<xsl:template match="/">

<Tags>

<rdml:fragment name="TAGLISTDETAILS" />

</Tags>

</TagNotification>

</xsl:template>

</xsl:transform>

dynamic-taglist-

details.xsl

<xsl:output method="xml" omit-xml-declaration="no" indent="yes" xalan:indent-amount="4"/>

<xsl:template match="/">

<Tag>

<rdml:fragment name="TAGLISTATTRIBUTES" />

</Attributes>

<rdml:fragment name="TAGLISTCHILDREN" />

</Children>

</Tag>

</xsl:template>

</xsl:transform>

dynamic-taglist- attributes.xsl

<xsl:output method="xml" omit-xml-declaration="yes" indent="yes" xalan:indent-amount="4"/>

<xsl:template match="/">

<Element Value="{/rdml:function/rdml:fields/rdml:field[@name='RFDEUXVAL']/@value}"

Description="{/rdml:function/rdml:fields/rdml:field[@name='RFDEUDESC']/@value}"

Name="{/rdml:function/rdml:fields/rdml:field[@name='RFDEUELEM']/@value}"/>

</xsl:template>

</xsl:transform>

dynamic-taglist-

children.xsl

<xsl:output method="xml" omit-xml-declaration="yes" indent="yes" xalan:indent-amount="4"/>

<xsl:template match="/">

</xsl:template>

</xsl:transform>

Generated XML sent to HTTP endpoint

Action

XML Schema

Multi-tag list XML

<?xml version="1.0" encoding="UTF-8"?>

<EventBindingID>DYNAMIC_TAG_LIST</EventBindingID>

<LocationID>SERVICE-GROUP</LocationID>

<Tags>

<Tag>

<Object>ASSET</Object>

<ContainerID>GROUPID</ContainerID>

<ItemName>Hand Drill</ItemName>

<BrandName>Dewalt</BrandName>

<Description>18 V Drill, with re-chargeable battery</Description>

<Image>drill.jpg</Image>

<InventoryType>ASSET TRACKING</InventoryType>

<Level1>LOCKER</Level1>

</Attributes>

</Children>

</Tag>

<Tag>

<Object>ASSET</Object>

<Comment>Accounting Dept</Comment>

<ItemName>Color Printer</ItemName>

<Description>HP Laserjet Color Printer</Description>

<InventoryType>ASSET TRACKING</InventoryType>

</Attributes>

</Tag>

</Tags>

</TagNotification>

XML Response

Endpoint sends back an HTTP 200 response