Edit

Share via

Read Tracker (msdyn_readtracker) table/entity reference (Microsoft Dynamics 365)

  • Article

Keeps track of the records read by an user in the system

Messages

The following table lists the messages for the Read Tracker (msdyn_readtracker) table. Messages represent operations that can be performed on the table. They may also be events.

Name
Is Event?		 Web API Operation SDK for .NET
Assign
Event: True		 PATCH /msdyn_readtrackers(msdyn_readtrackerid)
Update the ownerid property.		 AssignRequest
Associate
Event: True		 Associate records Associate records
BulkRetain
Event: True		 BulkRetain Learn to use messages with the SDK for .NET
Create
Event: True		 POST /msdyn_readtrackers
See Create		 Create records
CreateMultiple
Event: True		 CreateMultiple CreateMultipleRequest
Delete
Event: True		 DELETE /msdyn_readtrackers(msdyn_readtrackerid)
See Delete		 Delete records
DeleteMultiple
Event: True		 DeleteMultiple Learn to use messages with the SDK for .NET
Disassociate
Event: True		 Disassociate records Disassociate records
PurgeRetainedContent
Event: True		 PurgeRetainedContent Learn to use messages with the SDK for .NET
Retain
Event: True		 Retain Learn to use messages with the SDK for .NET
Retrieve
Event: True		 GET /msdyn_readtrackers(msdyn_readtrackerid)
See Retrieve		 Retrieve records
RetrieveEntityChanges
Event: True		 RetrieveEntityChangesRequest
RetrieveMultiple
Event: True		 GET /msdyn_readtrackers
See Query data		 Query data
RetrievePrincipalAccess
Event: True		 RetrievePrincipalAccess RetrievePrincipalAccessRequest
RollbackRetain
Event: True		 RollbackRetain Learn to use messages with the SDK for .NET
Update
Event: True		 PATCH /msdyn_readtrackers(msdyn_readtrackerid)
See Update		 Update records
UpdateMultiple
Event: True		 UpdateMultiple UpdateMultipleRequest
Upsert
Event: True		 PATCH /msdyn_readtrackers(msdyn_readtrackerid)
See Upsert a table row		 UpsertRequest
UpsertMultiple
Event: True		 UpsertMultiple UpsertMultipleRequest
ValidateRetentionConfig
Event: True		 ValidateRetentionConfig Learn to use messages with the SDK for .NET

Properties

The following table lists selected properties for the Read Tracker (msdyn_readtracker) table.

Property Value
DisplayName Read Tracker
DisplayCollectionName Read Trackers
SchemaName msdyn_readtracker
CollectionSchemaName msdyn_readtrackers
EntitySetName msdyn_readtrackers
LogicalName msdyn_readtracker
LogicalCollectionName msdyn_readtrackers
PrimaryIdAttribute msdyn_readtrackerid
PrimaryNameAttribute msdyn_name
TableType Elastic
OwnershipType UserOwned

Writable columns/attributes

These columns/attributes return true for either IsValidForCreate or IsValidForUpdate (usually both). Listed by SchemaName.

ImportSequenceNumber

Property Value
Description Sequence number of the import that created this record.
DisplayName Import Sequence Number
IsValidForForm False
IsValidForRead True
LogicalName importsequencenumber
RequiredLevel None
Type Integer
MaxValue 2147483647
MinValue -2147483648

msdyn_LastReadOn

Property Value
Description Date and time when the record was last read by an user.
DisplayName LastReadOn
IsValidForForm True
IsValidForRead True
LogicalName msdyn_lastreadon
RequiredLevel None
Type DateTime
CanChangeDateTimeBehavior False
DateTimeBehavior UserLocal
Format DateAndTime
ImeMode Auto
SourceTypeMask 0

msdyn_Name

Property Value
Description The name of the read tracker record
DisplayName Name
IsValidForForm True
IsValidForRead True
LogicalName msdyn_name
RequiredLevel ApplicationRequired
Type String
Format Text
FormatName Text
ImeMode Auto
IsLocalizable False
MaxLength 100

msdyn_ReadStatus

Property Value
Description Whether a record is read or unread by the user
DisplayName ReadStatus
IsValidForForm True
IsValidForRead True
LogicalName msdyn_readstatus
RequiredLevel None
Type Picklist
DefaultFormValue 100000001
GlobalChoiceName msdyn_readtracker_msdyn_readstatus

msdyn_ReadStatus Choices/Options

Value Label
0 UnRead
1 Read

msdyn_readtrackerId

Property Value
Description Unique identifier for the read tracking record
DisplayName Read Tracker
IsValidForForm False
IsValidForRead True
LogicalName msdyn_readtrackerid
RequiredLevel SystemRequired
Type Uniqueidentifier

msdyn_RegardingObjectId

Property Value
Description Regarding Object
DisplayName Regarding Object
IsValidForForm True
IsValidForRead True
LogicalName msdyn_regardingobjectid
RequiredLevel SystemRequired
Type Lookup
Targets activitypointer, email, incident, msdyn_ocliveworkitem, task

msdyn_RegardingObjectIdSerialized

Property Value
Description String representation of Regarding Object Entity Reference
DisplayName Regarding Object Serialized
IsValidForForm True
IsValidForRead True
LogicalName msdyn_regardingobjectidserialized
RequiredLevel SystemRequired
Type String
Format Text
FormatName Text
ImeMode Auto
IsLocalizable False
MaxLength 200

msdyn_RegardingObjectIdType

Property Value
Description
DisplayName
IsValidForForm False
IsValidForRead True
LogicalName msdyn_regardingobjectidtype
RequiredLevel None
Type EntityName

msdyn_UserId

Property Value
Description Unique identifier of the user who read or unread the record.
DisplayName User
IsValidForForm True
IsValidForRead True
LogicalName msdyn_userid
RequiredLevel SystemRequired
Type Lookup
Targets systemuser

OverriddenCreatedOn

Property Value
Description Date and time that the record was migrated.
DisplayName Record Created On
IsValidForForm False
IsValidForRead True
LogicalName overriddencreatedon
RequiredLevel None
Type DateTime
CanChangeDateTimeBehavior False
DateTimeBehavior UserLocal
Format DateOnly
ImeMode Inactive
SourceTypeMask 0

OwnerId

Property Value
Description Owner Id
DisplayName Owner
IsValidForForm True
IsValidForRead True
LogicalName ownerid
RequiredLevel SystemRequired
Type Owner
Targets systemuser, team

OwnerIdType

Property Value
Description Owner Id Type
DisplayName
IsValidForForm False
IsValidForRead True
LogicalName owneridtype
RequiredLevel SystemRequired
Type EntityName

PartitionId

Property Value
Description Logical partition id. A logical partition consists of a set of records with same partition id.
DisplayName Partition Id
IsValidForForm True
IsValidForRead True
LogicalName partitionid
RequiredLevel None
Type String
Format Text
FormatName Text
ImeMode Auto
IsLocalizable False
MaxLength 100

TTLInSeconds

Property Value
Description Time to live in seconds.
DisplayName Time to live
IsValidForForm True
IsValidForRead True
LogicalName ttlinseconds
RequiredLevel None
Type Integer
MaxValue 2147483647
MinValue 1

Read-only columns/attributes

These columns/attributes return false for both IsValidForCreate and IsValidForUpdate. Listed by SchemaName.

CreatedBy

Property Value
Description Unique identifier of the user who created the record.
DisplayName Created By
IsValidForForm True
IsValidForRead True
LogicalName createdby
RequiredLevel None
Type Lookup
Targets systemuser

CreatedOn

Property Value
Description Date and time when the record was created.
DisplayName Created On
IsValidForForm True
IsValidForRead True
LogicalName createdon
RequiredLevel None
Type DateTime
CanChangeDateTimeBehavior False
DateTimeBehavior UserLocal
Format DateAndTime
ImeMode Inactive
SourceTypeMask 0

CreatedOnBehalfBy

Property Value
Description Unique identifier of the delegate user who created the record.
DisplayName Created By (Delegate)
IsValidForForm True
IsValidForRead True
LogicalName createdonbehalfby
RequiredLevel None
Type Lookup
Targets systemuser

ModifiedBy

Property Value
Description Unique identifier of the user who modified the record.
DisplayName Modified By
IsValidForForm True
IsValidForRead True
LogicalName modifiedby
RequiredLevel None
Type Lookup
Targets systemuser

ModifiedOn

Property Value
Description Date and time when the record was modified.
DisplayName Modified On
IsValidForForm True
IsValidForRead True
LogicalName modifiedon
RequiredLevel None
Type DateTime
CanChangeDateTimeBehavior False
DateTimeBehavior UserLocal
Format DateAndTime
ImeMode Inactive
SourceTypeMask 0

ModifiedOnBehalfBy

Property Value
Description Unique identifier of the delegate user who modified the record.
DisplayName Modified By (Delegate)
IsValidForForm True
IsValidForRead True
LogicalName modifiedonbehalfby
RequiredLevel None
Type Lookup
Targets systemuser

OwnerIdName

Property Value
Description Name of the owner
DisplayName
IsValidForForm False
IsValidForRead True
LogicalName owneridname
RequiredLevel SystemRequired
Type String
Format Text
FormatName Text
ImeMode Auto
IsLocalizable False
MaxLength 100

OwnerIdYomiName

Property Value
Description Yomi name of the owner
DisplayName
IsValidForForm False
IsValidForRead True
LogicalName owneridyominame
RequiredLevel SystemRequired
Type String
Format Text
FormatName Text
ImeMode Auto
IsLocalizable False
MaxLength 100

OwningBusinessUnit

Property Value
Description Unique identifier for the business unit that owns the record
DisplayName Owning Business Unit
IsValidForForm True
IsValidForRead True
LogicalName owningbusinessunit
RequiredLevel None
Type Lookup
Targets businessunit

OwningTeam

Property Value
Description Unique identifier for the team that owns the record.
DisplayName Owning Team
IsValidForForm False
IsValidForRead True
LogicalName owningteam
RequiredLevel None
Type Lookup
Targets team

OwningUser

Property Value
Description Unique identifier for the user that owns the record.
DisplayName Owning User
IsValidForForm False
IsValidForRead True
LogicalName owninguser
RequiredLevel None
Type Lookup
Targets systemuser

VersionNumber

Property Value
Description Version Number
DisplayName Version Number
IsValidForForm False
IsValidForRead True
LogicalName versionnumber
RequiredLevel None
Type BigInt
MaxValue 9223372036854775807
MinValue -9223372036854775808

Many-to-One relationships

These relationships are many-to-one. Listed by SchemaName.

business_unit_msdyn_readtracker

One-To-Many Relationship: businessunit business_unit_msdyn_readtracker

Property Value
ReferencedEntity businessunit
ReferencedAttribute businessunitid
ReferencingAttribute owningbusinessunit
ReferencingEntityNavigationPropertyName owningbusinessunit
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

lk_msdyn_readtracker_createdby

One-To-Many Relationship: systemuser lk_msdyn_readtracker_createdby

Property Value
ReferencedEntity systemuser
ReferencedAttribute systemuserid
ReferencingAttribute createdby
ReferencingEntityNavigationPropertyName createdby
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

lk_msdyn_readtracker_createdonbehalfby

One-To-Many Relationship: systemuser lk_msdyn_readtracker_createdonbehalfby

Property Value
ReferencedEntity systemuser
ReferencedAttribute systemuserid
ReferencingAttribute createdonbehalfby
ReferencingEntityNavigationPropertyName createdonbehalfby
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

lk_msdyn_readtracker_modifiedby

One-To-Many Relationship: systemuser lk_msdyn_readtracker_modifiedby

Property Value
ReferencedEntity systemuser
ReferencedAttribute systemuserid
ReferencingAttribute modifiedby
ReferencingEntityNavigationPropertyName modifiedby
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

lk_msdyn_readtracker_modifiedonbehalfby

One-To-Many Relationship: systemuser lk_msdyn_readtracker_modifiedonbehalfby

Property Value
ReferencedEntity systemuser
ReferencedAttribute systemuserid
ReferencingAttribute modifiedonbehalfby
ReferencingEntityNavigationPropertyName modifiedonbehalfby
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

msdyn_msdyn_readtracker_systemuser

One-To-Many Relationship: systemuser msdyn_msdyn_readtracker_systemuser

Property Value
ReferencedEntity systemuser
ReferencedAttribute systemuserid
ReferencingAttribute msdyn_userid
ReferencingEntityNavigationPropertyName msdyn_userId
IsHierarchical
CascadeConfiguration Archive: RemoveLink
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

msdyn_readtracker_poly_activitypointer

One-To-Many Relationship: activitypointer msdyn_readtracker_poly_activitypointer

Property Value
ReferencedEntity activitypointer
ReferencedAttribute activityid
ReferencingAttribute msdyn_regardingobjectid
ReferencingEntityNavigationPropertyName msdyn_RegardingObjectId
IsHierarchical
CascadeConfiguration Archive: RemoveLink
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

msdyn_readtracker_poly_email

One-To-Many Relationship: email msdyn_readtracker_poly_email

Property Value
ReferencedEntity email
ReferencedAttribute activityid
ReferencingAttribute msdyn_regardingobjectid
ReferencingEntityNavigationPropertyName msdyn_RegardingObjectId
IsHierarchical
CascadeConfiguration Archive: RemoveLink
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

msdyn_readtracker_poly_incident

One-To-Many Relationship: incident msdyn_readtracker_poly_incident

Property Value
ReferencedEntity incident
ReferencedAttribute incidentid
ReferencingAttribute msdyn_regardingobjectid
ReferencingEntityNavigationPropertyName msdyn_RegardingObjectId
IsHierarchical
CascadeConfiguration Archive: RemoveLink
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

msdyn_readtracker_poly_msdyn_ocliveworkitem

One-To-Many Relationship: msdyn_ocliveworkitem msdyn_readtracker_poly_msdyn_ocliveworkitem

Property Value
ReferencedEntity msdyn_ocliveworkitem
ReferencedAttribute activityid
ReferencingAttribute msdyn_regardingobjectid
ReferencingEntityNavigationPropertyName msdyn_RegardingObjectId
IsHierarchical
CascadeConfiguration Archive: RemoveLink
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

msdyn_readtracker_poly_task

One-To-Many Relationship: task msdyn_readtracker_poly_task

Property Value
ReferencedEntity task
ReferencedAttribute activityid
ReferencingAttribute msdyn_regardingobjectid
ReferencingEntityNavigationPropertyName msdyn_RegardingObjectId
IsHierarchical
CascadeConfiguration Archive: RemoveLink
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

owner_msdyn_readtracker

One-To-Many Relationship: owner owner_msdyn_readtracker

Property Value
ReferencedEntity owner
ReferencedAttribute ownerid
ReferencingAttribute ownerid
ReferencingEntityNavigationPropertyName ownerid
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

team_msdyn_readtracker

One-To-Many Relationship: team team_msdyn_readtracker

Property Value
ReferencedEntity team
ReferencedAttribute teamid
ReferencingAttribute owningteam
ReferencingEntityNavigationPropertyName owningteam
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

user_msdyn_readtracker

One-To-Many Relationship: systemuser user_msdyn_readtracker

Property Value
ReferencedEntity systemuser
ReferencedAttribute systemuserid
ReferencingAttribute owninguser
ReferencingEntityNavigationPropertyName owninguser
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

See also

Dataverse table/entity reference
Dataverse Web API Reference