Exchange Web Service Connector 25.1
Exchange Web Service Connector Help

# Construct XML to Update Access Control Lists

To update the Access Control Lists of items in Exchange, you must construct some XML that specifies the items to update, and provides information about how to change the ACL.

    <identifiersXML>
        <identifier value="...">
            <acl_update>
                ...
            </acl_update>
        </identifier>
    </identifiersXML>

In the identifier `value` attribute, replace "..." with the identifier of the item that you want to update. Identifiers can be found using the identifiers fetch action. You can update the ACLs of several items by including more than one `identifier` element in your XML:

    <identifiersXML>
        <identifier value="...">
            <acl_update>
                ...
            </acl_update>
        </identifier>
        <identifier value="...">
            <acl_update>
                ...
            </acl_update>
        </identifier>
    </identifiersXML>

The following table describes the XML elements that you can use in the `acl_update` element to specify how to change the ACL.

XML Element | Description | Permitted Occurrences
--- | --- | ---
`<ace action="...">` | Add or remove an entry from the ACL. The `action` attribute must be specified and accepts the value `add` or `remove`. The following child elements must all appear exactly once: `principal` - the user whose permissions you want to modify in the ACL. The value you set must correspond to `principalType`. `principalType` - the type of principal specified by the `principal` element: `Email` - an e-mail address. `level` - a comma-separated list of permissions to add or remove: `read` `edit` `delete` `visible` `createItems` `createSubFolders` `folderOwner` `folderContact` `*` - denotes all permissions, allowed only when removing permissions. | 0 or more

The following example demonstrates how to change the ACL for a folder in Exchange. It makes the following changes:

- removes all permissions from `someuser@mydomain.com`
- grants the specified list of permissions to `otheruser@mydomain.com`

    <identifiersXML>
        <identifier value="BASE64IDENTIFIER==">
            <acl_update>
                <ace action="remove">
                    <principal>someuser@mydomain.com</principal>
                    <principalType>Email</principalType>
                    <level>*</level>
                </ace>
                <ace action="add">
                    <principal>otheruser@mydomain.com</principal>
                    <principalType>Email</principalType>
                    <level>read, edit, delete, visible, createItems, createSubFolders, folderOwner, folderContact</level>
                </ace>
            </acl_update>
        </identifier>
    </identifiersXML>

Copyright 2024 Open Text
Version 25.1 | Last updated January 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Exchange Web Service Connector 25.1

Topic Title: Construct XML to Update Access Control Lists