Introdução ao serviço Web de implantação
Publicado: janeiro de 2017
Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
O serviço de implantação permite criar soluções para tirar proveito do suporte a várias organizações - também chamado suporte multilocatário.Microsoft Dynamics 365 possibilita hospedar diversas organizações de cliente dentre de uma única implantação. Esse recurso beneficia soluções hospedadas ou empresas que exigem uma separação dos dados dentro da organização. Como o uso do serviço de implantação requer acesso ao servidor do Dynamics 365, ele só pode ser usado para implantações locais do Microsoft Dynamics 365 .
Com suporte a várias organizações, o aplicativo web e os serviços da Web do Microsoft Dynamics 365 oferecem suporte ao armazenamento e recuperação de dados em várias organizações de negócios, mantendo a segurança e a privacidade de cada organização individual. Um único banco de dados de configuração Microsoft Dynamics 365 armazena metadados e informações de local para todas as organizações do cliente. Entretanto, cada organização de cliente tem seu próprio banco de dados em um servidor que executa o Microsoft SQL Server. Para obter mais informações sobre as entidades e as definições de configuração controladas pelo serviço de implantação, consulte Entidades de implantação e definições da configuração de implantação.
O Microsoft Dynamics 365 não oferece suporte a um ponto de extremidade de compatibilidade retroativa para o serviço de implantação, portanto qualquer código gravado para o serviço de implantação do Microsoft Dynamics CRM 4.0 deve ser atualizado e recompilado com o novo assembly.
Adicionar o serviço de implantação ao projeto
Você pode usar o serviço de implantação, adicionando uma referência ao assembly Microsoft.Xrm.Sdk.Deployment.dll, que pode ser localizado na pasta SDK\bin. Como alternativa, você pode adicionar a seguinte referência de serviço à solução.
http://myservername/xrmdeployment/2011/deployment.svc
svcutil.exe http:// myservername/XRMDeployment/2011/Deployment.svc?wsdl
Esse método gerará um arquivo de configuração e um arquivo de código contendo a classe do cliente. Adicione esses dois arquivos ao aplicativo cliente e use a classe do cliente gerada para chamar o serviço.
Instalação do serviço de implantação
Para executar chamadas para entidades de implantação do Microsoft Dynamics 365, a função de servidor do serviço de implantação deve ser instalada corretamente em um servidor Microsoft Dynamics 365. Certifique-se de que os seguintes critérios sejam atendidos na instalação do serviço de implantação:
Para usar as operações da organização, como criar ou atualizar, você deve instalar a função de servidor do serviço de implantação usando um usuário de domínio. A conta de usuário do domínio deve ter direitos de administrador local e do sistema no SQL Server em que as bases de dados da organização serão hospedadas.
O serviço de implantação deve ser executado com uma identidade de serviço diferente dos outros serviços e do servidor de aplicativos do Microsoft Dynamics 365 . Se estiver usando o serviço de rede, a função de servidor deve ser instalada em um servidor separado, sem nenhuma outra função do servidor Microsoft Dynamics 365 instalada. A instalação da função de serviço de implantação junto com outras funções do servidor pode causar riscos de segurança, porque ambos os servidores são executados na conta de serviço de rede. Se você usar a conta de serviço de rede, não poderá executar operações de organização usando ou o Windows PowerShell ou o serviço da Web de implantação.
Para obter mais informações sobre a instalação do serviço de implantação, consulte Funções do servidor do Microsoft Dynamics CRM.
O Microsoft Dynamics 365 tem dois componentes de servidor primário: o servidor de aplicativos Microsoft Dynamics 365 e o servidor Microsoft Dynamics 365. Cada um inclui um grupo separado de funções de servidor que são instaladas quando a configuração é executada. A função do serviço de implantação é instalada automaticamente durante o uso do assistente de instalação para instalar o servidor de plataforma do Microsoft Dynamics 365 .
Autenticação e representação do serviço de implantação
A autenticação do serviço de implantação é executada com o Active Directory, que também é conhecido como autenticação integrada do Windows. Você também pode usar a representação, que permite chamar os métodos do serviço Web em nome de outro usuário autenticado para fornecer um recurso ou serviço desejado. Para chamar o serviço Web de implantação, você deve ser um Microsoft Dynamics 365 Administrador de Implantação. Para obter mais informações, consulte Adicionar um administrador de implantação.
O exemplo a seguir mostra como usar a classe ProxyClientHelper para autenticar e usar o serviço de implantação utilizando as credenciais padrão.
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);
}
Os serviços Web do Microsoft Dynamics 365 podem ser chamados por vários clientes e serviços em nome de um usuário do Microsoft Dynamics 365 . Cada chamada deve ser uma chamada autenticada. A representação é usada para executar uma chamada em nome de um usuário autenticado do Microsoft Dynamics 365. Ao usar a representação, você evita tratar os problemas de autenticação e de autorização no código do serviço Web (ASP.NET). Em vez disso, você confia no Serviços de Informações da Internet (IIS) para autenticar o usuário e passar um token autenticado para o serviço Web. Se o usuário não puder ser autenticado, o IIS transmite um token não autenticado.
O exemplo a seguir mostra como usar a representação com o serviço de implantação.
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);
}
Recursos do serviço de implantação
O serviço de implantação acompanha um modelo de desenvolvimento similar ao serviço Web principal do Microsoft Dynamics 365. Há entidades, métodos e mensagens que você usa para interagir com o serviço de implantação. Para obter mais informações sobre o serviço Web principal do Microsoft Dynamics 365, consulte Usar os serviços do Microsoft Dynamics 365 em código.
Há dois tipos de entidades para o serviço de implantação: entidades de implantação e definições de configuração de implantação. Ambos são acessados pelo mesmo conjunto de métodos. Para obter mais informações sobre essas entidades, consulte Entidades de implantação e definições da configuração de implantação.
Além das entidades de implantação principais, o serviço de implantação oferece a capacidade de ler e editar as configurações avançadas orientadas por metadados. Essas configurações avançadas oferecem acesso às informações armazenadas no banco de dados de configuração.
O serviço de implantação oferece suporte para mensagens síncronas e assíncronas para o método Execute. Para obter mais informações, consulte Mensagens do serviço Web de implantação.
A tabela abaixo lista os métodos disponíveis no serviço de implantação.
Nome do método |
Descrição |
|---|---|
Exclui um registro de uma entidade na implantação. |
|
Executa uma solicitação para o serviço de implantação. Para obter mais informações, consulte Mensagens do serviço Web de implantação. |
|
Recupera um registro de uma entidade de implantação ou das definições de configuração de implantação. |
|
Recupera todos os registros de uma entidade de implantação ou das definições de configuração de implantação. |
|
Atualiza um registro de uma entidade de implantação ou das definições de configuração de implantação. |
Confira Também
IDeploymentService
Microsoft.Xrm.Sdk.Deployment.Proxy
ProxyClientHelper
Administre a implantação usando o serviço Web de implantação
Entidades de implantação e definições da configuração de implantação
Mensagens do serviço Web de implantação
Microsoft Dynamics 365
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais