Microsoft Identity Integration Server 2003 Developer Reference

ManagementAgent.NormalizeString(String)

The NormalizeString(String) method allows the MIIS system to perform comparisons for string values on MAs that move data between a connected directory and the connector space, where the connected directory changes the case of the string text or removes accents from the string text. This method will manipulate the string before it is exported so that the text string follows the text format rules for the targeted server. This way, when the management agent string is imported back to the connector space from the target directory, the MA string value can be mapped to the correct connector space object..

[C#]
public void NormalizeString(String)(
  string Value
);

[Visual Basic .NET]
Public Sub NormalizeString(String)( _
  ByVal Value As string _
)

Parameters

Value: Text string to normalize. The string will be changed to all upper case and the accents will be removed.

Return Values

This method has no return values.

Exceptions

Exception type	Condition
ArgumentException	An input text string must be specified.
ArgumentNullException	The argument is null.
OutOfMemoryException	A memory allocation failure occurred.

Remarks

Certain directories, such as RACF, TopSecret, or ACF2 change text strings that are imported into the directory to remove accents from text characters or to make the text strings all upper case. When data from the management agent is then imported back into the connector space, the connector space object can no longer map the MA string to the correct metaverse object. When you use this method, you can set case rules on the string, which makes the string all upper case, or accent rules, which removes accent characters from the string. The following table demonstrates how this would work when this method is used:

MV	Data Flow	CS uses NormalizeString	Data Flow	Connected Directory
café	—————>	café<——>CAFE	—————>	RACF Directory
café	<—————	CAFE<——>CAFE	<—————	RACF Directory

This method is used on the Extensible Management Agent and the XML Management Agent. The management agents can be call-based or file-based.

Once you have created the management agent that contains this method, you must use the Identity Manager UI to set the options for how the string should be normalized. In Identity Manager, you will need to create a new management agent. In the Create Management Agent UI, on the Configure Connection Information page, the management agents can be set as call-based or file-based. You must select the Import and Export radio button as the step type. On the Configure Attributes page, there are two check boxes: Upper Case and Remove Accents. Select one or both options.

Requirements

Product: Microsoft Identity Integration Server 2003
Namespace: Defined in Microsoft.MetadirectoryServices.
Assembly: Requires Microsoft.MetadirectoryServices (in Microsoft.MetadirectoryServices.dll).
.NET Framework: Requires .NET Framework 1.1.