How to setup an ex attribute to directly reference HR connector data

3 min

How to setup an "ex" attribute to reference HR connector data

A customer may require information that is stored in an HR connector to be referenced on a WebForm or in an email notification. Normally you would have the external data stored on an AD Attribute or in a "ex" Extended Attribute, which would be updated by the Create and Update User tasks. However due to the nature of the data it may not be necessary (or appropriate) for it to be stored directly on the user object. It is however possible to reference the data directly off the HR connector instead.

Prerequisites

The HR User connector must contain the user object GUID in the schema. This is used to link the AD Object with the relevant row in the connector.

The Connector_Schema must contain the following column:

<column name="objectGuid" type="uniqueidentifier" default="null" noimport="1" />

Steps

Once the prerequisites have been met, the extended attribute can be setup by following the below steps:

Navigate to \\Resources\ActiveDirectory

Open the CustomSchema parameter

Add the following XML to the schema:

<property name="exConnectorData" extended="Innovation.Activate.Library\Innovation.Activate.Properties.ConnectorProperty"> <connector>=//Resources/Connectors/User</connector> </property>

Update the name if a different name is required

Update the "connector" node with the path to the user connector

Save and exit the Custom Schema

Restart the Activate Administrator, Activate Job Service, and do an IISRESET

Once the setup has been completed, you can now use the following expression to reference the data: =//CurrentUser/exConnectorData/<columnName> e.g. =//CurrentUser/exConnectorData/terminationDate.