ManagementAgent.NormalizeString(String) Method
The NormalizeString(String) method enables the user to normalize case and accent in a string according to the setting for that particular MA. By calling this function, the user can normalize the string according to the connected directory format during provisioning. As a result, when the management agent string is imported back to the connector space from the target directory, the string value imported will be the same as what was written to connector space at provisioning time, allowing confirmation of the export.
Syntax
public void NormalizeString(String)(
string Value
);
Public Sub NormalizeString(String)( _
ByVal Value As string _
)
Parameters
- Value
Text string to normalize.The string will be changed to upper case, and accents will be normalized to the user interface for the MA.
Return Value
This method does not return a value.
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 imported back into the connector space, the string in connector space is not the same as what was staged for export, since the directory will have modified the value. 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. Since normalization is carried out only in outbound synchronization, setting the initial value of an attribute in CS where the configuration specifies normalizing both case and accents would yield the following:
- MV attribute value is café.
- On initial attribute setting or during EAF, use of NormalizeString transforms the value (assuming both case and accents are configured in the UI) to CAFE.
- CS attribute is export to RACF as CAFE.
- At a later stage, the CAFE is imported, and the unconfirmed change is cleared.
| MV | Data flow | CS uses NormalizeString | Data flow | Connected directory |
|---|---|---|---|---|
| café | ———> Initial attribute value (provisioning) Or EAF |
String is normalized café<——>CAFE |
——> Export |
CAFE RACF Directory |
| café | ———> | Exported data is re-imported CAFE<——>CAFE |
<—— Stage |
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 | ILM 2007 FP1 |
| Namespace | Microsoft.MetadirectoryServices |
| Assembly | Microsoft.MetadirectoryServices |
| .NET Framework | .NET Framework 2.0 |
Send comments about this topic to Microsoft
Build date: 2/16/2009