Partilhar via

Como criar um aplicativo baseado em modelo de reprodução básica

  • Artigo

Um aplicativo de reprodução básico é um aplicativo baseado em modelo que reproduz um problema em um ambiente básico. Ao contrário dos aplicativos de tela, os aplicativos baseados em modelo no mesmo ambiente compartilham personalizações, como scripts de cliente e plug-ins de servidor. Portanto, pode ser um desafio determinar se um problema é causado por uma personalização incorreta ou por um problema do produto.

Vanilla significa sem personalizações. Portanto, um ambiente vanilla é um ambiente em seu estado original, como uma nova instalação. Usar um ambiente vanilla com modificações mínimas para reproduzir um problema pode ajudar a descartar a possibilidade de um erro de configuração.

Depois de criar um aplicativo de reprodução básico, você pode compartilhá-lo com outras pessoas, como na Comunidade do Microsoft Power Apps ou por meio do Suporte da Microsoft.

Crie um ambiente vanilla

Um ambiente básico não se refere a nenhum tipo específico de ambiente no Power Platform. Você pode criar um novo ambiente de avaliação, sandbox ou desenvolvedor para usar como um ambiente básico. Mas você precisa de uma licença apropriada.

Se você não tiver uma licença para criar novos ambientes, considere simplificar as personalizações em seu ambiente.

Recriar tabelas personalizadas e outros componentes

O Microsoft Power Apps e o Microsoft Dynamics 365 têm algumas tabelas (entidades) prontas para uso, como Contas e Contatos. Para resolver problemas com tabelas personalizadas, você pode criar tabelas semelhantes no ambiente básico. Você não precisa copiar a configuração exata. Por exemplo, se o problema for com uma coluna (campo) de uma tabela, crie a coluna para uma nova tabela.

O mesmo princípio se aplica a quaisquer personalizações, como regras de negócios, comandos, formulários e exibições.

Criar dados de exemplo

Um ambiente vanilla inicialmente não tem dados. Para problemas simples, você pode adicionar manualmente algumas linhas (registros). Você também pode adicionar dados de amostra para tabelas prontas para uso.

Se um problema exigir dados específicos para serem reproduzidos, você poderá preparar um arquivo .csv ou Excel e importar dados usando o centro de administração do Power Platform ou importar dados para um aplicativo baseado em modelo.

Simplifique as personalizações do desenvolvedor

Algumas personalizações avançadas exigem conhecimento de programação. Isso inclui scripts de cliente, componentes de código (controles personalizados), comandos clássicos, plug-ins e recursos da Web. Se eles forem necessários para reproduzir um problema, simplifique-os o máximo possível. Remova todas as linhas de código irrelevantes e referências a bibliotecas de terceiros.

Isolar páginas personalizadas

As páginas personalizadas são um tipo especial de aplicativo de tela. Você pode criar um aplicativo de tela de reprodução mínima para demonstrar problemas com páginas personalizadas. Primeiro, crie um aplicativo de tela regular com dados de exemplo. Se o problema não ocorrer, ele pode estar relacionado a como a página personalizada é integrada ao aplicativo baseado em modelo. Para investigar mais, crie uma versão simplificada da página personalizada em um novo aplicativo baseado em modelo.

Exporte o aplicativo de reprodução de baunilha

Depois de verificar se existe um problema em um ambiente básico, você pode criar uma solução não gerenciada para o aplicativo de reprodução.

Deve incluir personalizações relevantes, como:

  • Um aplicativo baseado em modelo (se não for um aplicativo padrão do Microsoft Dynamics 365, como o Hub do SAC ou o Hub de Vendas.)
  • Páginas personalizadas
  • Painéis
  • Formulários
  • Relações
  • Tabelas
  • Exibições

Em seguida, você pode exportar o aplicativo de reprodução básico e quaisquer personalizações relevantes em uma solução não gerenciada.

Para verificar se os componentes necessários foram incluídos, importe a solução para um ambiente vanilla diferente e verifique se o problema pode ser reproduzido.

Às vezes, outros materiais necessários não podem ser empacotados em soluções. Aqui estão algumas outras coisas para incluir no aplicativo de reprodução vanilla.

Dados de amostra

Alguns problemas exigem dados específicos para serem reproduzidos. Como os dados não são exportados em uma solução, você precisa fornecer um arquivo .csv ou Excel com os dados necessários. Lembre-se de remover todos os dados privados e confidenciais.

Código-fonte

Personalizações avançadas criadas usando JavaScript e C# podem ser difíceis de empacotar em uma solução, por exemplo, comandos clássicos ou plug-ins.

É mais fácil explicar o problema fornecendo uma cópia do código-fonte e citando as linhas de código relevantes. Especifique as APIs que não estão funcionando conforme o esperado.

Descrever personalizações complexas

Se as personalizações forem complicadas, pode ser difícil para outras pessoas entenderem, mesmo que tenham um aplicativo de reprodução básico. É útil descrever como essas personalizações são feitas para que outras pessoas possam recriá-las.

Por que não consigo reproduzir um problema em um ambiente vanilla

Se um problema não puder ser reproduzido em um ambiente básico, você precisará verificar a configuração. Alguns fatores ausentes podem não ser contabilizados no ambiente de baunilha.

O fato de um problema não ocorrer em um ambiente é uma pista importante. Ao examinar sistematicamente diferentes tipos de personalizações, você pode descobrir as condições que reproduzem o problema.

Aqui estão alguns motivos pelos quais um problema ocorre em um ambiente, mas não em outro:

  • As personalizações estão interferindo na operação normal. Para confirmar se esse é o caso, adicione essas personalizações uma a uma ao ambiente básico ou remova-as do ambiente em que o problema ocorre.
  • Tabelas, relações e outros componentes são configurados de forma diferente. Para confirmar se esse é o caso, reexamine as diferenças entre os mesmos componentes no ambiente vanilla e no ambiente onde o problema ocorre.
  • Os componentes podem estar corrompidos. Para confirmar se esse é o caso, recrie-os no ambiente em que o problema ocorre.
  • Razões específicas do usuário. Por exemplo, alguns usuários têm direitos de acesso diferentes em um ambiente. Para confirmar se esse é o caso, tente maneiras alternativas de acessar os dados ou executar a mesma tarefa. As tabelas do Dataverse podem ser acessadas de várias maneiras, como em aplicativos baseados em modelo, aplicativos de tela, designer de tabela do Power Apps, Power Pages e solicitações de API Web.
  • Versões diferentes. O ambiente pode ser uma versão diferente ou em uma região geográfica diferente. Verifique a seção Sobre nos detalhes do aplicativo ou do ambiente no centro de administração do Power Platform para obter detalhes da versão.
  • Problemas com o servidor de um ambiente. Para confirmar se esse é o caso, examine o tráfego de rede para determinar se o servidor está enviando as informações corretas. Compare-o com o tráfego de rede no ambiente vanilla.

Próximas etapas

Confira também