Share this page

# Converting Projects to Unicode

This section describes how to convert projects to Unicode. You can select a specific project to convert, or you can select a domain and convert its projects to Unicode.

Unicode is a feature of MS-SQL that allows multi-language support. In Oracle, multi-language support is defined when installing the server.

You can convert the following types of projects to Unicode:

- Projects that are version 11.5 or above.
- Projects created on an MS SQL server.
- Projects created in ASCII.

Caution: Unicode increases the memory required for the database server.

To convert projects in a domain to Unicode:

1. In Site Administration, click the Site Projects tab and select the domain whose projects you want to convert.

2. Click the Maintain Domain button and select Convert to Unicode in Domain. The Convert to Unicode Domain dialog box opens.

   Note: Convert to Unicode in Domain is only available if projects that can be converted to Unicode exist in the selected domain.

3. Select the project or projects you want to convert and click Convert to Unicode. Under Convert to Unicode Results, a log is displayed.

   Tip: Click Display Versions to display the versions of the selected projects.

   Note: Projects with columns whose length is greater than 4000 cannot be converted to Unicode. The validation process fails and an error message is generated.

   To fix the problem, either reduce the column length to 4000 or add the columns to the alm_i18n_exceptions.xml exception file before converting. System defined columns and system defined user fields must be reduced and cannot be added to the exception file.

4. To pause the conversion process, click the Pause button. To continue, click the Resume button.

5. To abort the conversion process, click the Abort button. Click Yes to confirm.

6. After the process has completed successfully or stopped due to failure, you can select one of the following:

   - Clear Log. Clears the text displayed in the Convert to Unicode Results area. This disables the Export Log button.

   - Export Log. Enables you to save the log as a .txt file. In the Export Log to File dialog box, select a location and type a name for the file. Click Save.

7. Click Close to close the Convert to Unicode Domain dialog box.

Back to top

To convert a project to Unicode:

1. In Site Administration, click the Site Projects tab and select the project you want to convert.

2. Click the Maintain Project button and select Convert Project to Unicode. The Convert to Unicode dialog box opens.

3. Click Convert to Unicode. Under Convert to Unicode Results, a log is displayed.

   Note: Projects with columns whose length is greater than 4000 cannot be converted to Unicode. The validation process fails and an error message is generated.

   To fix the problem, either reduce the column length to 4000 or add the columns to the alm_i18n_exceptions.xml exception file before converting. System defined columns and system defined user fields must be reduced and cannot be added to the exception file.

4. To pause the conversion process, click the Pause button. To continue, click the Resume button.

5. To abort the conversion process, click the Abort button. Click Yes to confirm.

6. After the process has completed successfully or stopped due to failure, you can select one of the following:

   - Clear Log. Clears the text displayed in the Convert to Unicode Results area. This disables the Export Log button.

   - Export Log. Enables you to save the log as a .txt file. In the Export Log to File dialog box, select a location and type a name for the file. Click Save.

7. Click Close to close the Convert to Unicode dialog box.

Back to top

https://admhelp.microfocus.com ALM 8942
Tips to improve your search results... ALM Help Center ALM Help Center ALM Help 15.5-15.5.1 All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version: