Personalizações com suporte para o Dataverse

Você pode personalizar Microsoft Dataverse usando ferramentas disponíveis em Power Apps ou descritas na documentação do desenvolvedor. Essas personalizações têm suporte e podem ser atualizadas.

As personalizações feitas usando métodos diferentes daqueles descritos aqui não têm suporte e podem causar problemas durante atualizações e atualizações para o Dataverse. Para obter mais informações, consulte Personalizações sem suporte.

Tópicos abordados em artigos técnicos publicados em Microsoft sites como Microsoft Learn têm suporte, mas podem não ser atualizáveis.

Personalizações usando Power Apps

Há uma variedade de ferramentas incluídas no Dataverse que você pode usar para personalizá-lo. As personalizações feitas usando as ferramentas do Power Apps e a aplicação Web são totalmente suportadas e totalmente atualizáveis.

Os seguintes métodos de personalização podem ser usados para produzir personalizações totalmente compatíveis:

• Personalização no Power Apps ou gerenciador de soluções. Para obter mais informações, consulte o que é o Dataverse?

• Configurações no aplicativo Web. Para obter mais informações, consulte Administrar Power Apps.

• Serviços de Relatório Para obter mais informações, consulte Adicionar relatórios ao seu aplicativo controlado por modelos.

Para obter mais informações sobre como usar as ferramentas de personalização no aplicativo Web, consulte o Que é o Dataverse?.

Personalizações aplicadas usando código

A documentação neste site para desenvolvedores, artigos técnicos e código de exemplo publicado neste site e informações divulgadas pela Equipe de Suporte ao Desenvolvedor do Dataverse estão incluídas na área de personalizações aplicadas usando código. As ações específicas e os níveis de capacidade de suporte e de atualização são descritos posteriormente neste tópico.

Serviços Web do Dataverse

O uso dos serviços Web tem suporte total. Isso inclui: API Web, serviço organizacional e serviço de descoberta. Nos esforçamos para manter as APIs compatíveis com versões anteriores, mas reservamos o direito de alterar APIs para recursos adicionais. As colunas de tabela também podem ser alteradas em versões futuras.

Arquivo de solução

Há suporte para a modificação de um arquivo de solução não gerenciado, conforme descrito nesta documentação. Determinadas tarefas de personalização para aplicativos controlados por modelo podem ser executadas usando estas etapas:

1. Exporte um componente da solução como uma solução não gerenciada.
2. Extraia o conteúdo do pacote de solução.
3. Editar o arquivo Customizations.xml.
4. Reempacote o arquivo de soluções.
5. Importe a solução modificada.

As seguintes tarefas com suporte podem ser executadas usando este procedimento:

• Personalização da faixa de opções.
• Personalização de navegação do aplicativo usando SiteMap.
• Personalização de formulário e painel usando FormXml.
• Personalização de consulta salva.

Plug-ins

A capacidade de criar lógica de negócios personalizada usando o mecanismo de plug-in descrito nesta documentação é totalmente compatível e atualizável. Os plug-ins só podem ser registrados e executados em sandbox (modo isolado). Mais informações: Plug-ins

Extensões de fluxo de trabalho

A capacidade de criar atividades de fluxo de trabalho personalizadas (assemblies) a serem chamadas de regras de fluxo de trabalho é totalmente compatível e atualizável. As atividades de fluxo de trabalho personalizadas só podem ser registradas e executadas na área restrita (isolamento). Mais informações: extensões de fluxo de trabalho

Suporte para versões do .NET Framework

A seguir, descreve as considerações de suporte para o código personalizado direcionado ao .NET Framework do Microsoft.

• Qualquer cliente de serviço Web criado usando o Microsoft .NET Framework 4.6.2 ou superior que chama os serviços Web do Dataverse tem suporte total.
• Qualquer projeto de assembly .NET destinado ao Microsoft .NET Framework 4.6.2 ou posterior, para uso no Dataverse como assembly de plug-in ou como assembly de atividade de fluxo de trabalho personalizada, é compatível.

Você pode ver a lista mais recente de destinos de compilação com suporte do .NET Framework nos pacotes NuGet do Dataverse Microsoft.PowerPlatform.Dataverse.Client ou Microsoft.CrmSdk.CoreAssemblies.

Suporte para versões do .NET Core

A lista a seguir descreve as considerações de suporte para o código personalizado direcionado ao .NET Core do Microsoft.

• Qualquer cliente de serviço Web criado usando o Microsoft .NET Core 8 ou superior que chama os serviços Web do Dataverse tem suporte total.

Você pode ver a lista mais recente de destinos de compilação do .NET Core compatíveis no pacote NuGet Microsoft.PowerPlatform.Dataverse.Client.

Personalizações sem suporte

Modificações no Dataverse que sejam feitas sem usar os métodos descritos nesta documentação ou as ferramentas do Dataverse não são suportadas nem preservadas durante atualizações ou upgrades do Dataverse. Não há suporte para qualquer coisa que não esteja documentada nesta documentação e documentos de suporte. Além disso, modificações sem suporte podem causar problemas ao atualizar por meio da adição de hotfixes ou service packs ou atualização do Dataverse.

A seguir, está uma lista de tipos de ação sem suporte sobre os quais há perguntas frequentes:

• Fazendo referência a quaisquer DLLs (bibliotecas de vínculo dinâmico) do Dataverse que não sejam as seguintes:

  • Microsoft.Crm.Outlook.Sdk.dll
  • Microsoft.Crm.Sdk.Proxy.dll
  • Microsoft.Xrm.Sdk.dll
  • Microsoft.Xrm.Sdk.Data.dll
  • Microsoft.Xrm.Sdk.Deployment.dll
  • Microsoft.Xrm.Sdk.Workflow.dll
  • Microsoft.Xrm.Tooling.Connector.dll
  • Microsoft.Xrm.Tooling.CrmConnectControl.dll
  • Microsoft.Xrm.Tooling.PackageDeployment.CrmPackageExtentionBase.dll
  • Microsoft.Xrm.Tooling.WebResourceUtility.dll

• O uso de APIs (interfaces de programação de aplicativo) que não sejam as APIs documentadas nos serviços Web: API Web, SDK para .NET, Serviço de implantação, serviço de descoberta, serviço de Dados da Organização.

• Os conjuntos de plug-in e de fluxo de trabalho devem conter toda a lógica necessária dentro das respectivas DLLs. Os plug-ins podem fazer referência a alguns assemblies .NET principais. No entanto, não há suporte para dependências em assemblies .NET que interagem com APIs de Windows de baixo nível, como a interface de design gráfico. Anteriormente, o Dynamics 365 permitia que os assemblies fizessem referência a essas interfaces, mas, para atender aos nossos padrões de segurança, esse comportamento precisa ser alterado.

• Não há suporte para criar um assembly de plug-in para um assembly padrão do Dataverse (Microsoft.Crm.*.dll) nem para executar uma atualização ou exclusão de um pluginassembly criado pela plataforma.

• Registrar e executar plug-ins ou atividades de fluxo de trabalho personalizadas de assemblies destinados a qualquer versão do .NET Core.

• Não há suporte para editar um arquivo de soluções para editar quaisquer componentes de solução que não sejam faixas de opções, formulários, SiteMap ou consultas salvas. Para obter mais informações, consulte Quando editar o arquivo de personalizações. Não há suporte para definir novos componentes de solução editando o arquivo de soluções. Não há suporte para a edição de arquivos de recursos da Web exportados com uma solução. Exceto pelas etapas documentadas em Manter soluções gerenciadas, não há suporte para a edição do conteúdo de uma solução gerenciada.

Cliente Outlook

• Modificações em qualquer um dos formulários do Dynamics 365 ou a adição de novos formulários, como páginas .aspx personalizadas, diretamente no Office Outlook, ou alterações em arquivos .pst. Essas alterações não serão atualizadas.
• Fazer personalizações usando qualquer meio que não seja as ferramentas com suporte.

Consulte também

Personalizações com suporte para aplicativos controlados por modelo