
Crestron e-control Database Manager SW-DBM
65 •• Appendices Installation & Reference Guide — DOC. 5823
DataFilter scroller signal
Description
Direction
System to Server
Type
Analog
Value
A bit pattern
Expected Reply
Comments
The bits in the pattern refer to the fields listed in the datafields field of the
Queries table. There is a one-to-one correspondence between the bits in the
pattern and the fields in the opened record. Bit 0 corresponds to the first field listed,
bit 1 to the second, etc. When a bit is set, the field is transmitted.
The bit pattern has an initial value specified as part of the scroller definition; it can
also be set at run-time using the DataFilter (analog) signal. The initial value is
shown in the Scroller Signal Block Definition window in hexadecimal. Note that the
default for this initial value is $FFFF (all bits set = all fields sent).
The bit pattern contains only 16 bits. Therefore only the first 16 data fields are
filterable. Any additional listed fields are always sent.
Data are transmitted using the Data signal with a number equal to the position of
the field in the list in the datafields field of the Queries table.
Example 1: Assume there are four fields listed in datafields. If the first and third fields
are filtered out (value set with DataFilter = $FFFA), the second and fourth fields are
transmitted via signals Data2 and Data4.
All Data signals in a successive query are subject to filtering, including those
signals used to echo the list fields.
Example 2: Consider Example 2 in the entry for the Data signal. To filter out extra list
field columns from being echoed, as well as any echoes from the last list at all, and
to echo only the second field listed in datafields, set the filter to $83. With this setting
only the following signals are sent: The contents of the first picked record’s list field
echoed via Data1; the contents of the first (of three) columns (only) of the second
picked record’s list fields via Data2; nothing of the third picked record’s list fields, but
upon the third touch, the second (of three) data fields via Data8.
Note that regardless of the number of fields listed and the current value of the data
filter bit pattern, only the first n signals can ever be transmitted, where n is the
number of Data signals defined.
If Renumber fields is checked in the Scroller Signal Block Definition window, the
fields remaining after the filter is applied are renumbered consecutively.
Example 3: Consider again Example 1, above. If the (proposed) “compress” option is
checked, the data would instead be transmitted via the first two Data signals, namely
Data1 and Data2.
Example 4: Consider again Example 2, above. Instead of responding with Data1,
Data2, and Data8, the server would respond with Data1, Data2, and Data3.
Note however that the Renumber fields checkbox remains unimplemented in the
present release.
See Also Data signal
See “Bit Patterns,” page 54
Commenti su questo manuale