Microsoft Teams data
source connector field mappings
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.
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.
You can map any Teams field to the document title or document body
Amazon Q reserved/default index fields.
Supported entities and field mappings
Chat messages
Microsoft Teams field name |
Index field name |
Description |
Data type |
subject |
tms_subject |
Custom |
String |
summary |
tms_summary |
Custom |
String |
importance |
tms_importance |
Custom |
String |
messageType |
tms_message_type |
Custom |
String |
sender |
tms_sender |
Custom |
String |
sourceUrl |
_source_uri |
Default |
String |
attachments |
tms_attachments |
Custom |
String list |
reactions |
tms_reactions |
Custom |
String list |
mentions |
tms_mentions |
Custom |
String list |
deletedAt |
tms_last_deleted_at |
Custom |
Date |
createdAt |
_created_at |
Default |
Date |
lastModifiedAt |
_last_updated_at |
Default |
Date |
Chat attachments
Microsoft Teams field name |
Index field name |
Description |
Data type |
fileName |
tms_name |
Custom |
String |
size |
tms_file_size |
Custom |
Long (numeric) |
title |
tms_title |
Custom |
String |
sourceUrl |
_source_uri |
Default |
String |
lastModifiedBy |
tms_last_modified_by |
Custom |
String |
createdBy |
tms_created_by |
Custom |
String |
createdAt |
_created_at |
Default |
Date |
lastModifiedAt |
_last_updated_at |
Default |
Date |
Channel posts
Microsoft Teams field name |
Index field name |
Description |
Data type |
subject |
tms_subject |
Custom |
String |
summary |
tms_summary |
Custom |
String |
importance |
tms_importance |
Custom |
String |
messageType |
tms_message_type |
Custom |
String |
createdBy |
tms_created_by |
Custom |
String |
deletedAt |
tms_last_deleted_at |
Custom |
Date |
sourceUrl |
_source_uri |
Default |
String |
mentions |
tms_mentions |
Custom |
String list |
reactions |
tms_reactions |
Custom |
String list |
attachments |
tms_attachments |
Custom |
String list |
createdAt |
_created_at |
Default |
Date |
lastModifiedAt |
_last_updated_at |
Default |
Date |
Channel file
attachments
Microsoft Teams field name |
Index field name |
Description |
Data type |
fileName |
tms_name |
Custom |
String |
size |
tms_file_size |
Custom |
Long (numeric) |
channelName |
tms_channel_name |
Custom |
String |
Title |
tms_title |
Custom |
String |
sourceUrl |
_source_uri |
Default |
String |
createdBy |
tms_created_by |
Custom |
String |
lastModifiedBy |
tms_last_modified_by |
Custom |
String |
createdAt |
_created_at |
Default |
Date |
lastModifiedAt |
_last_updated_at |
Default |
Date |
oneNoteDocument |
tms_onenote_document |
Custom |
String |
oneNoteSection |
tms_onenote_section |
Custom |
String |
oneNotePage |
tms_onenote_page |
Custom |
String |
Wiki
Microsoft Teams field name |
Index field name |
Description |
Data type |
channelName |
tms_channel_name |
Custom |
String |
fileName |
tms_name |
Custom |
String |
size |
tms_file_size |
Custom |
Long (numeric) |
createdBy |
tms_created_by |
Custom |
String |
lastModifiedBy |
tms_last_modified_by |
Custom |
String |
title |
tms_title |
Custom |
String |
sourceUrl |
_source_uri |
Default |
String |
createdAt |
_created_at |
Default |
Date |
lastModifiedAt |
_last_updated_at |
Default |
Date |
Meeting chats
Microsoft Teams field name |
Index field name |
Description |
Data type |
subject |
tms_subject |
Custom |
String |
summary |
tms_summary |
Custom |
String |
importance |
tms_importance |
Custom |
String |
messageType |
tms_message_type |
Custom |
String |
Sender |
tms_sender |
Custom |
String |
attachments |
tms_attachments |
Custom |
String list |
mentions |
tms_mentions |
Custom |
String list |
reactions |
tms_reactions |
Custom |
String list |
sourceUrl |
_source_uri |
Default |
String |
deletedAt |
tms_last_deleted_at |
Custom |
Date |
createdAt |
_created_at |
Default |
Date |
lastModifiedAt |
_last_updated_at |
Default |
Date |
Meeting details
Microsoft Teams field name |
Index field name |
Description |
Data type |
subject |
tms_subject |
Custom |
String |
summary |
tms_summary |
Custom |
String |
importance |
tms_importance |
Custom |
String |
username |
tms_from_user |
Custom |
String |
eventStartTime |
tms_event_start_time |
Custom |
Date |
eventEndTime |
tms_event_end_time |
Custom |
Date |
sourceURL |
_source_uri |
Default |
String |
Meeting notes
Microsoft Teams field name |
Index field name |
Description |
Data type |
fileName |
tms_name |
Custom |
String |
title |
tms_title |
Custom |
String |
createdBy |
tms_created_by |
Custom |
String |
lastModifiedBy |
tms_last_modified_by |
Custom |
String |
sourceUrl |
_source_uri |
Default |
String |
createdAt |
_created_at |
Default |
Date |
lastModifiedAt |
_last_updated_at |
Default |
Date |
Meeting files
Microsoft Teams field name |
Index field name |
Description |
Data type |
fileName |
tms_name |
Custom |
String |
title |
tms_title |
Custom |
String |
size |
tms_file_size |
Custom |
Long (numeric) |
sourceUrl |
_source_uri |
Default |
String |
createdBy |
tms_created_by |
Custom |
String |
lastModifiedBy |
tms_last_modified_by |
Custom |
String |
createdAt |
_created_at |
Default |
Date |
lastModifiedAt |
_last_updated_at |
Default |
Date |