Criar uma solicitação de suporte eficaz

Se um aplicativo não estiver se comportando conforme o esperado, pode ser um problema com sua configuração do Power Apps ou com um sistema fora do Power Apps.

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

Diferenças entre bugs do aplicativo e Power Apps bugs

Um bug de aplicativo é um comportamento inesperado em um aplicativo específico. Em comparação, um Power Apps bug é um comportamento inesperado no sistema que cria, executa ou gerencia o aplicativo. Um bug subjacente Power Apps pode causar um bug de aplicativo, tornando difícil determinar se o bug é de aplicativo ou Power Apps bug.

Aqui estão alguns sinais distintivos.

Erros de aplicativo de exemplo

Os exemplos a seguir mostram bugs de aplicativos e como os usuários podem descrevê-los como etapas para os proprietários de aplicativos, para que os proprietários possam reproduzir e resolver os bugs.

1. Aplicativo de tela não mostra faturas.

   1. Faça login no seu aplicativo de tela, como Contoso.
   2. Na página inicial, selecione Minhas faturas.
      • Comportamento esperado: as faturas criadas pelo usuário são exibidas.
      • Comportamento real: nenhuma fatura é mostrada.

2. Aplicativo baseado em modelo não mostra faturas.

   1. Faça login no aplicativo Contoso em seu ambiente.
   2. Na página Painel, selecione Faturas no mapa do site.
   3. Na página Faturas, defina a exibição como Minhas faturas ativas. A lista de faturas é exibida.
      • Comportamento esperado: as faturas criadas pelo usuário são exibidas.
      • Comportamento real: nenhuma fatura é mostrada.

Os bugs podem ter grande variação porque recursos, interfaces de usuário e tabelas são específicos para um aplicativo e organização, tornando a causa dos bugs diferente para todos. Por exemplo, fatura não é uma tabela interna no Power Apps. Não há um recurso especializado em aplicativos tela para filtrar registros por um determinado usuário, portanto, o criador de aplicativos deve escrever Power Fx expressões ou configurar conectores de dados. Da mesma forma, o criador deve configurar Exibições em aplicativos baseados em modelo para exibir os registros desejados.

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

Exemplos de bugs Power Apps

Se os criadores de aplicativos investigarem e encontrarem o que classificam como Power Apps bug, eles poderão reportá-los de forma semelhante aos exemplos a seguir.

1. A função de filtro do aplicativo de tela não retorna resultados quando o texto do filtro contém caractere de asterisco

   1. Um aplicativo mínimo de reprodução é anexado para demonstrar o problema.
   2. Este aplicativo contém uma coleção simples: TestTable com dados [{Name: "a"}, {Name: "*b"}].
   3. Há dois controles Tabela no aplicativo. Ambos os controles são configurados para mostrar a coluna Nome .
   4. Tabela1 tem Itens definidos como Filter(TestTable, Name="a").
   5. Tabela2 tem Itens definidos como Filter(TestTable, Name="*b").
      • Comportamento esperado: Tabela1 mostra o registro {Name: "a"}, correspondendo à condição da funçãoFiltroName="a". Tabela2 mostra o registro {Name: "*b"}, correspondendo à condição da funçãoFiltroName="*b".
      • Comportamento real: Tabela1 mostra o registro esperado, mas Tabela2 não mostra nenhum registro.
      • Observações: o mesmo comportamento é observado com outros controles de conjunto de dados, como Galeria, quando Itens são definidos com as mesmas expressões.

2. A Exibição do aplicativo baseado em modelo não retorna resultados quando a condição do filtro contém caractere de asterisco

   1. Criar uma Exibição para qualquer tabela.
   2. Remova todos os filtros da exibição.
   3. Adicione um filtro para a coluna primária, correspondendo ao texto que começa com *b.
   4. Adicione essa exibição e a tabela a qualquer aplicativo baseado em modelo.
   5. Salve e publique todas as alterações.
   6. Execute o aplicativo.
   7. Adicione alguns registros com valores diferentes para a coluna primária. Certifique-se de que uma coluna comece com *b.
   8. Vá para a página da tabela.
   9. Altere o modo de exibição para o modo de exibição recém-criado.
      • Comportamento esperado: grade mostra registros com valores de coluna primária que começam com *b.
      • Comportamento real: nenhum registro mostrado.
      • Observações: quando a condição do filtro não usa um asterisco, como b, o filtro funciona conforme o esperado.

Esses Power Apps bugs descrevem problemas com recursos específicos Power Apps: a função Filtro para o aplicativo de tela e filtros Exibição para o aplicativo baseado em modelo.

Uma boa solicitação de suporte fornece informações suficientes para que qualquer pessoa reproduza o problema facilmente. O autor pode mencionar o resultado de suas ações investigativas ou das soluções de problemas que tentou ao isolar o problema. Por exemplo, o autor pode mencionar que o problema ocorre apenas no navegador Chrome, mas não em Firefox.

Quais são os componentes de uma solicitação de suporte Power Apps de sucesso?

Uma boa solicitação de suporte enquadra um problema como um Power Apps bug, não um bug do aplicativo. Siga estas diretrizes, quando aplicável, para ajudar a Microsoft a entender e resolver o problema rapidamente.

Tenha um título descritivo

O título deve mencionar:

1. Um recurso Power Apps específico
2. O comportamento inesperado
3. As condições que causam o bug

Exemplo de um título incorreto: "O controle da galeria está em branco"

Exemplo de um bom título: "A função de filtro não retorna resultados quando o texto do filtro contém caractere de asterisco"

Anexar um aplicativo simplificado, não o aplicativo original

Para problemas com a execução de um aplicativo, forneça um aplicativo de reprodução mínima para aplicativos tela ou uma solução de reprodução simples para aplicativos baseados em modelo.

Exceções

Um aplicativo de reprodução mínima ou simples nem sempre é viável ou necessário para esses problemas:

• Acesso a dados e salvamentos de uma fonte de dados específica
• Dados específicos do usuário, como permissões de usuário
• Licenciamento
• Operação offline
• Problemas gerais do servidor

Independentemente disso, simplifique seu aplicativo o máximo possível e isole o problema para de tela ou aplicativos baseados em modelo.

Anexar um rastreamento de rede

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

Você pode usar o Monitor ou as ferramentas de desenvolvimento do navegador para registrar um rastreamento de rede.

Certifique-se de começar a gravar pouco antes de reproduzir o problema e terminar a gravação diretamente depois de reproduzi-lo com sucesso. Esse breve intervalo minimiza informações irrelevantes no rastreamento que podem causar atrasos no processamento da solicitação de suporte pela Microsoft.

Forneça etapas detalhadas para reproduzir o problema

Se você criou um aplicativo de reprodução mínima ou simples, descreva como reproduzir o problema nesse aplicativo. Não descreva problemas com o aplicativo onde você encontrou o problema originalmente.

Mencione o comportamento observado e o comportamento esperado.

Fornecer capturas de tela ou vídeos

Para problemas de interface do usuário, capturas de tela ou vídeos podem esclarecer mais rapidamente as etapas para reproduzir o bug, em vez de uma descrição escrita.

Link para documentação da política

A documentação da Microsoft existe para o recurso afetado e explica o comportamento esperado

Para problemas com recursos de desenvolvimento profissional, forneça um link para a documentação da função de API que não funciona.

Simplificar exemplos de código

Se o problema envolver codificação e outros recursos de desenvolvimento profissional, simplifique o código primeiro. Normalmente, apenas algumas linhas de código são necessárias para demonstrar um Power Apps bug. Implante o aplicativo em um ambiente novo sem outras personalizações. Verifique se o problema ocorre e anexe um trecho do código problemático.

Exemplos de características de desenvolvimento profissional em Power Apps:

• Componentes do Power Apps
• Personalizar scripts de formulário em aplicativos baseados em modelo
• Power Fx ou comandos JavaScript em aplicativos baseados em modelo
• Recursos da Web para aplicativos controlados por modelo

Mencione etapas de configuração específicas para que outras pessoas possam reproduzir o problema em seu próprio ambiente.

Fornecer informações do sistema

Um problema pode ocorrer apenas em uma versão específica de Power Apps, um navegador ou um ambiente. Forneça a ID da sessão para que Microsoft possa usar esses detalhes.

Adicionar anotações de sua investigação

Você pode tentar configurações diferentes para eliminar possíveis causas. Mencione essas configurações na solicitação de suporte. Essa inclusão ajuda outras pessoas a entender melhor o problema e evitar repetir os mesmos etapas.

Enviar uma solicitação de suporte para Power Apps

Antes de enviar uma solicitação de suporte, verifique se o bug é um problema conhecido. Se o erro ainda não for conhecido, você pode criar uma solicitação de suporte para relatar o erro.

Consultar também

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