officedev / microsoft-teams-apps-champion-management

Champion Management Platform is a custom Teams app that enables organizations to onboard and maintain champions/ SME in their organization in Teams.

Champion Management Platform

Documentation	Solution Overview	Architecture	Deployment Guide

Introduction

The Champion Management Platform is a custom Teams app that enables organizations to onboard and maintain Champions / SME in their organization in Teams, allowing everyone discover Champions right where they collaborate. Utilize this template for multiple scenarios: such as new initiative adoption, champion onboarding, or to maintain organization-wide Subject Matter Experts. Now also available is the Tournament of Teams module allowing for organizational wide tournaments promoting adoption themes you are skilling your users up on.

The app provides an easy interface for designated users to add members to the champion program, preview, collaborate and communicate and build a community of Champions.

Additional Customization Options

The Champion Management Platform is built to provide a great starting point for managing your program. There are several ways you can modify the solution to fit your needs, refer to this section for more on customization.

Legal

This app template is provided under the MIT License terms. In addition to these terms, by using this app template you agree to the following:

• You are responsible for complying with all applicable privacy and security regulations related to use, collection, and handling of any personal data by your app. This includes complying with all internal privacy and security policies of your organization if your app is developed to be sideloaded internally within your organization.

• Where applicable, you may be responsible for data related incidents or data subject requests for data collected through your app.

• Any trademarks or registered trademarks of Microsoft in the United States and/or other countries and logos included in this repository are the property of Microsoft, and the license for this project does not grant you rights to use any Microsoft names, logos or trademarks outside of this repository. Microsoft's general trademark guidelines can be found here.

• Use of this template does not guarantee acceptance of your app to the Teams app store. To make this app available in the Teams app store, you will have to comply with the submission and validation process, and all associated requirements such as including your own privacy statement and terms of use for your app.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA. This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Disclaimer

THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.

microsoft-teams-apps-champion-management's Issues

Install in existing site

Can this be installed in an existing SharePoint site instead of creating a new one?

Where to find CMP File Download

Hello,

I am hoping you can point me in the right direction as to how to find the CMP download folder as referenced in step 4. Trying to get this kicked off.

Thanks in advance!

Localization

Hi, is there a guidance on how to localize this app?

Unable to update app layout in Microsoft Teams

Hi Team, Is there a way to customize the app layout of the Champions Management app? Specifically I want to customize the registration layouts. I find that when I update these in the SharePoint lists (The headers), it does not update the header in the actual app despite the choices being updated. Thanks!

Failed to sync solution to Teams

Unable to sync customized solution to Teams. Its failing with error "Failed to sync solution to Teams".

Already tried below two options:

1. Deleting old App from MS Teams.
2. Allowing permissions to External App.

Please suggest what could be wrong here and solution for it.

Multiple default items creation in Event list

When using the app, there is multiple default items creation in the Event list. I don't think it's a normal behavior from this app.

Reinstalled with update but still getting spinning circle

Hello,

My team has been trying to install this, but ran into the spinning circle issue. I removed the app and downloaded the current version, but this remains unresolved.

I read through some of the other threads, and it's probably a permissions issue but my challenge is that there is no option to add 'Everyone except external users'. This group does not exist in my tenant. I tried adding a group that serves a similar purpose for my organization, but it made no difference. I'm a bit of a loss on where to go from here, so any advice is appreciated.

spinning blue circle during first load experience

When trying to add app to my left rail in Teams I get the spinning blue circle during first load experience. I have pimmed to Teams Admin, SharePoint, Admin, and Application Administrator.

If I try to add the app to a Teams/channel site, I get a message at top saying 'Welcome to the Microsoft 365 Champion Management Platform' on the left side is text "Quick Start Guide' and on the right side is the spinning blue circle. I am an owner of the Teams site.

I've tried multiple times, e.g. uninstalling the app. In SharePoint I approved the API access. As a SharePoint admin, I can create SharePoint sites.

I am working with version 1.3.0.0

Error running npm install

Hi, I cloned the repo locally then executed the npm start command from VS Code (using admin mode) and I get the following errors.

I'm running npm v7.19.1 and node v14.18.1

Error with gulp build

I'm stuck with this error in the output from gulp build:

[11:58:01] Finished subtask 'tslint' after 19 s
[11:58:07] Error - [tsc] node_modules/reselect/es/defaultMemoize.d.ts(1,13): error TS1005: '=' expected.
[11:58:07] Error - [tsc] node_modules/reselect/es/defaultMemoize.d.ts(1,33): error TS1005: ';' expected.
[11:58:07] Error - [tsc] node_modules/reselect/es/index.d.ts(1,13): error TS1005: '=' expected.

Icon keeps spinning with v1.2

These are the deployment steps that I took. However, after adding the Champion Management app, the icon beside champion leader board keeps spinning.
Account using has global and SharePoint roles

1. downloaded the cmp.sppkg v1.2
2. added to the SharePoint admin app catalog
3. approved api access
4. sync to teams
5. open teams and add app "champion management platform"
6. Icon spinning
   other issues - can't find a site called "ChampionManagementPlatform" https://.sharepoint.com/sites/ChampionManagementPlatform/

Please let me know if I am missing something here.

After deleting champions user list, app content disappear

Hi,
yesterday we have replaced users used to test with official users champion list but immediately app look like corrupted and show a white page instead of content.

Data are all present on SharePoint, list populated with data, but app on Teams doesn't work.

Considering that are simple row and that has not changed structure of SharePoint site, probably there's something that is correlated with deletion but we don't know where.

We have tried also to deploy again app but result is always the same

CMP first load failing with no error

On first load of the Teams app, Champion Leader board tile shows up and a spinning circle.
It spins for ever and stays stuck.
App is loaded in Teams Windows client.
Tried removing all components and reloading the cmp package several times. Did not make a difference.
Tried loading the app in Teams Web client after removing the following assets from the SharePoint site:

• Digital Badge Assets
• Event Track Details list
• Events List
• Member List
  It now prompt with a message saying "Admin permission have been granted to user X. Please refresh the app"
  All is now functional.

Unable to redeploy Championship Management Platform

I followed the steps and deployed the Championship management platform, but then I had the circling error of not all the groups formed on the Champions Page, so I deleted the site, and then followed by application.

I am then trying to recreate the solution, importing the solution shows success but API access page no permission requests are made, assuming its already there I tried but with no success, after going through the issues here, I deleted the site permanently and now the site also not getting created and am stuck , any inputs are appreciated to get this going.

Application is listed on the SharePoint Apps Page

API Access I don't see it.

When I sync, I get "sync failed to Teams"

also I dont see the SharePoint site created.

How to configure creation of the "Member List" on another site than the root site of the tenant?

Hi,

I am able to change the name of the site collection that gets created by the App, but I can't find a way to change the location of the "Member List". This one always gets created in the https://tenantname.sharepoint.com/ root site, which I would like to change to an existing site collection.
I tried updating the "siteconfig.json" file, adding the "rootSideId" key (as shown in the screenshot on the deployment page) but provided the GUID of another (non root) site as value. However, it didn't work - the Member List still got created in the true root site of the SharePoint tenant.

Is there a way to control the location of the "Member List"?

Thank you in advance,

Kind Regards,

Jim

Source code vulnerabilities identified by WhiteSource Bolt scan

Hi @arun-msft

I just wanted to highlight that when we upload this code to our DevOps repository, we got the source scanned with WhiteSource Bolt. However, it has reported 8 high vulnerabilities and 1 medium vulnerability, I have attached the scan report to this issue. Just wondering if you can please take a look and apply a fix.

ModernWorkplace-riskReport(PDF).zip

Thank you.

Deploy Multiple Instances

Hello!
I was wondering if there was a way to deploy multiple instances of this app each with different member lists and config?
This would be useful as we have different champion networks for different transformation projects.
Thanks in advance
Martin

‎Champion management platform‎

Hi,
I tried setting up this App in Syngenta tenant, but I was not able to proceed further step-10 from the steps provided in below link:
https://github.com/OfficeDev/microsoft-teams-apps-champion-management .

The API’s which needs to be approved from the Tenant are not visible.

Deploy to Site Collection Level App Catalog

Hi,

Since the CMP app assets can now reside on a single site collection, we tried to get it working - deploying from the Site Collection App Catalog, but that prevents the app from being available from being deployed to Teams from the Local App Catalog. Would there be a way to get the CPM working without having to deploy to the Tenant App Catalog and "Make this solution available to all sites in the organization" but using a site collection App Catalog instead?

Populate Event name and Member name in Event Track list

Currently it is difficult to report on who delivered which event types. THe tabke in Event Track list includes reference to memberid and eventid. It is left to user to manually cross reference eventid to ID column in Event List and memberid to ID column in Member List.

Adding columns Member and Event Title/Type to Event Track Details and populating them when adding a row would make it better for tracking member activities better.

I recognize that the app shows activities when clicking on the person in leaderboard but it isn't sustainable in large orgs where sponsors might want to use PowerBI and other ways to report champion activities.

Customization of columns

My customer is having problems with using the app since tweaking some of the customizable code to suit their needs. The app doesn't install successfully after the customizations are applied.

Wont update the members list attributes v1.2

Hi,
after installing v1.2 i am trying to change the attributes required to be filled out on the Become a Champion page. i have added 2 new columns in the SharePoint list but they do not show on the Become a Champion signup. i have hidden the focus area and group columns and added Area and Branch. focus area and group still show on the sign up page but the new columns do not.

originally i edited the name and input of Focus area and group columns. this caused the entire app to white screen when become a champion was clicked or the leader board if you were already a champion. i had to delete the site and re create it.

i am running v1.2 the guide is limited on how exactly you do this but i have followed what is there under additional customisation options:
This action is done from selecting the list you would like to edit (champion list for this example), selecting the drop down on the column, then navigating to Column settings -> Edit.

Can you please advise
columns on site list

displayed attributes on sign up

Bundle error

Hello,

I am getting the following error when trying to bundle the solution

Unable to successfully upload app package to App Catalog

I am unable to successfully upload the app (version 1.3) to the tenant App Catalog as I receive the errors:

Valid App Package: No
App Package Error Message: Invalid SharePoint App package. Error: File contains corrupted data.

Note that I did not have this issue with version 1.2, however I was experiencing another issue where the SharePoint site was not being created as expected after deploying the Teams app. This is apparently corrected with version 1.3.

Continuous circle of waiting - 2

I am receiving this problem and can see the last recorded report of this is marked as issue closed even though other people have added to the chat with the problem.

I have checked - the app permission requests have been approved..

Unable to "find" the app in teams

Hi,

We have now successfully uploaded the application and synced to Teams. We find the app in the Teams Admin Center under the apps overview. However, when we try adding the app as a tab in a team, we are unable to find the app. We search for "Champion" but no app appears, even when we look in the all apps overview. See screenshot below:

In the Teams Admin Center, in the apps overview, we have also tried clicking the "add to team" button. Still, the app does not appear.

Could you please assist? Thank you :-)

PS: we have tried restarting teams and have waited 24 hours since we synced the app to Teams, but it still does not work.

Regards, Elise.

Digital badge can not be retrieved nor applied

Digital badges are not shown, even tho i just deployed the solution and the library has default images without having them tagged to tournaments. When trying to apply badge this error is shown:

Any ideas?

here the list of bades for reference:

Fail to sync to Teams

I followed this doc to create a Standard deployment, I am Sharepoint admin and Teams admin, I also tried with a global admin in the Enterprise and I still cannot make it Sync to Teams.

This is the error we get when we Sync to Teams. I tried to open a case with MS Support, but they sent us to developers.

Please advise what to do after this.

Teams SharePoint Error

I did not make any custom configurations and just uploaded cmp.sppkg into SharePoint Admin App Catalog and did a sync to Teams. I'm able to add the see Champion Management Platform in my Teams tab, but it doesn't load fully. 

Not sure if the error is Teams or SharePoint?

Thank you for any help you can provide.

Continuous circle of waiting

After installing the Champion Management app in Sharepoint and then sharing it to Teams, we have added it into a Team (more than one time and more than one Team) and all we get is a spinning circle - it never resolves whether in the Windows app or on the Teams website. Removing it and readding it, nor recreating within a new team changes the response. It will spin for hours.

I have tried with both the admin (Global) account that the app was installed in and with a different user and no difference.

The app installed with no errors.

What should be my next step here?

App not updating profile picture with badge

Hi,
we successfull installed the App at our tenant and everything works fine except the update profile picture function. We didn't customized anything just used the default app. All API Requests are granted!

PS: Downloading your own profilpicture works!

Champion Leader Board page not loading in team tab context

The Champion Leader Board page isn't loading in a team tab context (blank page).

Install on GCC or Higher

When attempting to install on GCC Tenant the backend SP Site and associated lists are not created.

403 Error in MS Teams

We installed the package successfully in the App Catalog. The user who created a MS Team from the template can access the app tab without issues but when I go (desktop or web) I get "Something went wrong. 403" dialog and only see the Champion Leader Board, Add Members, and Digital Badge icons. Digital Badge and Add Members both seem to work but Champion Leader Board is a blank white page with the blue CMP banner.

Global Rank is not showing data

Hi,
yesterday, after app deployment, we noticed that Global Rank part is not showing any data (point and ranking) as below

Any idea

Regards

Champions (Employees) cannot see all options in CMP - SharePoint Member List

We rolled out CMP, but the internal employees that are added as members in the CMP cannot see all options, but only a moving circle. We tried to edit the email addresses of the invited champions in the SharePoint member list, but they don't have access to the platform, regardless of the E-mail addresses we use in SharePoint.

Last time, we investigated the following solution, but unfortunately it is not working as follows:

1. The issue is due to the difference in UPN and Email. Below is the snapshot of the results when we searched for Anna in share point. The CMP App assumes both UPN and Email are same.

2. When adding a user through “Add Member” screen it’s adding the ids with “x-x.com” and the user is not able to see the options. But when we changed it to “xx.com” it started working.

As I have demonstrated we have 2 options in this use case where the UPNs and Emails are not matching.

1. Add people to through ”Add Members” and modify the emails in the “Members List” in SharePoint.
2. By default the employees will only see LeaderBoard option and they can request to become a champion. Once they submit the request the Admin has to approve the access using “Manage Approvals” option in the App. After Approval the champion can access other options.
   In this case it works as expected and no manual fix is required.

Any ideas what the issue can be?

Clarify Pre-requisites

The steps to create the app package asks user to run npm install and gulp, however there are no mentions of installing NPM or Gulp in pre-requisites.

Running latest version of NPM was resulting in failures when running npm install. Only using Node 10.24 from https://nodejs.org/en/download/releases/ fixed that issue.

To install gulp, I had to run npm install -g gulp .

The pre-requisites should provide reference to appropriate node.js version and download links as well as reference to command to install gulp so the steps don't fail and create confusion for someone who doesn't have developer background and is relying on instructions.

Error importing default cmp.sppkg

Seeing this error trying to install the default SPO package. Any ideas?

Administrative options are not shown to users who are configured as managers

Fresh deployment of v1.3. API permissions granted and the /sites/ChampionManagementPlatform SharePoint site was successfully provisioned.

All employees were granted edit access to the site collection. Users who have been added to the Member List as managers do not see any administrative options in the Teams app, only the "Leaderboard" icon, receiving the following error in Teams for web:

"An embedded page at (tenant sp root collection) says / an unexpected error occurred while retrieving user role. Below are the details: TypeError: Cannot read property 'toLowerCase' of undefined"

Tried deleting app and site and re-deployed, to no avail.

Use Site Collection App Catalog instead of Global App Catalog

One of the concerns of most customers I work with is that the app template deploys in Global App Catalog, allowing the app to be available and deployed to any site in the SharePoint environment. Most customers want to control which sites the solution can be deployed to due to governance requirements. If the app deploys to Site Collection App Catalog instead of Global App catalog, it can be made available to desired SPO sites, meeting governance requirements.

This is a blocker for customers I have worked with and addressing it would enable broader usage of this app template.

Assistance with deployment

We have been unsuccessful in deploying this. At the last MS Higher Ed Advisory Committee Board meeting it was suggested that I reach out to this group to ask someone for assistance with this matter.

Is this something someone here would be able to help with?
Best regards

Is this supported in GCCH or DoD tenant?

is this custom application supported in GCCH or DoD tenants?

App not loading components when added as Personal App in Teams

The app is not loading the components like Add Members, Digital Badge etc., when added as Personal App in Teams.

First name & Last Name populated incorrectly

Hi,

We are using champion management platform. When we add a new member, the first name and last name populated incorrectly.
For example:

• Member name: Yeoh Mei Kuan
• In sharepoint list, First Name = Yeoh, Last Name = Mei.

gulp build throws error TS1005: ',' expected.

Build target: DEBUG
[12:05:38] Using gulpfile C:\DEV\microsoft-teams-apps-champion-management\gulpfile.js
[12:05:38] Starting gulp
[12:05:38] Starting 'build'...
[12:05:38] Starting subtask 'configure-sp-build-rig'...
[12:05:38] Finished subtask 'configure-sp-build-rig' after 6.87 ms
[12:05:38] Starting subtask 'pre-copy'...
[12:05:38] Finished subtask 'pre-copy' after 185 ms
[12:05:38] Starting subtask 'copy-static-assets'...
[12:05:38] Starting subtask 'sass'...
[12:05:39] Finished subtask 'sass' after 510 ms
[12:05:39] Starting subtask 'tslint'...
[12:05:40] [tslint] tslint version: 5.12.1
[12:05:41] Starting subtask 'tsc'...
[12:05:41] [tsc] typescript version: 3.3.4000
[12:05:41] Finished subtask 'copy-static-assets' after 2.47 s
[12:05:58] Error - [tsc] node_modules/@material-ui/data-grid/dist/data-grid.d.ts(3201,70): error TS1005: ',' expected.
[12:05:58] Error - [tsc] node_modules/@material-ui/data-grid/dist/data-grid.d.ts(3201,81): error TS1005: ',' expected.
[12:05:58] Error - [tsc] node_modules/@material-ui/data-grid/dist/data-grid.d.ts(3238,64): error TS1005: ',' expected.
[12:05:58] Error - [tsc] node_modules/@material-ui/data-grid/dist/data-grid.d.ts(3238,75): error TS1005: ',' expected.
[12:05:58] Error - [tsc] node_modules/@material-ui/data-grid/dist/data-grid.d.ts(3259,82): error TS1005: ',' expected.
[12:05:58] Error - 'tsc' sub task errored after 18 s 
 exited with code 2
[12:05:58] 'build' errored after 20 s
[12:05:58]
[12:05:59] ==================[ Finished ]==================
Error - [tsc] node_modules/@material-ui/data-grid/dist/data-grid.d.ts(3201,70): error TS1005: ',' expected.
Error - [tsc] node_modules/@material-ui/data-grid/dist/data-grid.d.ts(3201,81): error TS1005: ',' expected.
Error - [tsc] node_modules/@material-ui/data-grid/dist/data-grid.d.ts(3238,64): error TS1005: ',' expected.
Error - [tsc] node_modules/@material-ui/data-grid/dist/data-grid.d.ts(3238,75): error TS1005: ',' expected.
Error - [tsc] node_modules/@material-ui/data-grid/dist/data-grid.d.ts(3259,71): error TS1005: ',' expected.
Error - [tsc] node_modules/@material-ui/data-grid/dist/data-grid.d.ts(3259,82): error TS1005: ',' expected.
Error - 'tsc' sub task errored after 18 s 
 exited with code 2
[12:05:59] Project clb version:0.0.1
[12:05:59] Build tools version:3.12.1
[12:05:59] Node version:v10.16.0
[12:05:59] Total duration:28 s
[12:05:59] Task errors:7

Champion app permissions

My company has reviewed this Champion app for teams and thinks it’s great. However, our security team are concerned about the level of permissions that it requires.

The app requires access up to managing all sites. I know this is a delegated permission so it will only be able to manage the sites that the user can manage so the risk is less great than it may first appear.

But the main concerns are:

1. By granting this permission to the Champion app we are also granting it to all apps we deploy.
2. Can we be sure that the code in any app that is deployed won’t take advantage of the high level permission? We have some sensitive sites e.g. HR data. For example, code could be written to pull out sensitive data when an HR Admin uses an app.

What is the best wording to pass onto the security team?

Bundle error

Hello,

I tried building the solution via AzureDevops YAML pipeline, but encountered this error

"Insufficient privileges to complete the operation." in API access

When trying to approve the API access, I'm getting:

error: {code: "Authorization_RequestDenied", message: "Insufficient privileges to complete the operation.",…}
code: "Authorization_RequestDenied"
innerError: {date: "2021-05-23T06:39:06", request-id: "799ac1b2-b3e0-46c9-877e-6eeb72508938",…}
client-request-id: "799ac1b2-b3e0-46c9-877e-6eeb72508938"
date: "2021-05-23T06:39:06"
request-id: "799ac1b2-b3e0-46c9-877e-6eeb72508938"
message: "Insufficient privileges to complete the operation."

I have the SharePoint Admin role.

Is CMP v2 version supported in mobile?

Is CMP v2 version supported in mobile?

Provide a way to add Manager and manage approvals

Currently it isn't clear from instructions that the manager and champion roles must be assigned manually through Champions List.

For a user not familiar with SharPoint wouldn't know how to manage approvals or change assign manager role to others.

It would be better if the app can provide a way to manage approvals and champion/manager role assignments directly in Teams app.