How To Tokenize An Out Of Box Connector
Article ID: 375645
Updated On:
Products
Issue/Introduction
Using the Language Switching feature does not work with out of box connectors in the IM User Console which continue to display in English only.
Environment
All Identity Manager
Cause
While the RoleDef jar provided for out of box connectors does already contain translated properties files, importing the RoleDef for an out of box connector in the Identity Manager Management Console will only import as English only and not as tokenized since the XML included within the RoleDef is not tokenized.
Resolution
It is possible to use an ant command as mentioned in the \Identity Manager\IAM Suite\Identity Manager\tools\samples\Localization\readme.htm to generate a tokenized XML file for the out of box connector.
As an example I extracted the META-INF.CA_Top_Secret_v2-RoleDef.xml out of the \standalone\deployments\iam_im.ear\user_console.war\WEB-INF\lib\CA_Top_Secret_v2.jar and used that CA_Top_Secret_v2-RoleDef.xml with the tokenizeroledef command:
ant tokenizeroledef -Dinputfile=CA_Top_Secret_v2-RoleDef.xml
Running the command will generated a new CA_Top_Secret_v2-RoleDef.xml_Tokenized.xml and CA_Top_Secret_v2-RoleDef.xml_Tokenized.properties file.
The CA_Top_Secret_v2-RoleDef.xml_Tokenized.properties file can be ignored since it is already included in the \standalone\deployments\iam_im.ear\user_console.war\WEB-INF\lib\CA_Top_Secret_v2.jar
For the generated CA_Top_Secret_v2-RoleDef.xml_Tokenized.xml you will need to do a replace all on the file to change "${bundle=resourceBundles.CA_Top_Secret_v2-RoleDef_Tokenized" to instead be "${bundle=provisioning.resourceBundles.CA_Top_Secret_v2-RoleDef_Tokenized" so that it can use the localized property files already included in the \standalone\deployments\iam_im.ear\user_console.war\WEB-INF\lib\CA_Top_Secret_v2.jar and save it as CA_Top_Secret_v2-RoleDef.xml_Tokenized_Fixed.xml
After first making sure you already imported the RoleDef for that connector via the IM Management Console you can now import this updated CA_Top_Secret_v2-RoleDef.xml_Tokenized_Fixed.xml with the IM Management Console to replace the original English only to support the tokenized instead. Restart the IME on all nodes and you will be able to use the Language Switching feature with the screens for the out of box connector.
Additional Information
The product documentation has also been updated with the "Import Role Definition in a Localized Environment" section as well which provides additional similar approaches on steps you can take to localize the out of box connector:
Feedback
