Technical FAQ

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.

Back To Top

What is ActiveADAPTER?

ActiveADAPTER is a set of BizTalk adapters for working with Active Directory from BizTalk Server. We offer you:

  • A BizTalk Send Adapter that you can use to:
    • Create, move and delete Active Directory objects
    • Change object properties such as email addresses, office locations, home folder locations…
    • Set user passwords and add objects to security groups
  • A BizTalk Receive Adapter that you can use to query Active Directory and receive the results in an XML message into BizTalk Server
  • The input and output schemas for all ActiveADAPTER operations
  • Sample orchestrations and example XML input
  • Complete documentation

Back To Top

What Can I Do With 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.

Back To Top

What will ActiveADAPTER add to what I see in BizTalk Server?

After installing ActiveADAPTER you will see a new transport type option when configuring a send port or receive location. With BizTalk send ports, you can create, delete, rename, move, and modify Active Directory objects. With BizTalk receive locations, you can draw XML messages into BizTalk containing Active Directory query results.

On your Programs menu you will also have an ActiveADAPTER program group containing shortcuts to documentation, sample orchestrations and schemas to get you developing your solutions quickly.

Back To Top

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.

Back To Top

What versions of Microsoft BizTalk Server does ActiveADAPTER support?

Microsoft BizTalk Server 2006 R2 to 2013 R2.

Back To Top

Is there a version of ActiveADAPTER for BizTalk 2006?

An older version of ActiveADAPTER is available for BizTalk Server 2006, based on .NET 2.0. Please contact us if you are interested in evaluating this version.

Back To Top

Is there a WCF version of ActiveADAPTER?

Yes. ActiveADAPTER is available as a Windows Communication Foundation (WCF) service. So with or without BizTalk Server, you can query and update Active Directory with ActiveADAPTER

ActiveADAPTER WCF exposes essentially the same functionality as our Active Directory Send and Receive Adapters.

ActiveADAPTER WCF services can be consumed by BizTalk Server, but BizTalk Server is not required.

Like an evaluation? Get in touch through our contact page.

Back To Top

We are interested in purchasing ActiveADAPTER for use by government or government contractors. What are the export conditions for ActiveADAPTER?

ActiveADAPTER was originally developed by Equate IT, a company registered in Australia. All developers and consultants have Australian or US citizenship. More information can be found in the EULA displayed during installation of ActiveADAPTER.

Back To Top

Is the ability to create Solicit-Response ports that query Active Directory on demand part of the Receive Adapter or the Send Adapter?

Both. The query is sent out by the send adapter. The actual querying is done by components of the receive adapter. Therefore, to be licensed to create Solicit-Response send ports, you need to be licensed for both the ActiveADAPTER send and receive adapters.

Back To Top

Can we purchase components of the ActiveADAPTER BizTalk Accelerator separately?

Yes. Prices for individual components are included on our price list. Email salesinfo@activeadapter.com for more information.

Back To Top

Do you supply the schemas I will need?

Absolutely. A link to them is installed to the Programs menu in the ActiveADAPTER\Schemas folder.

Back To Top

What version of the .NET framework does ActiveADAPTER require?

.NET framework 3.5SP1. If it is not installed it can be easily downloaded and installed from Microsoft at:

http://www.microsoft.com/en-au/download/details.aspx?id=22

Back To Top

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.

Back To Top

Will the ActiveADAPTER Send Adapter return error information back to my orchestration?

Yes. The adapter will return any exceptions back to your application AFTER any retries you have configured have been done.

Within your orchestration you can use Scope shapes to catch exceptions. In your exception handlers you can retrieve the error description to determine which way to branch.

Sample orchestrations that illustrate exception handing are included in the ActiveADAPTER Samples folder.

Back To Top

Can ActiveADAPTER help me retrieve information from Active Directory?

Yes. The Active Directory Receive Adapter can be used to create a Receive Location that queries Active Directory at regular intervals and submit the results to your BizTalk application. A message can be submitted to BizTalk at every polling interval, or only when a change occurs in the query results (this is the “On Change Only” option on the Active Directory Receive Adapter property configuration).

In addition, the Active Directory Send Adapter can be used with a Solicit-Response Send Port to perform an on-demand query. You just send your query parameters to the send port in a message that conforms to the supplied schema, and receive your results back in a new message.

Back To Top

Can the Active Directory Receive Adapter help me build an orchestration that listens for changes to Active Directory?

Yes. The ON CHANGE ONLY option on the Active Directory Receive Adapter provides this feature. A message is submitted to your BizTalk application only when the results of the query you have specified change. This feature provides a great way to trigger orchestrations and keep information in your Enterprise Applications synchronized.

There is also a REAL-TIME mode that gets events from Active Directory asynchronously and submits them to BizTalk  as they happen.

Back To Top

Which properties of Active Directory objects can ActiveADAPTER modify?

Virtually all properties. ActiveADAPTER can update, add to, or clear all properties that are compatible with string, number and byte array data types. A number of special properties are also integrated – objectGUID and objectSid, for example. This covers virtually all the properties you can see using Active Directory Users and Computers.

If there are specific properties you wish to use that you are having trouble with, let us know!

Back To Top

What transactional strategy does the ActiveADAPTER Send Adapter use?

The Send Adapter commits changes per message and per object. This means commits cannot span messages. Within a message, changes to an object are all committed together. To ensure changes are all or nothing, therefore, the strategy you need to use is one message per object.

Back To Top

Can I use the ActiveADAPTER Send Adapter with dynamic send ports?

Yes. The Send Adapter is fully compatible with dynamic ports.

A sample orchestration showing the use of ActiveADAPTER with dynamic send ports is included in the ActiveADAPTER\Samples folder.

Back To Top

I have purchased an ActiveADAPTER license. How do I swap out the evaluation version for the licensed version?

To uninstall your evaluation version and replace it with your licensed version follow this procedure:

1. Stop any BizTalk applications and host instances that use ActiveADAPTER

2. Close any instances of the BizTalk Admin Console

3. Uninstall ActiveADAPTER through Control Panel

4. Check that the %ProgramFiles%\ActiveADAPTER folder has been  completely removed

5. Install your licensed software

In most cases this shouldn’t affect any receive location or send port settings you have created, but check your BizTalk applications after restarting them.

Back To Top

Latest News
BizTalk Server logo
BizTalk 2020 announced!
ActiveADAPTER will support the new version, which should be here in early 2020. Read more here.

Azure AD logo
ActiveADAPTER now for Azure AD!
Download it now!

Uloba logo
Uloba chooses ActiveADAPTER.

Thanks for visiting us at Integrate!

Integrate 2014 logo

Swedish Government Service Center logo
Swedish Governmental Service Center chooses ActiveADAPTER.

Royal Agricultural College logo
Royal Agricultural College uses ActiveADAPTER to automate management of its Active Directory Forest.
On YouTube