Crie um pedido de suporte eficaz

Se uma aplicação não estiver a comportar-se como esperado, pode ser um problema com a sua configuração do Power Apps ou com um sistema fora do Power Apps.

Dependendo do problema, pode obter ajuda das seguintes pessoas ou organizações:

Diferenças entre erros de aplicações e erros do Power Apps

Um erro de aplicação é um comportamento inesperado numa determinada aplicação. Em comparação, um erro do Power Apps é um comportamento inesperado no sistema que cria, executa ou gere a aplicação. Um erro subjacente do Power Apps pode causar um erro de aplicação, dificultando determinar se o erro é um erro de aplicação ou do Power Apps.

Eis alguns sinais distintivos.

Exemplo de erros de aplicação

Os exemplos a seguir mostram erros de aplicação e como os utilizadores podem descrevê-los como passos aos proprietários da aplicação, para que os proprietários possam reproduzir e resolver os erros.

1. A aplicação de tela não mostra faturas.

   1. Inicie sessão na sua aplicação de tela, como Contoso.
   2. No seu ecrã Base, selecione As Minhas Faturas.
      • Comportamento esperado: as faturas criadas pelo utilizador são apresentadas.
      • Comportamento real: nenhuma fatura é mostrada.

2. A aplicação condicionada por modelo não mostra faturas.

   1. Inicie sessão na aplicação da Contoso no seu ambiente.
   2. Na página Dashboard, selecione Faturas no mapa do site.
   3. Na página Faturas, defina a vista como As minhas faturas ativas. A lista de faturas é apresentada.
      • Comportamento esperado: as faturas criadas pelo utilizador são apresentadas.
      • Comportamento real: nenhuma fatura é mostrada.

Os erros podem ter grande variância porque as funcionalidades, interfaces utilizador e tabelas são específicas de uma aplicação e organização, tornando a causa dos erros diferente para todos. Por exemplo, a fatura não é uma tabela incorporada no Power Apps. Não há um funcionalidade especializada em aplicações de tela para filtrar registos por um determinado utilizador, portanto, o criador da aplicação tem de escrever expressões do Power Fx ou de configurar conectores de dados. Da mesma forma, o criador tem de configurar Vistas em aplicações condicionadas por modelo para apresentar os registos desejados.

Não há informações suficientes em nenhum dos exemplos para determinar se há um problema com o Power Apps. Os criadores da aplicação são os mais adequados para investigar os problemas da aplicação.

Erros do Power Apps de exemplo

Se os criadores da aplicação investigarem e encontrarem o que classificam como um erro do Power Apps, poderão denunciá-lo de forma semelhante aos exemplos a seguir.

1. A função Filtrar da aplicação de tela não devolve resultados quando o texto do filtro contém o caráter asterisco

   1. Uma reprodução mínima da aplicação é anexada para demonstrar o problema.
   2. Esta aplicação contém uma coleção simples: TestTable com dados [{Name: "a"}, {Name: "*b"}].
   3. Há dois controlos Tabela na aplicação. Ambos os controlos estão configurados para mostrar a coluna Nome.
   4. A Tabela1 tem Itens definidos como Filter(TestTable, Name="a").
   5. A Tabela2 tem Itens definidos como Filter(TestTable, Name="*b").
      • Comportamento esperado: a Tabela1 mostra o registo {Name: "a"}, correspondendo à condição da função de Name="a". A Tabela2 mostra o registo {Name: "*b"}, correspondendo à condição da função de Name="*b".
      • Comportamento real: a Tabela1 mostra o registo esperado, mas a Tabela2 não mostra nenhum registo.
      • Notas: O mesmo comportamento é observado com outros controlos de conjunto de dados, como Galeria, quando Itens estão definidos para as mesmas expressões.

2. A Vista da aplicação condicionada por modelo não devolve resultados quando a condição do filtro contém o caráter asterisco

   1. Crie uma Vista para qualquer tabela.
   2. Remova todos os filtros da vista.
   3. Adicione um filtro para a coluna primária, correspondendo ao texto que começa por *b.
   4. Adicione esta vista e a tabela a qualquer aplicação condicionada por modelo.
   5. Guarde e publique todas as alterações.
   6. Execute a aplicação.
   7. Adicione alguns registos com valores diferentes para a coluna primária. Certifique-se de que uma coluna começa por *b.
   8. Aceda à página da tabela.
   9. Altere a vista para a vista recentemente criada.
      • Comportamento esperado: a grelha mostra registos com valores de coluna primária que começam por *b.
      • Comportamento real: nenhum registo é mostrado.
      • Notas: Quando a condição do filtro não utiliza um asterisco, como b, o filtro funciona como esperado.

Estes erros do Power Apps descrevem problemas com funcionalidades específicas do Power Apps: a função Filtro para aplicações de tela e Filtros de vista para a aplicação condicionada por modelo.

Um bom pedido de suporte fornece informações suficientes para qualquer pessoa reproduzir o problema facilmente. O autor pode mencionar o resultado das suas ações investigativas ou resolver problemas que tentou ao tentar isolar o problema. Por exemplo, o autor pode mencionar que o problema ocorre apenas no browser Chrome, mas não no Firefox.

Qual é o segredo de um bom pedido de suporte do Power Apps

Um bom pedido de suporte enquadra um problema como um erro do Power Apps, não como um erro de aplicação. Siga estas diretrizes, quando aplicável, para ajudar a Microsoft a entender e a resolver o problema rapidamente.

Ter um título descritivo

O título deve mencionar:

1. A caraterística específica do Power Apps
2. O comportamento inesperado
3. As condições que fazem com que o erro aconteça

Exemplo de um título incorreto: "O controlo Galeria está em branco"

Exemplo de um título correto: "A função Filtrar da aplicação de tela não devolve resultados quando o texto do filtro contém o caráter asterisco"

Anexe uma aplicação simplificada, não a aplicação original

Para problemas com a execução de uma aplicação, forneça um aplicação de reprodução mínima para aplicações de tela ou uma solução de reprodução simplificada para aplicações condicionadas por modelo.

Exceções

Uma aplicação de reprodução mínima ou simplificada nem sempre é viável ou necessária para estes problemas:

• Acesso a dados e guarda a partir de uma origem de dados específica
• Dados de utilizador específicos, como permissões de utilizador
• Licenciamento
• Operação offline
• Problemas gerais de servidor

Independentemente disto, simplifique a sua aplicação o máximo possível e isole o problema para aplicações de tela ou aplicações condicionadas por modelo.

Anexar um rastreio de rede

Para problemas de dados e de servidor, examinar as comunicações de rede entre o cliente e o servidor ajuda a isolar a camada problemática. Um registo de chamadas de rede é conhecido como rastreio de rede.

Pode usar o Monitor ou as ferramentas de desenvolvimento do browser para gravar um rastreio de rede.

Certifique-se de que começa a gravar pouco antes de reproduzir o problema e de que termina a gravação imediatamente depois de reproduzi-lo com sucesso. Este intervalo breve minimiza informações irrelevantes no rastreio que poderão causar atrasos no processamento do pedido de suporte pela Microsoft.

Forneça passos detalhado para reproduzir o problema

Se criou uma aplicação de reprodução mínima ou simplificada, descreva como reproduzir o problema nessa aplicação. Não descreva problemas com a aplicação onde encontrou originalmente o problema.

Mencione o comportamento observado e o comportamento esperado.

Forneça capturas de ecrã ou vídeos

Para problemas de interface de utilizador, capturas de ecrã ou vídeos podem esclarecer mais rapidamente os passos para reproduzir o erro, em vez de uma descrição escrita.

Associar à documentação oficial

Inclua ligações para a documentação da Microsoft para clarificar a funcionalidade afetada e o comportamento esperado.

Para problemas com caraterísticas de desenvolvimento profissional, forneça uma ligação para a documentação da função API que não funciona.

Simplificar amostras de código

Se o problema envolver codificação e outras caraterísticas de desenvolvimentos profissionais, simplifique o código primeiro. Normalmente, apenas algumas linhas de código são necessárias para demonstrar um erro do Power Apps. Implemente a aplicação num ambiente novo sem outras personalizações. Verifique se o problema ocorre e anexe um fragmento do código problemático.

Exemplos de caraterísticas de desenvolvimento profissional no Power Apps:

• Componentes do Power Apps
• Scripts de formulário personalizados em aplicações condicionadas por modelo
• Power Fx ou comandos do JavaScript em aplicações condicionadas por modelo
• Recursos Web para aplicações condicionadas por modelos

Mencione passos de configuração específica para que outras pessoas possam reproduzir o problema no seu próprio ambiente.

Fornecer informações do sistema

Um problema poderá acontecer apenas numa versão específica do Power Apps, num browser ou num ambiente. Forneça o ID da sessão para que a Microsoft possa usar esses detalhes.

Adicionar notas da sua investigação

Poderá tentar configurações diferentes para eliminar possíveis causas. Mencione estas definições no pedido de suporte. Esta inclusão ajuda outras pessoas a entenderem melhor o problema e a evitarem repetir os mesmos passos.

Submeter um pedido de suporte do Power Apps

Antes de submeter um pedido de suporte, verifique se o erro é um problema conhecido. Se o erro ainda não for conhecido, pode criar um pedido de suporte para reportá-lo.

Veja também

• Estratégias gerais de depuração do Power Apps