Práticas recomendadas para o desenvolvimento de suplementos do Office

Os suplementos eficazes oferecem uma funcionalidade exclusiva e fascinante que estende os aplicativos do Office de uma maneira visualmente atraente. Para criar um excelente suplemento, ofereça uma primeira experiência envolvente para seus usuários, desenvolva uma experiência de interface de usuário de alto nível e otimize o desempenho do seu suplemento. Aplique as práticas recomendadas descritas neste artigo para criar suplementos que ajudem os usuários a concluir suas tarefas de forma rápida e eficiente.

Fornecer um valor claro

• Crie suplementos que ajudem os usuários a concluir tarefas de forma rápida e eficiente. Concentre-se nos cenários que fazem sentido para aplicativos do Office. Por exemplo:
  • Torne as principais tarefas de criação mais rápidas e fáceis, com menos interrupções.
  • Habilite novos cenários no Office.
  • Incorpore serviços complementares nas aplicações do Office.
  • Melhore a experiência do Office para aumentar a produtividade.
• Certifique-se de que o valor do seu suplemento é claro para os utilizadores imediatamente ao criar uma experiência de primeira execução envolvente.
• Saiba como criar uma listagem eficaz do AppSource para promover o seu suplemento.
  • Deixe claro quais são os benefícios do seu suplemento no seu título e descrição. Não dependa da sua marca para comunicar o que seu suplemento faz.
  • O seu suplemento tem de fornecer valor suficiente para justificar o investimento dos utilizadores. O seu suplemento não deve ser um utilitário simples ou de âmbito limitado.
  • Se o seu suplemento destinar-se a grandes organizações e empresas, vários requisitos do AppSource diferem dos de um suplemento geral do marketplace comercial. Para obter mais informações, veja as FAQ de submissão.

Criar uma experiência envolvente na primeira execução

• Envolva os novos usuários com uma primeira experiência altamente útil e intuitiva. Observe que, mesmo depois de baixar o suplemento da loja, os usuários ainda estão decidindo se vão utilizá-lo.

• Deixe claro quais são as etapas que usuário terá que seguir para se envolver com seu suplemento. Use vídeos, diagramas, painéis de paginação ou outros recursos para atrair usuários.

• Reforce a proposta de valor do seu suplemento no início, em vez de apenas pedir que seus usuários entrem.

• Forneça uma interface do usuário informativa e torne sua interface do usuário pessoal.

  

• Se seu suplemento de conteúdo estiver vinculado a dados no documento do usuário, inclua exemplos de dados ou um modelo para mostrar aos usuários o formato de dados a ser usado.

  

• Ofereça avaliações gratuitas. Caso o suplemento exija uma assinatura, disponibilize algumas funcionalidades sem a necessidade da assinatura.

• Simplificar a experiência de inscrição. Informações de pré-preenchimento, como o e-mail e o nome a apresentar, e ignorar as verificações de e-mail.

• Evite janelas de pop-up. Se tiver de utilizá-los, oriente o utilizador para ativar a janela de pop-up.

Para padrões que podem ser aplicados ao desenvolver sua experiência de primeira execução, consulte Padrões de design da experiência do usuário para suplementos do Office.

Usar comandos de suplemento

• Fornece ao suplemento pontos de entrada relevantes da interface do usuário usando os comandos do suplemento. Confira mais detalhes, inclusive as práticas recomendadas de design, nos comandos de suplemento.

Aplicar os princípios de design de UX

• Assegure-se de que a aparência e a funcionalidade de seus suplementos complementam a experiência do Office. Consulte Estruturar a IU dos Suplementos do Office.

• Favoreça o conteúdo através do Chrome. Evite elementos de interface do usuário supérfluos que não agregam valor à experiência do usuário.

• Mantenha os usuários no controle. Verifique se os usuários compreenderam as decisões importantes e podem reverter facilmente as ações realizadas pelo suplemento.

• Use uma identidade visual para inspirar confiança e orientar os usuários. Não utilize a imagem corporativa para sobrecarregar ou anunciar aos utilizadores.

• Evite a necessidade de rolagem. Otimize para a resolução 1366 x 768.

• Não inclua imagens não licenciadas.

• Use uma linguagem clara e simples no seu suplemento.

• Preocupe-se com a acessibilidade: facilite a interação dos usuários com o seu suplemento e inclua tecnologias adaptativas, como leitores de tela.

• Desenvolva para todas as plataformas e métodos de entrada, incluindo teclado/mouse e toque. Certifique-se de que sua interface do usuário seja responsiva a diferentes fatores de forma.

Otimizar para toque

• Utilize a propriedade Context.touchEnabled para detetar se a aplicação do Office em que o seu suplemento é executado está ativada por toque.

  Observação

  Esta propriedade não é suportada no Outlook.

• Verifique se todos os controles são dimensionados adequadamente para interação por toque. Por exemplo, se os botões têm destinos de toque adequados e se as caixas de entrada têm a dimensão correta para que os usuários insiram entradas.

• Não dependa de métodos de entrada não táteis, como pairar o rato ou clicar com o botão direito do rato.

• Verifique se o suplemento funciona nos modos retrato e paisagem. Observe que parte do suplemento pode ficar oculta pelo teclado virtual em dispositivos de toque.

• Teste seu suplemento em um dispositivo real usando sideloading.

Otimizar e monitorar o desempenho do suplemento

• Crie a percepção de respostas rápidas da interface do usuário. Seu suplemento deverá ser carregado em 500 ms ou menos.

• Certifique-se de que todas as interações do usuário respondam em menos de um segundo.

• Forneça indicadores de carregamento para operações com longa execução.

• Utilize uma rede de entrega de conteúdos (CDN) para alojar imagens, recursos e bibliotecas comuns. Carregue o máximo possível de um só lugar.

• Siga as práticas da Web padrão para otimizar a página. Use apenas versões reduzidas das bibliotecas na produção. Carregue somente os recursos que você precisar e otimize como os recursos são carregados.

• Se o tempo de execução das operações demorar, forneça feedback aos usuários. Observe os limites relacionados na tabela a seguir. Saiba mais em Limites de recurso e otimização de desempenho para Suplementos do Office.

  Classe de interação	Target	Limite superior	Percepção humana
  Instantâneo	<=50 ms	100 ms	Nenhum atraso considerável.
  Rápida	50 – 100 ms.	200 ms	Atraso mínimo considerável. Não são necessários comentários.
  Típico	100 – 300 ms	500 ms	Rápido, mas não o suficiente para ser descrito como rápido. Não são necessários comentários.
  Dinâmico	300 – 500 ms.	1 segundo	Não muito rápido, embora pareça ser dinâmico. Não são necessários comentários.
  Contínuo	>500 ms	5 segundos	Tempo de espera médio, já não parece ser dinâmico. Podem ser necessários comentários.
  Cativo	>500 ms	10 segundos	Longo, mas não o suficiente para fazer executar outra ação. Podem ser necessários comentários.
  Estendida	>500 ms	>10 segundos	Longo o suficiente para realizar outra ação durante o tempo de espera. Podem ser necessários comentários.
  Longa execução	>5 segundos	>1 minuto	Os usuários certamente farão algo mais.

• Monitore a integridade do serviço e use a telemetria para monitorar o sucesso do usuário.

• Minimize as trocas de dados entre o suplemento e o documento do Office. Para obter mais informações, veja Evitar utilizar o método context.sync em ciclos.

Publicar e comercializar o seu suplemento

• Crie uma listagem eficaz no AppSource.

  • Use títulos sucintos e descritivos para o suplemento. Inclua no máximo 128 caracteres.

  • Escreva descrições curtas, apelativas e precisas do seu suplemento. Responda a pergunta "Qual problema este suplemento resolve?".

  • Transmita a proposta de valor do seu suplemento em seu título e descrição. Não confie apenas em sua marca.

• Crie um site para ajudar os usuários a encontrar e utilizar seu suplemento.

• Publique o suplemento no AppSource. Certifique-se de que segue a lista de verificação e o guia de submissãoda pré-publicação do AppSource.

  • Certifique-se de que o suplemento funciona sem erros em todos os sistemas operativos, browsers e dispositivos suportados pelo conjunto mínimo de APIs declarados no manifesto do suplemento.

  • Forneça instruções de teste detalhadas e recursos para os revisores de certificação verificarem a funcionalidade do seu suplemento.

• Promova o seu suplemento a partir do seu site.

Suporte para webviews mais antigos da Microsoft e versões do Office (recomendado, mas não obrigatório)

Consulte Suportar webviews mais antigos da Microsoft e versões do Office.

Confira também

• Visão geral da plataforma Suplementos do Office
• Saiba mais sobre o Programa para Desenvolvedores do Microsoft 365