Introducción al servicio web de implementación
Publicado: noviembre de 2016
Se aplica a: Dynamics CRM 2015
El servicio de implementación le permite crear soluciones para aprovechar el soporte para varias organizaciones —también llamado soporte multiempresa.Microsoft Dynamics 365 permite hospedar varias organizaciones del cliente en una sola implementación. Esta capacidad se beneficia de las soluciones alojadas o de las empresas que requieren una separación de los datos dentro de la organización. Dado que el uso del servicio de implementación requiere acceso al servidor de CRM, solo puede usarse para Microsoft Dynamics CRM 2015 en implementaciones locales.
Con soporte para varias organizaciones, la aplicación web Microsoft Dynamics 365 y los servicios web admiten el almacenamiento y la recuperación de datos a través de varias organizaciones a la vez que mantienen la seguridad y la privacidad de cada organización individual. Una base de datos Microsoft Dynamics 365 de configuración única que almacena metadatos e información de ubicación para todas las organizaciones cliente. Sin embargo, cada organización del cliente tiene su propia base de datos en un servidor que ejecuta Microsoft SQL Server. Para obtener más información acerca de las entidades y los parámetros de configuración controlados por el servicio de implementación, consulte Entidades de implementación y valores de configuración de implementación.
Microsoft Dynamics CRM 2015 no admite un punto final compatible con versiones anteriores para el servicio de implementación así que cualquier código escrito para el servicio de implementación de Microsoft Dynamics CRM 4.0 deben actualizarse y recompilar con el nuevo ensamblado.
Agregar el servicio de implementación para su proyecto
Puede usar el servicio de implementación al agregar una referencia al ensamblado Microsoft.Xrm.Sdk.Deployment.dll, que se encuentra en la carpeta SDK\bin . Como alternativa, puede agregar la siguiente referencia de servicio a la solución.
http://myservername/xrmdeployment/2011/deployment.svc
svcutil.exe http:// myservername/XRMDeployment/2011/Deployment.svc?wsdl
Se generará un archivo de configuración y un archivo de código que contenga la clase de cliente. Agregue estos dos archivos a la aplicación cliente y use la clase de cliente generada para llamar al servicio.
Instalación del servicio de implementación
Para ejecutar llamadas con las entidades de implementación de Microsoft Dynamics 365 , el rol de servidor del servicio de implementación debe instalarse correctamente en un servidor de Microsoft Dynamics 365. Asegúrese de que se cumplan los siguientes criterios en la instalación del servicio de implementación:
Para usar las operaciones de la organización como crear o actualizar, deberá instalar el rol de servidor del servicio de implementación mediante un usuario de dominio. La cuenta de usuario de dominio debe tener derechos de administrador local y de administrador del sistema en SQL Server sobre los que se hospedarán las bases de datos de la organización.
El servicio de implementación debe ejecutarse con una identidad de servicio diferente a los demás servicios de Microsoft Dynamics 365 y del servidor de aplicaciones. Si usa el servicio de red, el rol de servidor debe instalarse en un servidor diferente por sí mismo sin ningún otro rol de servidor de Microsoft Dynamics 365 instalado. Instalación del rol del servicio de implementación junto a otros roles de servidor puede causar riesgos de seguridad porque ambos servidores se ejecutan bajo la cuenta de servicio de red. Si usa una cuenta de servicio de red no podrá realizar operaciones de la organización mediante Windows PowerShell o el servicio web de implementación.
Para obtener más información acerca de la instalación del servicio de implementación, consulte los Roles de servidor de Microsoft Dynamics CRM.
Microsoft Dynamics 365 tiene dos componentes principales de servidor: el servidor de aplicaciones de Microsoft Dynamics 365 y el Servidor de Microsoft Dynamics 365. Cada uno incluye un grupo independiente de roles de servidor que se instalaron al ejecutar la Configuración. El rol del servicio de implementación se instala automáticamente cuando se usa el asistente de configuración para instalar el servidor de plataformas de Microsoft Dynamics 365.
Autenticación y suplantación del servicio de implementación
La autenticación del servicio de implementación se administra a través de Active Directory, que también se conoce como autenticación integrada de Windows. También puede usar la suplantación, que le permite llamar a los métodos de servicio de red en nombre de otro usuario autenticado para proporcionar una característica o servicio deseada. Para llamar al servicio web de implementación, debe ser un Administrador de implementaciones de Microsoft Dynamics 365. Para obtener más información, consulte Agregar un administrador de implementación.
El siguiente ejemplo muestra cómo usar el tipo de ProxyClientHelper para autenticar y usar el servicio de implementación mediante las credenciales predeterminadas.
DeploymentServiceClient service = Microsoft.Xrm.Sdk.Deployment.Proxy.ProxyClientHelper.CreateClient(new Uri("http://MyServerName/XRMDeployment/2011/Deployment.svc"));
RetrieveAllRequest request = new RetrieveAllRequest()
{
EntityType = DeploymentEntityType.DefaultOrganization};
RetrieveAllResponse response = (RetrieveAllResponse) service.Execute(request);
}
Los servicios web deMicrosoft Dynamics 365 pueden ser llamados por varios clientes y servicios en nombre del usuario de Microsoft Dynamics 365 . Cada llamada debe ser una llamada autenticada. La suplantación se usa para ejecutar una llamada en nombre de un usuario de Microsoft Dynamics 365 autenticado. Cuando usa suplantación, evita ocuparse de los problemas de autenticación y de autorización en el código de servicio web (ASP.NET). En cambio, depende de Internet Information Services (IIS) para autenticar al usuario y trasladar un símbolo autenticado al servicio de red. Si el usuario no puede ser autenticado, IIS pasa un símbolo no autenticado.
El siguiente ejemplo muestra cómo usar la suplantación con el servicio de implementación.
DeploymentServiceClient service = Microsoft.Xrm.Sdk.Deployment.Proxy.ProxyClientHelper.CreateClient(new Uri("http://myservername/XRMDeployment/2011/Deployment.svc"));
service.ClientCredentials.Windows.ClientCredential = new NetworkCredential("administrator", "myp@ssword!", "myservernamedom");
RetrieveAllRequest request = new RetrieveAllRequest()
{
EntityType = DeploymentEntityType.DefaultOrganization};
RetrieveAllResponse response = (RetrieveAllResponse) service.Execute(request);
}
Capacidades del servicio de implementación
El servicio de implementación sigue un modelo de desarrollo similar al servicio web de Microsoft Dynamics 365 principal. Existen entidades, métodos y mensajes que se usan para interactuar con el servicio de implementación. Para obtener más información acerca del servicio web principal de Microsoft Dynamics 365, consulte Uso de servicios de Microsoft Dynamics CRM 2015 en código:
Existen dos tipos de entidades para el servicio de implementación: entidades de implementación y opciones de configuración de implementación. Puede acceder a ambos mediante el mismo conjunto de métodos. Para obtener más información sobre estas entidades, consulte Entidades de implementación y valores de configuración de implementación.
Además de las principales entidades de implementación, el servicio de implementación ofrece la posibilidad de leer y modificar la configuración avanzada controlada por los metadatos. Estas configuración avanzada proporciona acceso a la información almacenada en la base de datos de la configuración.
El servicio de implementación admite mensajes sincrónicos y asincrónicos para el método de Execute. Para obtener más información, vea Mensajes del servicio web de implementación.
La siguiente tabla enumeran los métodos disponibles en el servicio de implementación.
Nombre del método |
Descripción |
|---|---|
Elimina un registro de una entidad de la implementación. |
|
Ejecuta una solicitud para un servicio de implementación. Para obtener más información, vea Mensajes del servicio web de implementación. |
|
Recupera un registro de una entidad de implementación o los parámetros de configuración de la implementación. |
|
Recupera todos los registros de una entidad de implementación o los parámetros de configuración de la implementación. |
|
Actualiza un registro de una entidad de implementación o los parámetros de configuración de la implementación. |
Ver también
IDeploymentService
Microsoft.Xrm.Sdk.Deployment.Proxy
ProxyClientHelper
Administrar la implementación mediante el servicio web de implementación
Entidades de implementación y valores de configuración de implementación
Mensajes del servicio web de implementación
© 2017 Microsoft. Todos los derechos reservados. Copyright