• Several points must be checked before reintegrating the messages (see notes).
• If changes have been made to the initial extraction file created by WDMSG, it must be reintegrated to apply such changes.

Reintegrating text into a project

1. Open your project in WINDEV, WEBDEV or WINDEV Mobile: in the "Home" pane, in the "General" group, pull down "Open" and select "Open a project".
2. Launch WDMSG: under the "Project" pane, in the "Translate" group, pull down "Translate" and select "Message reintegration".
3. Select the languages in which the text will be reintegrated.
   
   Remarks:
   • The names of the custom languages also appear in the list.
   • Multiple language selection is available for HFSQL or WDMSG translation files only. The resources to translate are previously extracted to the translation file and translated with WDTRAD.
   • The "Use another available language if a translation is empty." option is used to avoid blank spaces in the interface. You can then select the language that will be used if the translation is empty. Thus, if this option is enabled, when a resource is not found in the reintegrated language, it is searched in the specified language. If after this search, the resource is still not found, the resource is kept in the source language.
   • To reintegrate a language that was initially not supported in the project, select "Reintegrate an additional language external to the project". Simply specify that language to be reintegrated.
4. Proceed to the next step of the wizard.
5. Select the reintegration options of the file containing the translated text. These options are presented in the paragraph below.
   
6. Go to the next step.
7. When reintegrating text, you can check whether the text of the current project matches previously extracted text. This feature is useful when the text is translated while the application is being developed.
   After this verification, the translation of the text that has been edited in the project will not be reintegrated. The text that has been edited will be extracted and saved in a new file.
   To perform this verification:
   • check "Check whether messages have been modified since their extraction".
   • specify the initial extraction file (with the text that has not been translated or modified) and the new extraction file that contains only the edited text.
     Go to the next step.
   • select the initial extraction language.
     Go to the next step.
8. When the text is reintegrated, you can also reintegrate corrections (spelling mistakes, etc.) made in the initial extraction file. This feature is useful when translators make corrections to the source text of the initial file. The translations and the corrections made to the source text can be reintegrated.
   To perform this reintegration:
   • check "Reintegrate changes made to the source text".
   • specify the initial extraction file containing the corrections.
   • select the initial extraction language.
   Go to the next step.
9. WDMSG gives you the ability to create a reference file. This file will only contain new text or the text that has been edited since the last time the text was translated.
   To create a reference file:
   • check "Extract a reference file".
   • specify the reference file.
   • select the language of the reference file.
   Go to the next step.
10. Validate. Messages are reintegrated. If you specified other operations, the corresponding files will be processed and generated.
    You can check the reintegration directly in the tool used (in WINDEV, WEBDEV or WINDEV Mobile).
    For example, view the description of an Edit control. The translation of the control caption will be available.

Reintegration options

• Recover in OEM format If this option is checked, the file text must be in OEM format (DOS character format), otherwise in ANSI format (Windows character format).

Reintegration options for a translation software

• Consider delimiter for parts of text not to be translated For some translation programs, it is possible to ignore parts of text in a document to be translated. For example, the comments generated by WDMSG can be ignored. To do so, the text sections to ignore must be enclosed in delimiters (specific to the software).
  If this option is enabled, all the sections of text specific to the format of the extraction file will be enclosed in delimiters (SSTRX by default) and will not be translated.
  For more details on delimiters, see the documentation of the translation software used.
• Consider the space before the delimiter Some translation programs require a space before the delimiter.
  If this option is enabled, a space is added before the delimiter.
• Consider the space after the delimiter For some translation programs, it is necessary to add a space after the delimiter.
  If this option is enabled, a space is added after the delimiter.

Before reintegrating the text

• a project backup was made in WINDEV, WEBDEV or WINDEV Mobile. To make a backup, go to the "Project" tab, "Other actions" group, expand "Backup/Restore" and select "Make a project backup".
  Important WDMSG does not create backup files.
• in the case of a translation text file: the keywords in the extraction file have not been modified during translation or spelling correction of the file (otherwise error messages will appear during integration).
• the target language has been defined in the project. Otherwise, you must:
  • add the language in the "Languages" tab of the project description: under the "Project" pane, in the "Project" group, click on "Description".
  • upgrade the project before integration: in the "Project" pane, in the "Project" group, pull down "Recompile and synchronize" and select "Repair project (Upgrade)".
• in the case of simultaneous reintegration of several languages (HFSQL or WDMSG data file): the various languages contained in the translation file have been translated using the WDTRAD tool.