Operación AddDelegate
La operación AddDelegate agrega uno o varios delegados al buzón de una entidad de seguridad y establece permisos de acceso específicos.
Encabezados SOAP
La operación AddDelegate puede usar los encabezados SOAP que se enumeran y describen en la tabla siguiente.
| Header | Elemento | Descripción |
|---|---|---|
| Suplantación |
ExchangeImpersonation |
Identifica al usuario al que suplanta la aplicación cliente. |
| MailboxCulture |
MailboxCulture |
Identifica la referencia cultural RFC3066 que se va a usar para acceder al buzón. |
| RequestVersion |
RequestServerVersion |
Identifica la versión del esquema de la solicitud de operación. |
| ServerVersion |
ServerVersionInfo |
Identifica la versión del servidor que respondió a la solicitud. |
Ejemplo de solicitud AddDelegate
Descripción
En el ejemplo siguiente de una solicitud AddDelegate se muestra un intento de conceder permisos delegados user1 en carpetas que son propiedad de user2. A User1 se le conceden permisos de nivel de autor para la carpeta calendario de user2 y permisos de nivel de revisor para la carpeta Contactos de user2. User1 no recibirá copias de mensajes de reunión y no podrá ver elementos privados en el buzón de user2. Las convocatorias de reunión se enviarán a user1 y user2.
Código
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Header>
<t:RequestServerVersion Version="Exchange2007_SP1"/>
</soap:Header>
<soap:Body xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<AddDelegate>
<Mailbox>
<t:EmailAddress>user2@example.com</t:EmailAddress>
</Mailbox>
<DelegateUsers>
<t:DelegateUser>
<t:UserId>
<t:PrimarySmtpAddress>user1@example.com</t:PrimarySmtpAddress>
</t:UserId>
<t:DelegatePermissions>
<t:CalendarFolderPermissionLevel>Author</t:CalendarFolderPermissionLevel>
<t:ContactsFolderPermissionLevel>Reviewer</t:ContactsFolderPermissionLevel>
</t:DelegatePermissions>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</t:DelegateUser>
</DelegateUsers>
<DeliverMeetingRequests>DelegatesAndMe</DeliverMeetingRequests>
</AddDelegate>
</soap:Body>
</soap:Envelope>
Ejemplo de respuesta addDelegate
Descripción
En el ejemplo siguiente de una respuesta AddDelegate se muestra una respuesta correcta a una solicitud AddDelegate .
Código
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8"
MinorVersion="1"
MajorBuildNumber="206"
MinorBuildNumber="0"
Version="Exchange2007_SP1"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<m:AddDelegateResponse xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
ResponseClass="Success"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseCode>NoError</m:ResponseCode>
<m:ResponseMessages>
<m:DelegateUserResponseMessageType ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:DelegateUser>
<t:UserId>
<t:SID>S-1-5-21-1333220396-2200287332-232816053-1116</t:SID>
<t:PrimarySmtpAddress>User1@example.com</t:PrimarySmtpAddress>
<t:DisplayName>User1</t:DisplayName>
</t:UserId>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</m:DelegateUser>
</m:DelegateUserResponseMessageType>
</m:ResponseMessages>
</m:AddDelegateResponse>
</soap:Body>
</soap:Envelope>
Ejemplo de respuesta de error addDelegate
Descripción
En el ejemplo siguiente se muestra la respuesta a una solicitud para agregar un delegado que ya se ha agregado al buzón de la entidad de seguridad.
Código
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8"
MinorVersion="1"
MajorBuildNumber="206"
MinorBuildNumber="0"
Version="Exchange2007_SP1"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<m:AddDelegateResponse xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
ResponseClass="Success"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseCode>NoError</m:ResponseCode>
<m:ResponseMessages>
<m:DelegateUserResponseMessageType ResponseClass="Error">
<m:MessageText>The user is already a delegate for the mailbox.</m:MessageText>
<m:ResponseCode>ErrorDelegateAlreadyExists</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</m:DelegateUserResponseMessageType>
</m:ResponseMessages>
</m:AddDelegateResponse>
</soap:Body>
</soap:Envelope>
Comentarios
Si se devuelve el código de respuesta ErrorDelegateAlreadyExists al intentar agregar un delegado, use la operación GetDelegate para obtener todos los permisos actuales para el delegado y, a continuación, use la operación UpdateDelegate para establecer los nuevos permisos.