Procedimientos recomendados para desarrollar complementos de Office

Los excelentes complementos proporcionan una funcionalidad única y atractiva que amplía las aplicaciones de Office de maneras visualmente atractivas. Para crear un complemento correcto, deberá crear una experiencia de usuario atractiva por primera vez, diseñar una interfaz de usuario pulida y optimizar el rendimiento. Siga los procedimientos recomendados de este artículo para ayudar a los usuarios a completar tareas de forma rápida y eficaz.

Nota:

Si tiene previsto publicar el complemento en Microsoft Marketplace y hacer que esté disponible en la experiencia de Office, asegúrese de que cumple las directivas de certificación de Marketplace comercial. Por ejemplo, para superar la validación, el complemento debe funcionar en todas las plataformas que sean compatibles con los métodos especificados (para más información, vea la sección 1120.3 y la página de disponibilidad y aplicación del complemento de Office).

Proporcionar un valor claro

Cree complementos que ayuden a los usuarios a completar tareas de forma rápida y eficaz. Céntrese en escenarios que tengan sentido para las aplicaciones de Office, como:

• Haga que las tareas de creación principales sean más rápidas y fáciles con menos 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 los usuarios comprendan el valor del complemento inmediatamente mediante la creación de una experiencia de primera ejecución atractiva.

Cuando esté listo para promocionar el complemento, obtenga información sobre cómo crear una descripción eficaz de Microsoft Marketplace.

• Dejar claras las ventajas del complemento en el título y la descripción. No dependa solo de su marca para comunicar lo que hace el complemento.
• Asegúrese de que el complemento proporciona un valor suficiente para justificar la inversión de los usuarios. No debe ser solo una utilidad simple o tener un ámbito limitado.
• Si el complemento se dirige a organizaciones y empresas más grandes, varios requisitos de Microsoft Marketplace difieren de los de un complemento de Marketplace comercial general. Para obtener más información, consulte las preguntas más frecuentes sobre el envío.

Crear una atractiva experiencia de primera vista

Los nuevos usuarios siguen decidiendo si usar o abandonar el complemento después de descargarlo desde la tienda. Aquí te mostremos cómo ganarlos.

• Desactive los pasos siguientes. Use vídeos, marcadores, paneles de paginación u otros recursos para guiar a los usuarios a través del complemento.

• Cliente potencial con valor, no registro. Refuerce la propuesta de valor del complemento cuando se inicie, en lugar de pedir inmediatamente a los usuarios que inicien sesión.

• Proporcionar instrucciones útiles. Incluya la interfaz de usuario de enseñanza para guiar a los usuarios y hacer que la experiencia se sienta personal.

  

• Mostrar a los usuarios lo que se espera. Si el complemento de contenido se enlaza a los datos del documento del usuario, incluya datos de ejemplo o una plantilla para mostrar a los usuarios el formato de datos esperado.

  

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

• Simplifique el registro. Rellenar previamente información como el correo electrónico y el nombre para mostrar, y omitir las comprobaciones de correo electrónico cuando sea posible.

• Evite elementos emergentes. Si debe usarlos, guíe a los usuarios sobre cómo habilitar la ventana emergente.

Para ver los patrones que puede aplicar al desarrollar su experiencia de primera ejecución, consulte Patrones de diseño de experiencia de 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. Estos comandos ayudan a los usuarios a detectar y acceder a la funcionalidad del complemento directamente desde la cinta de Office. Para más información y procedimientos recomendados de diseño, consulte comandos de complemento.

Aplicar principios de diseño de experiencia del usuario

Siga estos principios clave para crear complementos que se sientan nativos de Office:

• Coincide con la experiencia de Office. Asegúrese de que la apariencia, la funcionalidad y la apariencia del complemento complementan la experiencia de Office. Consulte Diseño de la interfaz de usuario de los complementos de Office.

• Priorice el contenido sobre el cromo. Evite elementos de interfaz de usuario innecesarios que no agreguen valor a la experiencia del usuario.

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

• Use la personalización de marca cuidadosamente. Inspire confianza y ayude a orientar a los usuarios, pero no abrume ni anuncie a ellos.

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

• Use solo imágenes con licencia. Evite problemas legales y de personalización de marca que provienen de imágenes sin licencia.

• Escribir con claridad. Use un lenguaje claro y sencillo en el complemento.

• Diseño para accesibilidad. Haga que el complemento sea fácil para que todos los usuarios interactúen con tecnologías de asistencia, como los lectores de pantalla, y se adapten a ellas. Consulte nuestras directrices de accesibilidad.

• Admite todas las plataformas y métodos de entrada. Diseño para mouse/teclado y táctil. Asegúrese de que la interfaz de usuario responde bien a diferentes factores de forma.

Optimizar para la función táctil

La compatibilidad táctil es esencial para los complementos de Office modernos.

• Detecte la compatibilidad 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 la función táctil.

  Nota:

  Esta propiedad no se admite en Outlook.

• Controles de tamaño adecuados. Asegúrese de que todos los controles funcionen bien con la interacción táctil. Por ejemplo, los botones necesitan destinos táctiles adecuados y los cuadros de entrada deben ser lo suficientemente grandes como para que los usuarios escriban texto fácilmente.

• No se base en mantener el mouse o hacer clic con el botón derecho. Estos métodos de entrada no están disponibles en dispositivos táctiles.

• Admite ambas orientaciones. Asegúrese de que el complemento funciona en los modos vertical y horizontal. Recuerde que, en los dispositivos táctiles, el teclado suave podría ocultar parte del complemento.

• Prueba en dispositivos reales. Use la instalación local para probar el complemento en dispositivos táctiles reales.

Optimizar y supervisar el rendimiento de los complementos

El rendimiento afecta directamente a la satisfacción del usuario. Siga estas directrices para mantener el complemento rápido y con capacidad de respuesta:

• Apunta a una carga rápida. El complemento debe cargarse en 500 ms o menos para crear la percepción de respuestas rápidas de la interfaz de usuario.

• Responder rápidamente a las interacciones. Todas las interacciones del usuario deben responder en menos de un segundo.

• Mostrar el progreso de las operaciones largas. Proporcione indicadores de carga para las operaciones que tardan tiempo.

• Use una red CDN. Hospedar imágenes, recursos y bibliotecas comunes en una red de entrega de contenido (CDN). Cargue tanto como sea posible desde un solo lugar.

• Siga los procedimientos recomendados de optimización web. En producción, use solo versiones reducidas de las bibliotecas. Cargue solo los recursos que necesita y optimice su carga.

• Proporcione comentarios para operaciones más largas. Cuando las operaciones tardan tiempo en ejecutarse, proporcione a los usuarios comentarios en función de los umbrales de la tabla siguiente. Para obtener más información, vea Límites de recursos y optimización del rendimiento para 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 servicio. Use la telemetría para supervisar el estado del servicio y el éxito del usuario.

• Minimizar los intercambios de datos. Reduzca 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.

Publicación y comercialización del complemento

¿Está listo para compartir su complemento con el mundo? A continuación se muestra cómo empezar.

• Cree una cuenta del Centro de partners. Este proceso puede tardar tiempo, por lo que si planea publicar en Microsoft Marketplace, comience antes. Consulte Cuenta del Centro de partners.

• Cree una lista efectiva de Microsoft Marketplace. Siga estas sugerencias:

  • Use títulos descriptivos y sucintos (128 caracteres o menos).
  • Escriba descripciones breves y atractivas que respondan a "¿Qué problema resuelve este complemento?"
  • Transmita claramente la propuesta de valor del complemento en el título y la descripción. No confíes solo en tu marca.

  Obtenga más información sobre cómo crear descripciones eficaces de Microsoft Marketplace.

• Publicar en Microsoft Marketplace. Siga la guía de envío y lista de comprobación de publicación previa de Microsoft Marketplace. Asegúrese de:

  • Pruebe el complemento exhaustivamente en todos los sistemas operativos, exploradores y dispositivos compatibles.
  • Proporcione instrucciones y recursos de prueba detallados para los revisores de certificación.

• Cree un sitio web. Ayuda a los usuarios a detectar el complemento fuera de Microsoft Marketplace.

• Promueve tu complemento desde tu sitio web. Vea cómo promover el complemento.

Importante

Si el complemento se dirige a organizaciones y empresas más grandes, varios requisitos de Microsoft Marketplace difieren de los de un complemento de Marketplace comercial general. Para obtener más información, consulte las preguntas más frecuentes sobre el envío.

Vea también

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