ResourceSpec (resource specification) entity messages and methods

 

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

A resource specification contains the resource requirements for a service. Typically the resource specification includes a count of resources and exactly one reference to a resource group from which resources are selected. The required count attribute may be one (any of), more than one (n of), or all (all of) to indicate the number of group members required to perform this service. A resource specification also includes a binding objective described as an arithmetic expression (see Search Expressions in this topic) based on properties of group members or custom common language runtime (CLR) functions. This entity also specifies the effort required on each resource or the service cost that can vary over time. This is expressed as a calendar function. The schema name for this entity is ResourceSpec. To view the entity metadata for your organization, install the Metadata Browser solution described in Browse the metadata for your organization. You can also view the metadata for an uncustomized organization in the Excel file called EntityMetadata.xlsx included in the top-level folder of the SDK download.

The following table describes the messages for this entity, which you use with the IOrganizationService.Execute method.

Message

Description

AssociateRequest

Creates a link between a record and one or more records that participate in a relationship. You can also use the IOrganizationService.Associate method. For more information, see Actions on entity records. For a list of default relationships for this entity, see the ResourceSpec entity metadata. You can find this information in the metadata for your organization. See the preceding metadata browser information.

CreateRequest

Creates a resource specification. You can also call the IOrganizationService.Create method.

DeleteRequest

Deletes a resource specification. You can also call the IOrganizationService.Delete method.

DisassociateRequest

Removes a link between a record and one or more records that participate in a relationship. You can also use the IOrganizationService. Disassociate method. For more information, see Actions on entity records. For a list of default relationships for this entity, see the ResourceSpec entity metadata. You can find this information in the metadata for your organization. See the preceding metadata browser information.

InitializeFromRequest

Initializes a new record from an existing record provided that an attribute map is defined for the two entities. For more information, see Customize entity and attribute mappings.

RetrieveDuplicatesRequest

Detects and retrieves duplicate records for the specified record provided that duplicate detection is enabled and there are published duplicate detection rules for the entity. For more information, see Detect duplicate data.

RetrieveRequest

Retrieves a resource specification. You can also call the IOrganizationService.Retrieve method.

RetrieveMultipleRequest

Retrieves a collection of resource specifications. You can also call the IOrganizationService.RetrieveMultiple method.

UpdateRequest

Updates a resource specification. You can also call the IOrganizationService.Update method.

Search Expressions

The scheduling engine supports the following three search strategies specified in the ResourceSpec.ObjectiveExpression attribute:

  • Least Busy. From the list of resources that can perform that specific service, select the resource that is the least busy and is also available at the requested time.
  • Most Busy. From the list of resources that can perform that specific service, select the resource that is the busiest and is also available at the requested time.
  • Random. From the list of resources that can perform that specific service, select any resource that is available at the requested time.

See Also

Resource entities
Privileges by entity
ResourceGroup (scheduling group) entity messages and methods

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright