Dise Parser Modifiers

From DISE KnowledgeBase

Jump to: navigation, search

Contents

About

File:ParserModifiers.png

Modifiers

There are several different modifiers in Dise Parser, all described below. Some will take input and based on the settings they will do changes and output the result, for the next modifier to use. Some will just do output and some will just take input. Some modifiers will do their processing based on XML tag that has been added to the input earlier.

General

Command modifier

Function

Will process the input data looking for some supported tags.

Has the following functions:

  • Copy file
  • Download file
  • Remove file(s)
  • Delay (wait) for a number of seconds.
  • Replace
    tags a specified text.

XML tag support

CopyFile

Copy a file from one location to another
Parameters
src
Filename of the source file
dst
Filename of the destination file
srcprefix
Will prefix the source file
dstprefix
Will prefix the destination file
overwrite
Skip copying if the file already exists. (0 for false and 1 for true.)

Lightbulb.png Note: If the file content of the source file is the same as in the destination file, then the file will not be replaced.

Example.png Example:

<CopyFile srcprefix="C:\Data\" src="file1.jpg" dstprefix="C:\Content\" 
          dst="newsimage1.jpg" overwrite="0">

DownloadFile

Download a file from an URL
Parameters
src
URL of the source
dst
Filename of the destination file
srcprefix
Will prefix the source URL
dstprefix
Will prefix the destination file

Lightbulb.png Note: If the content of the source URL is the same as in the destination file, then the file will not be replaced.

Example.png Example:

<DownloadFile srcprefix="http://news.source.com/getnewsimage.php?newsid=" 
              src="1" dstprefix="C:\Content\" dst="newsimage1.jpg">

RemoveFile

Remove a specified file
Parameters
target
Filename of the file to remove

Example.png Example:

<RemoveFile target="C:\Data\oldimage.jpg">

Delay

Wait for a number of seconds
Parameters
ms
Number of milliseconds to wait

Example.png Example:

<Delay ms=500>

Settings

File:Commandsettings.png

Command settings

Replace <br /> tags with

Specify if <br /> tags in the input data should be replaced and what it should be replaced with.

Execute file modifier

Function

Run a executable file or batch script with or without parameters.

Settings

File:DPFileExecuteModifier.png

File Execute Settings Window

Filename

The file to execute

Parameters

The parameters to pass to the executable file

Check exit code

If the exit code is checked then the modifer will fail of the exit code is not a success.

Output process text

Will take the output (stdout) and use as the output of this modifier

Output process errors

Will take the errors (stderr) and use as the output of this modifier

Log process text

Will take the output (stdout) and display it in the parser log

Log process errors

Will take the errors (stderr) and display it in the parser log

File read/write modifier

Function

Use a text file for input or output.

Support for UTF-8 and most code pages.

XML tag support

ChangeOutputFile

Change the file used as output, enables writing to several different files with one modifier. Also enables you to set the output file dynamically.
Parameters:
dst
The output filename to use for all text after this command.

Example.png Example:

<ChangeOutputFile dst="New_output_file.txt">

Settings

File:FileReadWriteSerttings.png

File Read/Write Settings Window

Mode

Select if the modifier should read from or write to the specified file.

Filename

Filename to use'

Code page

Code page used for writing the text, if you have unicode text you will need to use UTF-8 or the code page used in your region to be able to save the text correctly.

Only update if content is different

Will check if the content is different before writing the file, prevents file date and time being updated without any content changes.

Remove whitespace from beginning/end of text

Will remove whitespace (space, tab, row break) from the beginning and end of the text (both when on read and write).

Monitor input file for changes

Will only read the file if a change is detected. This only works if this modifier is used as the first node in a tree. If no change is detected it will not continue processing the rest of the modifiers in the tree.

Keyboard modifier

Function

Listens to keyboard events, allowing Dise Parser to react to user-triggered events, similar to Dise Keyboard Control. The output from this modifier will be in XML looking like below:

Example.png Example:

<Keyboard>
  <Key Code="49">stop</Key>
</Keyboard>

Settings

File:DiseKeyboardControl2KeyboardSettings.png

Keyboard Settings Window

Key list

List of key listeners and their associated messages.

Add/Edit

Add/edit a key listener by opening the Edit key dialog.

Remove

Remove the selected key listener.

Edit key dialog

Key

Focus the press key field and press the key to use.

Key code

Manually enter the key code.

Select

Select from a drop-down list of keys made available by Windows.

Associated data

What network message to send on key presses.

ODBC modifier

Function

Fetch data from a database or other ODBC source.

The output from this modifier will be in XML looking like below:

Example.png Example:

<ODBC>
  <Row>
    <Column1>Data of column 1</Column1>
    <Column2>Data of column 2</Column2>
    ...
  </Row>
  ...
</ODBC>

This XML data can the be easily processed into text.

Should work with all ODBC compatible data sources, but has been tested successfully with:

Lightbulb.png Note: Make sure you have the ODBC drivers installed on the machine for the source you are attempting to connect to.

Lightbulb.png Note: If you are using 64-bit windows, since Dise Parser is a 32-bit application you will need to run the 32-bit ODBC administration to setup a DSN, located at C:\Windows\SysWOW64\odbcad32.exe.

Lightbulb.png Note: Running Dise Parser as a service requires the DSN be setup as a System DSN, not User DSN.

Settings

File:ODBCsettings.png

ODBC Settings Window

Connection string

The DSN string used to do the connection, click on Edit to change the setup of the connection or to create a new one.

Excrypt connection string

Some DSN strings might contain password and other sensitive data, checking this option will encrypt the string when saving to disk and it will not be visible in the ODBC settings dialog. Remember however that the string will be decrypted when you click Edit and the setup dialog might display your password depending on database type.

Statement

The SQL query to send to the database.

Use name of column in output

If checked the output will contain the names of the columns instead of Column1,Column2,etc.

Script modifier

Function

Use the Windows Script Host to execute scripts.

Can execute VBScript (Visual Basic Script) or Java Script natively, but addons for Perl, Python, PHP and many other languages exist. Supports both input and output data from the scripts, that means that you can put all the data processing in a simple Java Script.

A Script to enable fetching of data from SOAP is included in the installation, read more in the SOAP Example.

How to write a script

Here is a very simple script showing the use of the different functions that exists in the script modifier host. The script will cancel if there are no data in the input, and otherwise it will add two XML tags that then can be handled in modifiers that exist later in the tree.

The #pragma in the beginning is also important, as it will setup what scripting language that the file contains.

The script modifer host (DPModifier) contains the following functions:

Log(string logString)

Log the following text to the parser output.

string GetInput()

Get the input for this modifier

SetOutput(string outputText)

Set the output for this modifier

CancelProcessing

Will cancel processing of modifiers in this tree when the script returns, anything set by the SetOuput function will not be used.

Example.png Example:

#pragma language JScript
 
function DoSomething()
{
  var input;
  var output;
 
  input = DPModifier.GetInput();
  if (input=="")
  {
    DPModifier.Log("Script: No input"); 
    DPModifier.CancelProcessing();
  }
  else
  {
    output = "<udp-multicast action=\"send\" data=\"";
    output += input;
    output += "\">";
    output += "<delay ms=\"5000\">";
    DPModifier.SetOutput(output);
}
 
DoSomething();

It is also possible to include other script files using #include "file.js" anywhere in the file (included files need to be in the same scripting language as the main one).

Settings

File:ScriptSettings.png

Script Settings Window

Filename

The file containing the script to execute.

Serial port (RS232) modifier

Function

This modifier can receive data from the serial (RS232) port. The serial port will be monitored and if used as the root modifier in a tree it will not allow further processing unless data has been received. This means that you can set the run interval of the modifier tree to a low value and then get a very quick response time.


The output from this modifier will be in XML looking like below:

Example.png Example:

<Serial Text="This is your modem speaking">

Example.png Example:

<Serial Hex="5468697320697320796f7572206d6f64656d20737065616b696e67">


Settings

File:DPSerialModifier.png

Serial (RS232) Settings Window

Serial port and settings

The serial port and its configuration to use to communicate.

Receive data

Read data from the serial port. The run interval of the modifier determines how often the serial port will be scanned for data.

Only open port (for use in script)

Do not read data immediately but instead lets you contact the serial port in child script modifiers.

Get data in Hex format

Specifies that the return data will use hex output instead of normal string data, this is useful if the data contains binary information.

Get data in XML format

Specifies that the return data will be wrapped in an XML tag.

Set RTS state on init

Set the RTS (Request To Send) pin on the RS232 port when starting the modifier.

Set DTR state on init

Set the DTR (Data Terminal Ready) pin on the RS232 port when starting the modifier.

Text process modifier

Function

The text processing modifier can remove XML tags and invalid characters, sort your data and process entities.

Settings

File:TextProcess.png

Text Process Settings Window

Entities

Specify how entities should be dealt with
Make entities XML compatible
Convert all incorrectly specified "&" characters to "&". This will ignore all characters inside a CDATA area
Process entities
Reverse the process above, convert all entities to unicode characters.

Remove XML Tags

Will remove all XML tags in the input data.

Remove invalid characters

Will remove all characters in the input data that has the value between (and including) 14 and 31. These characters are normally not visible and are used as control characters, seems that some apple text editors can add these characters.

Remove duplicate lines.

Will remove all duplicate lines, and just leave one copy.

Sort lines

'All lines in the input will be sorted in the way specified.

Case sensitive

Specify if sort and duplicate removal will be case sensitive.

Parse macros

Will detect and convert text macros in the input.

Text modifier

Function

The text modifier lets you specify a section of text to send to the next modifier.

Settings

File:TextSettings.png

Text settings window

Parse macros

Will detect and convert text macros in the text.

Insert macro

Lets you insert a text macro in the text.

Xsl modifier

Function

Use XSL (eXtensible Stylesheet Language) to process XML data into XML or text output.

Info.png Read more: XSLT Tutorial

Scripts for parsing ODBC modifier database output (example here), RSS Feeds (example here), yr.no weather and serial port data are included with the installation.

It is possible to do a lot of things from an XSL script, for example run Java- or VBscript. See the RSS xsl for an example of this.

Settings

File:XSL_settings.png

XSL Settings Window

Filename

Filename of the XSL script

Hardware sensors

AOpen modifier

Function

Will use the AOpen Hardware Monitor to collect data from the hardware, only works for AOpen motherboards with Hardware Monitor support.

The output from this modifier will be in XML looking like below:

Example.png Example:

<AOpen>
  <FanSpeed1 Unit="RPM">4350</FanSpeed1>
  <FanSpeed2 Unit="RPM">2032</FanSpeed2>
  <FanSpeed3 Unit="RPM">550</FanSpeed3>
  <Temperature1 Unit="C">45</Temperature1>
  <Temperature2 Unit="C">49</Temperature2>
  <Temperature3 Unit="C">32</Temperature3>
</AOpen>

Settings

There are no settings for this modifier.

Core temp modifier

Function

Handle output from the Core Temp software. The output from this modifier will be in XML looking like below:

Example.png Example:

<CoreTemp>
  <CPUName>Mobile Intel Core 2 Duo T6600 (Penryn-3M)</CPUName>
  <CPUSpeed Unit="MHz">1196.95</CPUSpeed>
  <CPUVID Unit="v">0.92</CPUVID>
  <PhysicalCPUs>1</PhysicalCPUs>
  <CoresCPU>2</CoresCPU>
  <CPU>
    <TjMax Unit="C">90</TjMax>
    <Core>
      <Temp Unit="C">50</Temp>
      <Load Unit="%">17</Load>
    </Core>
    <Core>
      <Temp Unit="C">50</Temp>
      <Load Unit="%">18</Load>
    </Core>
  </CPU>
</CoreTemp>

Settings

There are no settings for the Core temp modifier.

IBase modifier

Function

Use the IBase Sensor SDK (v2.33) to collect data from the hardware, only works for IBase motherboards with Hardware Monitor support.

Using the IBase WDT/DIO SDK (v2.1.11) you can also get some system info and utilize the built in watch dog.

Without any specific parameters (below) the output from this modifier will be in XML looking like below:

Example.png Example:

<IBase>
  <SensorChip>Winbond 83782D</SensorChip>
  <VoltageCore Unit="V">12</VoltageCore>
  <VoltageIo Unit="V">5</VoltageIo>
  <Voltage5Positive Unit="V">+5</Voltage5Positive>
  <Voltage12Positive Unit="V">+12</Voltage12Positive>
  <Voltage5Negative Unit="V">-5</Voltage5Negative>
  <Voltage12Negative Unit="V">-12</Voltage12Negative>
  <Fan1 Unit="RPM">4350</Fan1>
  <Fan2 Unit="RPM">2032</Fan2>
  <SystemTemperature Unit="C">45</SystemTemperature>
  <CpuTemperature Unit="C">57</CpuTemperature>
</IBase>

XML tag support

IBase

Parameters
action
Can be stats, watchdog or sysinfo.
count
When the action is Watchdog, this is the amount of seconds/minutes needed between each watchdog call. Default is 5.

Example.png Example:

<IBase action="stats" /> 
<IBase action="watchdog" count=5 />
<IBase action="sysinfo" />

Listing files will have the following XML output:

Example.png Example:

<IBase>
  <Info>Chipset information</Info>
</IBase>

Settings

There are no settings for this modifier.

Network

File transfer modifier

Function

Download and upload files using several different protocols.

Supported protocols:

  • FTP
  • FTPS
  • HTTP
  • HTTPS
  • SFTP
  • SCP

XML tag support

FileTransfer

Parameters
alias
If the alias is set it will only be accepted with File Transfer modifiers that has that alias in the settings.
action
Can be upload, download or list.
  • Upload a file based on src and dst, where src is a local file and dst is a URI beginning with "ftp://", "http://" or similar.
  • Download a file based on src and dst, where src is a URI beginning with "ftp://", "http://" or similar and dst is a local file.
  • List files in the directory specified by src, output is in XML like below:
src
The source file or URI
dst
The destination file or URI
short
If set to "true" then only directories will be listed.

Example.png Example:

<FileTransfer action="upload" src="C:\Files\Test.mp3" dst="ftp://10.1.23.10/Test.mp3" /> 
<FileTransfer action="download" src="ftp://10.1.23.10/Test.mp3" dst="C:\Files\Test2.mp3" />
<FileTransfer action="list" src="ftp://10.1.23.10/" />

Listing files will have the following XML output:

Example.png Example:

<Files>
  <Dir Name="ADirectory" Size="0" Date="2009-08-10 11:11:11">
  <File Name="TheFile.txt" Size="1234" Date="2009-10-25 13:37:47">
</Files>

Settings

File:EditFileTransfer.png

Edit File Transfer Window

Alias

Used with the XML tags above so that you can use more than one File Transfer modifier at the same time. So if you write "upload" here, and then set alias="upload" as a parameter on the XML tag used this modifier will do the work.

Set username/password

Specify username and password to be used, you do not have to specify anything if you are running anonymous FTP or HTTP connections.

Create missing directories

Create the directory if it does not exist.

Set timeout values

Specify time out values. In seconds.

Use file upload database

When using a file upload database, uploaded files will be checked against a database containing the file size, modification date and time and MD5 checksum. If a file exists in the database and the values in the database is the same as the file it will not be uploaded. After a file has been uploaded it will be added to the database.

HTTP get modifier

Function

Easily download files from HTTP or HTTPS sources.

XML tag support

http

Parameters:
action
What HTTP verb to use for the request (GET or POST)
url
Where to send the request
parameters
Additional parameters to send with the request. The parameters are separated with a & character.

Example.png Example:

<http action="POST" url="http://devserver/form.php" parameters="category=document&type=spreadsheet" />

Settings

File:Http_Settings.png

Http Get Settings Window

URL

The URL to request.

Force use of the following codepage

Specifies that the request will use a certain codepage.

Info.png Read more: Code page - wikipedia.org

Use user authentication

If the web server requires user authentication by username & password, enter them here.

Use proxy

Specifies the address of a proxy server for requests, with optional username & password.

Ping (ICMP) modifier

Function

Send a ICMP ping to a server.

Network time (SNTP) modifier

Function

Sync the computer to atomic time from a SNTP (Simple Network Time Protocol) server.

There are no XML input tag support for this modifer, it will just sync the computer time if you run it.

Settings

File:DPSNTPModifer.png

Network Time settings Window

Time server

The SNTP server to use, see http://ntp.org/ for more servers

Timeout (ms)

The timeout in milliseconds

Send mail modifier

Function

Used to send e-mails.

If you specify the e-mail addresses in the settings dialog everything in the input to this modifier will be sent as an e-mail using those settings.

Otherwise you can leave those settings empty, and use an XML tag (as below) to send customized e-mails.

When specifying the e-mail in the settings dialog, it will always use "DiseParser" as the subject.

XML tag support

SendMail

Parameters
to
The recipient of the e-mail sent.
from
The e-mail address to show as the sender of the e-mail.
server'
The server to send the e-mail with.
port
The port on the SMTP server.
subject
Subject of the e-mail.

Example.png Example:

<SendMail to="support@displayevolution.com" from="admin@happygoluckytoys.com" server="smtpserver.local" 
          port="25" subject="DiseParser">
Hi there,
Here is an e-mail informing about the update.
Regards, Dise Parser.
</SendMail>

Settings

File:Send_Mail_Settings.png

Send Mail Settings Window

To address

The recipient of the e-mail sent.

From address

The e-mail address to show as the sender of the e-mail.

SMTP server

The server to send the e-mail with.

SMTP port

The port on the SMTP server.

Social media modifier

Function

Authenticate with and fetch information from social media services. The modifier generally requires you to login with a valid service account.

Settings

URL

The resource in the social media service to access:
  • Facebook
  • Twitter
  • Flickr
  • Photobucket

Service type

The social media service.

Account

The account to use to authenticate to the social media service.

TCP/UDP Socket modifier

Function

Receive or send data on UDP or TCP. Can be used to send data to Dise that that will control scheduling, data connections, sync, and so on.

Lightbulb.png Note: This modifier listens for connections on all active network cards.

When in receiving XML mode the output from this modifier will be in XML looking like below:

Example.png Example:

<UDP Received="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque arcu." ReceivedBase64="TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2NpbmcgZWxpdC4g
UXVpc3F1ZSBhcmN1Lg==">

This XML data can the be easily processed into text.

Settings

File:DPSocketModifier.png

TCP/UDP Settings Window

Host & Port

The Host and Port to connect to.

TCP / UDP

The protocol that should be used.

Send data

The data to be sent would be specified in the Send data box.
If only send mode is selected, the the modifier will listen on the specified port for incoming data and if used as the root modifier in a tree it will not allow further processing unless data has been received. This means that you can set the run interval of the modifier tree to a low value and then get a very quick response time.

Receive data

Connect to the host and wait for data to arrive, if combined with the send data option data will be sent first and then the modifier will wait for data to arrive.

Receive as XML

Received data will be presented as XML, otherwise the data will just be assigned as the output of this modifier.

Add Base64 encoded data to XML

Instead of just adding the received data as text to the XML, we can also get it as Base64 encoded data.

Keep connection open

The connection will be kept open from the first time the modifier runs until the end (or until it is disconnected). This option is recommended if we will wait for long times between receiving data.

UDP Multicast modifier

Function

Receive or send data on UDP Multicast. Can be used to receive data from Dise. Or to send that that will control scheduling, data connections, sync, and so on.

When in receiving mode the output from this modifier will be in XML looking like below:

Example.png Example:

<UdpData>
  <Message>
    <Base64Text>TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2NpbmcgZWxpdC4g
UXVpc3F1ZSBhcmN1Lg==</Base64Text>
    <Text>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque arcu.</Text>
  </Message>
</UdpData>

This XML data can the be easily processed into text.

Settings

File:UDPMulticastSettings.png

UDP Multicast Settings Window

Multicast address & Port

The multicast IP and Port to broadcast on.

Send data

When in sending mode the modifier will send the input data using multicast udp.

Receive data

When in reviewing mode the modifier will receive data from the multicast udp and output that as XML.

Prefix data

Used when in Send mode, will send this data before the input data, can include an header or similar.

Add Dise remote control header

Will add a Dise remote control header. Ex. "20091123160052|" before the data.

Add Base64 encoded data to XML

Instead of just adding the received data as text to the XML, we can also get it as Base64 encoded data.

Only parse tags

Will only send out information enclosed in tags (see below)

XML tag support

udp-multicast

Parameters
action
What to do (send or receive)
data
The text to send out via multicast

Example.png Example:

<udp-multicast action="send" data="hello world"/>

XMPP - Messaging modifier

Function

Settings

Tag Readers

Xtractor RFID reader modifier

Function

Receive RFID data from devices using the Xtractor AxtiveX system from Hong Kong RFID Ltd.

When in receiving mode the output from this modifier will be in XML looking like below:

Example.png Example:

<Xtractor>
  <ActiveTags>
    <Tag>100000000000000000000002</Tag>
  </ActiveTags>
</Xtractor>

Settings

File:XtractorSettings.png

Xtractor RFID reader Settings Window

Baud Rate

The baud rate used for the connection.

Port number

The COM port number used for the connection.

Reader

Denotes which connected reader to use.

TagType

Denotes the type or standard the tag belongs to.

Info.png Read more: ISO15693 - Wikipedia

Info.png Read more: ISO18000 - Wikipedia

Info.png Read more: TagIT - Tagit Inc.

Info.png Read more: EPC_GEN2 - Wikipedia

Tag valid for (seconds)

For how many seconds should the tag be kept in the cache, starting from the detection of the tag.

TUIO API modifier

Function

Retrieve data from reacTIVision, reading fiduciary marker information.

Info.png Read more: reacTIVision - sourceforge.net

Info.png Read more: Interactivity using fiducial markers

Output from this modifier will be in XML looking like below:

Example.png Example:

<TUIO>
  <ActiveObjects>
    <Object SymbolID="215" 
            SessionID="3" 
            X="0.927660465240478" 
            Y="0.707516849040985" 
            Angle="3.12536025047302" 
            MotionSpeed="0.0702865198254585" 
            RotationSpeed="0" 
            MotionAccel="-0.486240029335022" 
            RotationAccel="0"/>
  </ActiveObjects>
</TUIO>

Settings

None.

Special

Buttons modifier

Function

Renders a window with buttons for the user to click on, allowing Dise Parser to react to user-triggered events. The output from this modifier will be in XML looking like below:

Example.png Example:

<Buttons>
  <Button>start</Button>
</Buttons>

Settings

File:DiseKeyboardControl2ButtonSettings.png

Button Settings Window

Button list

List of button listeners and their associated messages.

Add/Edit

Add/edit a button listener by opening the Edit button dialog.

Remove

Remove the selected button listener.

Move up/down

Move the selected button listener up/down in the list (the top button will be rendered to the top left of the main window).
Edit button dialog

Caption

The button's text.

Associated data

What network message to send on button clicks.

Compression modifier

Function

Handle compressed files.

Currently supports extracting and listing the content of ZIP files.

XML tag support

Compression

Parameters
action
Can be open, extract or list
  • Open will just open the file you specify in the parameter file.
  • Extract will use the src, dst and setdate paramters.
  • List will just output a list of all files in the ZIP file into the output of the modifier
type
"zip" is currently the only supported type
file
For the open action you can specify a filename in the file parameter. Then that file will be used for all following extract tags until you pass a </Compression> tag. You can also specify a filename in each extract action and the you do not need to open or close.
src
A file or file mask of what file that should be extracted from the zip file.
dst
A file or directory where to extract file file(s) to.
setdate
To be used with extract, specify the date and time as: "YYYY-MM-DD HH:MM:SS".

Example.png Example:

<Compression action="open" type="zip" file="thezipfile.zip"> 
<Compression action="extract" type="zip" src="afile.txt" dst="T:\ZipTest\File.txt">
<Compression action="extract" type="zip" src="Subfolder/afile.txt" dst="T:\ZipTest\File.txt">
<Compression action="extract" type="zip" src="*.png" dst="T:\ZipTest\">
<Compression action="extract" type="zip" src="*" dst="T:\ZipTest\">
<Compression action="list" type="zip">
</Compression>

Example.png Example:

<Compression action="extract" type="zip" file="thezipfile.zip" src="afile.txt" dst="T:\ZipTest\File.txt">

List will output the following XML:

Example.png Example:

<Files>
  <File Name="thefile.txt" Size=123 CompressedSize=12 Compression="Zip">
  <File Name="afile.txt" Size=52546 CompressedSize=3234 Compression="Zip">
</Files>

Settings

There are no settings for the Compression modifier.

Q-Matic modifier

Function

This modifier can interface with the Customer Flow Management (queue number) systems from Q-Matic.

The output from this modifier will be in XML looking like below:

Example.png Example:

<QMatic>
  <Message>
    <TicketNumber>007</TicketNumber>
    <CashierNumber>01</CashierNumber>
    <ServiceType>1</ServiceType> 
  </Message>
</QMatic>

This XML data can the be easily processed into text using XSL, and then we can put it into a text file or send it directly to the player using UDP Multicast. Check out the QMatic.dpmodifiers sample and the QMatic.xsl / QMaticServiceType0.xsl file for more information.

Info.png Read more: Setting up QMatic with Dise

Settings

File:QMaticsettings.png

Q-Matic Settings Window

Serial port and settings

The serial port and its configuration to use to communicate with the Q-Matic hardware.

PC Power Management modifier

Function

Control the power of the Parser PC.

XML tag support

PCPower

Parameters
Action
  • Reboot will reboot the system.
  • Shutdown will shutdown the system.
  • Suspend will suspend the system.
  • Hibernate will hibernate the system.
  • MonitorStandby will put all the connected monitors in standby.
  • MonitorOn will turn all the connected monitors on.
  • MonitorOff will turn all the connected monitors off.
Force All non-monitor actions can be combined with the tag force, to force the system even if some other application is blocking the reboot or shutdown.
  • true
  • false
PowerOnAt Suspend and Hibernate can be combined with the poweronat tag to let the computer wake up from sleep at a set time.
  • time to wake up at, in hh:mm:ss format

Example.png Example:

<PCPower action="reboot" force=true>

Example.png Example:

<PCPower action="suspend" poweronat="07:15:00">

Settings

There are no settings for this modifier.

Volume modifier

Function

Control the Volume of the PC.

XML tag support

Volume

Parameters
action
Valid values: set, get
value
Only used on set, specify the wanted volume between 0.0 and 1.0

Example.png Example:

<Volume action="set" value=0.5>

Example.png Example:

<Volume action="get">


When you use the Get action the following XML will be the output:

Example.png Example:

<Volume>0.5</Volume>

Settings

There are no settings for this modifier.

Screen control modifier

Function

XML tag support

Settings

Exchange Web Services modifier

Function

XML tag support

exchange

Parameters
action
Valid values: calendar
mailbox
What mailbox to use, may be a different one than the one used to connect with.

Example.png Example:

<exchange action="calendar" mailbox="per@klocktornet.onmicrosoft.com"/>

Settings

Lync modifier

Function

XML tag support

Settings




All items on this website are copyright Klocktornet AB 2012, all rights reserved.
All trademarks are property of their respective owners.