Publicar objetos visuales personalizados en AppSourcePublish custom visuals to AppSource

Aprenda a publicar objetos visuales personalizados en AppSource para que otros usuarios puedan descubrirlos y usarlos.Learn how you can publish your custom visual to AppSource for others to discover and use. Officeoffice

Una vez que haya creado un objeto visual personalizado, puede publicarlo en AppSource para que otros usuarios lo detecten y lo usen.Once you have created your custom visual, you may want to publish it AppSource for others to discover and use. Para ello, es preciso prepararlo con anterioridad.There is some preperation that needs to be done before you can do that. Para más información acerca de cómo crear un objeto visual personalizado, consulte Uso de herramientas de desarrollo para crear objetos visuales personalizados.For more information on how to create a custom visual, see Use developer tools to create custom visuals.

¿Qué es AppSource?What is AppSource? En pocas palabras, es el lugar donde podrá encontrar aplicaciones SaaS y complementos para sus productos y servicios de Microsoft.Simply put, it is the place to find SaaS apps and add-ins for your Microsoft products and service. AppSource conecta millones de usuarios de productos como Office 365, Azure, Dynamics 365 o Cortana Intelligence con soluciones que les ayudan a realizar su trabajo de forma más eficaz, minuciosa o atractiva que antes.AppSource connects millions of users of Office 365, Dynamics 365, Cortana Intelligence, and others, to solutions that help them get work done more efficiently, more insightfully or more beautifully than before.

Preparación de objetos visuales para su envíoPreparing to submit your custom visual

Una vez que haya acabado de codificar y probar el objeto visual y lo haya empaquetado en un archivo pbiviz, también debe preparar los siguientes elementos antes de enviarlo.One you're done coding and testing your custom visual and have packaged it into a pbiviz file, you should also have the following ready for your submission.

Item (Elemento)Item ObligatoriaRequired DescripciónDescription
El paquete pbiviz contiene todos los metadatos requeridosPbiviz package contains all the required metadata Yes Nombre de objeto visualVisual name
Nombre para mostrarDisplay name
GUIDGUID
VersiónVersion
DescripciónDescription
Nombre y correo electrónico del autorAuthor name and email
Archivo de informe .pbix de ejemploSample .pbix report file Yes Para presentar el objeto visual, debe ayudar a los usuarios a familiarizarse con él.To showcase your visual, you should help users to get acquainted with the visual. Debe resaltar el valor que el objeto visual aporta al usuario y ofrecen ejemplos de uso, opciones de formato, etc. También puede agregar una página de "sugerencias" al final que contenga trucos y sugerencias, acciones que conviene evitar y cosas similares.You should emphasize on the value the visual brings to the user and give examples of usage, formatting options, etc. You can also add a "hints" page at the end with some tips and tricks, things to avoid and the like.
IconoIcon Yes Debe incluir el logotipo del objeto visual personalizado que aparecerá en el escaparate.You should include the custom visual logo that will appear in the store front. Su formato puede ser .png, .jpg, .jpeg o .gif.The format can be .png, .jpg, .jpeg or .gif. Debe tener, exactamente, 300 px (ancho) x 300 px (alto).It must be exactly 300px (width) x 300px (height). El tamaño del archivo no puede superar los 512 KB.It can be no larger than 512kb for the file size.
Capturas de pantallaScreenshots Yes Debe incluir al menos una captura de pantalla.You must provide at least one screenshot. Su formato puede ser .png, .jpg, .jpeg o .gif.The format can be .png, .jpg, .jpeg or .gif. Debe tener, exactamente, 1366 px de ancho x 768 px de alto.It must be exactly 1366px (width) x 768px (height). El tamaño del archivo no puede superar los 1024 kB.It can be no larger than 1024kb for the file size. Si el uso va a ser mayor, agregue burbujas de texto para articular la propuesta de valor de las características clave que se muestran en cada captura.For greater usage, add text bubbles to articulate the value proposition of key features shown in each screenshot.
Vínculo de descarga de soporte técnicoSupport download link Yes Especifique la dirección URL en la que se proporcionará soporte técnicos a los clientes que tengan problemas con el objeto visual.Provide the URL to support customers who have issues with your visual. El formato de la dirección URL debe incluir https:// o http://.The format of your URL should include https:// or http://.
Vínculo de documento de privacidadPrivacy document link Yes Especifique un vínculo a la directiva de privacidad para los clientes que usen el objeto visual.Provide a link to the privacy policy for customers who use your visual. El formato del vínculo debe incluir https:// o http://.The format of your link should include https:// or http://.
Contrato de licencia de usuario final (CLUF)End user license agreement (EULA) Yes Debe cargar un archivo con el CLUF.You must upload a EULA file. Puede ser su propio CLUF, o bien puede usar el CLUF predeterminado de la Tienda Office para objetos visuales personalizados de Power BI.This can be either your own EULA or use the default EULA within the Office store for Power BI custom visuals. Para usar el CLUF predeterminado, pegue la siguiente dirección URL en el cuadro de diálogo de carga del archivo del "Contrato de licencia para el usuario final" del panel del vendedor: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.To use the default EULA, paste the following URL in the seller dashboard's "End User License Agreement" file upload dialog: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.
Enlace de vídeoVideo link NoNo Para aumentar el interés de los usuarios por el objeto visual personalizado, se recomienda incluir un vínculo a un vídeo acerca de dicho objeto.To increase the interest of users for your custom visual, it is advised to provide a link to a video about your visual. El formato de la dirección URL debe incluir https:// o http://.The format of your URL should include https:// or http://.
Repositorio de GitHubGitHub repository NoNo Es preferible tener un vínculo válido y público a un repositorio de GitHub con orígenes del objeto visual y datos de ejemplo que permitir que otros desarrolladores incluyan comentarios y sugieran mejoras en el código.It is preferred to have a valid and public link to a GitHub repository with sources of your visual and sample data in it to allow other developers to provide feedback and propose improvements to your code.

Envío a Power BISubmitting to Power BI

Todo comienza con el envío de un correo electrónico al equipo de envío de objetos visuales personalizados de Power BI.Submission starts with sending an email to the Power BI custom visuals submission team. Dicho correo electrónico se puede dirigir a pbivizsubmit@microsoft.com.You can email pbivizsubmit@microsoft.com.

Adjunte tanto el archivo .pbiviz como el archivo .pbix del informe de ejemplo.Attach the .pbiviz file and the sample report .pbix file in your email. El equipo de Power BI responderá con instrucciones y un archivo XML del paquete de la aplicación que se debe cargar.The Power BI team will reply back with instructions and a app package XML file to upload. Dicho paquete se requiere para enviar cualquier objeto visual a través del Centro para desarrolladores de Office.This XML app package is required in order to submit your visual through the Office developer center.

Nota

Para mejorar la calidad y garantizar que los informes existentes no se interrumpan, las actualizaciones de los objetos visuales existentes tardará un dos semanas más en llegar al entorno de producción tras su aprobación en la tienda.To improve quality and assure that existing reports are not breaking, updates to existing visuals will take an additional two weeks to reach production environment after approval in the store.

Envío a AppSourceSubmitting to AppSource

Una vez que obtenga el código XML del paquete de la aplicación del equipo de Power BI, vaya al Centro para desarrolladores para enviar el objeto visual a AppSource.Once you get the app package XML from the Power BI team, navigate to the developer center to submit your visual to AppSource.

Nota

Para iniciar sesión en el Centro para desarrolladores de Office es preciso tener una cuenta de desarrollador de Office válida.You must have a valid Office developer account to log in to the Office developer center. Una cuenta de desarrollador de Office debe ser una cuenta Microsoft (Live ID, por ejemplo, hotmail.com o outlook.com).An Office developer account must be a Microsoft Account (Live ID, e.g. hotmail.com or outlook.com).

Importante

Debe enviar un correo electrónico con los archivos .pbiviz y .pbix al equipo de Power BI antes de realizar el envío a AppSource.You must send an email with the .pbiviz file and the .pbix file to the Power BI team before submitting to AppSource. Esto permite al equipo de Power BI cargar los archivos en el servidor de recursos compartidos público.This allows the Power BI team to upload the files to the public share server. De lo contrario, la tienda no podrá recuperar los archivos.Otherwise, the store will not be able to retrieve the files. Los archivos deben enviarse cada vez que se envíe un objeto visual nuevo, que se actualice uno existente y que se corrijan los envíos que han sido rechazados.You must send the files with each new visual submission, update to existing visual, and fixes to rejected submissions.

Proceso para el envío de un objeto visualProcess to submit visual

Siga estos pasos para completar el envío.Follow the below steps to complete the submission.

  1. Seleccione Agregar una nueva aplicación.Select Add a new app.

  2. Seleccione Objeto visual personalizado de Power BI y, después, Siguiente.Select Power BI custom visual and then Next.
  3. Seleccione el signo + en Paquete de la aplicación y, en el cuadro de diálogo Abrir archivo, seleccione el archivo XML del paquete de la aplicación que le ha enviado el equipo de Power BI.Select the + under App package and select the app package XML file that you received from the Power BI team from the open file dialog.

  4. Debería recibir una aprobación en la que se indica que se trata de un paquete de aplicación de Power BI válido.You should receive an approval that this is a valid Power BI app package.

  5. Rellene los detalles de Información general.Fill out the General info details.

    • Título del envío: cómo se denominará el envío en el Centro para desarrolladoresSubmission title: How your submission will be named in the developer center
    • Versión: el número de versión se rellena automáticamente desde el paquete de la aplicación del complemento.Version: Your version number is auto-populated from your add-in app package.
    • Fecha de lanzamiento (UTC): seleccione la fecha en que la aplicación se publicará en la tienda.Release Date (UTC): Select a date for your app to release to the store. Si se elige una fecha futura, la aplicación no estará disponible en la tienda hasta dicha fecha.If a future date is chosen, your app will not be available in the store until that date is reached.
    • Categoría: la primera categoría se rellenará como "Visualización de datos + BI" de forma automática.Category: The first category will be auto populated as "Data Visualization + BI". Así es como se etiquetarán todos los objetos visuales personalizados de Power BI. Puede especificar hasta dos categorías adicionales, lo ayuda a los usuarios a buscar fácilmente un objeto visualThat's how all Power BI custom visuals will be tagged.You may provide up to 2 additional categories, for help users easily search for your visual
    • Notas de pruebas: opcional, si desea proporcionar instrucciones para los evaluadores de MicrosoftTesting notes: optional, if you'd like to provide some instructions for the testers at Microsoft
    • Mi aplicación llama, admite, contiene o usa criptografía o cifrado: déjela desactivadaMy app calls, supports, contains, or uses cryptography or encryption: leave unchecked
    • Establecer este complemento como disponible en el catálogo de complementos de Office para iPad: déjela desactivadaMake this add-in available in the Office add-in catalog on iPad: leave unchecked
  6. Cargue el logotipo del objeto visual, para lo que debe seleccionar el signo + de Logotipo de la aplicación.Upload your visual's logo by selecting the + under App logo. Después, seleccione el archivo del icono en el cuadro de diálogo Abrir archivo.Then select the icon file in the open file dialog. El archivo debe tener una de las siguientes extensiones: .png, .jpg, .jpeg o .gif.The file must be .png, .jpg, .jpeg or .gif. Debe ser tener, exactamente, 300 px (ancho) x 300 px (ancho) y su tamaño no puede superar los 512 KB.It must be exactly 300px (width) x 300px (height) and no larger than 512kb in size.

  7. Rellene los datos de Documentos de soporte técnico.Fill out the Support documents details.

    • Vínculo de documento de soporte técnicoSupport document link
    • Vínculo de documento de privacidadPrivacy document link
    • Enlace de vídeoVideo link
    • Contrato de licencia de usuario final (CLUF)End User License Agreement (EULA)

      Debe cargar un archivo con el CLUF.You must upload a EULA file. Puede ser su propio CLUF, o bien puede usar el CLUF predeterminado de la Tienda Office para objetos visuales personalizados de Power BI.This can be either your own EULA or use the default EULA within the Office store for Power BI custom visuals. Para usar el CLUF predeterminado, pegue la siguiente dirección URL en el cuadro de diálogo de carga del archivo del "Contrato de licencia para el usuario final" del panel del vendedor: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.To use the default EULA, paste the following URL in the seller dashboard's "End User License Agreement" file upload dialog: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.

  8. Seleccione Siguiente para pasar a la página Detalles.Select Next to proceed to the Details page.
  9. Seleccione Idioma y elija uno de los idiomas de la lista.Select Language and pick a language from the list.

  10. Rellene los datos de "Descripción".Fill out the "Description" details.

    • Nombre de aplicación (para este idioma): escriba el título, tal como debe aparecer en escaparate.App name (for this language): Enter the title of your app as it should appear in the storefront.
    • Descripción breve: especifique una descripción breve de la aplicación, de hasta 100 caracteres, como debe aparecer en el escaparate.Short description: Enter the short description of your app, up to 100 characters, as it should appear in the storefront. Esta descripción se mostrará en las primeras páginas, junto con el logotipo.This description will show up in the top level pages along with the logo. Puede utilizar la descripción del paquete pbiviz.You can use the description from the pbiviz package.
    • Descripción larga: especifique una descripción más detallada de la aplicación, que es la que los clientes verán en la página de detalles de la aplicación.Long description: Provide a more detailed description of your app that customers will see on your app details page. Si quiere permitir que la comunidad mejore el objeto visual convirtiéndolo en código abierto, proporcione el vínculo al repositorio público, como GitHub, aquí.If you'd like to let the community improve your visual by making it open source, provide the link to the public repository, such as GitHub, here.
  11. Cargue al menos una captura de pantalla.Upload at least one screenshot. Su formato puede ser .png, .jpg, .jpeg o .gif.The format can be .png, .jpg, .jpeg or .gif. Debe tener, exactamente, 1366 px de ancho x 768 px de alto.It must be exactly 1366px (width) x 768px (height). El tamaño del archivo no puede superar los 1024 kB.It can be no larger than 1024kb for the file size. Si el uso va a ser mayor, agregue burbujas de texto para articular la propuesta de valor de las características clave que se muestran en cada captura.For greater usage, add text bubbles to articulate the value proposition of key features shown in each screenshot.
  12. Si desea agregar más idiomas, seleccione Agregar un idioma y repita los pasos 10 y 11.If you'd like to add more languages, select Add a language and repeat steps 10 and 11. La incorporación de más idiomas ayudará a los usuarios a ver la información del objeto visual personalizado en su propio idioma.Adding more languages will help your users view the custom visual details in their own language. Si el idioma no aparece en la lista, se utilizará de manera predeterminada el primer idioma seleccionado.Languages that will not be listed will default to the first language selected.
  13. Cuando haya terminado de agregar idiomas, seleccione Siguiente para pasar a la página Bloquear acceso.When you are done adding languages, select Next to proceed to the Block access page.
  14. Si desea impedir que clientes de determinados países o regiones usen o compren la aplicación, active la casilla y selecciónelo en la lista.If you want to prevent customers in specific countries or regions from using or purchasing your app, check the box and select from the list.
  15. Seleccione Siguiente para pasar a la página Precios.Select Next to proceed to the Pricing page.
  16. En estos momentos, solo se permiten los objetos visuales gratuitos, pero no las compras adicionales integradas ellos (compras desde la aplicación).Currently, only free visuals are supported and additional purchases inside the visual (In-App purchase) are not allowed. Seleccione Esta aplicación es gratuita.Select This app is free.

    Nota

    Si selecciona cualquier otra opción que no sea la gratuita, o bien si en el objeto visual enviado hay contenido para compras desde la aplicación, el envío se rechazará.If you select any other option other than free, or have an In-App purchase content in the submitted visual, the submission will be rejected.

  17. Ahora puede seleccionar Guardar como borrador" y enviarlo más tarde, o bien **Enviar para aprobación para enviar el objeto visual personalizado a la Tienda Office.You can now select Save as draft" and submit later, or select **Submit for approval to submit the custom visual to the Office store.

Seguimiento del uso y estado del envíoTracking submission status and usage

Puede revisar las directivas de validación.You can review the validation policies.

Después del envío, el estado del envío se puede ver en el panel de la aplicación.After submission, you will be able to view the submission status in the app dashboard.

Certificación del objeto visualCertify your visual

Una vez creado el objeto visual, si lo desea, puede obtener su certificación.Once your visual is created, you can optionally get your visual certified. Esto significa que puede ejecutarse en el servicio Power BI y utilizarse con otras características del servicio, como la exportación a PowerPoint.This means it can run within the Power BI service and be used with other features of the service such as exporting to PowerPoint. Para más información, consulte Obtención de un objeto visual personalizado certificado.For more information, see Getting a custom visual certified.

Pasos siguientesNext steps

Uso de herramientas de desarrollo para crear objetos visuales personalizadosUse developer tools to create custom visuals
Visualizaciones en Power BIVisualizations in Power BI
Visualizaciones personalizadas en Power BICustom Visualizations in Power BI
Obtención de un objeto visual personalizado certificadoGetting a custom visual certified

¿Tiene más preguntas?More questions? Pruebe a preguntar a la comunidad de Power BITry asking the Power BI Community