Práticas recomendadas para o desenvolvimento de suplementos do Office

Artigo
05/24/2023

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.

Observação

Se você planeja publicar o seu suplemento no AppSource e disponibilizá-lo na experiência do Office, certifique-se de que está em conformidade com as políticas de certificação do Marketplace Comercial. Por exemplo, para passar na validação, o suplemento deve funcionar em todas as plataformas com suporte para os métodos definidos (saiba mais na seção 1120.3 e na página de aplicativo e disponibilidade do Suplemento do Office).

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.
- Insira serviços complementares em aplicativos do Office.
- Melhore a experiência do Office para aumentar a produtividade.
Verifique se o valor do suplemento está claro para os usuários imediatamente criando uma experiência de primeira execução envolvente.
Crie uma listagem eficaz no AppSource. Deixe claro quais são os benefícios do seu suplemento no título e na descrição. Não dependa da sua marca para comunicar o que seu suplemento faz.

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.
Torne a experiência de inscrição simples. Informações de pré-preenchimento, como email e nome de exibição, e ignorar verificações de email.
Evite janelas pop-up. Se você precisar usá-las, guie o usuário para habilitar sua janela 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 Projetar a interface do usuário 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 use o recurso de identidade visual para sobrecarregar ou enviar anúncios aos usuários.
Evite a necessidade de rolagem. Otimize para a resolução 1366 x 768.
Não inclua imagens sem licença.
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

Use a propriedade Context.touchEnabled para detectar se o aplicativo do Office em que seu suplemento é executado está habilitado para toque.

Observação

Essa propriedade não tem suporte 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 confie em métodos de entrada sem toque, como passar o mouse ou clicar com o botão direito do mouse.
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.

Observação

Se você estiver usando a interface do usuário fluente React para seus elementos de design, muitos desses elementos serão incorporados ao sistema de design.

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.
Use uma CDN (rede de entrega de conteúdo) para hospedar 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.
Minimizar as trocas de dados entre o suplemento e o documento do Office. Para obter mais informações, consulte Evitar usar o método context.sync em loops.

Comercializar seu suplemento

Publique seu suplemento no AppSource e promova-o em seu site. 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 e atraentes para o 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.

Suporte a visões web mais antigas da Microsoft e versões do Office (recomendadas, mas não necessárias)

Consulte Suporte a versões mais antigas da Webviews da Microsoft e do Office.