Power Query connector submission

Introduction

This article provides instructions for how to submit your Power Query custom connector for certification. Do not submit your connector for certification unless you've been directed to by your Microsoft contact.

Prerequisites

After you've been approved for certification, ensure that your connector meets the certification requirements and follows all feature, style, and security guidelines. Prepare the submission artifacts for submission.

Submitting to the Connector Certification Portal

The Connector Certification Portal is an experience within ISV Studio that allows Microsoft partners and ISVs to submit, view, and manage connectors submitted for certification. After submission, communication between Microsoft and the partner connector developer will be through the Connector Certification Portal.

Initial Submission

  1. Navigate to ISV Studio and log in with your work Microsoft account. Personal accounts aren't supported in this experience.

  2. Select the Connector certification tab on the left to launch the Connector Certification Portal experience.

  3. Select Power Query as your connector type.

  4. Read and agree to our connector Partner Agreement. If there is a separate agreement governing the relationship between your organization and Microsoft, let your Microsoft contact know.

  5. Upload your .mez file and complete the form with information on your connector. Submit the form to finish the connector submission process. Once submitted, you can use the Activity Control experience on the right to communicate with your Microsoft contact.

  6. Read the guidelines for providing documentation for your custom connector. Submit a pull request to our public documentation repository with an .md file following the custom connector documentation guidelines. This step is crucial to ensure users know how to use your connector. Once the pull request has been made, send a link to the pull request in the Activity Control experience in the Connector Certification Portal.

  7. Also within the Activity Control, share a paragraph introducing your connector and explaining its value proposition to users and customers. This entry will be submitted as part of the Power BI blog in the upcoming month's post, announcing the release of your connector.

  8. If you would like to add teammates to manage your connector, let your Microsoft contact know.

After your connector code review is complete, our team will schedule a demo for your team to walk us through the connector experience. We will be validating the following scenarios:

  • You can successfully connect to the service.
  • Your connector correctly displays navigation tables.
  • Your connector correctly authenticates with the expected authentication method.
  • You can successfully refresh the connector.
  • You can successfully publish to the service.
  • You can successfully refresh end-to-end through the gateway.

Ensure that these scenarios are working successfully before the demo so that the demo goes smooth and doesn't block the release of your connector.

Updates

Updates to your connector submission can be made at any time, except when your connector is in the process of production deployment. When you are submitting an update, ensure that you submit an update to your existing submission, rather than creating a new submission.

  1. Navigate to the Connector certification experience within ISV Studio.

  2. From the list of connectors you manage, select the connector submission to view its connector versions.

  3. Select the most recent connector version.

  4. At the bottom left, select the "Submit an update" button.

  5. You can upload a new version of artifacts and complete the submission form again.

  6. After submitting the connector form, within the Activity Control chat feature on the right, submit a short changelog explaining the connector update. This information should be public and written in a customer-facing way, as it will be included in the next Power BI Desktop blog update.