Skip to content

Commit

Permalink
Merge pull request #110 from OfficeDev/release/cmpv2.3
Browse files Browse the repository at this point in the history
V2.3 release changes
  • Loading branch information
Porkai-Pandian authored Jul 28, 2022
2 parents e91ab74 + 273e41e commit ed00650
Show file tree
Hide file tree
Showing 77 changed files with 13,760 additions and 7,621 deletions.
Binary file modified Images/AddTab_ChampionAdd.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Images/CreateTournament.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Images/EmpView.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Images/Leaderboard.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Images/ManageTournament.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Images/MultipleTournaments.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Images/Upgrade-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Images/Upgrade_Modern_AppCatalog1.PNG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
28 changes: 27 additions & 1 deletion Wiki/FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,30 @@

"An unexpected error occurred while getting users."

This happens when the API permission “User.ReadBasic.All” is not approved after upgrading the app from older versions to version 2.0. Refer to the “Upgrade” section and approve the API permission. After approving the permission, it would take some time for it to take effect.
This happens when the API permission “User.ReadBasic.All” is not approved after upgrading the app from older versions to version 2.0. Refer to the “Upgrade” section and approve the API permission. After approving the permission, it would take some time for it to take effect.

### 4. Does the app support multiple locales?

Yes, CMP v2.3 supports the translations for below 12 languages,

- Arabic (SA)
- Chinese
- Chinese (TW)
- English (US)
- French
- German
- Hebrew
- Japanese
- Korean
- Portuguese (BR)
- Russian
- Spanish

### 5. Does the app support mobile devices?

Yes, CMP v2.3 supports the desktop, mobile and tab devices.

### 6. I see an error 'Failed to sync solution to Teams' or 'Couldn't add app to Teams' when I click on 'Sync to Teams'(Classic App Catalog) or 'Add to Teams'(Modern App Catalog)?

Delete the app from Teams Admin Center and then click on 'Sync to Teams' or 'Add to Teams'.

14 changes: 14 additions & 0 deletions Wiki/Release-Notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ This page contains the different release details for Champion Management Platfor
## Version history
| Version | Release Date |
|----|----|
| 2.3 | Jul 28, 2022 |
| 2.2 | May 17, 2022 |
| 2.1 | Apr 4, 2022 |
| 2.0 | Dec 9, 2021 |
Expand All @@ -12,6 +13,19 @@ This page contains the different release details for Champion Management Platfor

## Release notes

### 2.3 (Jul 28, 2022)

Below improvements released,

- New Feature: Ability to create multiple tournaments using excel template.
- New Feature: Ability to start multiple tournaments at the same time.
- New Feature: Local language support (translations) available for 12 languages.
- Ability to approve/reject multiple requests at a time in manage approval screen.
- New card layout for both Member and Non Member Leaderboards along with improved Search and option to connect with the champions.
- Mobile responsive UI implemented.
- Bug Fix: Incorrect ranking in leaderboard when applying search filters.
- Bug Fix: Inaccurate behavior when adding multiple events of same type in "Record Event" section of Leaderboard.

### 2.2 (May 17, 2022)

Below improvements released,
Expand Down
6 changes: 6 additions & 0 deletions Wiki/Solution-Overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,12 @@ An Admin / Champion can do the following:
- To view their Global rank and how they rank against others globally.
- Access their dashboard with list of events they have supported.
- Add and submit upcoming events to earn points associated with it. Example, hosting office hours can earn 10 points, whereas writing a blog can earn 5 points.
- Search for a champion based on region and focus area.
- View the activities of a champion by clicking on "View Activities" on the champion card.
- Connect with a champion using the below icons on the champion card
- Chat
- Request to call
- Send an Email
1. Nominate and approve an employee to be a champion (Add members )
- An Admin can add employee as a Champion.
- Where as an existing Champion can nominate their peers.
Expand Down
20 changes: 18 additions & 2 deletions Wiki/Tournament-of-Teams.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,16 +39,32 @@ Below are the master lists in Share Point that need to be managed by the TOT Adm

- Admins can create new tournaments by picking the Teams Actions from the list. New Teams Actions need to be added to the list “Actions List” in share point.

- Created Tournaments are not started by default. “Start Tournament” screen should be used to start the tournament.
![Quick Start Guide](../Images/CreateTournament.png)

![Quick Start Guide](../Images/CreateTournament.png)
- Multiple tournaments can also be created by uploading a spreadsheet with tournament details. The sample spread sheet can be downloaded by the users.

![Quick Start Guide](../Images/MultipleTournaments.png)

- Below are the guidelines that need to be followed while creating multiple tournaments using excel template:

- Do not modify the column headers in the template
- Do not delete the columns in the template
- Enter data in all the required(*) columns mentioned in the template
- Follow the character limit and type mentioned in the template for each column
- Enter data for only 1 tournament in each sheet as per the sample data provided
- Only 10 tournaments can be created at a time
- Ensure the Tournament Name is unique

- Created Tournaments are not started by default. “Manage Tournaments” screen should be used to start the tournament.

### Manage Tournaments

- A tournament can be started or completed by an admin using “Manage Tournaments” screen.

- Multiple tournaments can be active at a time.

- Multiple tournaments can be started at a time

![Quick Start Guide](../Images/ManageTournament.png)

### My Dashboard
Expand Down
33 changes: 18 additions & 15 deletions Wiki/Upgrade.md
Original file line number Diff line number Diff line change
@@ -1,40 +1,41 @@
### Upgrade to version 2.2 from 2.1, 2.0, 1.3 and 1.2
### Upgrade to version 2.3 from 2.2, 2.1, 2.0, 1.3 and 1.2

If you are already having version 2.1, 2.0, 1.3 or 1.2 installed on your tenant follow the below steps to upgrade to version 2.1 with an admin account:
If you are already having version 2.2, 2.1, 2.0, 1.3 or 1.2 installed on your tenant follow the below steps to upgrade to version 2.3 with an admin account:

NOTE: If you are using/seeing modern app catalog refer to the go to the [Modern App Catalog](#modern-app-catalog) section.

1. Navigate to App Catalog with a tenant Admin account. Do not delete the existing package. Upload the new package that is downloaded from "sharepoint/solution" folder which will replace the existing package.

![Upgrade 2.2](../Images/Upgrade-1.png)
![Upgrade](../Images/Upgrade-1.png)

2. Click on "Deploy".

![Upgrade 2.2](../Images/Upgrade-2.png)
![Upgrade](../Images/Upgrade-2.png)

3. "Check In" the package.

![Upgrade 2.2](../Images/Upgrade2.0-3.png)
![Upgrade](../Images/Upgrade2.0-3.png)

4. Select the package and click "Sync to Teams" from the ribbon and wait for the "Successfully synced to teams solution" message to appear.

![SyncToTeams](../Images/SyncToTeams.png)

5. The Champion Management Platform will be updated to the latest version and you will see changes reflected in Teams. Please note that if you do not see changes reflected in Teams after 30 minutes you can log out and back in and clear the Teams cache to see changes immediately.

6. If you already had "Tournament of Teams" enabled before the upgrade, click on "Enable Tournament of Teams" under "Admin Tools" section again. That will provision new lists for Tournament Reporting feature. "Tournament of Teams" icon will not be visible in the "Get Started" section without this step.
6. This steps applies only if you are upgrading from versions 2.1 or older. This step is not required if you are upgrading from version 2.2. <br>
If you already had "Tournament of Teams" enabled before the upgrade, click on "Enable Tournament of Teams" under "Admin Tools" section again. That will provision new lists for Tournament Reporting feature. "Tournament of Teams" icon will not be visible in the "Get Started" section without this step.

![Upgrade-2.2](../Images/Upgrade-3.png)
![Upgrade](../Images/Upgrade-3.png)

**NOTE:** If there is any completed tournament before the upgrade, enabling Tournament of Teams will take couple of minutes (depends on number of completed tournaments) to load the data about completed tournaments into the Tournaments Report and Participants Report lists. Do not navigate away from the screen until it is completed with success message.

![Upgrade-2.2](../Images/EnableTOT.png)
![Upgrade](../Images/EnableTOT.png)

![Upgrade-2.2](../Images/TOTScreen.png)
![Upgrade](../Images/TOTScreen.png)

7. The below graph permissions can be removed from "API Permissions" in sharePoint admin portal only if the permission is not used in any other apps in your tenant. The upgraded package for CMP is not using these permissions anymore.

![Upgrade-2.2](../Images/Upgrade-4.png)
![Upgrade](../Images/Upgrade-4.png)

8. A new CMP logo has been added in this package. If you have not customized the app logo for the CMP application, you can delete the "CMP Logo" library from SharePoint site so that it will be automatically re-created when the app is launched and the MS logo will be replaced with new CMP logo image in the library.

Expand All @@ -44,21 +45,23 @@ If you are already having version 2.1, 2.0, 1.3 or 1.2 installed on your tenant

1. Navigate to App Catalog. Do not delete the existing package. Upload the new package that is downloaded from "sharepoint/solution" folder which will replace the existing package.

![Upgrade-2.2](../Images/Upgrade_Modern_AppCatalog1.png)
![Upgrade](../Images/Upgrade_Modern_AppCatalog1.png)

1. After uploading the package, select "Enable this app and add it to all sites" and click on "Enable App"

![Upgrade-2.2](../Images/Modern_AppCatalog2.png)
![Upgrade](../Images/Modern_AppCatalog2.png)

1. Skip this step.

![Upgrade-2.2](../Images/Modern_AppCatalog3.png)
![Upgrade](../Images/Modern_AppCatalog3.png)

1. Once done, click on "Add to Teams" to make this app available in Teams

![Upgrade-2.2](../Images/Modern_AppCatalog4.png)
![Upgrade](../Images/Modern_AppCatalog4.png)

### Upgrade to version 2.2 from 1.1
``` Continue with steps 5 to 8 from the previous section.```

### Upgrade to version 2.3 from 1.1

If you are already having 1.1 installed on your tenant and want to upgrade to 2.2 the existing app and SharePoint site 'ChampionManagementSite' have to be deleted.

Expand Down
2 changes: 1 addition & 1 deletion config/package-solution.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"solution": {
"name": "championmanagement",
"id": "5099a3ef-113f-4baf-bb6a-a73b1dd286f8",
"version": "2.2.0.0",
"version": "2.3.0.0",
"includeClientSideAssets": true,
"skipFeatureDeployment": true,
"isDomainIsolated": false,"developer": {
Expand Down
Loading

0 comments on commit ed00650

Please sign in to comment.