Procedimientos recomendados para desarrollar complementos de Office

Los complementos eficaces ofrecen una funcionalidad única y atractiva que amplía las aplicaciones de Office de forma visualmente interesante. Para crear un complemento excelente, proporcione una experiencia atractiva la primera vez para sus usuarios, diseñe una experiencia de interfaz de usuario de primera clase y optimice el rendimiento de los complementos. Aplique los procedimientos recomendados descritos en este artículo para crear complementos que ayuden a los usuarios a completar las tareas de forma rápida y eficaz.

Proporcionar un valor claro

• Cree complementos que ayuden a los usuarios a completar las tareas con rapidez y eficacia. Céntrese en escenarios relevantes para las aplicaciones de Office. Por ejemplo:
  • Realizar las tareas de creación básicas de formas más rápida y fácil, y reducir las interrupciones.
  • Habilitar escenarios nuevos dentro de Office.
  • Insertar servicios complementarios en aplicaciones de Office.
  • Mejorar la experiencia de Office para aumentar la productividad.
• Asegúrese de que el valor del complemento sea claro para los usuarios de inmediato mediante la creación de una experiencia de primera ejecución atractiva.
• Cree una descripción eficaz para AppSource. Asegúrese de que las ventajas del complemento aparezcan claramente en el título y la descripción. No se base en su marca para comunicar lo que hace el complemento.

Crear una atractiva experiencia de primera vista

• Atraiga nuevos usuarios con una primera experiencia muy útil e intuitiva. Recuerde que los usuarios aún están decidiendo si usar o abandonar un complemento después de descargarlo desde la tienda.

• Para que el usuario se sienta atraído por el complemento, los pasos a seguir deben ser claros. Use vídeos, hojas de instrucciones, paneles de paginación u otros recursos para seducir a los usuarios.

• Refuerce la propuesta de valor del complemento en el inicio en lugar de limitarse a pedir a los usuarios que inicien sesión.

• Ofrezca interfaz de usuario de enseñanza para guiar a los usuarios y hacer que la interfaz de usuario sea personal.

  

• Si el complemento de contenido se enlaza a los datos en el documento del usuario, incluya una plantilla o datos de ejemplo para mostrar a los usuarios el formato de datos que hay que usar.

  

• Ofrezca pruebas gratuitas. Si el complemento requiere una suscripción, haga que ciertas funcionalidades estén disponibles sin una suscripción.

• Simplifica la experiencia de registro. Rellenar previamente la información, como el correo electrónico y el nombre para mostrar, y omitir las comprobaciones de correo electrónico.

• Evite ventanas emergentes. Si tiene que usarlos, guíe al usuario para habilitar la ventana emergente.

Para ver modelos que puede aplicar al desarrollar su experiencia de primera ejecución, vea Modelos de diseño de la experiencia del usuario para complementos de Office.

Usar comandos de complementos

• Proporcionar puntos de entrada de interfaz de usuario relevantes para el complemento mediante los comandos del complemento. Para obtener información detallada, incluidas las recomendaciones para el diseño, consulte comandos de complementos.

Aplicar principios de diseño de experiencia del usuario

• Asegúrese de que la apariencia y las funciones del complemento se adapten a la experiencia de Office. Consulte Diseño de la interfaz de usuario de los complementos de Office.

• Dé prioridad al contenido sobre el contenedor visual. Evite elementos superfluos de interfaz de usuario que no agreguen valor a la experiencia del usuario.

• Mantenga a los usuarios bajo control. Asegúrese de que comprendan las decisiones importantes y puedan revertir fácilmente las acciones que el complemento realiza.

• Use la personalización de marca para inspirar confianza y orientar a los usuarios. No la use para saturar o invadir con anuncios a los usuarios.

• Evite el desplazamiento. Optimice para una resolución de 1366 x 768.

• No incluya imágenes sin licencia.

• Use un lenguaje claro y sencillo en el complemento.

• Tenga en cuenta la accesibilidad: cree un complemento con el que todos los usuarios puedan interactuar fácilmente y se adapte a las tecnologías de asistencia como los lectores de pantalla.

• Diseñe para todas las plataformas y métodos de entrada, como mouse o teclado y función táctil. Garantice que la interfaz de usuario responda a distintos factores de forma.

Optimizar para la función táctil

• Use la propiedad Context.touchEnabled para detectar si la aplicación de Office en la que se ejecuta el complemento está habilitada para el uso táctil.

  Nota:

  Esta propiedad no se admite en Outlook.

• Asegúrese de que todos los controles tengan el tamaño adecuado para la interacción táctil. Por ejemplo, los botones tienen destinos táctiles adecuados y los cuadros de entrada son lo suficientemente grandes para que los usuarios escriban datos.

• No dependa de métodos de entrada no táctiles, como mantener el puntero o hacer clic con el botón derecho.

• Asegúrese de que el complemento funcione en orientación vertical y horizontal. Tenga en cuenta que, en los dispositivos táctiles, el teclado en pantalla podría ocultar parte del complemento.

• Pruebe el complemento en un dispositivo real mediante transferir localmente.

Optimizar y supervisar el rendimiento de los complementos

• Cree la percepción de respuestas rápidas de interfaz de usuario. El complemento debería cargarse en 500 milisegundos o menos.

• Asegúrese de que todas las interacciones del usuario respondan en menos de un segundo.

• Proporcione indicadores de carga para las operaciones de larga duración.

• Use una red de entrega de contenido (CDN) para hospedar imágenes, recursos y bibliotecas comunes. Cargue tanto como pueda desde un solo lugar.

• Siga las prácticas web estándar para optimizar su página web. En producción, use solo versiones reducidas de las bibliotecas. Cargue únicamente los recursos que necesita y optimice cómo se cargan los recursos.

• Si las operaciones tardan tiempo en ejecutarse, informe a los usuarios. Tenga en cuenta los umbrales enumerados en la tabla siguiente. Para más información, vea Límites de recursos y optimización de rendimiento para los complementos de Office

  Clase de interacción	Target	Límite superior	Percepción humana
  Instantánea	<=50 ms	100 ms	No se percibe demora.
  Rápido	50-100 ms	200 ms	Demora mínimamente perceptible. No es necesario informar.
  Típica	100-300 ms	500 ms	Breve, pero demasiado lenta para describirse como rápida. No es necesario informar.
  Respuesta correcta	300-500 ms	1 segundo	No es rápida, pero la respuesta se percibe como correcta. No es necesario informar.
  Continuo.	>500 ms	5 segundos	Espera media, ya no responde correctamente. Podrían necesitarse comentarios.
  Cautiva	>500 ms	10 segundos	Larga, pero no lo suficiente para poder hacer otra cosa. Podría ser necesario informar.
  Extendido	>500 ms	>10 segundos	Suficientemente larga para poder hacer otra cosa mientras se espera. Podría ser necesario informar.
  Ejecución prolongada	>5 segundos	>1 minuto	Los usuarios ciertamente harán otra cosa.

• Supervise el estado del servicio y use telemetría para supervisar el éxito del usuario.

• Minimice los intercambios de datos entre el complemento y el documento de Office. Para obtener más información, vea Evitar el uso del método context.sync en bucles.

Comercializar el complemento

• Publique su complemento en AppSource y promuévalo desde su sitio web. Cree una descripción de AppSource eficaz.

• Use títulos concisos y descriptivos para el complemento. No incluya más de 128 caracteres.

• Transmita la propuesta de valor de su complemento en el título y la descripción. No dependa de la marca.

• Transmita la propuesta de valor de su complemento en el título y la descripción. No dependa de la marca.

• Cree un sitio web para ayudar a los usuarios a buscar y usar el complemento.

Compatibilidad con versiones anteriores de Microsoft WebView y Office (recomendadas pero no necesarias)

Consulte Compatibilidad con versiones anteriores de Microsoft WebViews y Office.

Consulte también

• Información general sobre la plataforma de complementos de Office
• Infórmese sobre el Programa de desarrolladores de Microsoft 365