Tigase now is able to support querying message archives based on tags created for the query. Currently, Tigase can support the following tags to help search through message archives:
- hashtag Words prefixed by a hash (#) are stored with a prefix and used as a tag, for example #Tigase
- mention Words prefixed by an at (@) are stored with a prefix and used as a tag, for example @Tigase
NOTE: Tags must be written in messages from users, they do not act as wildcards. To search for #Tigase, a message must have #Tigase in the <body> element.
This feature allows users to query and retrieve messages or collections from the archive that only contain one or more tags.
To enable this feature, the following line must be in the config.tdsl file (or may be added with Admin or Web UI)
'message-archive' (class: tigase.archive.MessageArchiveComponent) {
'tags-support' = true
}To execute a request, the tags must be individual children elements of the retrieve or list element like the following request:
<query xmlns="http://tigase.org/protocol/archive#query">
<tag>#People</tag>
<tag>@User1</tag>
</query>You may also specify specific senders, and limit the time and date that you wish to search through to keep the resulting list smaller. That can be accomplished by adding more fields to the retrieve element such as 'with', 'from’, and ’end' . Take a look at the below example:
<iq type="get" id="query2">
<retrieve xmlns='urn:xmpp:archive'
with='juliet@capulet.com'
from='2014-01-01T00:00:00Z'
end='2014-05-01T00:00:00Z'>
<query xmlns="http://tigase.org/protocol/archive#query">
<tag>#People</tag>
<tag>@User1</tag>
</query>
</retrieve>
</iq>This stanza is requesting to retrieve messages tagged with @User1 and #people from chats with the user juliet@capulet.com between January 1st, 2014 at 00:00 to May 1st, 2014 at 00:00.
NOTE: All times are in Zulu or GMT on a 24h clock.
You can add as many tags as you wish, but each one is an AND statement; so the more tags you include, the smaller the results.