Preparar la aplicación de SharePoint Framework para publicarla en el Marketplace

  • Artículo

Antes de que se publique en el Marketplace una aplicación del SharePoint Framework, debe pasar por un proceso de aprobación. Este proceso es ejecutado de forma gratuita por Microsoft y tiene por objeto garantizar que su aplicación funcione correctamente y que su página describa claramente su propósito y características. Para ayudarlo a publicar su aplicación en el Marketplace, a continuación se presenta la lista de pruebas ejecutadas como parte del proceso de aprobación.

Requisitos previos

Usar SharePoint Framework v1.11 o más reciente

Para crear soluciones que quiera publicar en el Marketplace, necesita usar SharePoint Framework v1.11 o superior. A partir de la versión 1.11, el manifiesto de la solución de SharePoint Framework tiene información adicional sobre su organización y su solución, que es necesaria para publicar su aplicación en el Marketplace.

Sugerencia

Si su aplicación ha sido creada usando una versión anterior de SharePoint Framework, puede actualizarla fácilmente a SharePoint Framework v1.11 o a una más reciente usando la CLI para Microsoft 365. Para obtener más información, consulte https://pnp.github.io/cli-microsoft365/cmd/spfx/project/project-upgrade/.

Aplicación de prueba en los sitios raíz y no raíz

Cuando pruebe su aplicación, verifique que funciona como se pretende cuando se instala tanto en la colección de sitios raíz de un inquilino como en los sitios no raíz. Esto le ayudará a verificar que no tiene ninguna dependencia de los URLs de sitios específicos.

Aplicación de prueba en los exploradores requeridos

Cuando pruebe su aplicación con las comprobaciones descritas en la siguiente sección, compruebe que funciona como se espera, al menos en Windows 10 en las últimas versiones de Microsoft Edge, Google Chrome, Firefox y Microsoft Teams para cliente de escritorio (si su aplicación expone partes de la web en Teams).

Comprobaciones requeridas

Las siguientes comprobaciones deben ser pasadas. Si una o más comprobaciones de esta categoría fallan, su solicitud será rechazada y se le instruirá para que arregle los problemas reportados.

Asegurar la conformidad del contrato de SharePoint Framework

Su elemento web o personalizador solo debe manipular el elemento DOM proporcionado a través de la propiedad domElement. Este elemento y el objeto de contexto proporcionado son los únicos métodos aprobados para agregar funcionalidad a los sitios a través de la aplicación. La manipulación directa de la página DOM provocará el rechazo de su solución.

En circunstancias normales, la solución debería funcionar como está previsto

En circunstancias normales, todos los componentes (partes y extensiones de la web) de su solución deberían funcionar como está previsto. Preferiblemente, antes de presentar la solicitud para su aprobación, debe verificar que está funcionando como está previsto en múltiples inquilinos y utilizando diferentes cuentas de usuario para asegurarse de que no depende de ninguna configuración específica. Si su solución requiere ajustes específicos, menciónelo explícitamente en la descripción de la solución.

El elemento web debe funcionar en todos los hosts en los que está expuesto

Cuando se crean elementos web usando SharePoint Framework, se puede elegirdonde deben ser expuestas.. Antes de enviar la solicitud para la revisión, asegúrese de que el elemento web funciona como está previsto en todos estos hosts.

El paquete de solución debe contener metadatos válidos de los desarrolladores

El manifiesto de la solución (administrado en elpackage-solution.jsonarchivo) tiene que tener una nueva sección nombradadeveloper con las siguientes propiedades:

Atributo Description Obligatoria
name Nombre de la organización que creó la aplicación Sí
websiteUrl Dirección URL de un sitio web con información adicional sobre la aplicación Sí
mpnId Id. de red de Microsoft Partner (más detalles en MS Partner Network) No (pero es altamente recomendable proporcionarlo)
privacyUrl Dirección URL de la declaración de privacidad Sí
termOfUseUrl Dirección URL de las condiciones de uso Sí

La inclusión de esta información adicional le permite comunicar claramente la información sobre su aplicación a sus usuarios y en el futuro debería permitirle acceder a datos de uso adicionales.

La información del desarrollador se muestra cuando se instalan las partes de la web en Microsoft Teams. La información sobre la aplicación y el desarrollador que se muestra en el Marketplace se administra por separado en el Marketplace.

El texto de descripción de los metadatos de los elementos web debe describir brevemente su funcionalidad y su propuesta de valor

Asegúrese de que la descripción de sus elementos web en los metadatos sea significativa para que los usuarios entiendan cuál es el propósito de su elemento web y lo que pueden esperar de ella.

La descripción de la solución debe tener claramente descrita los diferentes componentes incluidos en el paquete

Al enviar el paquete al Marketplace, asegúrese de describir claramente los diferentes componentes (elementos web, personalizadores de la aplicación, etc.) que se incluyen en el paquete para administrar las expectativas de los usuarios y ayudarles a comprender el impacto de utilizar su aplicación.

No utilice los nombres de las funciones en Teams y de SharePoint en el nombre de la solución.

En el nombre de la solución, no use palabras que coincidan con las características en Microsoft Teams o de SharePoint, como Chat, Contactos, Calendario, Llamadas, Archivos, Reunión, Actividad, Teams, Aplicaciones, Ayuda, SharePoint,Lista, Página , etc., ya que estos nombres podrían confundirse con la funcionalidad estándar de los equipos y de SharePoint.

No usar nombres de otros productos de Microsoft en el nombre de la solución.

Su solución será rechazada si su nombre contiene un nombre de otro producto de Microsoft, como Outlook, Word, Calendario,Tareas, Teams, Excel, PowerPoint, Visio, etc.

La solución no debe utilizar las palabras clave específicas de Microsoft Teams o SharePoint como - Iniciar reunión, Hacer una llamada, Cargar archivo, Iniciar chat, etc. Estas palabras clave se utilizan en los productos de Microsoft y su uso en la aplicación podría confundir a los usuarios. Si su aplicación ofrece una función parecida, incluya el nombre de su nombre en la acción, por ejemplo: Iniciar una reunión de Zoom, subir un archivo a Dropbox,iniciar el chat de Freshdesk, etc.

Nombrar la solución

Si su solución tiene el nombre de una palabra común, como Órdenes, tendrá que incluir también el nombre de su empresa para diferenciarla claramente de otras soluciones del mercado, por ejemplo, Órdenes de Contoso. Donde Contoso hace referencia al nombre de la empresa que envía la solución.

Asegúrese de que el archivo de configuración package-solution.json tenga unname fácil de entender y actualizado de acuerdo con el formato del ejemplo siguiente.

No incluya publicidad adicional en la descripción y las capturas de pantalla de la aplicación.

Asegúrese que la descripción, las capturas de pantalla, el texto y las imágenes promocionales de la aplicación, describan sólo la aplicación y no contengan publicidad adicional.

Todas las propiedades expuestas en el panel de propiedades deben ser funcionales

Las propiedades expuestas en el panel de propiedades de su página web deben ser significativas. Al cambiar la configuración, debería cambiar claramente el comportamiento de los elementos web.

Verifique que el archivo del paquete pueda ser cargado en el catálogo de aplicaciones sin errores

Verifique que el paquete de soluciones pueda ser cargado en el catálogo de aplicaciones de su inquilino sin ningún error.

Verifique que la aplicación puede ser implementada sin errores

Verifique que la aplicación puede ser instalada en un sitio específico pero también que puede ser implementada globalmente en todos los sitios sin ningún error.

Proporcionar una justificación para cualquier solicitud de API

Si su aplicación requiere un acceso adicional a la API (por ejemplo, para comunicarse con Microsoft Graph), debe solicitarlo en el manifiesto de la solución. Además, prepare una justificación del acceso a la API solicitada, como se podría pedir al revisar su aplicación.

No se permite apoyar que los usuarios finales inyecten scripts

Su solución no debe permitirle a los usuarios finales insertar scripts arbitrarios en las páginas de SharePoint. Esto quiere decir que no se permite la publicación en la Tienda SharePoint de soluciones que habiliten escenarios de editor de script clásico o editor de contenido en SharePoint.

Este modelo no está permitido en la Tienda SharePoint, ya que origina problemas de seguridad por parte de los usuarios finales normales al insertar scripts en el portal. Solo puede brindar este tipo de solución a clientes fuera de la tienda ofrecida por Microsoft.

Todos los URLs mostrados en la parte web deben estar funcionando

Si su página web muestra URLs, deben estar apuntando a recursos existentes y no deben conducir a páginas inexistentes o de error.

La aplicación no deja de responder

Al usar la aplicación, no debería de dejar de responder a los usuarios. Si necesita realizar una operación que podría tardar un momento en completarse, se lo comunica al usuario respondiendo a los usuarios.

La solución se ha completado

¿La solución contiene todas las funciones que se anuncian en su descripción y en las capturas de pantalla?

Está terminada la interfaz de usuario de la aplicación

La primera impresión que los usuarios tendrán de su aplicación será laminado su interfaz de usuario. Si no se ve pulido, si algunos elementos están desalineados, si utiliza muchas fuentes diferentes o si algún texto de marcador de posición no ha sido sustituido por su valor final, podría darles la impresión de que su aplicación no está terminada y que no deberían utilizarla.

Sugerencia

Para garantizar una integración perfecta con SharePoint y Teams, le recomendamos que utilice Office UI Fabric, que es el lenguaje de diseño de Microsoft 365. Para obtener más información, consulte la sección dediseñode esta documentación.

La aplicación no debe incitar a los usuarios sin una interacción explícita

La aplicación no debe incitar a los usuarios sin una interacción explícita de su parte.

Verifique que los exploradores no bloqueen sus ventanas emergentes

SSi la aplicación utiliza pop-ups, verifique que los exploradores con configuración predeterminada no los bloqueen interrumpiendo el flujo de usuarios.

Corregir la experiencia del primer lanzamiento

Si es posible, la aplicación debe funcionar cuando se lanza por primera vez. Si debe ser configurado primero, comunique claramente los siguientes pasos al usuario.. Si la configuración es compleja o requiere información adicional, proporcione instrucciones claras para ayudar a los usuarios a configurar su aplicación.

Prueba de sincronización con los Teams

Si la aplicación contiene elemento de la web que están expuestas como pestañas de Teams o aplicaciones personales, verifique que se pueden desplegar en los equipos utilizando la opción Sincronizar con Teams del Catálogo de aplicaciones sin ningún error. Después de sincronizar la configuración con los Teams, verifique que todos los elementos web estén expuestos en el Catálogo de aplicaciones de Teams como es debido, que puedan ser instalados y que funcionen como se espera.

Verificar que los enlaces como losTérminos de servicio, la Directivas de privacidad,Acerca de, etc. sean válidos y apunten a las páginas correctas.

Adquirir la cuenta o la licencia

Si la solución requiere que los usuarios adquieran una cuenta o una licencia, ¿está claro cómo pueden hacerlo y cómo pueden utilizar la información obtenida con su aplicación?

No hay contenido de demostración si la prueba gratuita está incluida en la oferta

Si la oferta incluye una prueba gratuita de la aplicación, entonces su aplicación no debería incluir ningún contenido de demostración.

No incluya el código malicioso

Se rechazará la publicación en el Marketplace de soluciones que contengan código malintencionado, enlaces a sitios web malintencionados o recursos ilegales de otro tipo.

No incluya los recursos vulnerables

Verificar, que el código no contenga ninguna vulnerabilidad. Si está utilizando dependencias de terceros

Asegúrese de que la aplicación no utilice excesivamente los recursos

Cuando pruebe su aplicación, verifique que no provoque un aumento notable o sostenido del uso de la CPU, que no consuma mucha memoria y que no cause que el navegador no responda. En general, la aplicación debería funcionar bien en un ordenador de escritorio promedio con acceso a Internet. Además, no debería tardar más de 10 segundos en cargarse su aplicación.

Es necesario que las soluciones objetivo de Microsoft Teams sean de ámbito empresarial

Las soluciones de SharePoint Framework que se vayan a usar en Microsoft Teams deberán tener como objetivo un ámbito de espacio empresarial. Esta configuración se controla con el atributo skipFeatureDeployment en el archivo de configuración package-solution.json, y la configuración debe ser true para cualquier solución que tenga los componentes también destinados para Microsoft Teams.

Se recomienda pasar los siguientes controles. Aunque una comprobación fallida en esta categoría no impedirá que publique la aplicación en el Marketplace, podría tener un impacto negativo en la experiencia del usuario final.

El icono de los elementos web debe ser 64x64px con fondo transparente

Recomendamos que use una imagen de 64x64px con fondo transparente para el icono de la web. Esto permitirá que se muestre correctamente en los diferentes modos de la interfaz de usuario en SharePoint.

Los logotipos de Microsoft Teams deberán usar tamaños de imagen correctos.

Si la solución contiene componentes diseñados para Microsoft Teams, se espera que usen el tamaño de imagen oficial basado en la guía de Microsoft Teams. El contorno de la imagen tiene que ser de 32 x 32 px, mientras que el color de la imagen de 192 x 192 px.

La imagen de página completa debe tener el tamaño correcto.

Si la solución contiene componentes que están destinados a ser páginas de aplicación de un solo elemento, cada uno de estos componentes debe tener el atributo fullPageAppIconImageUrl con una imagen específica diseñada para usarse cuando se cree una nueva página en SharePoint. Esta imagen debe tener un tamaño de 193 x 158 px.

Los elementos web deben tener un título que sea configurable en el panel de propiedades

Recomendamos que todas los elementos de la web tengan un título que describa claramente la información que presenta la web. Los autores de las páginas deberían poder ajustar este título a través del panel de propiedades, de modo que si los elementos web son configurables, el título pueda describir correctamente su contenido.

Sugerencia

Usted puede agregar fácilmente un título configurable a su parte web usando el WebPartTitle PnP Reusable React

Manejar adecuadamente los diferentes temas

La aplicación debe manejar adecuadamente los temas de colores claros y oscuros. Cambiar entre los diferentes temas no debería tener un efecto negativo en el de la aplicación. Aunque el hecho de no apoyar los temas no impedirá que se publique la aplicación en el Marketplace, se recomienda que los apoyes para ofrecer una experiencia óptima al usuario.

Sugerencia

Para obtener más información acerca del uso de temas en la aplicación, consulte el artículo Usar los colores de los temas en las personalizaciones de la estructura de SharePoint.