ResourceSpec (resource specification) entity messages and methods
Applies To: Dynamics CRM 2013
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 |
|---|---|
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 ResourceSpec entity metadata. You can find this information in the metadata for your organization. See the preceding metadata browser information. |
|
Creates a resource specification. You can also call the IOrganizationService.Create method. |
|
Deletes a resource specification. You can also call the IOrganizationService.Delete method. |
|
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 ResourceSpec entity metadata. You can find this information in the metadata for your organization. See the preceding metadata browser information. |
|
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. |
|
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. |
|
Retrieves a resource specification. You can also call the IOrganizationService.Retrieve method. |
|
Retrieves a collection of resource specifications. You can also call the IOrganizationService.RetrieveMultiple method. |
|
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
ResourceSpec (resource specification) entity privileges
ResourceGroup (scheduling group) entity messages and methods