ActiveADAPTER adds Active Directory features to
BizTalk Server natively and securely...”

Frequently Asked Questions

Product

What is ActiveADAPTER?

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

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

What versions of Microsoft BizTalk Server does ActiveADAPTER support?

Can we purchase components of the ActiveADAPTER BizTalk Accelerator separately?

Is there a version of ActiveADAPTER for BizTalk 2006?

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

Technical

Which properties of Active Directory objects can ActiveADAPTER modify?

Can ActiveADAPTER help me retrieve information from Active Directory?

Does ActiveADAPTER supply the schemas I will need?

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

Can I use ActiveADAPTER components in multiple BizTalk applications?

What version of the .NET framework does ActiveADAPTER require?

Can I use the ActiveADAPTER Send Adapter with dynamic ports?

What transactional strategy does the ActiveADAPTER Send Adapter use?

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

 Product FAQ

What is ActiveADAPTER?

ActiveADAPTER is a set of BizTalk adapters for working with Active Directory from BizTalk Server.

It consists of:

  • 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

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, 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.

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.

What versions of Microsoft BizTalk Server does ActiveADAPTER support?

Microsoft BizTalk Server 2006 R2, 2009 and 2010.

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.

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.

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.

Technical FAQ

Which properties of Active Directory objects can ActiveADAPTER modify?

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 are not currently supported, our customization service can include these in your licensed product, usually without additional cost.

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.

Does ActiveADAPTER supply the schemas I will need?

Absolutely. They are installed to the ActiveADAPTER\Schemas folder.

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.

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.

What version of the .NET framework does ActiveADAPTER require?

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

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.

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.

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

Yes. The adapter will return any exceptions back to your application. Any retries or timeouts you configure will happen as normal for any send port or receive locations.

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 illustrates exception handing is included in the ActiveADAPTER Samples folder.

 
 
Got a question not answered here? Email us at:
questions@activeadapter.com



We take your privacy very seriously. All information is 100% confidential. ©2011 ActiveADAPTER.