msdyn_resourcerequirement EntityType

Entity used to track the high-level information about resource requirements.

Entity Set Path
[organization URI]/api/data/v9.0/msdyn_resourcerequirements
Base Type
Display Name
Resource Requirement
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

Date and time when the record was created.

Display Name: Created On

Read Only
exchangerate Edm.Decimal

Exchange rate for the currency associated with the entity with respect to the base currency.

Display Name: Exchange Rate

Read Only
importsequencenumber Edm.Int32

Sequence number of the import that created this record.

Display Name: Import Sequence Number

modifiedon Edm.DateTimeOffset

Date and time when the record was modified.

Display Name: Modified On

Read Only
msdyn_allocationmethod Edm.Int32

Select the allocation method to be used for creating requirement distribution over a time period.

Display Name: Allocation Method

Default Options
Value Label
192350000 None
192350001 Full capacity
192350004 Percentage capacity
192350003 Distribute evenly
192350005 Front load
msdyn_calendarid Edm.String

The calendar that will be used for a resource requirement

Display Name: Calendar Id

msdyn_city Edm.String

Type the city where the resource is required.

Display Name: City

msdyn_costprice Edm.Decimal

Enter the cost price of the resource required.

Display Name: Cost Price

msdyn_costprice_base Edm.Decimal

Value of the Cost Price in base currency.

Display Name: Cost Price (Base)

Read Only
msdyn_country Edm.String

Type the country/region where the resource is required.

Display Name: Country/Region

msdyn_duration Edm.Int32

Duration of total minutes required

Display Name: Duration

msdyn_effort Edm.Decimal

Effort that's required from resource capacity

Display Name: Effort

msdyn_fromdate Edm.DateTimeOffset

Display Name: From Date

msdyn_fulfilledduration Edm.Int32

The fulfilled duration, in minutes.

Display Name: Fulfilled Duration

msdyn_fulfilledhours Edm.Decimal

Enter the hours fulfilled against requirement when the requirement status is fulfilled.

Display Name: Fulfilled Hours (Deprecated)

msdyn_hours Edm.Decimal

Enter the number of hours for which a requirement is required.

Display Name: Hours (Deprecated)

msdyn_internalflags Edm.String

For internal use only.

Display Name: Internal Flags

msdyn_isprimary Edm.Boolean

Display Name: Is Primary

Default Options
Value Label
1 Yes
0 No
msdyn_istemplate Edm.Boolean

Is template requirement

Display Name: Is Template

Default Options
Value Label
1 Yes
0 No
msdyn_latitude Edm.Double

The latitude to use for the location of a requirement.

Display Name: Latitude

msdyn_longitude Edm.Double

The longitude to use for the location of a requirement.

Display Name: Longitude

msdyn_name Edm.String

The name of the custom entity.

Display Name: Name

msdyn_percentage Edm.Decimal

Enter the percentage of the calendar capacity required.

Display Name: Percentage

msdyn_pooltype Edm.String

Display Name: Pool Type

msdyn_proposedduration Edm.Int32

Display Name: Proposed Duration

msdyn_quantity Edm.Decimal

Enter the number of resources required.

Display Name: Quantity (Deprecated in v3.0)

msdyn_remainingduration Edm.Int32

Display Name: Remaining Duration

msdyn_requeststatus Edm.String

The status of the resource request associated with this requirement.

Display Name: Request Status

msdyn_requirementgroupcontrolviewid Edm.String

The requirement group control view id of the resource requirement entity. This field will has value only when the entity is inside the requirement group control.

Display Name: Requirement Group Control View Id

msdyn_resourcerequirementid Edm.Guid

Unique identifier for entity instances

Display Name: Resource Requirement

msdyn_resourcetype Edm.String

Display Name: Resource Type

msdyn_sortoptions Edm.String

Sort option string field of resource requirement

Display Name: Sort Options

msdyn_stateorprovince Edm.String

Type the state/province where the resource is required.

Display Name: State/Province

msdyn_templaterequirementid Edm.String

template requirement id if requirement is created from template

Display Name: Template Requirement Id

msdyn_timefrompromised Edm.DateTimeOffset

Enter the starting range of the time promised to the account that incidents will be resolved.

Display Name: Time From Promised

msdyn_timetopromised Edm.DateTimeOffset

Enter the ending range of the time promised to the account that incidents will be resolved.

Display Name: Time To Promised

msdyn_timewindowend Edm.DateTimeOffset

Display Name: Time Window End

msdyn_timewindowstart Edm.DateTimeOffset

Display Name: Time Window Start

msdyn_todate Edm.DateTimeOffset

End date of requirement period

Display Name: To Date

msdyn_type Edm.Int32

Select the type of resource requirement.

Display Name: Type

Default Options
Value Label
192350000 New
192350001 Extend
msdyn_worklocation Edm.Int32

Display Name: Work Location

Default Options
Value Label
690970000 Onsite
690970001 Facility
690970002 Location Agnostic
overriddencreatedon Edm.DateTimeOffset

Date and time that the record was migrated.

Display Name: Record Created On

statecode Edm.Int32

Status of the Resource Requirement

Display Name: Status

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

Reason for the status of the Resource Requirement

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

utcconversiontimezonecode Edm.Int32

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

Unique identifier of the delegate user who created the record.

_modifiedby_value modifiedby

Unique identifier of the user who modified the record.

_modifiedonbehalfby_value modifiedonbehalfby

Unique identifier of the delegate user who modified the record.

_msdyn_appointmentrequirementid_value createdby

Unique identifier for Appointment associated with Resource Requirement.

_msdyn_bookingsetupmetadataid_value msdyn_BookingSetupMetadataId

A unique identifier for the booking setup metadata that is associated with a resource requirement.

_msdyn_priority_value msdyn_Priority

Priority of the requirement. To be taken into consideration while scheduling resources

_msdyn_projectid_value msdyn_projectid

Select the project for which the resource is required.

_msdyn_requirementgroupid_value msdyn_requirementgroupid

Requirement Group

_msdyn_requirementrelationshipid_value msdyn_requirementrelationshipid

Requirement Relationship

_msdyn_roleid_value msdyn_roleid

Select the required role.

_msdyn_status_value msdyn_Status

Requirement Status

_msdyn_territory_value msdyn_Territory
_msdyn_timegroup_value msdyn_TimeGroup
_msdyn_workhourtemplate_value msdyn_workhourtemplate

The working hours for a requirement.

_msdyn_workorder_value msdyn_WorkOrder

Unique identifier for Work Order associated with Resource Requirement.

_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.

_transactioncurrencyid_value transactioncurrencyid

Unique identifier of the currency associated with the entity.

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_resourcerequirement_createdby
createdonbehalfby systemuser lk_msdyn_resourcerequirement_createdonbehalfby
modifiedby systemuser lk_msdyn_resourcerequirement_modifiedby
modifiedonbehalfby systemuser lk_msdyn_resourcerequirement_modifiedonbehalfby
msdyn_AppointmentRequirementId appointment msdyn_appointment_msdyn_resourcerequirement
msdyn_BookingSetupMetadataId msdyn_bookingsetupmetadata msdyn_msdyn_bookingsetupmetadata_msdyn_resource
msdyn_Priority msdyn_priority msdyn_msdyn_priority_msdyn_resourcerequirement_Priority
msdyn_projectid msdyn_project msdyn_project_resourcerequirement
msdyn_roleid bookableresourcecategory msdyn_bookableresourcecategory_resourcerequirement
msdyn_Status msdyn_requirementstatus msdyn_requirementstatus_resourcerequirement_status
msdyn_Territory territory msdyn_territory_msdyn_resourcerequirement_Territory
msdyn_TimeGroup msdyn_timegroup msdyn_msdyn_timegroup_msdyn_resourcerequirement_TimeGroup
msdyn_workhourtemplate msdyn_workhourtemplate msdyn_workhourtemplate_msdyn_resourcerequirement_workhourtemplate
msdyn_WorkOrder msdyn_workorder msdyn_msdyn_workorder_msdyn_resourcerequirement_WorkOrder
ownerid principal owner_msdyn_resourcerequirement
owningbusinessunit businessunit business_unit_msdyn_resourcerequirement
owningteam team team_msdyn_resourcerequirement
owninguser systemuser user_msdyn_resourcerequirement
transactioncurrencyid transactioncurrency TransactionCurrency_msdyn_resourcerequirement

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_resourcerequirement_msdyn_requirementcharacteristic_RequirementSystemUse msdyn_requirementcharacteristic msdyn_RequirementSystemUse
msdyn_msdyn_resourcerequirement_msdyn_workorderincident_ResourceRequirement msdyn_workorderincident msdyn_ResourceRequirement
msdyn_resourcerequirement_Annotations annotation objectid_msdyn_resourcerequirement
msdyn_resourcerequirement_AsyncOperations asyncoperation regardingobjectid_msdyn_resourcerequirement
msdyn_resourcerequirement_bookableresource bookableresource msdyn_resourcerequirement_bookableresource
msdyn_resourcerequirement_bookableresourcebooking_ResourceRequirement bookableresourcebooking msdyn_ResourceRequirement
msdyn_resourcerequirement_bookableresourcebookingheader_ResourceRequirement bookableresourcebookingheader msdyn_ResourceRequirement
msdyn_resourcerequirement_bookingheader bookableresourcebookingheader msdyn_resourcerequirement_bookingheader
msdyn_resourcerequirement_BulkDeleteFailures bulkdeletefailure regardingobjectid_msdyn_resourcerequirement
msdyn_resourcerequirement_characteristicreq msdyn_characteristicreqforteammember msdyn_resourcerequirementid
msdyn_resourcerequirement_details msdyn_resourcerequirementdetail msdyn_resourcerequirementid
msdyn_resourcerequirement_DuplicateBaseRecord duplicaterecord baserecordid_msdyn_resourcerequirement
msdyn_resourcerequirement_DuplicateMatchingRecord duplicaterecord duplicaterecordid_msdyn_resourcerequirement
msdyn_resourcerequirement_MailboxTrackingFolders mailboxtrackingfolder regardingobjectid_msdyn_resourcerequirement
msdyn_resourcerequirement_PrincipalObjectAttributeAccesses principalobjectattributeaccess objectid_msdyn_resourcerequirement
msdyn_resourcerequirement_ProcessSession processsession regardingobjectid_msdyn_resourcerequirement
msdyn_resourcerequirement_projectteam msdyn_projectteam msdyn_resourcerequirementid
msdyn_resourcerequirement_request msdyn_resourcerequest msdyn_resourcerequirementid
msdyn_resourcerequirement_requirementcharacteristic_resourcerequirement msdyn_requirementcharacteristic msdyn_ResourceRequirement
msdyn_resourcerequirement_requirementorganizationunit_ResourceRequirement msdyn_requirementorganizationunit msdyn_ResourceRequirement
msdyn_resourcerequirement_requirementresourcecategory_resourcerequirement msdyn_requirementresourcecategory msdyn_ResourceRequirement
msdyn_resourcerequirement_requirementresourcepreference_ResourceRequirement msdyn_requirementresourcepreference msdyn_ResourceRequirement
msdyn_resourcerequirement_SyncErrors syncerror regardingobjectid_msdyn_resourcerequirement
msdyn_resourcerequirement_systemuser systemuser msdyn_resourcerequirement_systemuser


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

Name Binding
GrantAccess Not Bound
IsValidStateTransition Not Bound
ModifyAccess Not Bound
msdyn_AcceptProposedBooking Entity
msdyn_createrequestfromrequirement Entity
msdyn_updateremainingresourcerequirement Entity
RetrievePrincipalAccess Not Bound
RetrieveSharedPrincipalsAndAccess Not Bound
RevokeAccess Not Bound


The following solutions include the msdyn_resourcerequirement entity type.

Name Description
Field Service Microsoft Dynamics 365 for Field Service allows organizations of any size to deliver intelligent, world class field service, managing all aspects of the end-to-end field service management cycle. Features include scheduling, mobile, asset management, inventory control, customer notifications, and resource utilization controls that help maximize efficiency and minimize costs.
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.
Project Service Automation Microsoft Dynamics 365 for Project Service Automation is an end-to-end solution that helps sales and delivery teams engage customers and deliver billable projects on time and within budget. Project Service gives you the tools you need to: Estimate, quote, and contract work; Plan and assign resources; Enable team collaboration; Capture time, expense, and progress data for real-time insights and accurate invoicing.

See also