MsgExt Search Command docs incomplete/contradict Teams Dev Portal & app manifest schema

[andrewconnell]

Statements in this page are either incorrect, incomplete, or contradict (or are contradicted by) other resources like the Teams app manifest schema and/or the Teams Developer Portal. These are either documentation bugs, omissions, missing clarifications that would help developers, or bugs/errors in the Teams Dev Portal / app manifest schema.

All observations & testing were done with the current Teams web client, Teams Dev Portal, app manifest v1.16 (latest), and Teams Toolkit for VSC (v5.2)

Listing these as bullet points with my observations from testing...

• [ ] doc doesn't mention if you can/can't use a task module for the search experience, yet the fetchTask attribute is present within the app manifest IntelliSense & this, passes validation when using the schema
  • observation/conclusion: you can't use fetchTask=true for search commands, you can only use static params
• [ ] doc doesn't mention you're limited to a single parameter for a search command, yet the Teams Developer Portal & app manifest schema both allow you to add multiple parameters with no message/warning it doesn't matter
  • observation/conclusion: you're limited to a single parameter, others are ignored
• [ ] doc doesn't include choiceset in the list of supported types for a parameter, yet it's an option in the app manifest and you can create it in the Teams Dev Portal

---

Document Details

⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

• ID: 06016378-5b30-cc4e-e53a-a9c46a2a3a13
• Version Independent ID: d013f99a-0ee5-67d3-ee79-67bc1a0b4557
• Content: Define message extension search commands - Teams
• Content Source: msteams-platform/messaging-extensions/how-to/search-commands/define-search-command.md
• Service: msteams
• GitHub Login: @surbhigupta
• Microsoft Alias: anclear

[microsoft-github-policy-service[bot]]

Hi andrewconnell! Thank you for bringing this issue to our attention. We will investigate and if we require further information we will reach out in one business day. Please use this link to escalate if you don't get replies.

Best regards, Teams Platform

[Prasad-MSFT]

@andrewconnell - Thanks for your valuable input. We will verify these from our end and will act accordingly.