Personalizar aplicativos controlados por modelos usando código

Saiba como personalizar aplicativos controlados por modelos usando ferramentas de Power Apps com suporte e código documentado. Este artigo ajuda você a identificar métodos compatíveis e atualizáveis para que você possa evitar problemas de personalização durante atualizações e atualizações.

As personalizações feitas usando métodos diferentes dos descritos aqui não têm suporte e podem causar problemas durante atualizações e atualizações para aplicativos controlados por modelos. Para obter mais informações, consulte personalizações sem suporte posteriormente neste tópico.

As personalizações feitas usando métodos diferentes dos descritos neste artigo não têm suporte e podem causar problemas durante atualizações e atualizações para aplicativos controlados por modelos. Para obter mais informações, consulte personalizações sem suporte posteriormente neste artigo.

Personalizações usando Power Apps

Artigos técnicos publicados em Microsoft sites como este dão suporte aos tópicos que abordam, mas podem não dar suporte à capacidade de atualização.

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 Visão geral da criação de aplicativos controlados por modelos
• Configurações no aplicativo Web. Para obter mais informações, consulte Administrar aplicativos controlados por modelos.
• Serviços de Relatório Para obter mais informações, consulte o guia de relatórios e análise para aplicativos controlados por modelos.

Personalizações aplicadas usando código

A documentação neste site para desenvolvedores, artigos técnicos, 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.

JavaScript do Lado do Cliente

Você pode usar JavaScript em aplicativos controlados por modelos em três áreas:

• Manipuladores de eventos do Script de Formulário: você pode configurar manipuladores de eventos de formulário para chamar funções definidas em recursos Web JavaScript.
• Comandos da barra de comandos (faixa de opções): você pode usar os elementos <CustomRule> ou <JavaScriptFunction> definir ações que chamam funções definidas nos recursos da Web do JavaScript.
• Recursos da Web e IFRAMEs: você pode usar recursos Web do JavaScript em recursos da Web HTML. IFRAMES configurado para permitir scripts entre sites ou scripts dentro de recursos da Web HTML incluídos em um formulário, pode interagir com os métodos documentados Xrm.Page ou Xrm.Utility dentro do formulário por meio da referência pai.

Toda a interação com as páginas do aplicativo deve usar apenas os métodos documentados na Referência de API do Cliente para aplicativos controlados por modelos. Não há suporte para acessar diretamente o DOM (Modelo de Objeto de Documento) de qualquer página de aplicativos controlados por modelos. Não use jQuery em scripts e comandos de formulário. Para obter mais informações, consulte scripts de cliente em aplicativos controlados por modelos usando JavaScript.

Você pode abrir formulários, exibições, diálogos e relatórios de aplicativos controlados por modelo usando os métodos documentados em formulários abertos, exibições, caixas de diálogo e relatórios com uma URL.

Personalização da faixa de opções

Você pode usar RibbonDiffXml para adicionar, remover ou ocultar elementos da faixa de opções. Você pode reutilizar comandos de faixa de opções definidos por aplicativos controlados por modelos; no entanto, Microsoft reserva o direito de alterar ou preterir os comandos disponíveis. Não é possível reutilizar funções JavaScript definidas nos comandos da faixa de opções.

Personalizações sem suporte

Não há suporte para modificações em aplicativos controlados por modelos que você faz sem usar os métodos descritos nesta documentação ou Power Apps ferramentas. Atualizações ou atualizações de aplicativos controlados por modelos não preservam essas modificações. Não há suporte para qualquer coisa que não esteja documentada nesta documentação e documentos de suporte. Modificações sem suporte podem causar problemas quando você atualiza por meio da adição de correções frequentes ou service packs ou aplicativos baseados em modelos de atualização.

A lista a seguir inclui tipos de ação sem suporte que são frequentemente questionados sobre:

• Reutilizando qualquer código JavaScript de aplicativos controlados por modelos. Esse código pode ser alterado ou substituído durante uma atualização.

• Não há suporte para a edição de 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 a definição de 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.

• Não há suporte para exibir um formulário em um IFrame inserido em outro formulário.

Consulte também

Personalizações com suporte para o Dataverse
Aplicar a lógica de negócios usando scripts de clientes em aplicativos baseados em modelos com JavaScript
Personalizar os comandos e a faixa de opções
Recursos da Web em aplicativos controlados por modelos