We should probably update the action description to provide more examples. Sorry about that.
The map is actually an SQLite table, so if you look online for SQLite documentation it should help (in combo with my response here).
Here are 3 different commands to give you an idea of things you can do with the
Map.Query action.
<?xml version="1.0" encoding="utf-16"?>
<!--VoxCommando 2.2.3.8-->
<commandGroup open="True" name="Sample sqLite queries for Map Tables" enabled="True" prefix="" priority="0" requiredProcess="" description="">
<command id="280" name="Select * from Map Table" enabled="true" alwaysOn="False" confirm="False" requiredConfidence="0" loop="False" loopDelay="0" loopMax="0" description="Each map row is a returned as a match.">
<action>
<cmdType>Map.Query</cmdType>
<params>
<param>Select * from YourTableName</param>
</params>
<cmdRepeat>1</cmdRepeat>
</action>
<action>
<cmdType>OSD.ShowText</cmdType>
<params>
<param>fromKey --> toValue</param>
</params>
<cmdRepeat>1</cmdRepeat>
</action>
<action>
<cmdType>OSD.AddText</cmdType>
<params>
<param>{Match.{i}.1} --> {Match.{i}.2}</param>
</params>
<cmdRepeat>{#M}</cmdRepeat>
</action>
</command>
<command id="268" name="Get all Keys in Map Table" enabled="true" alwaysOn="False" confirm="False" requiredConfidence="0" loop="False" loopDelay="0" loopMax="0" description="If you want all values, Select toValue from YourTableName.">
<action>
<cmdType>Map.Query</cmdType>
<params>
<param>Select fromKEY from YourTableName</param>
</params>
<cmdRepeat>1</cmdRepeat>
</action>
<action>
<cmdType>OSD.AddText</cmdType>
<params>
<param>{Match.{i}}</param>
</params>
<cmdRepeat>{#M}</cmdRepeat>
</action>
<phrase>Get all Keys in Map Table</phrase>
</command>
<command id="278" name="Limit Map query to first row" enabled="true" alwaysOn="False" confirm="False" requiredConfidence="0" loop="False" loopDelay="0" loopMax="0" description="You can set the limit to whatever. Limit 3 would return top 3 rows. etc. Of course, you can also just use Match.1 without setting a limit in your query, but in that case the query is still returning all matches.">
<action>
<cmdType>Map.Query</cmdType>
<params>
<param>Select * from YourTableName LIMIT 1</param>
</params>
<cmdRepeat>1</cmdRepeat>
</action>
<action>
<cmdType>OSD.ShowText</cmdType>
<params>
<param>{Match.1}</param>
</params>
<cmdRepeat>1</cmdRepeat>
</action>
<action>
<cmdType>OSD.AddText</cmdType>
<params>
<param>{Match.1.1} : {Match.1.2}</param>
</params>
<cmdRepeat>1</cmdRepeat>
</action>
<phrase>Limit Map query to first row</phrase>
</command>
</commandGroup>
If you have follow-up questions let me know. ... Or James may post more info later when he has time.
[Edit: Updated xml for clarity]