msdyn_timegroup EntityType

Specify time groups consisting of multiple time windows to be used for scheduling, for example.

Entity Set Path
[organization URI]/api/data/v9.0/msdyn_timegroups
Base Type
Display Name
Fulfillment Preference
Primary Key
Primary Key Attribute
Operations Supported


Properties represent fields of data stored in the entity.Some properties are read-only.

Name Type Details
createdon Edm.DateTimeOffset

Shows the date and time when the record was created. The date and time are displayed in the time zone selected in Microsoft Dynamics CRM options.

Display Name: Created On

Read Only
importsequencenumber Edm.Int32

Shows the sequence number of the import that created this record.

Display Name: Import Sequence Number

modifiedon Edm.DateTimeOffset

Shows the date and time when the record was last updated. The date and time are displayed in the time zone selected in Microsoft Dynamics CRM options.

Display Name: Modified On

Read Only
msdyn_displaytopxresultsinsatimegroup Edm.Int32

Only display the top results per time group detail, per date.

Display Name: Results per Time Group Detail

msdyn_hidebookingtimeonsa Edm.Boolean

Display Name: Hide Booking Time On Schedule Assistant

Default Options
Value Label
1 Yes
0 No
msdyn_interval Edm.Int32

Defines the window size of a time group

Display Name: Interval

msdyn_intervalsbegin Edm.DateTimeOffset

Defines a start time point of a time group

Display Name: Intervals Begin

msdyn_name Edm.String

Enter the name of the "Time Group" entity.

Display Name: Name

msdyn_resetpertimegroupdetail Edm.Boolean

If enabled, the interval calculation will be restarted at the beginning of each time group detail.

Display Name: Reset Per Time Group Detail

Default Options
Value Label
1 Yes
0 No
msdyn_resultsperinterval Edm.Int32

Display Name: Results per Interval

msdyn_timegroupid Edm.Guid

Shows the entity instances.

Display Name: Time Group

overriddencreatedon Edm.DateTimeOffset

Shows the date and time that the record was migrated.

Display Name: Record Created On

processid Edm.Guid

Shows the ID of the process associated with the entity.

Display Name: Process Id

statecode Edm.Int32

Status of the Time Group

Display Name: Status

Default Options
Value Label
0 Active
1 Inactive
statuscode Edm.Int32

Reason for the status of the Time Group

Display Name: Status Reason

Default Options
Value Label
1 Active
2 Inactive
timezoneruleversionnumber Edm.Int32

For internal use only.

Display Name: Time Zone Rule Version Number

traversedpath Edm.String

Shows a comma-separated list of string values representing the unique identifiers of stages in a business process flow instance in the order that they occur.

Display Name: Traversed Path

utcconversiontimezonecode Edm.Int32

Shows the time zone code that was in use when the record was created.

Display Name: UTC Conversion Time Zone Code

versionnumber Edm.Int64

Version Number

Display Name: Version Number

Read Only

Lookup Properties

Lookup properties are read-only, computed properties which contain entity primary key Edm.Guid data for one or more corresponding single-valued navigation properties. More information: Lookup properties and Retrieve data about lookup properties.

Name Single-valued navigation property Description
_createdby_value createdby

Unique identifier of the user who created the record.

_createdonbehalfby_value createdonbehalfby

Shows who created the record on behalf of another user.

_modifiedby_value modifiedby

Unique identifier of the user who modified the record.

_modifiedonbehalfby_value modifiedonbehalfby

Shows who last updated the record on behalf of another user.

_ownerid_value ownerid

Owner Id

_owningbusinessunit_value owningbusinessunit

Unique identifier for the business unit that owns the record

_owningteam_value owningteam

Unique identifier for the team that owns the record.

_owninguser_value owninguser

Unique identifier for the user that owns the record.

_stageid_value stageid

Shows the ID of the stage where the entity is located.

Single-valued navigation properties

Single-valued navigation properties represent lookup fields where a single entity can be referenced. Each single-valued navigation property has a corresponding partner collection-valued navigation property on the related entity.

Name Type Partner
createdby systemuser lk_msdyn_timegroup_createdby
createdonbehalfby systemuser lk_msdyn_timegroup_createdonbehalfby
modifiedby systemuser lk_msdyn_timegroup_modifiedby
modifiedonbehalfby systemuser lk_msdyn_timegroup_modifiedonbehalfby
ownerid principal owner_msdyn_timegroup
owningbusinessunit businessunit business_unit_msdyn_timegroup
owningteam team team_msdyn_timegroup
owninguser systemuser user_msdyn_timegroup
stageid processstage processstage_msdyn_timegroup

Collection-valued navigation properties

Collection-valued navigation properties represent collections of entities which may represent either a one-to-many (1:N) or many-to-many (N:N) relationship between the entities.

Name Type Partner
msdyn_msdyn_timegroup_msdyn_resourcerequirement_TimeGroup msdyn_resourcerequirement msdyn_TimeGroup
msdyn_msdyn_timegroup_msdyn_timegroupdetail msdyn_timegroupdetail msdyn_timegroupid
msdyn_msdyn_timegroup_msdyn_workorder_TimeGroup msdyn_workorder msdyn_timegroup
msdyn_timegroup_ActivityPointers activitypointer regardingobjectid_msdyn_timegroup
msdyn_timegroup_Annotations annotation objectid_msdyn_timegroup
msdyn_timegroup_Appointments appointment regardingobjectid_msdyn_timegroup_appointment
msdyn_timegroup_AsyncOperations asyncoperation regardingobjectid_msdyn_timegroup
msdyn_timegroup_BulkDeleteFailures bulkdeletefailure regardingobjectid_msdyn_timegroup
msdyn_timegroup_connections1 connection record1id_msdyn_timegroup
msdyn_timegroup_connections2 connection record2id_msdyn_timegroup
msdyn_timegroup_DuplicateBaseRecord duplicaterecord baserecordid_msdyn_timegroup
msdyn_timegroup_DuplicateMatchingRecord duplicaterecord duplicaterecordid_msdyn_timegroup
msdyn_timegroup_Emails email regardingobjectid_msdyn_timegroup_email
msdyn_timegroup_Faxes fax regardingobjectid_msdyn_timegroup_fax
msdyn_timegroup_Letters letter regardingobjectid_msdyn_timegroup_letter
msdyn_timegroup_MailboxTrackingFolders mailboxtrackingfolder regardingobjectid_msdyn_timegroup
msdyn_timegroup_msdyn_approvals msdyn_approval regardingobjectid_msdyn_timegroup_msdyn_approval
msdyn_timegroup_msdyn_bookingalerts msdyn_bookingalert regardingobjectid_msdyn_timegroup_msdyn_bookingalert
msdyn_timegroup_PhoneCalls phonecall regardingobjectid_msdyn_timegroup_phonecall
msdyn_timegroup_PrincipalObjectAttributeAccesses principalobjectattributeaccess objectid_msdyn_timegroup
msdyn_timegroup_ProcessSession processsession regardingobjectid_msdyn_timegroup
msdyn_timegroup_QueueItems queueitem objectid_msdyn_timegroup
msdyn_timegroup_RecurringAppointmentMasters recurringappointmentmaster regardingobjectid_msdyn_timegroup_recurringappointmentmaster
msdyn_timegroup_ServiceAppointments serviceappointment regardingobjectid_msdyn_timegroup_serviceappointment
msdyn_timegroup_SharePointDocumentLocations sharepointdocumentlocation regardingobjectid_msdyn_timegroup
msdyn_timegroup_SocialActivities socialactivity regardingobjectid_msdyn_timegroup_socialactivity
msdyn_timegroup_SyncErrors syncerror regardingobjectid_msdyn_timegroup
msdyn_timegroup_Tasks task regardingobjectid_msdyn_timegroup_task


The following operations can be used with the msdyn_timegroup entity type.

Name Binding
GrantAccess Not Bound
IsValidStateTransition Not Bound
ModifyAccess Not Bound
RetrievePrincipalAccess Not Bound
RetrieveSharedPrincipalsAndAccess Not Bound
RevokeAccess Not Bound


The following solutions include the msdyn_timegroup entity type.

Name Description
Universal Resource Scheduling The Universal Resource Scheduling solution provides the infrastructure to express resource requirements for any entity in the system and help staff those requirements with resources based on the availability and applicability of the resource for the requirement.

See also