When developing a query through a Solicit-Response port you get the error: “An error occurred while parsing EntityName”

This error is caused if you include an ampersand directly in your query string. If you build queries in ADSIEdit they might look like:

(&(objectCategory=user)(sAMAccountName=Jane))

The “&” character is not allowed in XML. Instead use “&”

For example:

<Directives WhereToBind="LDAP://DC2008R2/CN=Users,DC=test,DC=com" SearchScope="onelevel" Filter="(&amp;(objectCategory=user)(sAMAccountName=Jane))" PropertiesToReturn="distinguishedName"/>

FAQs
Can I use ActiveADAPTER components in multiple BizTalk applications?

Yes. Once installed, ActiveADAPTER Active Directory Send and Receive Adapters will be an available option for all Send Ports and Receive Locations.

See the entire answer

What is an example of how and why I might use ActiveADAPTER?

Here is an example of one of dozens of high ROI BizTalk applications you can build with ActiveADAPTER.

Suppose Jane is a new hire in your organization.

At the end of the hiring process, HR notify IT operations of Jane's start date. A member of IT Operations (with no Active Directory knowledge) goes to your Service Desk system, raises a new ticket, and completes a simple form about Jane's role in your organisation.

From the information entered, the Service Desk system creates an xml file and submits it to BizTalk. BizTalk uses the information in the message and ActiveADAPTER to:

  • create Jane's Active Directory account
  • synchronize Jane's Active Directory telephone numbers, office location, and Manager's name from the information in HR system entered during the recruitment process
  • set a first-use password for Jane and specify that it must be changed on first logon
  • grant Jane access to the resources she will need by placing her in a number of security groups

On Jane's first day BizTalk uses ActiveADAPTER to enable Jane's account and emails the first-use password to her Manager at 8am.

On arrival, Jane is given her first-use password and logs on with access to everything she needs.

See the entire answer

My Solicit-Response Send Port Query Is Only Returning 1000 Results

Try adding the setting PageSize="1000" to your query parameters. For example:

<ActiveDirectoryQuery><Directives WhereToBind="LDAP://CN=Users, DC=test, DC=com" Filter="(objectCategory=user)" SearchScope="onelevel" PropertiesToReturn="cn" PageSize="1000"/></ActiveDirectoryQuery>

By default Active Directory only allows for a single page of 1000 results. By explicitly setting this value multiple pages (and hence all results) are returned.

See the entire answer