Partilhar via

Como criar um aplicativo baseado em modelo de reprodução de baunilha

  • Artigo

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

Baunilha significa que não há personalizações. Portanto, um ambiente de baunilha é um ambiente em seu estado original, como uma nova instalação. Usar um ambiente de baunilha 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 de baunilha, você pode compartilhá-lo com outras pessoas, como na Comunidade do Microsoft Power Apps ou por meio de Suporte da Microsoft.

Criar um ambiente de baunilha

Um ambiente de baunilha não se refere a nenhum tipo específico de ambiente no Power Platform. Você pode criar um novo ambiente de avaliação, área restrita ou desenvolvedor para usar como um ambiente de baunilha. 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) fora da caixa, como Contas e Contatos. Para resolver problemas com tabelas personalizadas, você pode criar outras semelhantes no ambiente de baunilha. 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 amostra

Um ambiente de baunilha inicialmente não tem dados. Para problemas simples, você pode adicionar manualmente algumas linhas (registros). Você também pode adicionar dados de exemplo para tabelas fora da caixa.

Se um problema exigir que dados específicos sejam 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 controlado por modelos.

Simplificar personalizações de desenvolvedor

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

Isolar páginas personalizadas

Páginas personalizadas são um tipo especial de aplicativo de tela. Você pode criar um aplicativo de tela de repro 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 poderá estar relacionado à forma como a página personalizada é integrada ao aplicativo controlado pelo modelo. Para investigar mais, crie uma versão simplificada da página personalizada em um novo aplicativo controlado por modelos.

Exportar o aplicativo de reprodução de baunilha

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

Ele deve incluir personalizações relevantes, como:

  • Um aplicativo controlado por modelos (se não for um aplicativo padrão do Microsoft Dynamics 365, como o Customer Service Hub ou o Sales Hub.)
  • Páginas personalizadas
  • Painéis
  • Formulários
  • Relações
  • Tabelas
  • Exibições

Em seguida, você pode exportar o aplicativo de reprodução de baunilha 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 de baunilha diferente e marcar 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 a serem incluídas com o aplicativo de reprodução de baunilha.

Dados de exemplo

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 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 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 de baunilha. É útil descrever como essas personalizações são feitas para que outras pessoas possam recriá-las.

Por que não posso reproduzir um problema em um ambiente de baunilha

Se um problema não puder ser reproduzido em um ambiente de baunilha, você precisará marcar 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. Examinando sistematicamente diferentes tipos de personalizações, você pode descobrir as condições que reproduzem o problema.

Aqui estão algumas razões pelas 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 de baunilha 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 de baunilha e o ambiente em que o problema ocorre.
  • Os componentes podem estar corrompidos. Para confirmar se esse é o caso, recrie-os no ambiente em que o problema ocorre.
  • Motivos específicos do usuário. Por exemplo, alguns usuários têm funções de segurança diferentes em um ambiente. Para confirmar se esse é o caso, tente maneiras alternativas de acessar os dados ou executar a mesma tarefa. Tabelas do Dataverse podem ser acessadas de várias maneiras, como em aplicativos controlados por modelo, aplicativos de tela, designer de tabelas 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 no aplicativo ou detalhes 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 de baunilha.

Próximas etapas

Confira também