Search Directory Services

4 February 2015

  • Release 7.62 - The directorysearch now returns the full list of matches based on the supplied criteria - the old behavior is that only the first most relevant (based on a scoring system) match would be returned. This means that the directorysearch command can now be used to return a list of matches instead of a single match. The results are still sorted in the order of relevant with most relevant being returned first. Since the results can now be rather large depending on the search criteria, it is recommended to use sifting to return only partial results.
  • Release 7.62 - The timeout parameter is no longer used.
directorysearch (Commands)
TypeCorrade progressive command
Commanddirectorysearch
DescriptionCorrade is able to search directory services for classifieds, events, groups, land, people and places.
Permissionsdirectory
Parametersgroup, password, type, name (The name parameter is optional for classified and event search type but required for all other search types.)
Last ChangesRelease 7.62 - now returns a full list of matches.

Corrade is able to search directory services for classifieds, events, groups, land, people and places.

Command Required Parameters Required Corrade Permissions Example
directorysearch group, password, type, name1) directory
llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            "command", "directorysearch",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "type", "event",
            "name", "hunt"
        ]
    )
);
Parameter Possible Values Description
type classified, event, group, land, people, places The directory search type.

The results can be filtered using the optional data parameter which follows the libopenmetaverse data structures of each search type. In order to do so, supply a CSV list to the data parameter containing pairs of fields or properties and the desired value.

Parameter Possible Values Optional Parameter Structure Example
type classified data Classified
llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            "command", "directorysearch",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "type", "classified",
            "name", "hunt",
            "timeout", 10000,
            "data", wasListToCSV(
                [
                    "Price",
                    73888
                ]
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);
name A string to search the name by.
event data Event Search Data
llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            "command", "directorysearch",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "type", "event",
            "name", "hunt",
            "timeout", 10000,
            "data", wasListToCSV(
                [
                    "Owner",
                    "fc785fe9-f15b-431d-9f2f-3104811095b"
                ]
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);
name A string to search the name by.
group data Group Search Data
llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            "command", "directorysearch",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "type", "group",
            "name", "Wizardry",
            "timeout", 10000,
            "data", wasListToCSV(
                [
                    "Members",
                    17
                ]
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);
land data Directory Parcel
llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            "command", "directorysearch",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "type", "land",
            "timeout", 10000,
            "data", wasListToCSV(
                [
                    "ActualArea",
                    4096,
                    "SalePrice",
                    1
                ]
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);
people data Agent Search Data
llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            "command", "directorysearch",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "type", "people",
            "name", "Roger",
            "timeout", 10000,
            "data", wasListToCSV(
                [
                    "Online",
                    "True"
                ]
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);
places data Directory Parcel
llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            "command", "directorysearch",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "type", "place",
            "name", "love",
            "timeout", 10000,
            "data", wasListToCSV(
                [
                    "ActualArea",
                    4096
                ]
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);
1)
The name parameter is optional for classified and event search type but required for all other search types.

secondlife/scripted_agents/corrade/api/progressive/commands/directorysearch.txt ยท Last modified: 2017/02/22 18:28 (external edit)

Access website using Tor


For the copyright, license, warranty and privacy terms for the usage of this website please see the license and privacy pages.