Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[Doc Improvement][App Import Flows][4014508] #11631

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

[Doc Improvement][App Import Flows][4014508] #11631

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c77370d
Update teams-developer-portal.md
v-kushals Sep 25, 2024
d890cf8
Update teams-developer-portal.md
v-kushals Sep 25, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 11 additions & 8 deletions msteams-platform/concepts/build-and-test/teams-developer-portal.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,23 +61,26 @@ Follow the steps to import and manage your existing app in Developer Portal:

1. Select **Import**.

* Developer Portal creates a unique app ID and locks the ID for your registered Teams app. You can’t edit or provide an ID of your choice, which prevents to have duplicate app IDs for multiple apps.
* If you import an app that is already published in [Teams admin center](https://admin.teams.microsoft.com/) and registered in Developer Portal, the portal creates a duplicate app with a new, unique app ID. You can’t edit or provide an ID of your choice, which prevents duplicate app IDs for multiple apps. You're the sole owner of the duplicate app and it isn't related to the previously registered app in any way.
* You can't import or take ownership of an app that is already published in Teams admin center but isn't registered in Developer Portal.
* If you create an app using the Microsoft Teams Toolkit for Visual Studio Code, you can manage your app in Developer Portal.
* You can import an existing app to Developer Portal that was created in App Studio. If an app in your tenant doesn't have an owner, the Teams Tenant admin or Global admin can take ownership of the app from Teams Developer Portal.
* You can import an existing app to Developer Portal that was created in App Studio. If an app in your tenant doesn't have an owner, the Teams tenant admin or global admin can take ownership of the app from Developer Portal.

:::image type="content" source="../../assets/images/tdp/change-ownership-app-teams-global-admin.png" alt-text="Screenshot shows an example of a tenant admin taking ownership of an app in Teams Developer Portal.":::
:::image type="content" source="../../assets/images/tdp/change-ownership-app-teams-global-admin.png" alt-text="Screenshot shows an example of a tenant admin taking ownership of an app in Developer Portal.":::

For more information about how tenant or global admins can import and take ownership of apps in Developer Portal, see ***placeholder link***.

#### Steps to import a published app that's not registered in Developer Portal

You might have published apps in Teams Store that wasn't registered in Developer Portal. If you want to monitor app analytics or validate your app, you must import your app into Developer Portal. While importing your published app, you might face the following error:

:::image type="content" source="../../assets/images/tdp/error-message.png" alt-text="Screenshot shows an example of error message when you import an existing app in Teams Developer Portal.":::
:::image type="content" source="../../assets/images/tdp/error-message.png" alt-text="Screenshot shows an example of error message when you import an existing app in Developer Portal.":::

To resolve this error, we recommend that you raise a [support ticket](../../feedback.md) to Microsoft with the following details:
To resolve this error, we recommend that you ask your Teams tenant admin or global admin to raise a [support ticket](../../feedback.md) to Microsoft with the following details:

* App ID
* Tenant ID
* Your email ID
* Teams tenant admin or global admin's email ID
* Screenshot of the email from Partner Center when the app was published.

This information is required to verify the app owner's identity, who raises the ticket and to allow them to import an app.
Expand All @@ -88,13 +91,13 @@ Changelog for Developer Portal allows you to stay engaged with the latest update

To view **Changelog**, sign in to [Developer Portal](https://dev.teams.microsoft.com) and select **Changelog** from the left pane.

:::image type="content" source="../../assets/images/tdp/changelog.png" alt-text="Screenshot shows the Changelog in the Developer Portal highlighted in red.":::
:::image type="content" source="../../assets/images/tdp/changelog.png" alt-text="Screenshot shows the Changelog in Developer Portal highlighted in red.":::

The updates for Changelog in Developer Portal are categorized based on the following:

* **Added**: Updates on a service or feature that's a new feature or capability.
* **Changed**: Updates on a service or API that's modified.
* **Removed**: Updates on a service or API that's removed and may be replaced with a new and updated service.
* **Removed**: Updates on a service or API that's removed and might be replaced with a new and updated service.
* **Fixed**: Updates on a service or API that was previously identified as a high-priority or breaking-change issue that's fixed or mitigated.
* **Deprecated**: Updates on a service or API at the end of its life and deprecated.
* **Security**: Updates on important and critical security patch.
Expand Down