Batch Add Avatars to Roles

26 January 2019

  • C10 - added.
batchaddtorole (Commands)
TypeCorrade progressive command
Commandbatchaddtorole
DescriptionThe batchaddtorole command can be used to assign avatars en-bloc to multiple roles.
Permissionsgroup
Parametersgroup, password, avatars
Last ChangesC10 - added.

The batchaddtorole command can be used to assign avatars en-bloc to multiple roles.

Command Required Parameters Required Corrade Permissions Required Group Abilities Example
batchaddtorole group, password, avatars group * For assigning to Corrade's role in the group: Roles→Assign Members to Assigner's Roles
* For assigning to any role in the group: Roles→Assign Members to Any Role
llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            "command", "batchaddtorole",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            // Assign all avatars to these two roles.
            "role", wasURLEscape(
                wasListToCSV(
                    [
                        "The Good Role",
                        "a7440dd7-70f4-4267-b059-33c8c7c01e60"
 
                    ]
                )
            ),
            "avatars", wasURLEscape(
                wasListToCSV(
                    [
                        "Philip Linden",
                        // Agent by UUID
                        "ff19c6b5-4824-4de3-995a-d739d588cf18",
                        "Ectogram Resident"
                    ]
                )
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);

The command will return a list of avatars that could not be assigned to the roles.

Optional Parameters Possible Value Description
role A CSV list of role names or UUIDs. Assign avatars to the specified roles.
target A group name or UUID. The group to act upon. If this parameter is omitted, then the command acts upon the configured group passed to the group parameter.

Notes

  • Note that in the Linden protocol, role names are not unique, such that a command sending a role name instead of a role UUID would be ambiguous in a context where two roles with the same name exist. In other words, in case you have multiple roles with the same name, it is better to previously issue a getroles command to retrieve a list of roles and their corresponding UUIDs and then issue the command by setting role to an UUID instead of a name.

secondlife/scripted_agents/corrade/api/commands/batchaddtorole.txt · Last modified: 2020/09/04 06:44 (external edit)

Access website using Tor Access website using i2p Wizardry and Steamworks PGP Key


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