Post an adaptive card

<< Click to Display Table of Contents >>

Navigation:  NITRO™ Workflows > Configuring Workflows > Workflow Actions > Microsoft Teams >

Post an adaptive card

This action requires Crow Canyon's NITRO Bot to be configured. If you haven't already, please contact sales@crowcanyon.com to subscribe to Crow Canyon's bot service.

 

You'll also need to configure the Self-service Bot once you have a subscription: https://www.crowcanyon.help/article/398/

 

More than just a notification, the adaptive card allows for user input directly from the Teams interface. For example, if you have an approval process, and need input from the approver, you can send an adaptive card to the designated approver and take their decision through Teams. No email, no signing into SharePoint.

 

If you have not already, you'll need to follow the steps in this article to enable the Teams API for NITRO in order to use this action.

 

Post an adaptive card action in designer workflow:

 

 Post an adaptive card in designer 1

 Post an adaptive card in designer 2

Post an adaptive card action in legacy workflow:

 

 Post an adaptive card in legacy 1

 Post an adaptive card in legacy 2

 

 

General Settings                              

         Action Name: enter a name for this action

         Action Description: Describe the action (for future reference)

         Delay Execution: Set a time in milliseconds to delay the execution of this action

Post card to: Select where you want to post the card in below column

         Select Bot: it provide 3 options in dropdown

                 Both: select this option if you want to post the card in NITRO Engage and Self-Service bot.

                 NITRO Engage: select this option if you want to post the card in NITRO Engage.

                 Self-Service Bot: select this option if you want to post the card in Self-Service Bot.

Card Recipient

         Bot conversation: to send the card to same conversation from which this workflow command is invoked. This can be bot itself or bot added to some teams channel (@ followed by bot name). This option is not valid for event or timer based workflows.

         To: To whom to send the adaptive card. This can be an individual, multiple users, or a SharePoint group.

Card Layout

The options here are to either send the Default card or a Custom Card. The Custom Card requires JSON. More info about Teams adaptive cards can be found here: https://docs.microsoft.com/en-us/microsoftteams/platform/task-modules-and-cards/cards/cards-reference#adaptive-card

Shown below is the Default Card Layout; each placeholder in this screen can use placeholders from the referenced SharePoint item by clicking on the binocular icon to the right of the field.

 Default card

 

The default card has the following options:

         Card Title: This will appear at the top of the card

         Card image: This provide two option in dropdown.

       User

       Other

 User: This will be a generic image and is not specific to any user. It looks like this:        

clip0841

 Select User                        

         Other: If you want to add a different picture than the above, specify a URL for an image to show on the card

         Select Other Image

'Image size' and 'Image alignment' column will be available when 'Card Image' column value is selected.

                 Image size: Relative size of the image with options of Large, Medium and Small

Image alignment: Shows the image to the left or the right of the text on the card                        

         Heading: Appears between Card Title and Sub Heading

         Sub Heading: Appears between the Heading and the Sub Text

         Sub Text: Appears between the Sub Heading and Description

         Description: Appears between the Sub Text and any columns you want to show on the card

       Columns: Column values from the SharePoint item that you want to show on the card. These appear between the Description and  the Item Link Text and to the right of the corresponding column label from the SharePoint list
       Item Link Text: The hyperlink text shown on the card. It is clickable so that the user can navigate to the URL provided in this setting. Appears between the columns and any actions added to the card.

Card Actions

The user can take the following actions from the adaptive card. These will appear as buttons on the card. NOTE: The user will need to click twice to run an action. First on the Action Button itself. Second on the "Submit Button" to confirm they want to take the desired action.

1. Create List Item

 Create List Item Action In post Card

         This will take input from the user to create a new list item.

         Action Name: Appears on the action button below the Item Link Text

         Description: When clicked, the description will appear in a dialog below the Action button

         Submit Button Text: This text will appear on the confirmation button (e.g. "Are you sure?")

         Success Message: Appears as a message in Teams when the action is successfully executed.

                 Update Card: Success Message will appear in place of the Adaptive Card.

clip1319

                 Teams Message: Success Message will appear below the Adaptive Card.

clip1320

 

Expire Action: If this option is selected, action will not be executed after specified number of hours

         Web: This is the site where you want to create the new item. Note: only sites within the same Site Collection are available

         List: This is the list within the above site where you want to create the new item

       Columns to Update: Define which columns to update as part of the card action. This can take User Input or set default and calculated values. See image and description below
       Add Column Mapping

Column: Select which column to update

         User Input: Decide whether to have the user input the value or to use a Default Value

         Required: Indicates if this particular field is required; applicable when accepting User Input

       Default Value: Sets the value of the specified column; can use placeholders and functions from the SharePoint list column values when using the binoculars icon. Use this when "User Input" is turned off
for lookup column, 'Cascading lookup settings' option is provided where filtering can be done based on selected view and parent column value. for example, 'Issue Type' in 'Tickets' list can be filtered based on 'Category' column value as shown below:
Cascading lookup settings

 

         Invoke NITRO Workflow: this will show all workflows configured with 'user/bot triggered' in dropdown. workflow will be executed after the items have been updated.                

2. Update List Item

 Update Post card

 

         This will take input from the user to update the list item.

         Action Name: Appears on the action button below the Item Link Text

         Description: When clicked, the description will appear in a dialog below the Action button

         Submit Button Text: This text will appear on the confirmation button (e.g. "Are you sure?")

         Success Message: Appears as a message in Teams when the action is successfully executed.

         Expire Action: If this option is selected, action will not be executed after specified number of hours

       Columns to Update: Define which columns to update as part of the card action. This can take User Input or set default and calculated values. See image and description below
Add Column Mapping
Column: Select which column to update

         User Input: Decides whether to have the user input the value or to use a Default Value

         Required: Indicates if this particular field is required; applicable when accepting User Input

       Default Value: Sets the value of the specified column; can use placeholders and functions from the SharePoint list column values when using the binoculars icon. Use this when "User Input" is turned off

         Invoke NITRO Workflow: Start a NITRO Workflow after the items have been updated                

         

3. Invoke Workflow

 Invoke workflow

 

         Action Name: This is shown in the action button in the card.

         Description: When clicked, the description will appear in a dialog below the Action button.

         Submit Button Text: This text will appear on the confirmation button (e.g. "Are you sure?").

         Success Message: Appears as a message in Teams when the action is successfully executed.

         Expire Action: If this option is selected, action will not be executed after specified number of hours.

         Invoke Workflow: Select which NITRO workflow to invoke as part of this action.

4.  Launch URL

         Launch URL Card

         Action Name: Provide action name.

         URL: directly specify the URL that you want to launch from post card or provide item column placeholder ( which is having URL) by using binocular icon.

 5. Input Form

         Input form card

         This will take input from the user to update the variable value.

         Action Name: Appears on the action button below the Item Link Text

         Description: When clicked, the description will appear in a dialog below the Action button

         Submit Button Text: This text will appear on the confirmation button (e.g. "Are you sure?")

         Success Message: Appears as a message in Teams when the action is successfully executed.

         Expire Action: If this option is selected, action will not be executed after specified number of hours

       Columns to Update: Define which columns to update as part of the card action. This can take User Input or set default and calculated values in 'Variable'. See image and description below
Column Mapping for Input form

Column: Select column name from dropdown.

Variable name: provide variable name in which you want to map selected column value.

         User Input: Decides whether to have the user input the value or to use a Default Value

         Required: Indicates if this particular field is required; applicable when accepting User Input

         Default Value: Sets the value of the specified column; can use placeholders and functions from the SharePoint list column values when using the binoculars icon. Use this when "User Input" is turned off

         Invoke NITRO Workflow: Start a NITRO Workflow after the items have been updated                

 

Refer this article to approve request from bot:How To Approve Requests From Crow Canyon Self-Service Bot In Microsoft Teams