Data Trigger

[This is preliminary documentation and subject to change.]

Data triggers indicate that data, such as an HTML enhancement file, is about to be transmitted. They are formatted as shown following

"1 [<protocol>] ConnectionInformation"

where

protocol

Optional parameter that specifies the data transfer protocol. The default is FTS. The following table lists the currently-defined protocols:

Protocol	Description
FTS	Downloads a file using Microsoft® File Transfer Service.
CAB	Unpacks the specified cabinet file.

ConnectionInformation

Connection information. The format of this string depends on which protocol is used. For more information, see the remarks section.

Remarks

If the protocol is FTS, ConnectionInformation has the following format:

xxx.xxx.xxx.xxx:yyyy&dirname[&timeout]

where

xxx.xxx.xxx.xxx

IP address that the FTS data will be transmitted on.

yyyy

IP port.

dirname

Directory name in which the transmitted files should be saved. Note that this value cannot contain subdirectories. For example, "msnbc" is a valid value for dirname, but "msnbc\MyShow" is not.

To store a transmitted file in a subdirectory of dirname, specify the subdirectory when the file is transmitted.

timeout

Optional parameter that specifies a time-out interval, in minutes. After Timeout minutes have elapsed, the subdirectory is deleted. The default value is 120 minutes.

CAB:

If the protocol is CAB, ConnectionInformation is a Broadcast Architecture URL that specifies the cabinet file to unpack. For example: "bpc://msnbc/myshow/cabfile.cab"

Examples

Both of the following triggers cause the enhancement control to receive a file at IP address 233.43.170.18, port 1718.

"1 233.43.170.18:1718&MyShow"
"1 <FTS> 233.43.170.18:1718&MyShow"
 

The following trigger causes the enhancement control to unpack the cabinet file located at: "C:\Program Files\TV Viewer\Interactive Content\<random>\Msnbc\MyShow\MyFile.cab"

"1 <CAB> bpc://msnbc/myshow/myfile.cab"
 

where <random> is a random string generated by the broadcast client. Adding a random string to the file path improves security on the client by ensuring that enhancement files can only be located using the Broadcast Architecture URL format and thus processed using the Internet Security Zone settings.