In Microsoft Dynamics CRM 3.0, new messages are introduced in the Microsoft Dynamics CRM Web service. These messages let you set the state of a business entity and are known as SetState messages. An example of a SetState message is the SetStateOpportunity message.
When you use a SetState message in the Microsoft Dynamics CRM Web service to change the state of an entity, the status reason attributes of the entity is updated to a value that is valid for the given state code of the entity. You can specify a specific status reason code. Or, you can let Microsoft Dynamics CRM set the status reason to a default status reason.
If you want to update the status reason attributes of an entity without changing the state of the entity, you should not use the SetState messages to update the status reason attributes. When the code is ran without any errors, the status reason attributes are not changed if the state of the entity is not changed. To update the status reason attributes of an entity without changing the state of the entity, you can use one of the following methods:
- Use the Update method of the Microsoft Dynamics CRM Web service.
- Use the Update message together with one of the Target entity objects.
Note The status reason attributes must be updated to a value that is valid for the state code of the entity.