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.

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

Fixes and Images, Gif File Updates #1234

Merged
merged 2 commits into from Apr 29, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified samples/bot-tag-mention/csharp/Images/Tag-mention-bot.gif
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
32 changes: 17 additions & 15 deletions samples/bot-tag-mention/csharp/README.md
Expand Up @@ -36,33 +36,33 @@ This sample app demonstrates the use of tag mention funtionality in teams scope

### Register you app with Azure AD.

1. Register a new application in the [Microsoft Entra ID � App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
1. Register a new application in the [Microsoft Entra ID � App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
2. Select **New Registration** and on the *register an application page*, set following values:
* Set **name** to your app name.
* Choose the **supported account types** (any account type will work)
* Leave **Redirect URI** empty.
* Choose **Register**.
3. On the overview page, copy and save the **Application (client) ID, Directory (tenant) ID**. You�ll need those later when updating your Teams application manifest and in the appsettings.json.
3. On the overview page, copy and save the **Application (client) ID, Directory (tenant) ID**. You�ll need those later when updating your Teams application manifest and in the appsettings.json.
4. Under **Manage**, select **Expose an API**.
5. Select the **Set** link to generate the Application ID URI in the form of `api://{base-url}/botid-{AppID}`. Insert your fully qualified domain name (with a forward slash "/" appended to the end) between the double forward slashes and the GUID. The entire ID should have the form of: `api://fully-qualified-domain-name/botid-{AppID}`
* ex: `api://%ngrokDomain%.ngrok-free.app/botid-00000000-0000-0000-0000-000000000000`.
6. Select the **Add a scope** button. In the panel that opens, enter `access_as_user` as the **Scope name**.
7. Set **Who can consent?** to `Admins and users`
8. Fill in the fields for configuring the admin and user consent prompts with values that are appropriate for the `access_as_user` scope:
* **Admin consent title:** Teams can access the user�s profile.
* **Admin consent description**: Allows Teams to call the app�s web APIs as the current user.
* **Admin consent title:** Teams can access the user�s profile.
* **Admin consent description**: Allows Teams to call the app�s web APIs as the current user.
* **User consent title**: Teams can access the user profile and make requests on the user's behalf.
* **User consent description:** Enable Teams to call this app�s APIs with the same rights as the user.
* **User consent description:** Enable Teams to call this app�s APIs with the same rights as the user.
9. Ensure that **State** is set to **Enabled**
10. Select **Add scope**
* The domain part of the **Scope name** displayed just below the text field should automatically match the **Application ID** URI set in the previous step, with `/access_as_user` appended to the end:
* `api://[ngrokDomain].ngrok-free.app/botid-00000000-0000-0000-0000-000000000000/access_as_user.
11. In the **Authorized client applications** section, identify the applications that you want to authorize for your app�s web application. Each of the following IDs needs to be entered:
11. In the **Authorized client applications** section, identify the applications that you want to authorize for your app�s web application. Each of the following IDs needs to be entered:
* `1fec8e78-bce4-4aaf-ab1b-5451cc387264` (Teams mobile/desktop application)
* `5e3ce6c0-2b1f-4285-8d4b-75ee78787346` (Teams web application)
12. Navigate to **API Permissions**, and make sure to add the follow permissions:
- Select Add a permission
- �Select Microsoft Graph -\>�Delegated permissions.
- �Select Microsoft Graph -\>�Delegated permissions.
- `TeamworkTag.Read`
- `TeamworkTag.ReadWrite`
- Click on Add permissions. Please make sure to grant the admin consent for the required permissions.
Expand All @@ -72,7 +72,7 @@ This sample app demonstrates the use of tag mention funtionality in teams scope
* Select **Add a platform**.
* Select **web**.
* Enter the **redirect URI** `https://token.botframework.com/.auth/web/redirect`. This will be use for bot authenticaiton.
14. Navigate to the **Certificates & secrets**. In the Client secrets section, click on "+ New client secret". Add a description(Name of the secret) for the secret and select �Never� for Expires. Click "Add". Once the client secret is created, copy its value, it need to be placed in the appsettings.json.
14. Navigate to the **Certificates & secrets**. In the Client secrets section, click on "+ New client secret". Add a description(Name of the secret) for the secret and select �Never� for Expires. Click "Add". Once the client secret is created, copy its value, it need to be placed in the appsettings.json.

15. Create a Bot Registration
- Register a bot with Azure Bot Service, following the instructions [here](https://docs.microsoft.com/en-us/azure/bot-service/bot-service-quickstart-registration?view=azure-bot-service-3.0).
Expand Down Expand Up @@ -145,9 +145,10 @@ You can interact with this bot in Teams by sending it a message, or selecting a
>Note : Before using the Tag Mention sample in a team channel scope, please install this app in your Personal scope to enable Single Sign-On (SSO) login.

**Personal Scope**
![PersonalScope-interactions ](Images/1.AddPersonalScope.png)

1. **SSO Login**
![groupChat-BotCommands-interactions ](Images/personal-sso-interaction.png)
![groupChat-BotCommands-interactions ](Images/2.LoginWithPersonalScope.png)

**Team channel Scope**

Expand All @@ -156,30 +157,31 @@ You can interact with this bot in Teams by sending it a message, or selecting a
- **Valid Scopes:** team chat

**Show Welcome command interaction:**
![groupChat-BotCommands-interactions ](Images/team-BotCommands-interaction.png)
![groupChat-BotCommands-interactions ](Images/4.WelcomeMessage_Teams.png)

2. **MentionTag**
- **Result:** The bot will respond to the message and mention a tag
- **Valid Scopes:** team chat

- **Team Scope Interactions:**
![Add To Teams Scope ](Images/3.AddToTeamsScope.png)

**MentionTag command interaction:**
**Command 1:** `@<Bot-name> <your-tag-name>` - It will work only if you have Graph API permissions to fetch the tags and bot will mention the tag accordingly in team's channel scope.
![team-MentionCommand-Interaction ](Images/team-MentionCommand-Interaction.png)
![team-MentionCommand-Interaction ](Images/5.MetionedTag.png)

**Command 2:** `@<Bot-name> @<your-tag>` - It will work without Graph API permissions but you need to provide the tag as command to experience tag mention using bot.
![team-MentionCommand-Interaction ](Images/team-MentionCommand-Interaction1.png)
![team-MentionCommand-Interaction ](Images/5.MetionedTag-2.png)

**Hover on the tag to view the details card:**
![team-MentionCommand-Interaction ](Images/team-MentionCommand-Interaction-2.png)
![team-MentionCommand-Interaction ](Images/6.TagMentionDetails.png)

**Message interaction:**
When you mention the bot in Teams without providing any commands, you will receive the following message.
![team-MentionCommand-Interaction ](Images/team-MentionCommand-Interaction-3.png)
![team-MentionCommand-Interaction ](Images/8.WithOutCommand.png)

If you attempt to use the bot before creating a tag or if you provide an incorrect tag name, you will receive the following message.
![team-MentionCommand-Interaction ](Images/team-MentionCommand-Interaction-4.png)
![team-MentionCommand-Interaction ](Images/7.MessageWhenNoTagFound.png)

## Deploy the bot to Azure

Expand Down
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified samples/bot-tag-mention/nodejs/Images/Tag-mention-bot.gif
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
16 changes: 9 additions & 7 deletions samples/bot-tag-mention/nodejs/README.md
Expand Up @@ -159,9 +159,10 @@ You can interact with this bot in Teams by sending it a message, or selecting a
>Note : Before using the Tag Mention sample in a team channel scope, please install this app in your Personal scope to enable Single Sign-On (SSO) login.

**Personal Scope**
![PersonalScope-interactions ](Images/1.AddPersonalScope.png)

1. **SSO Login**
![groupChat-BotCommands-interactions ](Images/personal-sso-interaction.png)
![PersonalScope-interactions ](Images/2.LoginWithPersonalScope.png)

**Team channel Scope**

Expand All @@ -170,30 +171,31 @@ You can interact with this bot in Teams by sending it a message, or selecting a
- **Valid Scopes:** team chat

**Show Welcome command interaction:**
![groupChat-BotCommands-interactions ](Images/team-BotCommands-interaction.png)
![groupChat-BotCommands-interactions ](Images/4.WelcomeMessage_Teams.png)

2. **MentionTag**
- **Result:** The bot will respond to the message and mention a tag
- **Valid Scopes:** team chat

- **Team Scope Interactions:**
![Add To Teams Scope ](Images/3.AddToTeamsScope.png)

**MentionTag command interaction:**
**Command 1:** `@<Bot-name> <your-tag-name>` - It will work only if you have Graph API permissions to fetch the tags and bot will mention the tag accordingly in team's channel scope.
![team-MentionCommand-Interaction ](Images/team-MentionCommand-Interaction.png)
![team-MentionCommand-Interaction ](Images/5.MetionedTag.png)

**Command 2:** `@<Bot-name> @<your-tag>` - It will work without Graph API permissions but you need to provide the tag as command to experience tag mention using bot.
![team-MentionCommand-Interaction ](Images/team-MentionCommand-Interaction1.png)
![team-MentionCommand-Interaction ](Images/5.MetionedTag-2.png)

**Hover on the tag to view the details card:**
![team-MentionCommand-Interaction ](Images/team-MentionCommand-Interaction-2.png)
![team-MentionCommand-Interaction ](Images/6.TagMentionDetails.png)

**Message interaction:**
When you mention the bot in Teams without providing any commands, you will receive the following message.
![team-MentionCommand-Interaction ](Images/team-MentionCommand-Interaction-3.png)
![team-MentionCommand-Interaction ](Images/8.WithOutCommand.png)

If you attempt to use the bot before creating a tag or if you provide an incorrect tag name, you will receive the following message.
![team-MentionCommand-Interaction ](Images/team-MentionCommand-Interaction-4.png)
![team-MentionCommand-Interaction ](Images/7.MessageWhenNoTagFound.png)

## Deploy the bot to Azure

Expand Down
10 changes: 9 additions & 1 deletion samples/bot-tag-mention/nodejs/aad.manifest.json
Expand Up @@ -3,7 +3,7 @@
"appId": "${{AAD_APP_CLIENT_ID}}",
"name": "bot-tag-mention-aad",
"accessTokenAcceptedVersion": 2,
"signInAudience": "AzureADandPersonalMicrosoftAccount",
"signInAudience": "AzureADMultipleOrgs",
"oauth2AllowIdTokenImplicitFlow": true,
"oauth2AllowImplicitFlow": true,
"optionalClaims": {
Expand All @@ -25,6 +25,14 @@
{
"id": "User.Read",
"type": "Scope"
},
{
"id": "TeamworkTag.ReadWrite",
"type": "Scope"
},
{
"id": "TeamworkTag.Read",
"type": "Scope"
}
]
}
Expand Down
21 changes: 14 additions & 7 deletions samples/meetings-sidepanel/csharp/README.md
Expand Up @@ -108,25 +108,32 @@ User interactions(Meeting Organizer)
- **Add** - Adds the agenda from Textinput to the SidePanel agenda list.
- **Publish Agenda** - Sends the agenda list to the meeting chat.

## Installation and setup meetings sidepanel.
![Install](Images/1.Install.png)

![Install](Images/2.AddToMeeting.png)

![Install](Images/3.ConfigureTab.png)

1. Welcome image to added side panel.
![Customform](SidePanel/Images/welcome.png)
![Customform](SidePanel/Images/4.Sidepanel.png)

2. Screen ready to added the agenda.
![AddNewAgenda](SidePanel/Images/addnewagenda.png)
![AddNewAgenda](SidePanel/Images/5.PushedAgenda.png)

3. On click of "Add" button, agenda point will be added to the agenda list.
![AgendaSubmit](SidePanel/Images/addagendabutton.png)
![AgendaSubmit](SidePanel/Images/6.PublishAgenda.png)

4. On click of "Publish Agenda", the agenda list will be sent to the meeting chat.
![AgendaCard](SidePanel/Images/agendacard.png)
![AgendaCard](SidePanel/Images/7.PublishAgendaChat.png)

## Interaction with app theme when Teams theme changes.

![Preview Image](Images/light.PNG)
![Preview Image](SidePanel/Images/8.DarkTheme.png)

![Preview Image](Images/dark.PNG)
![Preview Image](SidePanel/Images/4.Sidepanel.png)

![Preview Image](Images/contrast.PNG)
![Preview Image](SidePanel/Images/9.ContrastTheme.png)

## Deploy the bot to Azure

Expand Down
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Binary file modified samples/meetings-sidepanel/nodejs/Images/Preview.gif
Diff not rendered.
Diff not rendered.
Diff not rendered.
Binary file removed samples/meetings-sidepanel/nodejs/Images/dark.PNG
Diff not rendered.
Binary file removed samples/meetings-sidepanel/nodejs/Images/light.PNG
Diff not rendered.
22 changes: 15 additions & 7 deletions samples/meetings-sidepanel/nodejs/README.md
Expand Up @@ -149,17 +149,25 @@ Interact with SidePanel by clicking on the App icon present on the top menu besi

1. Once the app is clicked, sidepanel appears with the default agenda list. Only organizer gets the feasibility to add new agenda points to the list using "Add New Agenda Item" button.

![Dashboard](Images/Dashboard.png)
## Installation and setup meetings sidepanel.

![Install](Images/1.Install.png)

![Install](Images/2.AddToMeeting.png)

![Install](Images/3.ConfigureTab.png)

2. On click of "Add" button, agenda point will be added to the agenda list by organizer.

![AddNewAgendaItem](Images/AddNewAgendaItem.png)
![AddNewAgendaItem](Images/4.Sidepanel.png)

![AddedNew](Images/AddedNew.png)
![AddedNew](Images/5.PushedAgenda.png)

3. On click of "Publish Agenda", the agenda list will be sent to the meeting chat.

![Notification](Images/Notification.png)
![Notification](Images/6.PublishAgenda.png)

![Notification](Images/7.PublishAgendaChat.png)

**User interactions(Meeting Organizer)**
- **Add New Agenda Item** - Gives provision to add new Agenda point.
Expand All @@ -169,11 +177,11 @@ Interact with SidePanel by clicking on the App icon present on the top menu besi

## Interaction with app theme when Teams theme changes.

![Preview Image](Images/light.PNG)
![Preview Image](Images/4.Sidepanel.png)

![Preview Image](Images/dark.PNG)
![Preview Image](Images/8.DarkTheme.png)

![Preview Image](Images/contrast.PNG)
![Preview Image](Images/9.ContrastTheme.png)

## Deploy the bot to Azure

Expand Down
2 changes: 1 addition & 1 deletion samples/meetings-sidepanel/nodejs/teamsapp.local.yml
Expand Up @@ -94,4 +94,4 @@ deploy:
MicrosoftAppId: ${{AAD_APP_CLIENT_ID}}
MicrosoftAppPassword: ${{SECRET_AAD_APP_CLIENT_SECRET}}
MicrosoftAppType: ${{MICROSOFT_APP_TYPE}}
BaseURL: ${{BOT_ENDPOINT}}
BaseUrl: ${{BOT_ENDPOINT}}
Binary file modified samples/meetings-stage-view/csharp/Images/app-theme.gif
Binary file modified samples/meetings-stage-view/csharp/Images/preview_web.gif
27 changes: 13 additions & 14 deletions samples/meetings-stage-view/csharp/README.md
Expand Up @@ -163,11 +163,11 @@ Please find below demo manifest which is deployed on Microsoft Azure and you can

- App in stage view.

![Stage View Screen](Images/stage_view.png)
![Stage View Screen](Images/10.StageView2.png)

- Sharing specific part of your app to the meeting stage.

![Share Specific part screen](Images/share_specific_part.png)
![Share Specific part screen](Images/9.ShareSpecificPart.png)

**NOTE: Currently Live Share SDK is not supported in mobiles.**

Expand All @@ -187,39 +187,38 @@ Please find below demo manifest which is deployed on Microsoft Azure and you can

- Search for your app `App in meeting` and add it.

![Select App](Images/select_app.png)
![Select App](Images/1.Install.png)

- Join the meeting and click on the app icon at the top
- This will open a sidepanel with `Share` icon at top to share the app for collaboration in stage view.

![App icon](Images/app_icon.png)

![Share Icon](Images/share_icon.png)
![Share Icon](Images/2.StageView.png)

- You can now interact with the app.


- Add Details for collaboration.

![Add Button](Images/add_button.png)
![Add Doing](Images/3.AddDoing.png)

![Add ToDo](Images/4.AddToDo.png)

![Add Details](Images/add_details.png)
![Add Done](Images/5.AddDone.png)

- App in sidepanel.

![App in sidepanel](Images/side_panel.png)
![App in sidepanel](Images/1.AppInMeetings.png)

- Sharing specific parts of app.

![Share specific part](Images/share_specific_part_sidepanel.png)
![Share specific part](Images/9.ShareSpecificPart.png)

## Interaction with App theme when Teams Theme changes.

![light](Images/light.PNG)
![light](Images/2.StageView.png)

![dark](Images/dark.PNG)
![dark](Images/7.DarkTheme.png)

![contrast](Images/contrast.PNG)
![contrast](Images/8.ContrastTheme.png)

## Further reading

Expand Down
Diff not rendered.
Diff not rendered.
Diff not rendered.
Binary file modified samples/meetings-stage-view/nodejs/Images/app-theme.gif
Diff not rendered.
Diff not rendered.
Binary file removed samples/meetings-stage-view/nodejs/Images/dark.PNG
Diff not rendered.
Binary file removed samples/meetings-stage-view/nodejs/Images/light.PNG
Diff not rendered.
Binary file modified samples/meetings-stage-view/nodejs/Images/preview_web.gif
Diff not rendered.
Diff not rendered.
24 changes: 11 additions & 13 deletions samples/meetings-stage-view/nodejs/Readme.md
Expand Up @@ -155,11 +155,11 @@ You can use this app by following the below steps:

- App in stage view.

![Stage View Screen](Images/stage_view.png)
![Stage View Screen](Images/10.StageView2.png)

- Sharing specific part of your app to the meeting stage.

![Share Specific part screen](Images/share_specific_part.png)
![Share Specific part screen](Images/9.ShareSpecificPart.png)

**NOTE: Currently Live Share SDK is not supported in mobiles.**

Expand All @@ -179,39 +179,37 @@ You can use this app by following the below steps:

- Search for your app `App in meeting` and add it.

![Select App](Images/select_app.png)
![Select App](Images/1.Install.png)

- Join the meeting and click on the app icon at the top
- This will open a sidepanel with `Share` icon at top to share the app for collaboration in stage view.

![App icon](Images/app_icon.png)

![Share Icon](Images/share_icon.png)
![Stage View](Images/2.StageView.png)

- You can now interact with the app.


- Add Details for collaboration.

![Add Button](Images/add_button.png)
![Add Doing](Images/3.AddDoing.png)

![Add Details](Images/add_details.png)
![Add Todo](Images/4.AddToDo.png)

- App in sidepanel.

![App in sidepanel](Images/side_panel.png)
![App in sidepanel](Images/1.AppInMeetings.png)

- Sharing specific parts of app.

![Share specific part](Images/share_specific_part_sidepanel.png)
![Share specific part](Images/9.ShareSpecificPart.png)

## Interaction with App theme when Teams Theme changes.

![light](Images/light.PNG)
![light](Images/10.StageView2.png)

![dark](Images/dark.PNG)
![dark](Images/7.DarkTheme.png)

![contrast](Images/contrast.PNG)
![contrast](Images/8.ContrastTheme.png)

## Further reading

Expand Down