Skip to content

Commit 1d52db8

Browse files
committed
Added article about Bot Powered ACEs with TTK+TS
1 parent fcc6b52 commit 1d52db8

12 files changed

+546
-4
lines changed

docs/spfx/viva/bot-powered/Building-Your-First-Bot-Powered-ACE-TTK-TS.md

Lines changed: 530 additions & 0 deletions
Large diffs are not rendered by default.

docs/spfx/viva/bot-powered/Building-Your-First-Bot-Powered-ACE.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: Building your first Bot Powered Adaptive Card Extension
2+
title: Building your first Bot Powered Adaptive Card Extension with .NET
33
description: Learn how to build your first Bot Powered Adaptive Card Extension using the Bot Framework for Microsoft .NET.
44
ms.date: 10/30/2024
55
ms.localizationpriority: high
66
---
7-
# Building your first Bot Powered Adaptive Card Extension
7+
# Building your first Bot Powered Adaptive Card Extension with .NET
88

9-
Bot Powered Adaptive Card Extensions (ACEs) for Microsoft Viva Connections enables extending the Microsoft Viva Connections Dashboard using the Bot development model.
9+
Bot Powered Adaptive Card Extensions (ACEs) for Microsoft Viva Connections enable extending the Microsoft Viva Connections Dashboard using the Bot development model.
1010

1111
From a development point of view, a Bot Powered ACE behaves like a regular client-side ACE built with SharePoint Framework (SPFx). As such, you can render Card Views, Quick Views, you can provide properties configurable via a Property Pane, and you can implement specific behaviors to handle actions in the user interface of the ACE. You can learn more about the basics of client-side Adaptive Card Extensions for Microsoft Viva Connections by reading the tutorial ["Build your first SharePoint Adaptive Card Extension."](../get-started/build-first-sharepoint-adaptive-card-extension.md)
1212

@@ -479,6 +479,17 @@ For example, the `TextInputCardViewParameters` instance is made of the following
479479

480480
In the code excerpt, the images used to render the Card Views are downloaded from the web site hosted in the Bot project, and available under the **wwwroot** folder of the project. In that folder, you should upload the **Media** subfolder that you can find in the [samples folder of the reference GitHub repository](https://github.com/SharePoint/sp-dev-docs/tree/main/assets/bot-powered/Media).
481481

482+
#### Serving Card Views requests
483+
484+
To serve the card views, you need to implement the `OnSharePointTaskGetCardViewAsync` method so that it will return the instance of the card view to collect feedback that you created in the constructor. Here follows the method implementation.
485+
486+
```CSharp
487+
protected override Task<CardViewResponse> OnSharePointTaskGetCardViewAsync(ITurnContext<IInvokeActivity> turnContext, AceRequest aceRequest, CancellationToken cancellationToken)
488+
{
489+
return Task.FromResult(cardViews[CollectFeedbackCardView_ID]);
490+
}
491+
```
492+
482493
#### Handling user's tasks and actions
483494

484495
When the user selects on the submit action in a Card View, the `OnSharePointTaskHandleActionAsync` method is triggered and you can handle the submission event. In the following code excerpt, you can see how the ACE collects the feedback submission.

docs/spfx/viva/bot-powered/Overview-Bot-Powered-ACEs.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,8 @@ In this series of articles, you can understand what Bot Powered Adaptive Card Ex
2828

2929
The series of articles covers the following topics:
3030

31-
1. [Building your first Bot Powered Adaptive Card Extension](Building-Your-First-Bot-Powered-ACE.md)
31+
1. [Building your first Bot Powered Adaptive Card Extension with .NET](Building-Your-First-Bot-Powered-ACE.md)
32+
1. [Building your first Bot Powered Adaptive Card Extension with Microsoft Teams Toolkit and TypeScript](Building-Your-First-Bot-Powered-ACE-TTK-TS.md)
3233
1. [Understanding Bot Powered Adaptive Card Extensions](Understanding-Bot-Powered-ACEs.md)
3334
1. [Authentication and Authorization in Bot Powered Adaptive Card Extensions](AuthN-and-AuthZ-in-Bot-Powered-ACEs.md)
3435
1. [Building Bot Powered Adaptive Card Extensions with Microsoft Entra ID and Single Sign-on](AuthN-and-AuthZ-in-Bot-Powered-ACEs-Entra.md)
Loading
Loading
Loading
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)