- My Solicit-Response Send Port Query Is Only Returning 1000 Results
- What is ActiveADAPTER?
- What Can I Do With ActiveADAPTER?
- What will ActiveADAPTER add to what I see in BizTalk Server?
- What is an example of how and why I might use ActiveADAPTER?
- What versions of Microsoft BizTalk Server does ActiveADAPTER support?
- Is there a version of ActiveADAPTER for BizTalk 2006?
- Is there a WCF version of ActiveADAPTER?
- We are interested in purchasing ActiveADAPTER for use by government or government contractors. What are the export conditions for ActiveADAPTER?
- Is the ability to create Solicit-Response ports that query Active Directory on demand part of the Receive Adapter or the Send Adapter?
- Can we purchase components of the ActiveADAPTER BizTalk Accelerator separately?
- Do you supply the schemas I will need?
- What version of the .NET framework does ActiveADAPTER require?
- Can I use ActiveADAPTER components in multiple BizTalk applications?
- Will the ActiveADAPTER Send Adapter return error information back to my orchestration?
- Can ActiveADAPTER help me retrieve information from Active Directory?
- Can the Active Directory Receive Adapter help me build an orchestration that listens for changes to Active Directory?
- Which properties of Active Directory objects can ActiveADAPTER modify?
- What transactional strategy does the ActiveADAPTER Send Adapter use?
- Can I use the ActiveADAPTER Send Adapter with dynamic send ports?
- I have purchased an ActiveADAPTER license. How do I swap out the evaluation version for the licensed version?
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.
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
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.
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.
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 to 2013 R2.
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.
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.
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.
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.
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.
Do you supply the schemas I will need?
Absolutely. A link to them is installed to the Programs menu in the ActiveADAPTER\Schemas folder.
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:
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.
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.
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.
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.
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!
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.
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.
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.