# Microsoft Teams data source connector field mappings
<a name="teams-field-mappings"></a>

To help you structure data for retrieval and chat filtering, Amazon Q Business crawls data source document attributes or metadata and maps them to fields in your Amazon Q index.

Amazon Q has reserved fields that it uses when querying your application. When possible, Amazon Q automatically maps these built-in fields to attributes in your data source. If a built-in field doesn't have a default mapping, or if you want to map additional index fields, use the custom field mappings to specify how a data source attribute maps to your Amazon Q application. You create field mappings by editing your data source after your application and retriever are created.

To learn more about document attributes and how they work in Amazon Q, see [Document attributes and types in Amazon Q](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/doc-attributes.html).

**Important**  
Filtering using document attributes in chat is only supported through the API.

The Amazon Q Teams connector supports the following entities and the associated reserved and custom attributes.

**Note**  
You can map any Teams field to the document title or document body Amazon Q reserved/default index fields.

**Topics**
+ [Chat messages](#teams-field-mappings-chat-messages)
+ [Chat attachments](#teams-field-mappings-chat-attachments)
+ [Channel posts](#teams-field-mappings-channel-posts)
+ [Channel file attachments](#teams-field-mappings-channel-file-attachments)
+ [Wiki](#teams-field-mappings-wiki)
+ [Meeting chats](#teams-field-mappings-meeting-chats)
+ [Meeting details](#teams-field-mappings-meeting-details)
+ [Meeting notes](#teams-field-mappings-meeting-notes)
+ [Meeting files](#teams-field-mappings-meeting-files)

## Chat messages
<a name="teams-field-mappings-chat-messages"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  subject  |  tms\$1subject  |  Custom  |  String  | 
|  summary  |  tms\$1summary  |  Custom  |  String  | 
|  importance  |  tms\$1importance  |  Custom  |  String  | 
|  messageType  |  tms\$1message\$1type  |  Custom  |  String  | 
|  sender  |  tms\$1sender  |  Custom  |  String  | 
|  sourceUrl  |  \$1source\$1uri  |  Default  |  String  | 
|  attachments  |  tms\$1attachments  |  Custom  |  String list  | 
|  reactions  |  tms\$1reactions  |  Custom  |  String list  | 
|  mentions  |  tms\$1mentions  |  Custom  |  String list  | 
|  deletedAt  |  tms\$1last\$1deleted\$1at  |  Custom  |  Date  | 
|  createdAt  |  \$1created\$1at  |  Default  |  Date  | 
|  lastModifiedAt  |  \$1last\$1updated\$1at  |  Default  |  Date  | 

## Chat attachments
<a name="teams-field-mappings-chat-attachments"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  fileName  |  tms\$1name  |  Custom  |  String  | 
|  size  |  tms\$1file\$1size  |  Custom  |  Long (numeric)  | 
|  title  |  tms\$1title  |  Custom  |  String  | 
|  sourceUrl  |  \$1source\$1uri  |  Default  |  String  | 
|  lastModifiedBy  |  tms\$1last\$1modified\$1by  |  Custom  |  String  | 
|  createdBy  |  tms\$1created\$1by  |  Custom  |  String  | 
|  createdAt  |  \$1created\$1at  |  Default  |  Date  | 
|  lastModifiedAt  |  \$1last\$1updated\$1at  |  Default  |  Date  | 

## Channel posts
<a name="teams-field-mappings-channel-posts"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  subject  |  tms\$1subject  |  Custom  |  String  | 
|  summary  |  tms\$1summary  |  Custom  |  String  | 
|  importance  |  tms\$1importance  |  Custom  |  String  | 
|  messageType  |  tms\$1message\$1type  |  Custom  |  String  | 
|  createdBy  |  tms\$1created\$1by  |  Custom  |  String  | 
|  deletedAt  |  tms\$1last\$1deleted\$1at  |  Custom  |  Date  | 
|  sourceUrl  |  \$1source\$1uri  |  Default  |  String  | 
|  mentions  |  tms\$1mentions  |  Custom  |  String list  | 
|  reactions  |  tms\$1reactions  |  Custom  |  String list  | 
|  attachments  |  tms\$1attachments  |  Custom  |  String list  | 
|  createdAt  |  \$1created\$1at  |  Default  |  Date  | 
|  lastModifiedAt  |  \$1last\$1updated\$1at  |  Default  |  Date  | 

## Channel file attachments
<a name="teams-field-mappings-channel-file-attachments"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  fileName  |  tms\$1name  |  Custom  |  String  | 
|  size  |  tms\$1file\$1size  |  Custom  |  Long (numeric)  | 
|  channelName  |  tms\$1channel\$1name  |  Custom  |  String  | 
|  Title  |  tms\$1title  |  Custom  |  String  | 
|  sourceUrl  |  \$1source\$1uri  |  Default  |  String  | 
|  createdBy  |  tms\$1created\$1by  |  Custom  |  String  | 
|  lastModifiedBy  |  tms\$1last\$1modified\$1by  |  Custom  |  String  | 
|  createdAt  |  \$1created\$1at  |  Default  |  Date  | 
|  lastModifiedAt  |  \$1last\$1updated\$1at  |  Default  |  Date  | 
|  oneNoteDocument  |  tms\$1onenote\$1document  |  Custom  |  String  | 
|  oneNoteSection  |  tms\$1onenote\$1section  |  Custom  |  String  | 
|  oneNotePage  |  tms\$1onenote\$1page  |  Custom  |  String  | 

## Wiki
<a name="teams-field-mappings-wiki"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  channelName  |  tms\$1channel\$1name  |  Custom  |  String  | 
|  fileName  |  tms\$1name  |  Custom  |  String  | 
|  size  |  tms\$1file\$1size  |  Custom  |  Long (numeric)  | 
|  createdBy  |  tms\$1created\$1by  |  Custom  |  String  | 
|  lastModifiedBy  |  tms\$1last\$1modified\$1by  |  Custom  |  String  | 
|  title  |  tms\$1title  |  Custom  |  String  | 
|  sourceUrl  |  \$1source\$1uri  |  Default  |  String  | 
|  createdAt  |  \$1created\$1at  |  Default  |  Date  | 
|  lastModifiedAt  |  \$1last\$1updated\$1at  |  Default  |  Date  | 

## Meeting chats
<a name="teams-field-mappings-meeting-chats"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  subject  |  tms\$1subject  |  Custom  |  String  | 
|  summary  |  tms\$1summary  |  Custom  |  String  | 
|  importance  |  tms\$1importance  |  Custom  |  String  | 
|  messageType  |  tms\$1message\$1type  |  Custom  |  String  | 
|  Sender  |  tms\$1sender  |  Custom  |  String  | 
|  attachments  |  tms\$1attachments  |  Custom  |  String list  | 
|  mentions  |  tms\$1mentions  |  Custom  |  String list  | 
|  reactions  |  tms\$1reactions  |  Custom  |  String list  | 
|  sourceUrl  |  \$1source\$1uri  |  Default  |  String  | 
|  deletedAt  |  tms\$1last\$1deleted\$1at  |  Custom  |  Date  | 
|  createdAt  |  \$1created\$1at  |  Default  |  Date  | 
|  lastModifiedAt  |  \$1last\$1updated\$1at  |  Default  |  Date  | 

## Meeting details
<a name="teams-field-mappings-meeting-details"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  subject  |  tms\$1subject  |  Custom  |  String  | 
|  summary  |  tms\$1summary  |  Custom  |  String  | 
|  importance  |  tms\$1importance  |  Custom  |  String  | 
|  username  |  tms\$1from\$1user  |  Custom  |  String  | 
|  eventStartTime  |  tms\$1event\$1start\$1time  |  Custom  |  Date  | 
|  eventEndTime  |  tms\$1event\$1end\$1time  |  Custom  |  Date  | 
|  sourceURL  |  \$1source\$1uri  |  Default  |  String  | 

## Meeting notes
<a name="teams-field-mappings-meeting-notes"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  fileName  |  tms\$1name  |  Custom  |  String  | 
|  title  |  tms\$1title  |  Custom  |  String  | 
|  createdBy  |  tms\$1created\$1by  |  Custom  |  String  | 
|  lastModifiedBy  |  tms\$1last\$1modified\$1by  |  Custom  |  String  | 
|  sourceUrl  |  \$1source\$1uri  |  Default  |  String  | 
|  createdAt  |  \$1created\$1at  |  Default  |  Date  | 
|  lastModifiedAt  |  \$1last\$1updated\$1at  |  Default  |  Date  | 

## Meeting files
<a name="teams-field-mappings-meeting-files"></a>


| Microsoft Teams field name | Index field name | Description | Data type | 
| --- | --- | --- | --- | 
|  fileName  |  tms\$1name  |  Custom  |  String  | 
|  title  |  tms\$1title  |  Custom  |  String  | 
|  size  |  tms\$1file\$1size  |  Custom  |  Long (numeric)  | 
|  sourceUrl  |  \$1source\$1uri  |  Default  |  String  | 
|  createdBy  |  tms\$1created\$1by  |  Custom  |  String  | 
|  lastModifiedBy  |  tms\$1last\$1modified\$1by  |  Custom  |  String  | 
|  createdAt  |  \$1created\$1at  |  Default  |  Date  | 
|  lastModifiedAt  |  \$1last\$1updated\$1at  |  Default  |  Date  |