Batch Remove Avatars from Roles

26 January 2019

C10 - added.

The batchdeletefromrole command can be used to unassign avatars en-bloc from multiple roles.

Command Required Parameters Required Corrade Permissions Required Group Abilities Example

batchdeletefromrole

group, password, avatars, role

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", "batchdeletefromrole",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            // Unassign all avatars from 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 unassigned from the roles.

Optional Parameters	Possible Value	Description
`role`	A CSV list of role names or UUIDs.	Unassign avatars from 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.