週期性規則 （RecurrenceRule） 資料表/實體參考 （Microsoft Dataverse）

週期規則代表週期性實體的發生模式。

Messages

下表列出週期性規則 （RecurrenceRule） 資料表的訊息。 訊息代表可以在表格上執行的作業。 它們也可能是事件。

名字 是事件嗎？	Web API 作業	SDK for .NET
Associate 事件：真實	關聯記錄	關聯記錄
Create 事件：真實	POST /recurrence規則 請參閱 建立	建立記錄
Delete 事件：真實	DELETE /recurrencerules（規則 ID） 請參閱 刪除	刪除記錄
Disassociate 事件：真實	取消關聯記錄	取消關聯記錄
Retrieve 事件：False	GET /recurrencerules（規則 ID） 請參閱 擷取	擷取記錄
RetrieveMultiple 事件：真實	GET /recurrence規則 請參閱 查詢資料	查詢數據
Update 事件：真實	PATCH /recurrencerules（規則 ID） 查看 更新	更新記錄
Upsert 事件：False	PATCH /recurrencerules（規則 ID） 請參閱更新 插入表格列	UpsertRequest
ValidateRecurrenceRule 事件：真實	ValidateRecurrenceRule	ValidateRecurrenceRuleRequest

屬性

下表列出週期性規則 （RecurrenceRule） 資料表的選取屬性。

房產	價值觀
DisplayName	週期規則
顯示集合名稱	週期規則
結構描述名稱	RecurrenceRule
集合架構名稱	RecurrenceRules
實體集名稱	recurrencerules
邏輯名稱	recurrencerule
邏輯集合名稱	recurrencerules
PrimaryId屬性	ruleid
表格類型	Standard
擁有權類型	UserOwned

可寫入的資料行/屬性

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

• 月日
• 星期幾遮罩
• Duration
• EffectiveEndDate
• EffectiveStartDate
• EndTime
• 星期的第一天
• 執行個體
• Interval
• 是NthMonthly
• 是Nth每年
• 是再生
• 是 WeekDayPattern
• 年份月份
• 物件標識符
• 物件類型代碼
• 發生次數
• 擁有者標識碼
• OwnerId類型
• 模式結束日期
• 模式結束類型
• 模式開始日期
• RecurrencePatternType
• 規則標識碼
• StartTime

DayOfMonth

房產	價值觀
Description	週期性約會或任務發生的月份的日期。
顯示名稱	月日
IsValidForForm	否
IsValidForRead	對
LogicalName	dayofmonth
RequiredLevel	None
類型	整數
最大值	31
最小值	0

星期幾遮罩

房產	價值觀
Description	Bitmask 代表一週中發生週期性約會或任務的天幾。
顯示名稱	星期幾面膜
IsValidForForm	否
IsValidForRead	對
LogicalName	daysofweekmask
RequiredLevel	None
類型	整數
最大值	127
最小值	1

持續時間

房產	價值觀
Description	週期性模式的持續時間（以分鐘為單位）。
顯示名稱	Duration
IsValidForForm	否
IsValidForRead	對
LogicalName	duration
RequiredLevel	None
類型	整數
最大值	2147483647
最小值	0

生效結束日期

房產	價值觀
Description	週期性模式擴充的實際結束日期。
顯示名稱	生效結束日期
IsValidForForm	否
IsValidForRead	對
LogicalName	effectiveenddate
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	日期與時間
Ime模式	停用
來源類型遮罩	0

生效開始日期

房產	價值觀
Description	週期性模式擴充的實際開始日期。
顯示名稱	生效開始日期
IsValidForForm	否
IsValidForRead	對
LogicalName	effectivestartdate
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	DateOnly
Ime模式	停用
來源類型遮罩	0

EndTime

房產	價值觀
Description	相關聯活動的結束時間。
顯示名稱	結束時間
IsValidForForm	否
IsValidForRead	對
LogicalName	endtime
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	日期與時間
Ime模式	停用
來源類型遮罩	0

第一週

房產	價值觀
Description	週期性模式的一週的第一天。
顯示名稱	一周的第一天
IsValidForForm	否
IsValidForRead	對
LogicalName	firstdayofweek
RequiredLevel	None
類型	整數
最大值	6
最小值	0

實例

房產	價值觀
Description	指定週期模式在指定間隔內有效的計數。
顯示名稱	執行個體
IsValidForForm	對
IsValidForRead	對
LogicalName	instance
RequiredLevel	None
類型	選擇清單
預設形式值
GlobalChoiceName	recurrencerule_instance

實例選擇/選項

價值觀	標籤
1	First
2	Second
3	第三
4	第四
5	最後一個

間隔

房產	價值觀
Description	出現之間給定週期類型的單位數。
顯示名稱	Interval
IsValidForForm	否
IsValidForRead	對
LogicalName	interval
RequiredLevel	None
類型	整數
最大值	1000
最小值	1

是NthMonthly

房產	價值觀
Description	指定每月週期模式是否為第 N 個月，僅對每月週期有效。
顯示名稱	第N個月
IsValidForForm	否
IsValidForRead	對
LogicalName	isnthmonthly
RequiredLevel	系統必要
類型	布林值
GlobalChoiceName	recurrencerule_isnthmonthly
預設值	否
真實標籤	Yes
虛假標籤	否

是Nth每年

房產	價值觀
Description	指定每年週期模式是否為 N 年，僅對每年週期有效。
顯示名稱	第 N 年
IsValidForForm	否
IsValidForRead	對
LogicalName	isnthyearly
RequiredLevel	系統必要
類型	布林值
GlobalChoiceName	recurrencerule_isnthyearly
預設值	否
真實標籤	Yes
虛假標籤	否

是再生

房產	價值觀
Description	僅對任務類型週期有效，指出是否應該重新產生任務。
顯示名稱	再生
IsValidForForm	否
IsValidForRead	對
LogicalName	isregenerate
RequiredLevel	系統必要
類型	布林值
GlobalChoiceName	recurrencerule_isregenerate
預設值	否
真實標籤	Yes
虛假標籤	否

是 WeekDayPattern

房產	價值觀
Description	指定每週週期模式是否實際上是每日每個工作日模式，僅對每週週期有效。
顯示名稱	每個工作日
IsValidForForm	否
IsValidForRead	對
LogicalName	isweekdaypattern
RequiredLevel	系統必要
類型	布林值
GlobalChoiceName	recurrencerule_isweekdaypattern
預設值	否
真實標籤	Yes
虛假標籤	否

年份中的月份

房產	價值觀
Description	指定對週期模式有效的年份月份。
顯示名稱	年月
IsValidForForm	否
IsValidForRead	對
LogicalName	monthofyear
RequiredLevel	None
類型	選擇清單
預設形式值	0
GlobalChoiceName	recurrencerule_monthofyear

年份月份選擇/選項

價值觀	標籤
0	一年中的無效月份
1	一月
2	二月
3	三月
4	四月
5	五月
6	June
7	July
8	八月
9	九月
10	十月
11	十一月
12	十二月

ObjectId (物件識別碼)

房產	價值觀
Description	與週期性規則相關聯之物件的唯一識別碼。
顯示名稱	關於
IsValidForForm	否
IsValidForRead	對
LogicalName	objectid
RequiredLevel	None
類型	查詢
Targets	活動指標

ObjectTypeCode

房產	價值觀
Description
顯示名稱	物件類型
IsValidForForm	否
IsValidForRead	對
LogicalName	objecttypecode
RequiredLevel	None
類型	實體名稱

發生次數

房產	價值觀
Description	週期性模式的出現次數。
顯示名稱	發生次數
IsValidForForm	否
IsValidForRead	對
LogicalName	occurrences
RequiredLevel	None
類型	整數
最大值	999
最小值	1

擁有者標識碼

房產	價值觀
Description	擁有週期規則之使用者或小組的唯一識別碼。
顯示名稱	Owner
IsValidForForm	否
IsValidForRead	對
LogicalName	ownerid
RequiredLevel	系統必要
類型	所有者
Targets	系統使用者、團隊

OwnerId類型

房產	價值觀
Description
顯示名稱
IsValidForForm	否
IsValidForRead	對
LogicalName	owneridtype
RequiredLevel	系統必要
類型	實體名稱

模式結束日期

房產	價值觀
Description	週期範圍的結束日期。
顯示名稱	週期範圍結束
IsValidForForm	對
IsValidForRead	對
LogicalName	patternenddate
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	日期與時間
Ime模式	停用
來源類型遮罩	0

模式結束類型

房產	價值觀
Description	模式結束 循環數列的類型。
顯示名稱	樣式端型
IsValidForForm	對
IsValidForRead	對
LogicalName	patternendtype
RequiredLevel	系統必要
類型	選擇清單
預設形式值	0
GlobalChoiceName	recurrencerule_patternendtype

PatternEndType 選擇/選項

價值觀	標籤
1	無結束日期
2	發生次數
3	模式結束日期

模式開始日期

房產	價值觀
Description	週期範圍的開始日期。
顯示名稱	週期範圍開始
IsValidForForm	對
IsValidForRead	對
LogicalName	patternstartdate
RequiredLevel	申請必填
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	日期與時間
Ime模式	停用
來源類型遮罩	0

RecurrencePatternType

房產	價值觀
Description	復發類型。
顯示名稱	週期模式
IsValidForForm	對
IsValidForRead	對
LogicalName	recurrencepatterntype
RequiredLevel	系統必要
類型	選擇清單
預設形式值	0
GlobalChoiceName	recurrencerule_recurrencepatterntype

RecurrencePatternType 選項/選項

價值觀	標籤
0	日常
1	週刊
2	每月
3	每年

規則識別碼

房產	價值觀
Description	與週期性規則相關聯之實體的唯一識別碼。
顯示名稱	週期規則
IsValidForForm	否
IsValidForRead	對
LogicalName	ruleid
RequiredLevel	系統必要
類型	Uniqueidentifier

StartTime

房產	價值觀
Description	週期性活動的開始時間。
顯示名稱	開始時間
IsValidForForm	否
IsValidForRead	對
LogicalName	starttime
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	日期與時間
Ime模式	停用
來源類型遮罩	0

唯讀資料行/屬性

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

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

CreatedBy

房產	價值觀
Description	建立週期規則之使用者的唯一識別碼。
顯示名稱	創建者
IsValidForForm	對
IsValidForRead	對
LogicalName	createdby
RequiredLevel	None
類型	查詢
Targets	systemuser

創建日期

房產	價值觀
Description	建立週期規則的日期和時間。
顯示名稱	建立時間
IsValidForForm	對
IsValidForRead	對
LogicalName	createdon
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	日期與時間
Ime模式	停用
來源類型遮罩	0

CreatedOnBehalfBy

房產	價值觀
Description	建立週期規則之委派使用者的唯一識別碼。
顯示名稱	建立者 （委派）
IsValidForForm	對
IsValidForRead	對
LogicalName	createdonbehalfby
RequiredLevel	None
類型	查詢
Targets	systemuser

ModifiedBy

房產	價值觀
Description	上次修改週期規則之使用者的唯一識別碼。
顯示名稱	修改者
IsValidForForm	對
IsValidForRead	對
LogicalName	modifiedby
RequiredLevel	None
類型	查詢
Targets	systemuser

修改時

房產	價值觀
Description	上次修改週期規則的日期和時間。
顯示名稱	修改於
IsValidForForm	對
IsValidForRead	對
LogicalName	modifiedon
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	日期與時間
Ime模式	停用
來源類型遮罩	0

ModifiedOnBehalfBy

房產	價值觀
Description	修改週期規則之委派使用者的唯一識別碼。
顯示名稱	建立者 （委派）
IsValidForForm	對
IsValidForRead	對
LogicalName	modifiedonbehalfby
RequiredLevel	None
類型	查詢
Targets	systemuser

擁有者名稱

房產	價值觀
Description
顯示名稱
IsValidForForm	否
IsValidForRead	對
LogicalName	owneridname
RequiredLevel	系統必要
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	100

OwnerIdYomi名稱

房產	價值觀
Description
顯示名稱
IsValidForForm	否
IsValidForRead	對
LogicalName	owneridyominame
RequiredLevel	系統必要
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	100

擁有業務單位

房產	價值觀
Description	擁有週期性規則之業務單位的唯一識別碼。
顯示名稱	擁有業務單位
IsValidForForm	對
IsValidForRead	對
LogicalName	owningbusinessunit
RequiredLevel	None
類型	查詢
Targets	業務單位

擁有團隊

房產	價值觀
Description
顯示名稱	擁有團隊
IsValidForForm	否
IsValidForRead	對
LogicalName	owningteam
RequiredLevel	None
類型	查詢
Targets	小組

擁有用戶

房產	價值觀
Description
顯示名稱	擁有使用者
IsValidForForm	否
IsValidForRead	對
LogicalName	owninguser
RequiredLevel	None
類型	查詢
Targets	systemuser

版本編號

房產	價值觀
Description
顯示名稱
IsValidForForm	否
IsValidForRead	對
LogicalName	versionnumber
RequiredLevel	None
類型	大國際
最大值	9223372036854775807
最小值	-9223372036854775808

多對一關聯

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

• activity_pointer_recurrencerule
• business_unit_recurrencerule
• lk_recurrencerule_createdby
• lk_recurrencerule_modifiedby
• lk_recurrencerulebase_createdonbehalfby
• lk_recurrencerulebase_modifiedonbehalfby
• owner_recurrencerules

activity_pointer_recurrencerule

一To-Many 關係： activitypointer activity_pointer_recurrencerule

房產	價值觀
參考實體	activitypointer
參考屬性	activityid
ReferencingAttribute	objectid
ReferencingEntityNavigationPropertyName	objectid
是階層式
CascadeConfiguration	存檔： NoCascade 指派： Cascade 刪除： Cascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： Cascade 取消分享： Cascade

business_unit_recurrencerule

一To-Many 關係： 業務單位business_unit_recurrencerule

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

lk_recurrencerule_createdby

一To-Many 關係： systemuser lk_recurrencerule_createdby

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

lk_recurrencerule_modifiedby

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

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

lk_recurrencerulebase_createdonbehalfby

一To-Many 關係： systemuser lk_recurrencerulebase_createdonbehalfby

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

lk_recurrencerulebase_modifiedonbehalfby

一To-Many 關係： systemuser lk_recurrencerulebase_modifiedonbehalfby

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

owner_recurrencerules

一To-Many 關係： 業主owner_recurrencerules

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

一對多關係

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

recurrencerule_recurringappointmentmaster

多To-One 關係： recurringappointmentmaster recurrencerule_recurringappointmentmaster

房產	價值觀
ReferencingEntity	recurringappointmentmaster
ReferencingAttribute	activityid
參考實體導航屬性名稱	recurrencerule_recurringappointmentmaster
IsCustomizable	False
關聯功能表配置	可用離線：True 態度： DoNotDisplay 隊： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

另請參閱

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