共同逐字稿訊息（msdyn_commontranscriptmessage）表格/實體參考（Microsoft Dynamics 365）

每個對話訊息儲存一列，並依對話 ID 分割。為文字記錄持久化而設的暫存存儲;列在歸檔後，過期時間約為 ttlinseconds。

Messages

下表列出了通用轉錄訊息（msdyn_commontranscriptmessage）表的訊息。 訊息代表可以在表格上執行的作業。 它們也可能是事件。

名稱 是事件嗎？	Web API 作業	適用於 .NET 的 SDK
Assign 事件：真實	PATCH /msdyn_commontranscriptmessages（msdyn_commontranscriptmessageid） 更新ownerid屬性。	AssignRequest
Associate 事件：真實	關聯記錄	關聯記錄
BulkRetain 事件：真實	BulkRetain	瞭解如何搭配 SDK for .NET 使用訊息
Create 事件：真實	POST /msdyn_commontranscriptmessages 請參閱 建立	建立記錄
CreateMultiple 事件：真實	CreateMultiple	CreateMultipleRequest
Delete 事件：真實	DELETE /msdyn_commontranscriptmessages（msdyn_commontranscriptmessageid） 請參閱 刪除	刪除記錄
DeleteMultiple 事件：真實	DeleteMultiple	瞭解如何搭配 SDK for .NET 使用訊息
Disassociate 事件：真實	取消關聯記錄	取消關聯記錄
PurgeRetainedContent 事件：真實	PurgeRetainedContent	瞭解如何搭配 SDK for .NET 使用訊息
Retain 事件：真實	Retain	瞭解如何搭配 SDK for .NET 使用訊息
Retrieve 事件：真實	GET /msdyn_commontranscriptmessages（msdyn_commontranscriptmessageid） 請參閱 擷取	擷取記錄
RetrieveEntityChanges 事件：真實		RetrieveEntityChangesRequest
RetrieveMultiple 事件：真實	GET /msdyn_commontranscriptmessages 請參閱 查詢資料	查詢數據
RetrievePrincipalAccess 事件：真實	RetrievePrincipalAccess	RetrievePrincipalAccessRequest
RollbackRetain 事件：真實	RollbackRetain	瞭解如何搭配 SDK for .NET 使用訊息
Update 事件：真實	PATCH /msdyn_commontranscriptmessages（msdyn_commontranscriptmessageid） 查看 更新	更新記錄
UpdateMultiple 事件：真實	UpdateMultiple	UpdateMultipleRequest
Upsert 事件：真實	PATCH /msdyn_commontranscriptmessages（msdyn_commontranscriptmessageid） 請參閱更新 插入表格列	UpsertRequest
UpsertMultiple 事件：真實	UpsertMultiple	UpsertMultipleRequest
ValidateRetentionConfig 事件：真實	ValidateRetentionConfig	瞭解如何搭配 SDK for .NET 使用訊息

屬性

下表列出共同逐字稿訊息（msdyn_commontranscriptmessage）表中所選屬性。

Property	價值
DisplayName	通用逐字稿訊息
顯示集合名稱	常見逐字稿訊息
結構描述名稱	msdyn_commontranscriptmessage
集合架構名稱	msdyn_commontranscriptmessages
實體集名稱	msdyn_commontranscriptmessages
邏輯名稱	msdyn_commontranscriptmessage
邏輯集合名稱	msdyn_commontranscriptmessages
PrimaryId屬性	msdyn_commontranscriptmessageid
PrimaryName屬性	msdyn_conversationid
表格類型	Elastic
擁有權類型	UserOwned

可寫入的資料行/屬性

這些資料行/屬性會針對 IsValidForCreate 或 IsValidForUpdate 傳回 true （通常兩者）。 依 SchemaName 列出。

• 匯入序列號
• msdyn_commontranscriptmessageId
• msdyn_content
• msdyn_conversationid
• msdyn_messagetimestamp
• msdyn_messagetype
• msdyn_participantid
• msdyn_productsku
• msdyn_role
• msdyn_sender
• msdyn_sequence
• msdyn_sourcemessageid
• OverriddenCreatedOn
• 擁有者標識碼
• OwnerId類型
• 分區識別碼
• TTL秒數

ImportSequenceNumber

Property	價值
說明	建立此記錄的匯入序號。
DisplayName	匯入序號
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	importsequencenumber
RequiredLevel	None
類型	Integer
最大值	2147483647
最小值	-2147483648

msdyn_commontranscriptmessageId

Property	價值
說明	實體執行個體的唯一識別碼。 內容定址：由對話 ID、來源訊息 ID、參與者 ID 及訊息文本推導而來，因此重遞為冪元。
DisplayName	通用逐字稿訊息
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	msdyn_commontranscriptmessageid
RequiredLevel	系統必要
類型	Uniqueidentifier

msdyn_content

Property	價值
說明	訊息文字，或是當訊息包含結構化內容時，序列化的 JSON 信封。
DisplayName	Content
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	msdyn_content
RequiredLevel	None
類型	備忘錄
Format	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	1048576

msdyn_conversationid

Property	價值
說明	交談識別碼。 從 partitionid 複製，讓該值可查詢並作為主要名稱。
DisplayName	交談標識碼
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	msdyn_conversationid
RequiredLevel	申請必填
類型	String
Format	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	100

msdyn_messagetimestamp

Property	價值
說明	訊息發送的時間。 重建對話時使用主要排序鍵。
DisplayName	訊息時間戳記
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	msdyn_messagetimestamp
RequiredLevel	申請必填
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
Format	日期與時間
Ime模式	Auto
來源類型遮罩	0

msdyn_messagetype

Property	價值
說明	內容辨別器：文字、adaptivecard、toolcall、toolresult 等等。
DisplayName	訊息類型
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	msdyn_messagetype
RequiredLevel	申請必填
類型	String
Format	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	100

msdyn_participantid

Property	價值
說明	訊息發送者的原始線路參與者識別碼。
DisplayName	參與者 ID
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	msdyn_participantid
RequiredLevel	申請必填
類型	String
Format	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	200

msdyn_productsku

Property	價值
說明	原始產品：D365CC 或 CCAI。 鏡像 CommonTranscriptDocument.ProductSKU.
DisplayName	SKU 產品
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	msdyn_productsku
RequiredLevel	申請必填
類型	String
Format	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	50

msdyn_role

Property	價值
說明	發送者角色：客戶、代理人、機器人、系統或工具。
DisplayName	Role
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	msdyn_role
RequiredLevel	申請必填
類型	String
Format	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	100

msdyn_sender

Property	價值
說明	衍生喇叭顯示名稱。 當上游通道沒有顯示名稱時，可能會是空的。
DisplayName	Sender
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	msdyn_sender
RequiredLevel	None
類型	String
Format	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	200

msdyn_sequence

Property	價值
說明	執行時指派的排序平手，用於共享時間戳的訊息。 並非全域唯一;訊息時間戳記會主導排序。
DisplayName	序列
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	msdyn_sequence
RequiredLevel	None
類型	Integer
最大值	2147483647
最小值	0

msdyn_sourcemessageid

Property	價值
說明	原始上游訊息識別碼（CCAI 為 A2A，D365CC 為 ACS）。 可追溯性加上對內容位址主鍵的輸入。
DisplayName	來源訊息ID
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	msdyn_sourcemessageid
RequiredLevel	申請必填
類型	String
Format	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	200

OverriddenCreatedOn

Property	價值
說明	移轉記錄的日期和時間。
DisplayName	記錄建立日期
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	overriddencreatedon
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
Format	DateOnly
Ime模式	無效
來源類型遮罩	0

擁有者ID

Property	價值
說明	擁有者識別碼
DisplayName	Owner
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	ownerid
RequiredLevel	系統必要
類型	Owner
Targets	系統使用者、團隊

OwnerId類型

Property	價值
說明	擁有者 ID 類型
DisplayName
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	owneridtype
RequiredLevel	系統必要
類型	實體名稱

分區識別碼

Property	價值
說明	邏輯分割區 ID。邏輯分割區由一組具有相同分割區 ID 的記錄組成。
DisplayName	分割區識別碼
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	partitionid
RequiredLevel	None
類型	String
Format	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	100

TTL秒數

Property	價值
說明	幾秒鐘內的生存時間。
DisplayName	活著的時間
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	ttlinseconds
RequiredLevel	None
類型	Integer
最大值	2147483647
最小值	1

唯讀資料行/屬性

這些資料行/屬性會針對 IsValidForCreate 和 IsValidForUpdate 傳回 false。 依 SchemaName 列出。

• 建立者
• 創建日期
• CreatedOnBehalfBy
• 修改者
• 修改時
• ModifiedOnBehalfBy
• 擁有者名稱
• OwnerIdYomi名稱
• 擁有業務單位
• 擁有團隊
• 擁有用戶
• 版本編號

CreatedBy

Property	價值
說明	建立記錄之使用者的唯一識別碼。
DisplayName	創建者
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	createdby
RequiredLevel	None
類型	查詢
Targets	systemuser

CreatedOn

Property	價值
說明	建立記錄的日期和時間。
DisplayName	建立日期
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	createdon
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
Format	日期與時間
Ime模式	無效
來源類型遮罩	0

CreatedOnBehalfBy

Property	價值
說明	建立記錄之委派使用者的唯一識別碼。
DisplayName	建立者 （委派）
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	createdonbehalfby
RequiredLevel	None
類型	查詢
Targets	systemuser

ModifiedBy

Property	價值
說明	修改記錄之使用者的唯一識別碼。
DisplayName	修改者
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	modifiedby
RequiredLevel	None
類型	查詢
Targets	systemuser

修改時

Property	價值
說明	修改記錄的日期和時間。
DisplayName	修改於
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	modifiedon
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
Format	日期與時間
Ime模式	無效
來源類型遮罩	0

ModifiedOnBehalfBy

Property	價值
說明	修改記錄之委派使用者的唯一識別碼。
DisplayName	修改者 （委派）
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	modifiedonbehalfby
RequiredLevel	None
類型	查詢
Targets	systemuser

擁有者名稱

Property	價值
說明	業主姓名
DisplayName
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	owneridname
RequiredLevel	系統必要
類型	String
Format	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	100

OwnerIdYomi名稱

Property	價值
說明	Yomi 所有者的名字
DisplayName
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	owneridyominame
RequiredLevel	系統必要
類型	String
Format	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	100

擁有業務單位

Property	價值
說明	擁有記錄之業務單位的唯一識別碼
DisplayName	擁有業務單位
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	owningbusinessunit
RequiredLevel	None
類型	查詢
Targets	事業單位

擁有團隊

Property	價值
說明	擁有記錄之小組的唯一識別碼。
DisplayName	擁有團隊
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	owningteam
RequiredLevel	None
類型	查詢
Targets	小組

擁有用戶

Property	價值
說明	擁有記錄之使用者的唯一識別碼。
DisplayName	擁有使用者
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	owninguser
RequiredLevel	None
類型	查詢
Targets	systemuser

版本號

Property	價值
說明	版本號碼
DisplayName	版本號碼
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	versionnumber
RequiredLevel	None
類型	BigInt
最大值	9223372036854775807
最小值	-9223372036854775808

多對一關聯

這些關係是多對一的。 依 SchemaName 列出。

• business_unit_msdyn_commontranscriptmessage
• lk_msdyn_commontranscriptmessage_createdby
• lk_msdyn_commontranscriptmessage_createdonbehalfby
• lk_msdyn_commontranscriptmessage_modifiedby
• lk_msdyn_commontranscriptmessage_modifiedonbehalfby
• owner_msdyn_commontranscriptmessage
• team_msdyn_commontranscriptmessage
• user_msdyn_commontranscriptmessage

business_unit_msdyn_commontranscriptmessage

一To-Many 關係： 事業單位business_unit_msdyn_commontranscriptmessage

Property	價值
參考實體	businessunit
參考屬性	businessunitid
ReferencingAttribute	owningbusinessunit
ReferencingEntityNavigationPropertyName	owningbusinessunit
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

lk_msdyn_commontranscriptmessage_createdby

一-To-Many 關係： 系統使用者lk_msdyn_commontranscriptmessage_createdby

Property	價值
參考實體	systemuser
參考屬性	systemuserid
ReferencingAttribute	createdby
ReferencingEntityNavigationPropertyName	createdby
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

lk_msdyn_commontranscriptmessage_createdonbehalfby

一To-Many 關係： 系統使用者lk_msdyn_commontranscriptmessage_createdonbehalfby

Property	價值
參考實體	systemuser
參考屬性	systemuserid
ReferencingAttribute	createdonbehalfby
ReferencingEntityNavigationPropertyName	createdonbehalfby
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

lk_msdyn_commontranscriptmessage_modifiedby

一To-Many 關係： 系統使用者lk_msdyn_commontranscriptmessage_modifiedby

Property	價值
參考實體	systemuser
參考屬性	systemuserid
ReferencingAttribute	modifiedby
ReferencingEntityNavigationPropertyName	modifiedby
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

lk_msdyn_commontranscriptmessage_modifiedonbehalfby

One-To-Many 關係： systemuser lk_msdyn_commontranscriptmessage_modifiedonbehalfby

Property	價值
參考實體	systemuser
參考屬性	systemuserid
ReferencingAttribute	modifiedonbehalfby
ReferencingEntityNavigationPropertyName	modifiedonbehalfby
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

owner_msdyn_commontranscriptmessage

一To-Many 關係： 擁有者owner_msdyn_commontranscriptmessage

Property	價值
參考實體	owner
參考屬性	ownerid
ReferencingAttribute	ownerid
ReferencingEntityNavigationPropertyName	ownerid
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

team_msdyn_commontranscriptmessage

一-To-Many 關係： 團隊team_msdyn_commontranscriptmessage

Property	價值
參考實體	team
參考屬性	teamid
ReferencingAttribute	owningteam
ReferencingEntityNavigationPropertyName	owningteam
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

user_msdyn_commontranscriptmessage

一-To-Many 關係： 系統使用者user_msdyn_commontranscriptmessage

Property	價值
參考實體	systemuser
參考屬性	systemuserid
ReferencingAttribute	owninguser
ReferencingEntityNavigationPropertyName	owninguser
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

另請參閱

Dataverse 資料表/實體參考
Dataverse Web API 參考