訊息範本（msdyn_oc_message_template）表格/實體參考（Microsoft Dynamics 365 Field Service）

提供與供應商無關的可重複使用訊息範本目錄（WhatsApp / SMS / MMS / RCS），供全通路消費者在不同供應商間取得或建立（如 Meta-Direct、ACS、Twilio）。

Messages

下表列出訊息範本（msdyn_oc_message_template）資料表的訊息。 訊息代表可以在表格上執行的作業。 它們也可能是事件。

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

屬性

以下表格列出訊息範本（msdyn_oc_message_template）資料表中所選的屬性。

屬性 值
DisplayName 訊息範本
顯示集合名稱 訊息範本
結構描述名稱 msdyn_oc_message_template
集合架構名稱 msdyn_oc_message_templates
實體集名稱 msdyn_oc_message_templates
邏輯名稱 msdyn_oc_message_template
邏輯集合名稱 msdyn_oc_message_templates
PrimaryId屬性 msdyn_oc_message_templateid
PrimaryName屬性 msdyn_name
表格類型 Standard
擁有權類型 OrganizationOwned

可寫入的資料行/屬性

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

ImportSequenceNumber

屬性 值
描述 建立此記錄的匯入序號。
DisplayName 匯入序號
IsValidForForm 否
IsValidForRead 沒錯
邏輯名稱 importsequencenumber
必要層級 無
類型 整數
最大值 2147483647
最小值 -2147483648

是可自訂的

屬性 值
描述 僅供內部使用。
DisplayName 可定制
IsValidForForm 否
IsValidForRead 沒錯
邏輯名稱 iscustomizable
必要層級 系統必要
類型 管理屬性

msdyn_bodytext

屬性 值
描述 非正規化的正文，方便快速預覽與搜尋。 非權威;權威結構存在於內容中。
DisplayName 內文文字
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_bodytext
必要層級 無
類型 備忘錄
Format 文字區域
格式名稱 文字區域
Ime模式 Auto
是可本地化 否
最大長度 4000

msdyn_category

屬性 值
描述 WhatsApp 範本分類（行銷/工具/認證）。 非 WhatsApp 服務提供者則使用 Null。
DisplayName Category
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_category
必要層級 無
類型 Picklist
預設形式值 -1
GlobalChoiceName msdyn_oc_message_template_category

msdyn_category選擇/選項

值 標籤
700610000 行銷
700610001 公用程式
700610002 驗證

msdyn_channelinstanceid

屬性 值
描述 模板所屬的 WABA / 頻道實例。 備用鍵的一部分;絕不能為空——對於無實例列的列，請使用保留哨兵。
DisplayName 通道執行個體識別碼
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_channelinstanceid
必要層級 申請必填
類型 String
Format 文字
格式名稱 文字
Ime模式 Auto
是可本地化 否
最大長度 100

msdyn_channeltype

屬性 值
描述 把範本的頻道（WhatsApp / SMS）連結。 頻道內的格式由 Template Format 獨立承載。
DisplayName 通道類型
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_channeltype
必要層級 申請必填
類型 Picklist
預設形式值 -1
GlobalChoiceName msdyn_oc_message_template_channeltype

msdyn_channeltype選擇/選項

值 標籤
700610000 WhatsApp
700610001 簡訊

msdyn_content

屬性 值
描述 模板的統一自描述 JSON 定義（提供者結構加上參數定義）。 WhatsApp 組件;MMS {文字、mediaAttachments};簡訊 {文字}。
DisplayName Content
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_content
必要層級 申請必填
類型 備忘錄
Format 文字
格式名稱 文字
Ime模式 Auto
是可本地化 否
最大長度 1048576

msdyn_displayname

屬性 值
描述 模板選擇器中顯示的可選友善標籤。
DisplayName 顯示名稱
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_displayname
必要層級 無
類型 String
Format 文字
格式名稱 文字
Ime模式 Auto
是可本地化 否
最大長度 200

msdyn_language

屬性 值
描述 典範 BCP-47 語言代碼（例如 en-US）。 提供者專屬的程式碼會在提供者介面卡中解析，而非儲存在此。
DisplayName 語言
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_language
必要層級 申請必填
類型 String
Format 文字
格式名稱 文字
Ime模式 Auto
是可本地化 否
最大長度 20

msdyn_lastsyncedon

屬性 值
描述 此目錄列與提供者（快取提供者）最後一次對帳的時間戳記。
DisplayName 最後同步時間
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_lastsyncedon
必要層級 無
類型 約會時間
CanChangeDateTime行為 否
日期時間行為 時區獨立
Format 日期與時間
Ime模式 無效
來源類型遮罩 0

msdyn_name

屬性 值
描述 提供者範本名稱 — 傳送給提供者的值。
DisplayName Name
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_name
必要層級 申請必填
類型 String
Format 文字
格式名稱 文字
Ime模式 Auto
是可本地化 否
最大長度 200

msdyn_oc_message_template_type

屬性 值
描述 訊息格式/頻道識別器（SMS / MMS / RCS / WhatsApp）。 是備用鍵的一部分，因此它總是以該列的單一典範值填充。
DisplayName 範本格式
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_oc_message_template_type
必要層級 申請必填
類型 Picklist
預設形式值 -1
GlobalChoiceName msdyn_octemplateformat

msdyn_oc_message_template_type 選擇/選項

值 標籤
100000000 簡訊
100000001 MMS
100000002 RCS
100000004 WhatsApp

msdyn_oc_message_templateId

屬性 值
描述 實體執行個體的唯一識別碼
DisplayName 訊息範本
IsValidForForm 否
IsValidForRead 沒錯
邏輯名稱 msdyn_oc_message_templateid
必要層級 系統必要
類型 唯一識別碼

msdyn_providerlastupdatedon

屬性 值
描述 提供者最後更新的時間戳（UTC）。
DisplayName 提供者 最後更新日期
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_providerlastupdatedon
必要層級 無
類型 約會時間
CanChangeDateTime行為 否
日期時間行為 時區獨立
Format 日期與時間
Ime模式 無效
來源類型遮罩 0

msdyn_providerstatus

屬性 值
描述 提供者回報的模板生命週期狀態（例如 Meta 核准狀態）。
DisplayName 提供者狀態
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_providerstatus
必要層級 無
類型 Picklist
預設形式值 -1
GlobalChoiceName msdyn_oc_message_template_providerstatus

msdyn_providerstatus 選擇/選項

值 標籤
700610000 已核准
700610001 Pending
700610002 拒絕
700610003 已暫停
700610004 Disabled
700610005 上訴
700610006 待刪除

msdyn_providertemplateid

屬性 值
描述 提供者端識別碼（如有）標識（例如元模板 ID）;對作者 ACS / MMS 範本為空。
DisplayName 提供者範本ID
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_providertemplateid
必要層級 無
類型 String
Format 文字
格式名稱 文字
Ime模式 Auto
是可本地化 否
最大長度 200

msdyn_providertype

屬性 值
描述 擁有此範本的訊息服務提供者（Twilio / Azure 通訊服務 / Meta）。
DisplayName 提供者類型
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_providertype
必要層級 申請必填
類型 Picklist
預設形式值 -1
GlobalChoiceName msdyn_oc_message_template_providertype

msdyn_providertype 選擇/選項

值 標籤
192350000 Twilio
192350001 Azure 通訊服務
192350002 Meta

msdyn_qualityscore

屬性 值
描述 供應商報告的範本品質評分（綠色/黃色/紅色）。
DisplayName 品質評分
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_qualityscore
必要層級 無
類型 Picklist
預設形式值 -1
GlobalChoiceName msdyn_oc_message_template_qualityscore

msdyn_qualityscore 選擇/選項

值 標籤
700610000 綠色
700610001 黃色
700610002 紅色

msdyn_rejectionreason

屬性 值
描述 這是供應商在模板被拒絕時提供的理由。
DisplayName 拒絕理由
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 msdyn_rejectionreason
必要層級 無
類型 String
Format 文字
格式名稱 文字
Ime模式 Auto
是可本地化 否
最大長度 500

OverriddenCreatedOn

屬性 值
描述 移轉記錄的日期和時間。
DisplayName 記錄建立日期
IsValidForForm 否
IsValidForRead 沒錯
邏輯名稱 overriddencreatedon
必要層級 無
類型 約會時間
CanChangeDateTime行為 否
日期時間行為 使用者本機
Format DateOnly
Ime模式 無效
來源類型遮罩 0

statecode

屬性 值
描述 訊息範本狀態
DisplayName 現況
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 statecode
必要層級 系統必要
類型 State
預設形式值
GlobalChoiceName msdyn_oc_message_template_statecode

statecode 選擇/選項

值 詳細資料
0 標籤： 活躍
預設狀態：1
不變量名稱： Active
1 標籤： 非活動
預設狀態：2
不變量名稱： Inactive

狀態代碼

屬性 值
描述 訊息範本狀態的原因
DisplayName 狀態原因
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 statuscode
必要層級 無
類型 現況
預設形式值
GlobalChoiceName msdyn_oc_message_template_statuscode

statuscode 選項/選項

值 詳細資料
1 標籤： 活躍
狀態：0
TransitionData：無
2 標籤： 非活動
狀態：1
TransitionData：無

時區規則版本編號

屬性 值
描述 僅供內部使用。
DisplayName 時區規則版本號碼
IsValidForForm 否
IsValidForRead 沒錯
邏輯名稱 timezoneruleversionnumber
必要層級 無
類型 整數
最大值 2147483647
最小值 -1

UTCConversionTimeZoneCode

屬性 值
描述 建立記錄時使用的時區代碼。
DisplayName UTC 轉換時區代碼
IsValidForForm 否
IsValidForRead 沒錯
邏輯名稱 utcconversiontimezonecode
必要層級 無
類型 整數
最大值 2147483647
最小值 -1

唯讀資料行/屬性

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

ComponentIdUnique

屬性 值
描述 僅供內部使用。
DisplayName 資料列識別碼唯一
IsValidForForm 否
IsValidForRead 沒錯
邏輯名稱 componentidunique
必要層級 系統必要
類型 唯一識別碼

元件狀態

屬性 值
描述 僅供內部使用。
DisplayName 元件狀態
IsValidForForm 否
IsValidForRead 沒錯
邏輯名稱 componentstate
必要層級 系統必要
類型 Picklist
預設形式值
GlobalChoiceName componentstate

ComponentState 選擇/選項

值 標籤
0 已發佈
1 未發表
2 已刪除
3 已刪除，未發布

CreatedBy

屬性 值
描述 建立記錄之使用者的唯一識別碼。
DisplayName 創建者
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 createdby
必要層級 無
類型 查詢
Targets systemuser

CreatedOn

屬性 值
描述 建立記錄的日期和時間。
DisplayName 建立日期
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 createdon
必要層級 無
類型 約會時間
CanChangeDateTime行為 否
日期時間行為 使用者本機
Format 日期與時間
Ime模式 無效
來源類型遮罩 0

CreatedOnBehalfBy

屬性 值
描述 建立記錄之委派使用者的唯一識別碼。
DisplayName 建立者 （委派）
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 createdonbehalfby
必要層級 無
類型 查詢
Targets systemuser

IsManaged

屬性 值
描述 指出解決方案元件是否為受控解決方案的一部分。
DisplayName 受管理
IsValidForForm 否
IsValidForRead 沒錯
邏輯名稱 ismanaged
必要層級 系統必要
類型 布林值
GlobalChoiceName ismanaged
預設值 否
真實標籤 Managed
虛假標籤 未受管理

ModifiedBy

屬性 值
描述 修改記錄之使用者的唯一識別碼。
DisplayName 修改者
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 modifiedby
必要層級 無
類型 查詢
Targets systemuser

修改時

屬性 值
描述 修改記錄的日期和時間。
DisplayName 修改於
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 modifiedon
必要層級 無
類型 約會時間
CanChangeDateTime行為 否
日期時間行為 使用者本機
Format 日期與時間
Ime模式 無效
來源類型遮罩 0

ModifiedOnBehalfBy

屬性 值
描述 修改記錄之委派使用者的唯一識別碼。
DisplayName 修改者 （委派）
IsValidForForm 沒錯
IsValidForRead 沒錯
邏輯名稱 modifiedonbehalfby
必要層級 無
類型 查詢
Targets systemuser

組織識別碼

屬性 值
描述 組織的唯一識別碼
DisplayName 組織識別碼
IsValidForForm 否
IsValidForRead 沒錯
邏輯名稱 organizationid
必要層級 無
類型 查詢
Targets 組織

覆蓋時間

屬性 值
描述 僅供內部使用。
DisplayName 記錄覆蓋時間
IsValidForForm 否
IsValidForRead 沒錯
邏輯名稱 overwritetime
必要層級 系統必要
類型 約會時間
CanChangeDateTime行為 否
日期時間行為 使用者本機
Format 日期與時間
Ime模式 無效
來源類型遮罩 0

解決方案標識碼

屬性 值
描述 相關聯解決方案的唯一識別碼。
DisplayName Solution
IsValidForForm 否
IsValidForRead 沒錯
邏輯名稱 solutionid
必要層級 系統必要
類型 唯一識別碼

支援解決方案標識碼

屬性 值
描述 僅供內部使用。
DisplayName Solution
IsValidForForm 否
IsValidForRead 否
邏輯名稱 supportingsolutionid
必要層級 無
類型 唯一識別碼

版本號

屬性 值
描述 版本號碼
DisplayName 版本號碼
IsValidForForm 否
IsValidForRead 沒錯
邏輯名稱 versionnumber
必要層級 無
類型 BigInt
最大值 9223372036854775807
最小值 -9223372036854775808

一對多關係

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

msdyn_proactive_engagement_message_template_msdyn_oc_message_template

多To-One 關係： msdyn_proactive_engagement_message_template msdyn_proactive_engagement_message_template_msdyn_oc_message_template

屬性 值
ReferencingEntity msdyn_proactive_engagement_message_template
ReferencingAttribute msdyn_ocmessagetemplateid
參考實體導航屬性名稱 msdyn_proactive_engagement_message_template_msdyn_oc_message_template
是可自訂的 False
關聯功能表配置 可用離線：True
態度： UseCollectionName
群組： Details
標籤：
MenuId：空值
訂單： 10000
QueryApi：空
檢視標識碼： 00000000-0000-0000-0000-000000000000

另請參閱

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

  • 上次更新時間：