Compartir a través de

Operación InstallApp

  • Artículo

Busque información sobre la operación InstallApp EWS.

La operación InstallApp instala una aplicación de correo para Outlook en un buzón.

Esta operación se introdujo en Exchange Server 2013.

Uso de la operación InstallApp

La operación InstallApp toma un único argumento que identifica una aplicación de correo que se va a instalar. El argumento contiene el manifiesto codificado en base64 para una aplicación de correo.

Encabezados SOAP de la operación InstallApp

La operación InstallApp puede usar los encabezados SOAP que aparecen en la tabla siguiente.

Nombre de encabezado Elemento Descripción
RequestVersion
RequestServerVersion
Identifica la versión del esquema de la solicitud de operación. Este encabezado es aplicable a una solicitud.
ServerVersion
ServerVersionInfo
Identifica la versión del servidor que respondió a la solicitud. Este encabezado se aplica a una respuesta.

Ejemplo de solicitud de operación InstallApp: Instalación de una aplicación de correo en un buzón

En el ejemplo siguiente de una solicitud de operación InstallApp se muestra cómo instalar una aplicación de correo para Outlook. El manifiesto de aplicación se puede encontrar mediante la operación GetAppManifests.

Nota:

El manifiesto de aplicación codificado en base64 se ha truncado arbitrariamente para conservar la legibilidad y no representa un manifiesto válido.

<?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"
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
   </soap:Header>
   <soap:Body >
      <m:InstallApp>
         <m:Manifest>TUwiIC8+CiAgPC9SdWxlPgo8L09mZmljZUFwcD4=</m:Manifest>
      </m:InstallApp>
   </soap:Body>
</soap:Envelope>

El cuerpo SOAP de la solicitud contiene los siguientes elementos:

Respuesta correcta de la operación InstallApp

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación InstallApp para instalar una aplicación de correo.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="556" 
                           MinorBuildNumber="14" 
                           Version="Exchange2013" 
                           xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="http://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <InstallAppResponse ResponseClass="Success" 
                          xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
      </InstallAppResponse>
   </s:Body>
</s:Envelope>

El cuerpo soap de respuesta contiene los siguientes elementos:

Respuesta de error de la operación InstallApp

En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación InstallApp . Se trata de una respuesta a una solicitud que contiene un manifiesto no válido.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="556" 
                           MinorBuildNumber="14" 
                           Version="Exchange2013" 
                           xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="http://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <InstallAppResponse ResponseClass="Error" 
                          xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>This app can't be installed. Missing OfficeApp element.</MessageText>
         <ResponseCode>ErrorInternalServerError</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
      </InstallAppResponse>
   </s:Body>
</s:Envelope>

El cuerpo SOAP de la respuesta de error contiene los siguientes elementos:

Vea también