Setting a Polling Group within AssetWorX allows users to define set data polling characteristics that can be connected to individual assets (either Equipment or Equipment Classes).
To Add a Polling Group
Expand your AssetWorX database ( localhost > [the name of your AssetWorX database. In our examples, we've named it 'AssetWorX'] > System properties) to show the 'Polling groups' branch.
Right-click on the 'Polling groups' branch and select 'Add PollingGroup' OR select the Polling Groups branch in the asset tree and then, once the contextual ribbon changes to the items relevant to your item selection, click on the 'Add Polling group' button in the Edit section of the Home ribbon. Both methods are highlighted in the image below.
'Add PollingGroup' in AssetWorX
This will open a [NewPollingGroup] tab in the right-side window of the Workbench, as well as a placeholder in the top right items list. This items list shows any sub-items connected to an asset, as well as any of its connected properties. Give your polling group a name and description (We have called our example 'Polling Group Alpha').
Polling Group Properties in AssetWorX
The following options can be set for the polling group:
Scan rate - When the Property is a normal Dynamic Tag, the scan rate is not specified by the configuration. It is specified by the client that connects to the Property. Until a client requests a Property, it is not on scan. When the polling mechanism subscribes (for a brief period) to the polled tag, it will use this Scan Rate. It has not much effect though, as the polling mechanism unsubscribes shortly after receiving the first update. Set in milliseconds.
Read timeout - How long the polling mechanism waits to get the first (good) value from the input source. Set in milliseconds.
Group splitting - The polling mechanism will subscribe, at a maximum, to this many tags at once, even if more Asset Catalog Properties are in the same polling group.
Recurrence type - The pulldown menu allows you to set the period of recurrence. The options include One time only, Time interval and Specific dates and times. The remainder of the Polling Group properties changes based on what Recurrent type you select.
One time only - Once you set the pulldown menu to 'One time only', you'll be able to enter the specific date and time in the 'Trigger at:' field directly or via the calendar tool (by clicking on the button). Clicking on the button brings up the calendar tool as shown in the image below. Select your date in the left side and the time in the time in the right side, then click on 'Close' to return to the main Polling Group properties screen.
'One time only' Settings
Time interval - Once you set the pulldown menu to 'Interval', you'll be able to enter the specific date and time in the 'Trigger at:' field directly or via the calendar tool (by clicking on the button), similar to the 'One time only' selection above. You will also be able to set the recurrence period by filling in the 'Recur every:' field. [NOTE: The format of the ‘Recur every’ field is: Day.Hour:Min:Seconds.] Highlight any portion of the time and you can use the up and down arrows to edit in increments.
'Time interval' Settings
Specific dates and times - Once you set the pulldown menu to 'Specific dates and times', you'll be able Once you set the pulldown menu to 'One time only', you'll be able to enter a specific date and time in the 'Starting at:' field directly or via the calendar tool (by clicking on the button), similar to the 'One time only' selection above.
'Specific dates and times' Settings
The remainder of the Polling Group properties changes based on what you select within the 'Recur every:' field. The pulldown allows you to select either Seconds, Minutes, Hours, Days, Weeks, Months or Years.
Seconds - Enter your desired number of seconds.
Minutes - Enter your desired number of minutes. OR you can click on the 'Pick specific times' checkbox to enter an additional number of seconds, as shown below.
OR, click on the ellipsis button [...] to open the 'Multi selection' window, where you can either click the checkbox next to each second you wish to use or click on the 'Select every ... second(s)' checkbox and enter a range in the text entry field.
Hours - Enter your desired number of hours. OR you can click on the 'Pick specific times' checkbox to enter an additional number of minutes and/or seconds, as shown below.
OR, click on the ellipsis button [...] to the right of the Minutes text entry field to open the 'Multi selection' window, where you can either click the checkbox next to each minute you wish to use or click on the 'Select every ... minute(s)' checkbox and enter a range in the text entry field.
You can also click on the ellipsis button [...] to the right of the Seconds text entry field to open an additional 'Multi selection' window, where you can either click the checkbox next to each second you wish to use or click on the 'Select every ... second(s)' checkbox and enter a range in the text entry field.
Days - Enter your desired number of days. OR you can click on the 'Pick specific times' checkbox to enter an additional number of hours and/or minutes and/or seconds, as shown below.
OR, click on the ellipsis button [...] to the right of the Hours text entry field to open the 'Multi selection' window, where you can either click the checkbox next to each hour you wish to use or click on the 'Select every ... minute(s)' checkbox and enter a range in the text entry field.
You can also click on the ellipsis button [...] to the right of the Minutes text entry field to open an additional 'Multi selection' window, where you can either click the checkbox next to each minute you wish to use or click on the 'Select every ... minutes(s)' checkbox and enter a range in the text entry field.
You can also click on the ellipsis button [...] to the right of the Seconds text entry field to open an additional 'Multi selection' window, where you can either click the checkbox next to each second you wish to use or click on the 'Select every ... second(s)' checkbox and enter a range in the text entry field.
Weeks - Enter your desired number of weeks. You can also set the day of the week for the recurrence. OR you can click on the 'Pick specific times' checkbox to enter an additional number of hours and/or minutes and/or seconds, as shown below.
You can click on the ellipsis button [...] to the right of the Hours text entry field to open the 'Multi selection' window, where you can either click the checkbox next to each hour you wish to use or click on the 'Select every ... minute(s)' checkbox and enter a range in the text entry field.
You can also click on the ellipsis button [...] to the right of the Minutes text entry field to open an additional 'Multi selection' window, where you can either click the checkbox next to each minute you wish to use or click on the 'Select every ... minutes(s)' checkbox and enter a range in the text entry field.
You can also click on the ellipsis button [...] to the right of the Seconds text entry field to open an additional 'Multi selection' window, where you can either click the checkbox next to each second you wish to use or click on the 'Select every ... second(s)' checkbox and enter a range in the text entry field.
Months - Enter your desired number of months.
If you click on the 'Day' radio button, you can also enter a specific number of days in the text entry field. If you click on the ellipsis to the right of the Day text entry field, this will open the 'Multi selection' window, where you can either click the checkbox next to each day you wish to use or click on the 'Select every ... day(s)' checkbox and enter a range in the text entry field.
If you click on the 'The' radio button, you can click on the ellipsis to the right of the first text box, which will open the 'Multi selection' window, where you can choose the order of the specific day (e.g. first, second, third, fourth, last).
If you click on the ellipsis to the right of the second text box, this will open the 'Multi selection' window, where you can select a day of the week (e.g. Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday, Week day, Weekend day).
OR you can click on the 'Pick specific times' checkbox to enter an additional number of hours and/or minutes and/or seconds, as shown below.
You can click on the ellipsis button [...] to the right of the Hours text entry field to open the 'Multi selection' window, where you can either click the checkbox next to each hour you wish to use or click on the 'Select every ... minute(s)' checkbox and enter a range in the text entry field.
You can also click on the ellipsis button [...] to the right of the Minutes text entry field to open an additional 'Multi selection' window, where you can either click the checkbox next to each minute you wish to use or click on the 'Select every ... minutes(s)' checkbox and enter a range in the text entry field.
You can also click on the ellipsis button [...] to the right of the Seconds text entry field to open an additional 'Multi selection' window, where you can either click the checkbox next to each second you wish to use or click on the 'Select every ... second(s)' checkbox and enter a range in the text entry field.
Years - Enter your desired number of years.
You can enter a month within the 'Every' text entry field. Clicking on the ellipsis button to the right of the 'Every' text entry field will open the 'Multi selection' window, where you can either click on the checkbox next to each month you wish to use or click on the 'Select every ... month(s)' checkox and enter a range in the text entry field.
If you click on the 'Day' radio button, you can also enter a specific number of days in the text entry field. If you click on the ellipsis to the right of the Day text entry field, this will open the 'Multi selection' window, where you can either click the checkbox next to each day you wish to use or click on the 'Select every ... day(s)' checkbox and enter a range in the text entry field.
If you click on the 'The' radio button, you can click on the ellipsis to the right of the first text box, which will open the 'Multi selection' window, where you can choose the order of the specific day (e.g. first, second, third, fourth, last).
If you click on the ellipsis to the right of the second text box, this will open the 'Multi selection' window, where you can select a day of the week (e.g. Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday, Week day, Weekend day).
OR you can click on the 'Pick specific times' checkbox to enter an additional number of hours and/or minutes and/or seconds, as shown below.
You can click on the ellipsis button [...] to the right of the Hours text entry field to open the 'Multi selection' window, where you can either click the checkbox next to each hour you wish to use or click on the 'Select every ... minute(s)' checkbox and enter a range in the text entry field.
You can also click on the ellipsis button [...] to the right of the Minutes text entry field to open an additional 'Multi selection' window, where you can either click the checkbox next to each minute you wish to use or click on the 'Select every ... minutes(s)' checkbox and enter a range in the text entry field.
You can also click on the ellipsis button [...] to the right of the Seconds text entry field to open an additional 'Multi selection' window, where you can either click the checkbox next to each second you wish to use or click on the 'Select every ... second(s)' checkbox and enter a range in the text entry field.
Preview - Once you have set your Polling Group parameters, you can click on the 'Preview' button (highlighted below) to see how the polling will take place according to your settings.
Polling Group Properties
The 'Recurrence preview' window will open. You can click on the calendar button () to the right of the 'Show occurrences after:' field to select a new date and time.
Recurrence preview
Recurrences preview with Calendar Selection Tool
Click on 'Close' to close the calendar selection tool and 'Close' again to close the Recurrence preview and return to the Polling Group properties window.
Click on 'Apply & Close' to save the Polling Group property settings and return to the main the Workbench screen.
See Also:
Properties Tab for Equipment Classes