cancel
Showing results for 
Search instead for 
Did you mean: 
Reply
furqanmajeed
Helper II
Helper II

How to create an adaptive Card for Multiple options?

I want to create a list of multiple options where users can select any option on a multiple choice list and get a response back based on selection. here is an example in the image. 

furqanmajeed_0-1664805719116.png

 

1 ACCEPTED SOLUTION

Accepted Solutions
HenryJammes
Copilot Studio
Copilot Studio

PVA + Bot Framework Composer to display a dynamic adaptive card

For this example, I will use the current version of Power Virtual Agents that's extensible with the Bot Framework Composer. I will provide an example on how to present a chatbot user with an adaptive card that contains dynamic content that is retrieved from an external data source. I use Dataverse in this example, but the approach should be similar for any other data source, as I retrieve data with a Power Automate cloud flow and pass the data back to Power Virtual Agents.

 

In my scenario, I start in Power Virtual Agents:

  • I create a new topic called "Store Locations" and give it a few trigger phrases.
  • I add a Question node to ask the user "What is your city"?
  • I use the default "City" entity to automatically extract the city from a user utterance.
  • I save the response as the "UserCity" variable and update the variable to make it global, so I change its scope to "Bot (any topic can access)". This is important for the rest of my demonstration because I will also pass that value to a Bot Framework Composer dialog.
  • I save my topic.

HenryJammes_1-1671133550534.png

 

Before going to Power Automate (to retrieve my data) or in Bot Framework Composer (to enrich my dialog with an adaptive card), the first thing I need to do is create and design an adaptive card.

  • There are many samples available here: https://adaptivecards.io/samples/ 
  • You can then further customize samples in the adaptive card designerhttps://adaptivecards.io/designer/.
  • In my example, I create a card with a FactSet (to display he location names and address in a small table), and then add 2 ActionSet, the first one with Action.OpenUrl actions, to open a location's page in a new window, and the second one with a Action.Submit action, to submit an option as an answer from the user.
    Note: Action.Submit will need adjustments depending on where you deploy your bot. For example if you deploy it to Microsoft Teams, you'll need to add extra information in the Data payload. You can refer to this documentation for more information: Adaptive Cards actions in Microsoft Teams.

I designed a sample card that looks like this:

HenryJammes_0-1671201916201.png

 

The corresponding card JSON payload is:

 

 

 

 

{
    "type": "AdaptiveCard",
    "body": [
        {
            "type": "TextBlock",
            "size": "Medium",
            "weight": "Bolder",
            "text": "️ Our Locations in X"
        },
        {
            "type": "FactSet",
            "facts": [
                {
                    "title": "Option A",
                    "value": "Address 1"
                },
                {
                    "title": "Option B",
                    "value": "Address 2"
                }
            ]
        },
        {
            "type": "Container",
            "items": [
                {
                    "type": "TextBlock",
                    "text": " Open for more details",
                    "wrap": true,
                    "size": "Default",
                    "weight": "Bolder",
                    "color": "Accent",
                    "isSubtle": false
                },
                {
                    "type": "ActionSet",
                    "actions": [
                        {
                            "type": "Action.OpenUrl",
                            "title": " Option A",
                            "url": "https://www.bing.com/search?q=Option A"
                        },
                        {
                            "type": "Action.OpenUrl",
                            "title": " Option B",
                            "url": "https://www.bing.com/search?q=Option B"
                        }
                    ],
                    "spacing": "None",
                    "separator": true
                },
                {
                    "type": "TextBlock",
                    "text": " Select store",
                    "wrap": true,
                    "size": "Default",
                    "weight": "Bolder",
                    "color": "Accent",
                    "isSubtle": false,
                    "horizontalAlignment": "Left",
                    "spacing": "Large"
                }
            ],
            "spacing": "Large"
        },
        {
            "type": "ActionSet",
            "actions": [
                {
                    "type": "Action.Submit",
                    "title": " Option A",
                    "id": "A",
                    "data": "Option A"
                },
                {
                    "type": "Action.Submit",
                    "title": " Option B",
                    "id": "B",
                    "data": "Option B"
                }
            ]
        }
    ],
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.3"
}

 

 

 

 

To make the adaptive card dynamic, I will use Power Automate to provide the various JSON arrays my card needs in the expected format. Because I have 3 datasets that are slighthly different, I will create 3 array variables in my cloud flow: "List Of Accounts" for the FactSet, "List Of Accounts Actions" for the first ActionSet, and "List Of Accounts Actions Submit" for the second Action Set.

 

From my topic in Power Virtual Agents:

  • I add a "Call an action" node
  • I select "Create a flow"

HenryJammes_2-1671133764441.png

 

In Power Automate:

  • I add "User City" as a text input for my flow.
  • I add 3 "Initialize variable" actions
    • integer variable "Number Of Accounts"  (I'll use it to count the number of results)
    • 3 array variables: "List Of Accounts", "List Of Accounts Actions", and "List Of Accounts Actions Submit"

HenryJammes_0-1671209492810.png

 

  • I use the "List Rows" from the Dataverse connector to retrieve a list of Accounts with a few OData expressions to optimize my query:
    • A select expressionto only retrive the Account Name, Address 1: Street 1 and Account ID (name,address1_line1,accountid)
    • A filter expression, to only retrieve active accounts that are located in the city the user provided (address1_city eq '@{triggerBody()['text']}' and statecode eq 0)
    • An order expression, so that results are sorted alphabetically (name asc)

HenryJammes_2-1671209820337.png

 

Now I need to use the data returned from my query to build the various variables I want to pass back to Power Virtual Agents and to my adaptive cards in Bot Framework Composer:

  • I add an "Apply to each" action, and select the "value" output from my "List Rows" action. That way, for each returned record, the actions I add within the "Apply to each" box will be applied.
  • First, an "Increment variable" action for the "Number Of Accounts" variable, with a value set to 1.

HenryJammes_4-1671210288211.png

  • Then 3 "Append to array variables" for my various arrays I initialized.
  • What is crucial here is to respect the JSON format that the adaptive card expects for the FactSet and the 2 ActionSet.

HenryJammes_5-1671210448377.png

 

  • Finally, in the "Return value(s) to Power Virual Agents" step, I add 4 outputs:
    • "Number Of Accounts"
    • "List Of Accounts",
    • "List Of Accounts Actions",
    • "List Of Accounts Actions Submit"
  • For array variables, I need to transform them to text format (as they were initialized as arrays). To that end, for each of them, I go the "Expression" tab, select "string" and go back to the "Dynamic Content" tab to select the variable name, and click OK.
  • I then save my cloud flow.

HenryJammes_0-1671210787266.png

 

Back in Power Virtual Agents:

  • I can see my Power Automate flows has the new 4 outputs created as variables.
  • I make the "ListOfAccounts", "ListOfAccountsActions" and "ListOfAccountsActionsSubmit" Bot-scoped variables.
  • I use the "NumberOfAccounts" variable in a Condition node so that I can have different user experienced if the city returns 0 results.
  • I save my topic

HenryJammes_2-1671210977884.png

 

I'm now going to move over to the Bot Framework Composer.

  • From the list of topics, I click on "Open in Bot Framework Composer".

HenryJammes_6-1671135297639.png

In Bot Framework Composer:

  • If I haven't done so already, I install it, authenticate and create a local folder for my changes
  • I add a new dialog for my bot that I name "ListOfAccountsAdaptiveCard

HenryJammes_3-1671211078975.png

 

  • In order for my dialog to return values to Power Virtual Agents, I add an Output: UserSelectedAccount and it's a string.

HenryJammes_4-1671211140419.png

 

  • Under "BeginDialog", I add a new "Ask a question" node of type "Text".
  • In the "Prompt for text" I click in the + icon and choose "Attachments", then "New attachment", "Create from template" and choose "Adaptive card"

HenryJammes_5-1671211275231.png

  • I expand the Attachment pane and paste my adaptive card JSON card payload, in between "- ```" and "```".
  • For each place where I want my content to be dynamic, I reference the Power Virtual Agents variables using that format: ${virtualagent.VariableName}.

HenryJammes_6-1671211522241.png

Example:

 

 

- ```{
    "type": "AdaptiveCard",
    "body": [
        {
            "type": "TextBlock",
            "size": "Medium",
            "weight": "Bolder",
            "text": "️ Our Locations in ${virtualagent.UserCity}"
        },
        {
            "type": "FactSet",
            "facts": ${virtualagent.ListOfAccounts}
        },
        {
            "type": "Container",
            "items": [
                {
                    "type": "TextBlock",
                    "text": " Open for more details",
                    "wrap": true,
                    "size": "Default",
                    "weight": "Bolder",
                    "color": "Accent",
                    "isSubtle": false
                },
                {
                    "type": "ActionSet",
                    "actions": ${virtualagent.ListOfAccountsActions},
                    "spacing": "None",
                    "separator": true
                },
                {
                    "type": "TextBlock",
                    "text": " Select store",
                    "wrap": true,
                    "size": "Default",
                    "weight": "Bolder",
                    "color": "Accent",
                    "isSubtle": false,
                    "horizontalAlignment": "Left",
                    "spacing": "Large"
                }
            ],
            "spacing": "Large"
        },
        {
            "type": "ActionSet",
            "actions": ${virtualagent.ListOfAccountsActionsSubmit}
        }
    ],
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.3"
}```

 

 

  • In "User input (Choice)", I set the "Properpty" to "dialog.result.UserSelectedAccount". That way, I am able to use the selected option in Power Virtual Agents, in a new variable.

HenryJammes_7-1671211607527.png

  • Once done, I go to the "Publish" tab, select my bot, and click "Publish selected bots"

HenryJammes_12-1671136795330.png

 

I return to my Power Virtual Agents "Store Locations" topic, and under "All other conditions", I add:

  • A message saying "OK, I have found {x] NumberOfAccounts location(s) in {x}bot.UserCity." using variables.
  • A "Redirect to another topic" node to select the "ListOfAccountsAdaptiveCard" Bot Framework dialog.
  • A message saying "You selected {x} UserSelectedAccount. Great choice!" using the new variable.

HenryJammes_8-1671211709731.png

 

And that's it.

The adaptive card with dynamic content is presented to the user:

 

HenryJammes_10-1671211857125.png

View solution in original post

8 REPLIES 8
bikashb
Frequent Visitor

I am trying the same and the only way I can think of is (if the list of items is dynamic), call Power Automate and have Power Automate generate a adaptive card with buttons. Although adaptive cards support templating / data mapping, I am not able to find a way to map buttons to a list, so right now I am composing the card json and sending that into a "Post adaptive card to MS Teams and wait for response" action. That's for teams though, but if you want generic multiple choice, then have you seen this? https://learn.microsoft.com/en-us/composer/how-to-ask-for-user-input?tabs=v2x

Thanks!

Anonymous
Not applicable

Good-day
My bot behaves unexpectedly, sustaining the state of the first call of Array and didn't get through. I reviewed quite many times and had no clue. Appreciate any insight given.
Details:
1. created a PVC topic, called Main menu, redirect to a BFC dialog called BFCmainMenu

2. created a BFC dialog, called BFCmainMenu, with:

  • set property of menu option Array
  • question in multiple choice, (Bot response/User input) set accordingly
  • branch switch inspecting the multi-choice option result to branch to corresponding dialogs (says, BFCbranchMenu) which in turn have similar setting as above hence another menu

3. The branching dialog BFCbranchMenu mentioned at last bullet point above eventually redirect to a PVC topic

4. The abovementioned PVC topic eventually redirect to BFCmainMenu

However, chatbot does not display the main-Menu anymore, instead it displays the branch-Menu.

HenryJammes
Copilot Studio
Copilot Studio

PVA + Bot Framework Composer to display a dynamic adaptive card

For this example, I will use the current version of Power Virtual Agents that's extensible with the Bot Framework Composer. I will provide an example on how to present a chatbot user with an adaptive card that contains dynamic content that is retrieved from an external data source. I use Dataverse in this example, but the approach should be similar for any other data source, as I retrieve data with a Power Automate cloud flow and pass the data back to Power Virtual Agents.

 

In my scenario, I start in Power Virtual Agents:

  • I create a new topic called "Store Locations" and give it a few trigger phrases.
  • I add a Question node to ask the user "What is your city"?
  • I use the default "City" entity to automatically extract the city from a user utterance.
  • I save the response as the "UserCity" variable and update the variable to make it global, so I change its scope to "Bot (any topic can access)". This is important for the rest of my demonstration because I will also pass that value to a Bot Framework Composer dialog.
  • I save my topic.

HenryJammes_1-1671133550534.png

 

Before going to Power Automate (to retrieve my data) or in Bot Framework Composer (to enrich my dialog with an adaptive card), the first thing I need to do is create and design an adaptive card.

  • There are many samples available here: https://adaptivecards.io/samples/ 
  • You can then further customize samples in the adaptive card designerhttps://adaptivecards.io/designer/.
  • In my example, I create a card with a FactSet (to display he location names and address in a small table), and then add 2 ActionSet, the first one with Action.OpenUrl actions, to open a location's page in a new window, and the second one with a Action.Submit action, to submit an option as an answer from the user.
    Note: Action.Submit will need adjustments depending on where you deploy your bot. For example if you deploy it to Microsoft Teams, you'll need to add extra information in the Data payload. You can refer to this documentation for more information: Adaptive Cards actions in Microsoft Teams.

I designed a sample card that looks like this:

HenryJammes_0-1671201916201.png

 

The corresponding card JSON payload is:

 

 

 

 

{
    "type": "AdaptiveCard",
    "body": [
        {
            "type": "TextBlock",
            "size": "Medium",
            "weight": "Bolder",
            "text": "️ Our Locations in X"
        },
        {
            "type": "FactSet",
            "facts": [
                {
                    "title": "Option A",
                    "value": "Address 1"
                },
                {
                    "title": "Option B",
                    "value": "Address 2"
                }
            ]
        },
        {
            "type": "Container",
            "items": [
                {
                    "type": "TextBlock",
                    "text": " Open for more details",
                    "wrap": true,
                    "size": "Default",
                    "weight": "Bolder",
                    "color": "Accent",
                    "isSubtle": false
                },
                {
                    "type": "ActionSet",
                    "actions": [
                        {
                            "type": "Action.OpenUrl",
                            "title": " Option A",
                            "url": "https://www.bing.com/search?q=Option A"
                        },
                        {
                            "type": "Action.OpenUrl",
                            "title": " Option B",
                            "url": "https://www.bing.com/search?q=Option B"
                        }
                    ],
                    "spacing": "None",
                    "separator": true
                },
                {
                    "type": "TextBlock",
                    "text": " Select store",
                    "wrap": true,
                    "size": "Default",
                    "weight": "Bolder",
                    "color": "Accent",
                    "isSubtle": false,
                    "horizontalAlignment": "Left",
                    "spacing": "Large"
                }
            ],
            "spacing": "Large"
        },
        {
            "type": "ActionSet",
            "actions": [
                {
                    "type": "Action.Submit",
                    "title": " Option A",
                    "id": "A",
                    "data": "Option A"
                },
                {
                    "type": "Action.Submit",
                    "title": " Option B",
                    "id": "B",
                    "data": "Option B"
                }
            ]
        }
    ],
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.3"
}

 

 

 

 

To make the adaptive card dynamic, I will use Power Automate to provide the various JSON arrays my card needs in the expected format. Because I have 3 datasets that are slighthly different, I will create 3 array variables in my cloud flow: "List Of Accounts" for the FactSet, "List Of Accounts Actions" for the first ActionSet, and "List Of Accounts Actions Submit" for the second Action Set.

 

From my topic in Power Virtual Agents:

  • I add a "Call an action" node
  • I select "Create a flow"

HenryJammes_2-1671133764441.png

 

In Power Automate:

  • I add "User City" as a text input for my flow.
  • I add 3 "Initialize variable" actions
    • integer variable "Number Of Accounts"  (I'll use it to count the number of results)
    • 3 array variables: "List Of Accounts", "List Of Accounts Actions", and "List Of Accounts Actions Submit"

HenryJammes_0-1671209492810.png

 

  • I use the "List Rows" from the Dataverse connector to retrieve a list of Accounts with a few OData expressions to optimize my query:
    • A select expressionto only retrive the Account Name, Address 1: Street 1 and Account ID (name,address1_line1,accountid)
    • A filter expression, to only retrieve active accounts that are located in the city the user provided (address1_city eq '@{triggerBody()['text']}' and statecode eq 0)
    • An order expression, so that results are sorted alphabetically (name asc)

HenryJammes_2-1671209820337.png

 

Now I need to use the data returned from my query to build the various variables I want to pass back to Power Virtual Agents and to my adaptive cards in Bot Framework Composer:

  • I add an "Apply to each" action, and select the "value" output from my "List Rows" action. That way, for each returned record, the actions I add within the "Apply to each" box will be applied.
  • First, an "Increment variable" action for the "Number Of Accounts" variable, with a value set to 1.

HenryJammes_4-1671210288211.png

  • Then 3 "Append to array variables" for my various arrays I initialized.
  • What is crucial here is to respect the JSON format that the adaptive card expects for the FactSet and the 2 ActionSet.

HenryJammes_5-1671210448377.png

 

  • Finally, in the "Return value(s) to Power Virual Agents" step, I add 4 outputs:
    • "Number Of Accounts"
    • "List Of Accounts",
    • "List Of Accounts Actions",
    • "List Of Accounts Actions Submit"
  • For array variables, I need to transform them to text format (as they were initialized as arrays). To that end, for each of them, I go the "Expression" tab, select "string" and go back to the "Dynamic Content" tab to select the variable name, and click OK.
  • I then save my cloud flow.

HenryJammes_0-1671210787266.png

 

Back in Power Virtual Agents:

  • I can see my Power Automate flows has the new 4 outputs created as variables.
  • I make the "ListOfAccounts", "ListOfAccountsActions" and "ListOfAccountsActionsSubmit" Bot-scoped variables.
  • I use the "NumberOfAccounts" variable in a Condition node so that I can have different user experienced if the city returns 0 results.
  • I save my topic

HenryJammes_2-1671210977884.png

 

I'm now going to move over to the Bot Framework Composer.

  • From the list of topics, I click on "Open in Bot Framework Composer".

HenryJammes_6-1671135297639.png

In Bot Framework Composer:

  • If I haven't done so already, I install it, authenticate and create a local folder for my changes
  • I add a new dialog for my bot that I name "ListOfAccountsAdaptiveCard

HenryJammes_3-1671211078975.png

 

  • In order for my dialog to return values to Power Virtual Agents, I add an Output: UserSelectedAccount and it's a string.

HenryJammes_4-1671211140419.png

 

  • Under "BeginDialog", I add a new "Ask a question" node of type "Text".
  • In the "Prompt for text" I click in the + icon and choose "Attachments", then "New attachment", "Create from template" and choose "Adaptive card"

HenryJammes_5-1671211275231.png

  • I expand the Attachment pane and paste my adaptive card JSON card payload, in between "- ```" and "```".
  • For each place where I want my content to be dynamic, I reference the Power Virtual Agents variables using that format: ${virtualagent.VariableName}.

HenryJammes_6-1671211522241.png

Example:

 

 

- ```{
    "type": "AdaptiveCard",
    "body": [
        {
            "type": "TextBlock",
            "size": "Medium",
            "weight": "Bolder",
            "text": "️ Our Locations in ${virtualagent.UserCity}"
        },
        {
            "type": "FactSet",
            "facts": ${virtualagent.ListOfAccounts}
        },
        {
            "type": "Container",
            "items": [
                {
                    "type": "TextBlock",
                    "text": " Open for more details",
                    "wrap": true,
                    "size": "Default",
                    "weight": "Bolder",
                    "color": "Accent",
                    "isSubtle": false
                },
                {
                    "type": "ActionSet",
                    "actions": ${virtualagent.ListOfAccountsActions},
                    "spacing": "None",
                    "separator": true
                },
                {
                    "type": "TextBlock",
                    "text": " Select store",
                    "wrap": true,
                    "size": "Default",
                    "weight": "Bolder",
                    "color": "Accent",
                    "isSubtle": false,
                    "horizontalAlignment": "Left",
                    "spacing": "Large"
                }
            ],
            "spacing": "Large"
        },
        {
            "type": "ActionSet",
            "actions": ${virtualagent.ListOfAccountsActionsSubmit}
        }
    ],
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.3"
}```

 

 

  • In "User input (Choice)", I set the "Properpty" to "dialog.result.UserSelectedAccount". That way, I am able to use the selected option in Power Virtual Agents, in a new variable.

HenryJammes_7-1671211607527.png

  • Once done, I go to the "Publish" tab, select my bot, and click "Publish selected bots"

HenryJammes_12-1671136795330.png

 

I return to my Power Virtual Agents "Store Locations" topic, and under "All other conditions", I add:

  • A message saying "OK, I have found {x] NumberOfAccounts location(s) in {x}bot.UserCity." using variables.
  • A "Redirect to another topic" node to select the "ListOfAccountsAdaptiveCard" Bot Framework dialog.
  • A message saying "You selected {x} UserSelectedAccount. Great choice!" using the new variable.

HenryJammes_8-1671211709731.png

 

And that's it.

The adaptive card with dynamic content is presented to the user:

 

HenryJammes_10-1671211857125.png

HenryJammes
Copilot Studio
Copilot Studio

PVA unified authoring canvas to display a dynamic adaptive card

In this second answer, I use the unified authoring canvas to provide an example on how to present a chatbot user with an adaptive card that contains dynamic content that is retrieved from an external data source. I use Dataverse in this example, but the approach should be similar for any other data source, as I retrieve data with a Power Automate cloud flow and pass the data back to Power Virtual Agents.

 

In Power Virtual Agents, using the unified authoring canvas:

  • I create a new topic called "Store Locations", give it a few trigger phrases, and add a Question node to ask the user "What is your city"?
    I use Power Virtual Agents' default "City" entity to automatically extract the city from a user utterance.
  • I save the response as the "UserCity" variable.
  • I save my topic.

HenryJammes_15-1671139957781.png

 

Before going to Power Automate (to retrieve my data) the first thing I need to do is create and design an adaptive card.

  • There are many samples available here: https://adaptivecards.io/samples/ 
  • You can then further customize samples in the adaptive card designerhttps://adaptivecards.io/designer/.
  • In my example, I create a card with a FactSet (to display the location names and address in a small table), and then add 2 ActionSet, the first one with Action.OpenUrl actions, to open a location's page in a new window, and the second one with a Action.Submit action, to submit an option as an answer from the user.

    Note: Action.Submit will need adjustments depending on where you deploy your bot. For example if you deploy it to Microsoft Teams, you'll need to add extra information in the Data payload. You can refer to this documentation for more information: Adaptive Cards actions in Microsoft Teams.

I designed a sample card that looks like this:

HenryJammes_0-1671201916201.png

 

The corresponding card JSON payload is:

 

 

{
    "type": "AdaptiveCard",
    "body": [
        {
            "type": "TextBlock",
            "size": "Medium",
            "weight": "Bolder",
            "text": "️ Our Locations in X"
        },
        {
            "type": "FactSet",
            "facts": [
                {
                    "title": "Option A",
                    "value": "Address 1"
                },
                {
                    "title": "Option B",
                    "value": "Address 2"
                }
            ]
        },
        {
            "type": "Container",
            "items": [
                {
                    "type": "TextBlock",
                    "text": " Open for more details",
                    "wrap": true,
                    "size": "Default",
                    "weight": "Bolder",
                    "color": "Accent",
                    "isSubtle": false
                },
                {
                    "type": "ActionSet",
                    "actions": [
                        {
                            "type": "Action.OpenUrl",
                            "title": " Option A",
                            "url": "https://www.bing.com/search?q=Option A"
                        },
                        {
                            "type": "Action.OpenUrl",
                            "title": " Option B",
                            "url": "https://www.bing.com/search?q=Option B"
                        }
                    ],
                    "spacing": "None",
                    "separator": true
                },
                {
                    "type": "TextBlock",
                    "text": " Select store",
                    "wrap": true,
                    "size": "Default",
                    "weight": "Bolder",
                    "color": "Accent",
                    "isSubtle": false,
                    "horizontalAlignment": "Left",
                    "spacing": "Large"
                }
            ],
            "spacing": "Large"
        },
        {
            "type": "ActionSet",
            "actions": [
                {
                    "type": "Action.Submit",
                    "title": " Option A",
                    "id": "A",
                    "data": "Option A"
                },
                {
                    "type": "Action.Submit",
                    "title": " Option B",
                    "id": "B",
                    "data": "Option B"
                }
            ]
        }
    ],
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.3"
}

 

 

To make the adaptive card dynamic, I use Power Automate to provide the various JSON arrays my card needs in the expected format. Because I have 3 datasets that are slighthly different, I create 3 array variables in my cloud flow: "List Of Accounts" for the FactSet, "List Of Accounts Actions" for the first ActionSet, and "List Of Accounts Actions Submit" for the second Action Set.

 

From my topic in Power Virtual Agents:

  • I add a "Call an action" node
  • I select "Create a flow"

HenryJammes_16-1671140163982.png

 

In Power Automate:

  • I add "User City" as a text input for my flow.
  • I add 3 "Initialize variable" actions
    • integer variable "Number Of Accounts"  (I'll use it to count the number of results)
    • 3 array variables: "List Of Accounts", "List Of Accounts Actions", and "List Of Accounts Actions Submit"

HenryJammes_0-1671209492810.png

 

  • I use the "List Rows" from the Dataverse connector to retrieve a list of Accounts with a few OData expressions to optimize my query:
    • A select expressionto only retrive the Account Name, Address 1: Street 1 and Account ID (name,address1_line1,accountid)
    • A filter expression, to only retrieve active accounts that are located in the city the user provided (address1_city eq '@{triggerBody()['text']}' and statecode eq 0)
    • An order expression, so that results are sorted alphabetically (name asc)

HenryJammes_2-1671209820337.png

 

Now I need to use the data returned from my query to build the various variables I want to pass back to Power Virtual Agents and to my adaptive cards in Bot Framework Composer:

  • I add an "Apply to each" action, and select the "value" output from my "List Rows" action. That way, for each returned record, the actions I add within the "Apply to each" box will be applied.
  • First, an "Increment variable" action for the "Number Of Accounts" variable, with a value set to 1.

HenryJammes_4-1671210288211.png

  • Then 3 "Append to array variables" for my various arrays I initialized.
  • What is crucial here is to respect the JSON format that the adaptive card expects for the FactSet and the 2 ActionSet.

HenryJammes_5-1671210448377.png

 

  • Finally, in the "Return value(s) to Power Virual Agents" step, I add 4 outputs:
    • "Number Of Accounts"
    • "List Of Accounts",
    • "List Of Accounts Actions",
    • "List Of Accounts Actions Submit"
  • For array variables, I need to transform them to text format (as they were initialized as arrays). To that end, for each of them, I go the "Expression" tab, select "string" and go back to the "Dynamic Content" tab to select the variable name, and click OK.
  • I then save my cloud flow.

HenryJammes_0-1671210787266.png

 

Back in Power Virtual Agents:

  • I can see my Power Automate flows has the new 4 outputs.
  • I map these with new corresponding variables.
  • I use the "NumberOfAccounts" variable in a Condition node so that I can have different user experienced if the city returns 0 results.

HenryJammes_0-1671469146625.png

 

Under "All other conditions", I add:

  • A "Send a message" node with a text saying "OK, I have found {x] NumberOfAccounts location(s) in {x}bot.UserCity." using variables.
  • An "Ask a question" node, where I add "Adaptive card".
  • I save the response as the UserSelectedAccount variable.

HenryJammes_4-1671470015154.png

 

  • Under JSON, I paste the content of my adaptive card JSON payload.
  • I expand the card content,
  • I then convert the JSON to a Power Fx Formula record,
  • For each of the dynamic arrays in my adaptive card, I reference the retrieved Power Automate JSON data using Topic.VariableName within as a Power Fx record, using the ForAll, Table, and ParseJSON formulas.
{
  type: "AdaptiveCard",
  body: [
    {
      type: "TextBlock",
      size: "Medium",
      weight: "Bolder",
      text: "🗺️ Our Locations in " & Topic.UserCity
    },
    {
      type: "FactSet",
      facts: ForAll(
                Table(ParseJSON(Topic.ListOfAccounts)),
            {
                    title: Text(ThisRecord.Value.title),
                    value: Text(ThisRecord.Value.value)
            }
            )
    },
    {
      type: "Container",
      items: [
        {
          type: "TextBlock",
          text: "🔎 Open for more details",
          wrap: true,
          size: "Default",
          weight: "Bolder",
          color: "Accent",
          isSubtle: false
        },
        {
          type: "ActionSet",
          actions: ForAll(
        Table(ParseJSON(Topic.ListOfAccountsActions)),
    {
            type: Text(ThisRecord.Value.type),
            title: Text(ThisRecord.Value.title),
            url: Text(ThisRecord.Value.url)
    }
    ),
          spacing: "None",
          separator: true
        },
        {
          type: "TextBlock",
          text: "👆 Select store",
          wrap: true,
          size: "Default",
          weight: "Bolder",
          color: "Accent",
          isSubtle: false,
          horizontalAlignment: "Left",
          spacing: "Large"
        }
      ],
      spacing: "Large"
    },
    {
      type: "ActionSet",
      actions: ForAll(
        Table(ParseJSON(Topic.ListOfAccountsActionsSubmit)),
    {
            type: Text(ThisRecord.Value.type),
            title: Text(ThisRecord.Value.title),
            id: Text(ThisRecord.Value.id),
            data: Text(ThisRecord.Value.data)
    }
    )
    }
  ],
  '$schema': "http://adaptivecards.io/schemas/adaptive-card.json",
  version: "1.3"
}

HenryJammes_3-1671469883752.png

I then can:

  • Add a message saying "You selected {x} UserSelectedAccount. Great choice!" using the new variable.
  • Save my topic.

HenryJammes_5-1671470173563.png

 

And that's it.

The adaptive card with dynamic content is presented to the user:

HenryJammes_6-1671470284953.png

Anonymous
Not applicable

Excellent illustration. Despite my nil knowledge on PA, I strived to follow your guide, attempting to induce a "better solution" to my own situation. I finally got it working with numerous trial-and-error in those PA flows/external data source etc. 

I had a breakthrough in my learning!
Thank you so much HenryJammes!

Great to hear @Anonymous – we plan to create a few MS Learn articles out of these and hopefully they will be easier to follow. Feel free to reach out by private message to share the steps that require more guidance 🙂

@HenryJammes This has been really helpful! Is there a way of passing a record after clicking an action button? 

 

For example I have an adaptive card with: 

{
        type: "ActionSet",
        actions: ForAll(
          Table(ParseJSON(Topic.cdtrOutputs)),
              {
                type: "Action.Submit",
                title: Text(ThisRecord.Value.OutputCode) & " - " & Text(ThisRecord.Value.Title),
                data: {cdtrItem: Text(ThisRecord.Value)}
              }
      )
}

 

And in my schema:

kind: Record
properties:
  actionSubmitId: String
  cdtrItem:
    type:
      kind: Record

 

But this returns Null for cdtrItem.

 

The dataset is:

 

[
  {
    "OutputId": 5700,
    "OutputCode": "2023-WCR-0027",
    "Title": "Weekly Report"
  },
  {
    "OutputId": 5698,
    "OutputCode": "2023-DCR-0130",
    "Title": "Daily Report"
  }
]
Sharmilshah
Helper I
Helper I

Does this solution work only with PVA premium version?

Helpful resources

Announcements

Celebrating a New Season of Super Users with Charles Lamanna, CVP Microsoft Business Applications

February 8 was the kickoff to the 2024 Season One Super User program for Power Platform Communities, and we are thrilled to welcome back so many returning Super Users--as well as so many brand new Super Users who started their journey last fall. Our Community Super Users are the true heroes, answering questions, providing solutions, filtering spam, and so much more. The impact they make on the Communities each day is significant, and we wanted to do something special to welcome them at our first kickoff meeting of the year.   Charles Lamanna, Microsoft CVP of Business Applications, has stressed frequently how valuable our Community is to the growth and potential of Power Platform, and we are honored to share this message from him to our 2024 Season One Super Users--as well as anyone who might be interested in joining this elite group of Community members.     If you want to know more about Super Users, check out these posts for more information today:    Power Apps: What is A Super User? - Power Platform CommunityPower Automate: What is A Super User? - Power Platform Community Copilot Studio: What is A Super User? - Power Platform Community Power Pages: What is A Super User? - Power Platform Community

February 2024 User Group Update: Welcoming New Groups and Highlighting Upcoming Events

It's a new month and a brand-new year, which means another opportunity to celebrate our amazing User Groups!Each month, we highlight the new User Groups that have joined the community. It's been a busy season for new groups, because we are thrilled to welcome 15 New User Groups! Take a look at the list below, shared by the different community categories. If your group is listed here, give this post a kudo so we can celebrate with you!   We love our User Groups and the difference they make in the lives of our Community! Thank you to all the new User Groups, new User Group leaders--we look forward to hearing about your successes and the impact you will leave!   In addition to our monthly User Group spotlight, it's a great time to share some of the latest events happening in our User Group community! Take a look at the list below to find one that fits your schedule and need! There's a great combination of in-person and virtual events to choose from. Also, don't forget to review the many events happening near you or virtually! It's a great time of year to connect and engage with User Groups both locally and online. Please Welcome Our NEW User Groups   Power Platform: Heathcare Power Platform User Group Power Platform Connect Hub Power Platform Usergroup Denmark Mexico Norte- Power Platform User Group Pune Power User Group Sudbury Power Platform User GroupMicrosoft User Group GhanaMPPBLR - Microsoft Power Platform Bengaluru User Group Power Apps:   Myrtle Beach Power Platform User GroupAnanseTechWB PowerApps Copilot Studio: Pathfinders Power Platform Community Dynamics365: Cairo, Egypt MSD 365 Business Central/NAV/F&O User GruopMS Dynamics 365 Business Central LatamCincinnati OH D365 F&O User Group February User Group Events February 2024 Cleveland Power Platform User GroupPortallunsj - Februar 2024Indiana D365/AX February User Group MeetingQ1 2024 KC Power Platform and Dynamics 365 CRM Users Group 

January 2024 Community Newsletter

Welcome to our January Newsletter, where we highlight the latest news, product releases, upcoming events, and the amazing work of our outstanding Community members. If you're new to the Community, please make sure to follow the latest News & Announcements in each Community and check out the Community on LinkedIn as well! It's the best way to stay up-to-date in 2024 with all the news from across Microsoft Power Platform and beyond.      COMMUNITY HIGHLIGHTS Check out the most active community members of the last month! These hardworking members are posting regularly, answering questions, giving (and receiving!) kudos, and consistently providing top solutions in their communities. We are so thankful for each of you--keep up the great work! If you hope to see your name here next month, make it your New Year's Resolution to be more active in the community in 2024.   Power AppsPower AutomateCopilot StudioPower PagesWarrenBelzWarrenBelzPstork1saudali_25LaurensMPstork1stephenrobertLucas001AARON_ClbendincpaytonSurendran_RANBNived_NambiarMariamPaulachanNikhil2JmanriqueriosANBJupyter123rodger-stmmbr1606Agniusstevesmith27mandelaPhineastrice602AnnaMoyalanOOlashynBCLS776grantjenkinsExpiscornovusJcookSpongYeAARON_CManishSolankiapangelesPstork1ManishSolankiSanju1Fubar   LATEST NEWS Power Platform 2024 Release Wave Highlights This month saw the 2024 Release Wave 1 plans for Microsoft Power Platform and Microsoft Dynamics 365- a compilation of new capabilities planned for release between April and September 2024. Click here to read Corporate Vice President Maureen (Mo) Osborne's detailed breakdown of the upcoming capabilities, and click the image below to check out some of the Power Platform 2024 Release Wave 1 highlights.     "What's New" Power Platform Shorts Series This month we also launched our brand-new 'Power Shorts' series on YouTube - a selection of super sweet snapshots to keep you in the loop with all the latest trends from across the Power Platform and beyond. Click the image below to check out the entire playlist so far, and don't forget to subscribe to our YouTube channel for all the latest updates.   Super User In Training (S.U.I.T) It was great to see the Power Platform Community officially kick off Season One of their Super User in Training (SUIT) program this month! Their first meeting saw an amazing turnout of over 300 enthusiastic participants who started their dynamic journey toward becoming Super Users. Huge thanks to Manas Maheshwari, Eric Archer, Heather Hernandez, and Duane Montague for a fantastic kick-off. The first meeting also saw seasoned Super User, Drew Poggemann, share invaluable insights on navigating the #MicrosoftCommunity with finesse. Many thanks to Drew for setting the stage and emphasizing the importance of active engagement and the art of providing thoughtful community solutions. If you want to learn more about the features and benefits of gaining Super User status, click the image below to find out more, and watch this space for more info about Season Two and how you can SUIT UP in the community!     UPCOMING EVENTS Microsoft 365 Community Day - Miami - February 1-2, 2024 It's not long now until the Microsoft 365 Community Day Miami, which will be taking place at the Wolfson Campus at Miami Dade College on 1-2 Feb. 2024. This free event is all about unlocking the full potential of Power Platform, Microsoft 365, and AI, so whether you’re a tech enthusiast, a business owner, or just curious about the latest Microsoft advancements, #M365Miami is for you.   The event is completely free and there will sessions in both English and Spanish to celebrate the vibrant and diverse make-up of our amazing community. Click the image below to join this amazing Community Day in Miami and become a part of our incredible network of learners and innovators!     Microsoft Fabric - Las Vegas - March 26-28, 2024 Exciting times ahead for the inaugural #MicrosoftFabric Community Conference on March 26-28 at the MGM Grand in Las Vegas. And if you book now, you can save $100 off registration! The Microsoft Fabric Conference will cover all the latest in analytics, AI, databases, and governance across 150+ sessions.   There will be a special Community Lounge onsite, interactive learning labs, plus you'll be able to 'Ask the Experts' all your questions to get help from data, analytics, and AI specialists, including community members and the Fabric Customer Advisory Team. Just add the code MSCUST when registering for a $100 discount today. Click the image below to find out more about the ultimate learning event for Microsoft Fabric!     Microsoft 365 Conference - Orlando - April 30 - May 2, 2024 Have you added The Microsoft 365 Conference to your community calendar yet? It happens this April 30th - May 2nd in Orlando, Florida. The 2024 Microsoft 365 Conference is one of the world’s largest gatherings of Microsoft engineers and community, with a strong focus on Power Platform, SharePoint, Azure, and the transition to an AI-powered modern workplace.   Click the image link below to find out more and be prepared to be enlightened, educated, and inspired at #M365Conf24!   LATEST COMMUNITY BLOG ARTICLES Power Apps Community Blog Power Automate Community Blog Copilot Studio Community Blog Power Pages Community Blog Check out 'Using the Community' for more helpful tips and information: Power Apps, Power Automate, Copilot Studio, Power Pages  

Super Users 2024 Season One is Here!

   We are excited to announce the first season of our 2024 Super Users is here! Our kickoff to the new year welcomes many returning Super Users and several new faces, and it's always exciting to see the impact these incredible individuals will have on the Community in 2024! We are so grateful for the daily difference they make in the Community already and know they will keep staying engaged and excited for all that will happen this year.   How to Spot a Super User in the Community:Have you ever written a post or asked for help in the Community and had it answered by a user with the Super User icon next to their name? It means you have found the actual, real-life superheroes of the Power Platform Community! Super Users are our heroes because of the way they consistently make a difference in the Community. Our amazing Super Users help keep the Community a safe place by flagging spam and letting the Community Managers know about issues. They also make the Community a great place to find answers, because they are often the first to offer solutions and get clarity on questions. Finally, Super Users share valuable insights on ways to keep the Community growing, engaging, and looking ahead!We are honored to reveal the new badges for this season of Super Users! Congratulations to all the new and returning Super Users!     To better answer the question "What is a Super User?" please check out this article: Power Apps: What is A Super User? - Power Platform CommunityPower Automate: What is A Super User? - Power Platform Community Copilot Studio: What is A Super User? - Power Platform Community Power Pages: What is A Super User? - Power Platform Community

Did You Attend the Microsoft Power Platform Conference in 2022 or 2023? Claim Your Badge Today!

If you were one of the thousands of people who joined us at the first #MPPC Microsoft Power Platform Conference in 2022 in Orlando--or attended the second-annual conference in Las Vegas in 2023--we are excited to honor you with a special community badge! Show your support for #MPPC Microsoft Power Platform Conference this year by claiming your badge!           Just follow this link to claim your badge for attending #MPPC in 2022 and/or 2023: MPPCBadgeRequest    Want to earn your badge for 2024? Just keep watching our News & Announcements for the latest updates on #MPPC24.

Microsoft Power Platform | 2024 Release Wave 1 Plan

Check out the latest Microsoft Power Platform release plans for 2024!   We have a whole host of exciting new features to help you be more productive, enhance delegation, run automated testing, build responsive pages, and so much more.    Click the links below to see not only our forthcoming releases, but to also try out some of the new features that have recently been released to market across:     Power Apps  Power Automate  Copilot Studio   We can’t wait to share with you all the upcoming releases that will help take your Power Platform experience to the next level!    Check out the entire Release Wave: Power Platform Complete Release Planner 

Users online (3,941)