How do I update object properties that don’t take strings?

Use the optional DataType property in your update message with the hex setting to specify your data as hexadecimal. For example:

ChangeToValue="F0-F1-F2-F3" DataType="hex"

Your hex data can contain no spaces (“F0F1F2F3“), or be separated with spaces or hyphens (“F0 F1 F2 F3” or “F0-F1-F2-F3“).

If you have a lot of data to upload – such as a .jpg photo – you can load it from a file using DataType="filename" with the path to the file in the ChangeToValue. Refer to the ActiveADAPTER Send Adapter User Guide for more information.

And don’t forget that the ActiveADAPTER evaluation installation package includes sample messages that show you how to set logon hours and add photos for user objects using hex data.

FAQs
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

What versions of Microsoft BizTalk Server does ActiveADAPTER support?

Microsoft BizTalk Server 2013 R2 to 2020.

We also have legacy versions back to 2006 R2.

See the entire answer

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!

See the entire answer