Skip to content

Commit 3e6d2b2

Browse files
author
Qian Wen
committed
adding review feedback article
1 parent 862c0bd commit 3e6d2b2

11 files changed

+72
-0
lines changed

articles/marketplace/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -456,6 +456,8 @@
456456
items:
457457
- name: Create an Azure application offer
458458
href: ./partner-center-portal/create-new-azure-apps-offer.md
459+
- name: Handling review feedback
460+
href: ./partner-center-portal/azure-apps-review-feedback.md
459461
- name: Dynamics 365 offers
460462
items:
461463
- name: Create a Dynamics 365 for Customer Engagement & PowerApps offer
Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
title: Handling review feedback for Azure Apps offer in the Commercial Marketplace
3+
description: How to handle review feedback for Azure Apps offer for listing or selling in the Azure Marketplace, AppSource, or through the Cloud Solution Provider (CSP) program using the Commercial Marketplace portal on Microsoft Partner Center.
4+
author: qianw211
5+
manager: evansma
6+
ms.author: v-qiwe
7+
ms.service: marketplace
8+
ms.subservice: partnercenter-marketplace-publisher
9+
ms.topic: conceptual
10+
ms.date: 11/11/2019
11+
---
12+
13+
# Handling review feedback
14+
15+
This article explains how to access the Azure DevOps environment used by the Microsoft Azure Marketplace review team. If critical issues are found in your Azure application offer during the **Microsoft review** step, you can sign into this system to view detailed information about these issues (review feedback). After you fix all these issues, you must resubmit your offer to continue to publish it on the Azure Marketplace. The following diagram illustrates how this feedback process relates to the publishing process.
16+
17+
![Review feedback process](./media/review-feedback-process.png)
18+
19+
Typically, review issues are referenced as pull request (PR). Each PR is linked to an online [Azure DevOps](https://azure.microsoft.com/services/devops/) (previously named Visual Studio Team Services (VSTS)) item, which contains details about the issue. The following image displays an example of the Partner Center experience in case of issues found during reviews.
20+
21+
![Publishing status](./media/publishing-status.png)
22+
23+
The PR that contains specific details about the submission will be mentioned in the “View Certification Report” link. For complex situations, the review and support teams may also email you.
24+
25+
## Azure DevOps access
26+
27+
To view the PR items referenced in review feedback, publishers must first be granted proper authorization. Otherwise, new publishers receive a 401 - Not Authorized response page when trying to view PRs. To request access to this Azure DevOps repository, perform the following steps:
28+
29+
1. Collect the following information:
30+
* Your publisher name and ID
31+
* Offer type (Azure app), offer name, and SKU ID
32+
* The pull request link, for example: `https://solutiontemplates.visualstudio.com/marketplacesolutions/_git/contoso/pullrequest/<number>`. This URL can be retrieved from the notification message or the address of the 401 response page.
33+
* The email address(es) of the individuals from your publishing organization that you want access granted to. This list should include the owner address(es) you provided when registering as a publisher on the Cloud Partner Portal (or Partner Center??).
34+
1. Create a support incident. In the title bar of the Cloud Partner Portal (??), select the **Help** button, then choose **Support** from the menu. Your default web browser should launch and navigate to the Microsoft new support incident page. (You may have to sign in first.)
35+
1. Specify the **Problem type** as **marketplace onboarding** and **Category** as **Access problem**, then select **Start request**.
36+
37+
![Create an incident](./media/create-an-incident.png)
38+
39+
1. In **Step 1 of 2** page, supply your contact information and select **Continue**.
40+
1. In **Step 2 of 2** page, specify an incident title (for example Request Azure DevOps access) and supply the information you collected in the first step (above). Read and accept the agreement, then select **Submit**.
41+
42+
If the incident creation was successful, a confirmation page is displayed. Save the confirmation information on this page for your reference. The Microsoft Support Team should reply to your access request within a few business days.
43+
44+
## Reviewing the pull request
45+
46+
Use the following procedure to review issues documented in the pull request.
47+
48+
1. In the **Microsoft review** sections of Publishing steps form, click on a PR link to launch your browser and navigate to the **Overview** (home) page for this PR. The following image depicts an example of the critical issue home page for the Contoso sample app offer. This page contains useful summary information about the review issues found in the Azure app.
49+
50+
[![Pull request home page](./media/pr-home-page-thumb.png)](./media/pr-home-page.png)
51+
<br/> *Click on the image to expand.*
52+
53+
1. (Optional) On the right side of the window, in the section **Policies**, click on the issue message (in this example: **Policy Validation failed**) to investigate the low-level details of the issue, including the associated log files. Errors are typically displayed at the bottom of the log files.
54+
1. In the menu on the left-side of the home page, select **Files** to display the list files that comprise the technical assets for this offer. The Microsoft reviewers should have added comments describing the discovered critical issues. In the following example, two issues have been discovered.
55+
56+
[![Pull request home page](./media/pr-files-page-thumb.png)](./media/pr-files-page.png)
57+
<br/> *Click on the image to expand.*
58+
59+
1. Click on each comment node in the left tree to navigate to the comment in context of the surrounding code. Fix your source code in your team's project to correct the issue described by the comment.
60+
61+
>[!Note]
62+
>You cannot edit your offer's technical assets within the review team's Azure DevOps environment. For publishers, this is a read-only environment for the contained source code. However, you can leave replies to the comments for the benefit of the Microsoft review team.
63+
64+
In the following example, the publisher has reviewed, corrected, and replied to the first issue.
65+
66+
![First fix and comment reply](./media/first-comment-reply.png)
67+
68+
## Next steps
69+
70+
After you correct the critical issues documented in the review PR(s), you must [republish your Azure app offer](./create-new-azure-apps-offer.md#publish).
39.2 KB
Loading
109 KB
Loading
109 KB
Loading
55.6 KB
Loading
93.1 KB
Loading
63 KB
Loading
94 KB
Loading
192 KB
Loading

0 commit comments

Comments
 (0)