Callout Configuration

banner art

The callout model requires configuration of callouts in an XML configuration file. You can specify a callout component to be associated with an entity and an event. For post-events, you can also specify the pre-image attribute set by listing the desired attributes.

Note If there are multiple callout components registered for a given entity and event, they are executed in the order as defined in the configuration file.

You are responsible for maintaining the configuration file and component assemblies. The configuration file must be put in this folder together with your assembly.

<installdir>\Program Files\Microsoft CRM\server\bin\assembly\callout.config.xml

Important   This folder should have its ACLs (security permissions) set to allow only local administrative access.

Determining which entity attributes can be used in a callout

To determine which entity attributes are valid for use as values in the callout configuration file, execute the following SQL query substituting your organization name where indicated. This SQL statement returns the attribute name and the entity name for customizable entities.

USE <organization>_METABASE
SELECT   attrib.[name] AS AttributeName, entity.[name] AS EntityName
FROM  dbo.attribute AS attrib
INNER JOIN dbo.entity AS entity
ON attrib.EntityId = entity.EntityId AND entity.IsCustomizable = 1
GROUP BY entity.[name],
HAVING (attrib.validforreadapi = 1 AND attrib.attributeof IS NULL)

Those attributes listed in the query results can be used as values for any callout event method.

Changing the callout configuration file

When you add or change your callout component configuration or DLLs you must perform the following steps:

  1. Reset Internet Information Services (IIS). To do this, click Start, click Run, type iisreset, and then click OK.
  2. Restart the Workflow Service.
  3. Restart the Bulk E-mail Service.

In This Topic

Configuration File Reference

Configuration File Errors

© 2007 Microsoft Corporation. All rights reserved.