Contract entity messages and methods

 

Applies To: Dynamics CRM 2013

A contract is an agreement to provide customer service support during specified coverage dates or for a specified number of cases or length of time. When customers contact customer service, the level of support they receive is determined by their contract.

The schema name for this entity is Contract. 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
AssignRequest	Assigns a contract to another user or team.
CancelContractRequest	Cancels a contract.
CloneContractRequest	Copies a contract.
CreateRequest	Creates a contract. You can also call the IOrganizationService.Create method.
DeleteRequest	Deletes a contract. You can also call the IOrganizationService.Delete method.
GrantAccessRequest	Shares a contract with another security principal (user or team).
ModifyAccessRequest	Changes the access rights for a contract previously shared with another security principal (user or team).
RenewContractRequest	Renews a contract.
RetrieveRequest	Retrieves a contract. You can also call the IOrganizationService.Retrieve method.
RetrieveMultipleRequest	Retrieves a collection of contracts. You can also call the IOrganizationService.RetrieveMultiple method.
RetrievePrincipalAccessRequest	Retrieves the access the specified security principal (user or team) has to a contract.
RetrieveSharedPrincipalsAndAccessRequest	Retrieves the security principals (users or teams) that have access to a contract, together with their access rights to the contract.
RevokeAccessRequest	Removes all access to a contract for the specified security principal (user or team).
RollupRequest	Rolls up or retrieves all the contracts related to the specified account or contact.
SetStateRequest	Sets the state of a contract. If you are using early bound types, use the ContractState enumeration to set the possible states. 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.
UpdateRequest	Updates a contract. You can also call the IOrganizationService.Update method.

See Also

Contract entities
ContractDetail (contract line) entity messages and methods
Sample: Manage contracts
Contract entity privileges