Batch Add Avatars to Roles

26 January 2019

C10 - added.

batchaddtorole (Commands)
Type	Corrade progressive command
Command	`batchaddtorole`
Description	The `batchaddtorole` command can be used to assign avatars en-bloc to multiple roles.
Permissions	`group`
Parameters	`group`, `password`, `avatars`
Last Changes	C10 - 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.