Microsoft KB Archive/929986

From BetaArchive Wiki
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
Knowledge Base


Description of how to use the SetState messages to update the status reason attributes of a business entity in Microsoft Dynamics CRM 3.0

Article ID: 929986

Article Last Modified on 12/27/2006



APPLIES TO

  • Microsoft Dynamics CRM 3.0



INTRODUCTION

This article describes how to use the SetState messages to update the status reason attributes of a business entity in Microsoft Dynamics CRM.

MORE INFORMATION

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.

Keywords: kbhowto kbinfo kbmbsmigrate KB929986