Batch Remove Avatars from Roles

26 January 2019

  • C10 - added.
batchdeletefromrole (Commands)
TypeCorrade progressive command
Commandbatchdeletefromrole
DescriptionThe batchdeletefromrole command can be used to unassign avatars en-bloc from multiple roles.
Permissionsgroup
Parametersgroup, password, avatars, role
Last ChangesC10 - 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