Extensões suportadas no Microsoft Dynamics CRM 2015

  • Artigo

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Você pode personalizar o Atualização do Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015 com as ferramentas disponíveis no aplicativo Web Microsoft Dynamics 365 ou descritas no SDK do Microsoft Dynamics CRM. Essas personalizações têm suporte e podem ser atualizadas.

Personalizações feitas usando métodos diferentes daqueles aqui descritos não tem suporte e podem causar problemas durante atualizações para o Microsoft Dynamics 365. Para obter mais informações, consulte Personalizações sem suporte.

Os tópicos abordados em artigos técnicos publicados no MSDN na Central de Desenvolvimento do CRM no MSDN são suportados, mas não podem ser atualizados.

Neste tópico

Personalizações usando o aplicativo Web Microsoft Dynamics

Personalizações usando o SDK do Microsoft Dynamics CRM

Suporte para as versões do .NET Framework

Personalizações sem suporte

Personalizações usando o aplicativo Web Microsoft Dynamics

Há diversas de ferramentas incluídas com o Microsoft Dynamics 365 que você pode usar para personalizar. Personalizações feitas usando as ferramentas e aplicativo Web do Microsoft Dynamics 365 têm total suporte e são totalmente atualizáveis.

Os seguintes métodos de personalização podem ser usadas para produzir personalizações totalmente suportadas:

Observação

Totalmente suportado significa que o suporte do desenvolvedor pode oferecer a assistência para personalizações e que o suporte do aplicativo pode ajudar os clientes a executar essas alterações.

Para obter mais informações sobre o uso das ferramentas de personalização no aplicativo da web, consulte o Guia de personalização do Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online.

Personalizações usando o SDK do Microsoft Dynamics CRM

O SDK do Microsoft Dynamics CRM, os artigos técnicos e o código de exemplo publicados na Central do Desenvolvedor do Microsoft Dynamics CRM e informações lançadas pela Equipe de Suporte do Desenvolvedor do Microsoft Dynamics 365 são incluídas na área de personalizações usando o SDK do Microsoft Dynamics CRM. As ações e os níveis de suporte e atualização específicos estão descritos posteriormente neste tópico.

SDK do Microsoft Dynamics CRM

O uso de serviços da Web é totalmente suportado. Isso inclui: DiscoveryService, OrganizationService, Organization Data Service, o ponto de extremidade OData, o ponto de extremidade SOAP de aplicativo moderno e o DeploymentService. Esforçamos para manter as APIs inversas compatíveis, mas reservados o direito de alterar APIs por recursos adicionais. Os atributos de entidade também podem ser alterados em versões futuras. Para obter mais informações, consulte Crie aplicativos e extensões do servidor e Administre a implantação usando o serviço Web de implantação.

Javascript do cliente

Você pode usar o JavaScript no Atualização do Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015 em três áreas:

  • Manipuladores de eventos do script de formulário: Você pode configurar manipuladores de eventos de formulário para chamar as funções definidas nos recursos da Web do JavaScript.

  • Comandos da barra de comandos (faixa de opções): Use os elementos <CustomRule> (RibbonDiffXml) ou <JavaScriptFunction> (RibbonDiffXml) para definir as ações que chamam funções definidas dentro dos recursos da Web do JavaScript.

  • IFRAMEs e recursos da Web: Você pode usar recursos da Web do JavaScript dentro dos recursos da Web HTML. IFRAMES configurados para permitir scripts entre locais ou script dentro de recursos da Web HTML incluídos em um formulário podem interagir com os métodos Xrm.Page ou Xrm.Utility dentro do formulário por meio de uma referência principal.

Todas as interações com as páginas do aplicativo do Microsoft Dynamics 365 devem ser executadas com os métodos com os espaços reservados Xrm.Page ou Xrm.Utility documentados no Referência de programação do cliente. Acessar diretamente o Modelo de Objeto de Documento (DOM) de qualquer página do aplicativo Microsoft Dynamics 365 não tem suporte. O uso do jQuery em scripts de formulários e comandos não é recomendado.Para obter mais informações:Uso do jQuery

Você pode abrir formulários, exibições, diálogos e relatórios do Microsoft Dynamics 365 usando os métodos documentos no Abrir formulários, exibições, caixas de diálogo e relatórios com uma URL.

Personalização da faixa de opções

O uso do RibbonDiffXml para adicionar, remover ou ocultar elementos da faixa de opções é suportado. Reutilização de comandos da faixa de opções definidos pelo Microsoft Dynamics 365 é suportado; entretanto, reservamos o direito de alterar ou substituir os comandos disponíveis. Reutilização de funções Javascript definidas nos comandos da faixa de opções não tem suporte.

Arquivo de solução

A modificação de um arquivo de solução não gerenciada é suportado conforme descrito no SDK do Microsoft Dynamics CRM. Determinadas tarefas de personalização são executadas usando estas etapas:

  • Exportar um componente da solução como uma solução não gerenciada.

  • Extraia o conteúdo do pacote de soluções.

  • Edite o arquivo Customizations.xml.

  • Reembale o arquivo de soluções.

  • Importe a solução modificada.

As alterações no arquivo Customizations.xml precisam estar de acordo com o esquema CustomizationsSolution.xsd. Para obter mais informações, consulte Schemas used in Microsoft Dynamics CRM 2015.

As tarefas suportadas a seguir exigem este procedimento:

  • Personalização da faixa de opções.

  • Personalização da navegação do aplicativo usando o SiteMap.

  • Personalização de formulários e painel usando o FormXml.

  • Personalização de consulta salva.

Plug-ins

A capacidade de criar a lógica de negócios personalizada usando o mecanismo de plug-in descrita no SDK do Microsoft Dynamics CRM é totalmente suportada e atualizável. Esse recurso está disponível para todas as implantações do Microsoft Dynamics 365, incluindo o local, IFD e Online. No entanto, os plug-ins só podem ser registrados e executados na área restrita (isolamento) do Microsoft Dynamics CRM Online.Para obter mais informações:Crie plug-ins para ampliar os processos empresariais

Adicionar os assemblies de atividade de fluxo de trabalho personalizado e plug-in para a pasta %installdir%\server\bin\ tem suporte apenas nas instalações do servidor IFD e Microsoft Dynamics 365 local.

Fluxo de Trabalho

A capacidade de criar atividades de fluxo de trabalho personalizadas (assemblies) a serem chamadas de regras de fluxo de trabalho é totalmente suportada e atualizável. Esse recurso está disponível para o Microsoft Dynamics 365 local, IFD e Online. No entanto, as atividades de fluxo de trabalho personalizados só podem ser registradas e executadas na área restrita (isolamento) do Microsoft Dynamics CRM Online.Para obter mais informações:Gravar fluxos de trabalho para automatizar processos empresariais

A capacidade de editar fluxos de trabalho XAML é totalmente suportada e atualizável. No entanto, esse recurso está disponível apenas para o Microsoft Dynamics 365 local e IFD.Para obter mais informações:Gravar fluxos de trabalho para automatizar processos empresariais

Suporte para as versões do .NET Framework

O diagrama a seguir ilustra as considerações sobre suporte para o código personalizado criado com o Microsoft Visual Studio 2012 ou 2013 e o Microsoft .NET Framework 4.5.2.

Qualquer cliente do serviço Web criado usando o Visual Studio e o Microsoft .NET Framework 4.5.2 que chama os serviços Web do Microsoft Dynamics 365 é totalmente suportado no Microsoft Dynamics 365. O uso do ASP.NET AJAX tem suporte.

Qualquer assembly do .NET que seja criado com o Visual Studio e o Microsoft .NET Framework 4.5.2 para uso no Microsoft Dynamics 365 como um assembly de plug-in do Microsoft Dynamics 365 ou como uma atividade de fluxo de trabalho personalizada do Microsoft Dynamics 365 tem suporte.

Qualquer visualização (gráfico) que é criada com o .NET Framework 4.5.2.

Para compatibilidade inversa, estes pontos de extremidade podem ser usados com versões anteriores do .NET Framework como o seguinte:

  • O ponto de extremidade de 2011 oferece suporte ao .NET Framework 4.

Personalizações sem suporte

As alterações no Microsoft Dynamics 365 realizadas sem usar as ferramentas do SDK do Microsoft Dynamics CRM ou Microsoft Dynamics 365 não têm suporte e não serão preservadas durante atualizações do Microsoft Dynamics 365. Tudo que não estiver documentado no SDK do Microsoft Dynamics CRM e nos documentos de suporte não tem suporte. Além disso, as alterações sem suporte podem causar problemas durante a atualização na adição de hotfixes ou service packs ou atualização do Microsoft Dynamics 365. Para minimizar problemas de atualização, não modifique os arquivos do Microsoft Dynamics 365 que não você não cria sozinho.

Os itens a seguir são uma lista de tipos de ação sem suporte que são frequentemente perguntados sobre:

  • Alterações em qualquer arquivo .aspx, .css .htm .js, .jpg, .xml ou .gif além de arquivos nos diretórios do wwwroot do aplicativo Microsoft Dynamics 365, ferramentas do Microsoft Dynamics 365 ou arquivos do Microsoft Dynamics 365 localizados em Arquivos de Programas\Microsoft Dynamics 365. Entretanto, se você tiver feito alterações nesses arquivos, esses arquivos são verificados por alterações e não serão substituídos.

  • Alterações no site do Microsoft Dynamics 365 (configurações de arquivos e sites). As soluções personalizadas devem ser instaladas em um site diferente. Isso inclui alterações nas listas de controle de acesso do sistema de arquivos (ACLs) de todos os arquivos no servidor do Microsoft Dynamics 365.

  • O uso de certificados do cliente não é suportado por SDK do Microsoft Dynamics CRM. Se você configurar o site do Microsoft Dynamics 365 para exigir certificados do cliente IIS, você obterá falhas de autenticação para todos os aplicativos que tenham sido criados usando o SDK.

  • Alterações no esquema físico do banco de dados, além de adicionar ou atualizar índices. Isso inclui todas as ações realizadas no banco de dados sem usar os recursos de Personalização do Sistema no aplicativo Web ou usar os APIs de metadados descritos nesta documentação do SDK. Alterar tabelas, procedimentos armazenados ou modos de exibição no banco de dados não tem suporte. Adicionar tabelas, procedimentos armazenados ou modos de exibições para o banco de dados não tem suporte devido a problemas de integridade referencial ou atualização. Para implantações locais do Microsoft Dynamics CRM 2015, adicionar índices é suportado de acordo com as diretrizes na documentação Implantando e administrando o Microsoft Dynamics CRM. Isso é aplicado a todos os bancos de dados do Microsoft Dynamics 365 e o banco de dados do Microsoft Dynamics CRM para Outlook local.

    Quando você altera o banco de dados sem usar os métodos de suporte para a personalização do sistema, você corre o risco de problemas ocorrendo durante atualizações.

  • Alterações de dados (registro) no banco de dados do Microsoft Dynamics 365 com comandos SQL ou qualquer tecnologia diferente dos descritos no SDK do Microsoft Dynamics CRM.

  • Referenciar qualquer bibliotecas de vínculo dinâmico (DLL) do Microsoft Dynamics 365 diferente do seguinte:

    • Microsoft.Xrm.Sdk.dll

    • Microsoft.Crm.Sdk.Proxy.dll

    • Microsoft.Xrm.Sdk.Workflow.dll

    • Microsoft.Xrm.Sdk.Deployment.dll

    • Microsoft.Crm.Outlook.Sdk.dll

    • Microsoft.Crm.Tools.EmailProviders.dll

  • O uso das interface de programação de aplicativos (APIs) diferente das APIs documentadas nos serviços Web DeploymentService, DiscoveryService, Serviço de Dados de Organização, ponto de extremidade SOAP para recursos Web e OrganizationService.

    Para obter a aparência e o comportamento do Microsoft Dynamics 365, a reutilização de controles da interface do usuário do Microsoft Dynamics 365, incluindo os controles de grade. Esses controles podem ser alterados ou substituídos durante uma atualização. Não é recomendável usar ou alterar o arquivo Default.css na pasta de instalação raiz do Microsoft Dynamics 365.

  • A reutilização de qualquer código Javascript do Microsoft Dynamics 365, incluindo comandos da faixa de opções. Esse código pode ser alterado ou substituído durante uma atualização.

  • Alterações nos formulários do Microsoft Office Outlook ou adição de novos formulários, como páginas .aspx personalizadas, diretamente no Microsoft Dynamics 365 ou realizar alterações nos arquivos .pst. Essas alterações não serão atualizadas.

  • Fazer personalizações exceto quando você usa as ferramentas suportadas do Microsoft Dynamics 365 disponíveis offline no Dynamics CRM para Outlook.

  • O uso de HttpModules personalizados para injetar HTML/DHTML em formulários do Microsoft Dynamics 365.

  • Criar um assembly de plug-in para um assembly Microsoft Dynamics 365 padrão (Microsoft.Crm.*.dll) ou ou executar uma atualização ou exclusão em uma plataforma criada do pluginassembly não têm suporte.

  • Plug-ins do Microsoft Dynamics CRM 4.0 e atividades do fluxo de trabalho personalizadas não são suportados.

  • Ponto de extremidade de serviço do Microsoft Dynamics CRM 4.0 (ponto de extremidade 2007) não tem suporte.

  • Criar um aplicativo Serviços de Informações da Internet (IIS) dentro do site do Microsoft Dynamics 365 para qualquer VDir e especificamente na pasta ISV não tem suporte. A pasta de <crmwebroot>\ISV não tem suporte.

  • Editar um arquivo de soluções para editar todos os componentes da solução diferentes de faixas de opção, formulários, mapa do site ou consultas salvas não têm suporte. Para obter mais informações, consulte Quando editar o arquivo de personalizações. Definir novos componentes de solução editando o arquivo de soluções não tem suporte. Editar os arquivos de recurso da Web exportados com uma solução não tem suporte. Exceto pelas etapas documentadas no Manter soluções gerenciadas, editar o conteúdo de uma solução gerenciada não tem suporte.

  • Silverlight Cache da Biblioteca de Aplicativos não tem suporte.

  • A exibição de um formulário de entidade dentro de um IFrame inserido em outro formulário de entidade não tem suporte.

Confira Também

Visão geral do desenvolvedor
Escolha o estilo de desenvolvimento do código gerenciado
Crie aplicativos e extensões do servidor
Criar códigos para os formulários do Microsoft Dynamics CRM 2015

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais