Some components (at present, EmailReceiver and RSSClient) embed information into messages that they produce specifying the order in which fields in these messages should be displayed, on small displays, and on large displays. For example, EmailReceiver might specify that, on a small display, the from and the subject fields of the any message should be displayed before any others.
If SmallDisplayStringExtractor is used with such messages, then no configuration is required. The relevant fields will be extracted from any message placed on property message, and will then be placed on properties lineOneText and lineTwoText. Users can override this process by setting acceptKeyOrderingFromMessage to false, and by specifying the names of fields that should be extracted through properties lineOneKey and lineTwoKey. If a message is supplied which does not define key ordering information, then these properties can also be used to specify which fields should be extracted from the message.