Setting up foreign languages, dictionaries and multilingual text templates^M

• Create foreign languages

  Users with administrative rights can create an unlimited number of foreign languages and enable them for different areas of the application. The language specified under Administration >  Settings >  Corporation >  Settings > Default language is not included here. That field defaults to German unless a different language is entered.

  1. Go to the  Administration tab and select  Languages >  New.
  2. Enter the Name of the new language and a Code. An Alternative name is automatically pre-assigned, but can be changed and is optional. Optionally assign a Flag, which is displayed as an icon for this language.
  3. Use the Sort number to specify the order in which languages are listed. If the sort number is not unique, the languages will be sorted alphabetically.
  4. Select a Dictionary for machine translation from the selection list (Install Hunspell dictionaries).
  5. Enable language selection:
     1. For  Accounts: to allow one language setting per account or contact person. If a foreign language is assigned to an account, any existing letter templates are automatically called up in this language.
     2. For  Items: to enable the entry of foreign-language item texts as required for multilingual text templates.
     3. For  Mail/Email : to input foreign-language versions of German mail or other text templates (mail, email, quotes, menu cards, etc.).
     4. If no text templates are to be entered in this language, click on the  expand triangle to enter a  Replacement language. Mail in this alternative language are then available for accounts assigned the new language.
        Example: "Dutch" can be assigned in an account, but no text templates are translated into Dutch. Alternatively, "English" is selected here and the customers receive English text templates.
  6.  Save your input by clicking on the icon in the top left-hand corner of the input window.
• Install Hunspell dictionaries

  A Hunspell dictionary allows users to check spelling in text fields and text templates. Due to licence regulations, this spell checker cannot be pre-installed by the manufacturer.

  1. Create a folder for the dictionary
     1. For server applications: C:\Bp Event\Bp Event Server\Application\Server Database\Resources\Hunspell
     2. For standalone applications: C:\Bp Event\Bp Event Standalone\ Application\Database\Resources\Hunspell
  2. Go to Hunspell Dictionaries German (https://www.j3e.de/hunspell/) and select the most recent file for your location.
  3. Unzip the downloaded ZIP file into the directory you have just created.
  4. Log out of the application and log in again.
  5. Go to the  Administration tab in the function bar and select  Settings >  Corporation >  Settings > Dictionary > German - Hunspell.
  6. Save your input by clicking on the icon in the top left-hand corner of the input window.
• Create foreign-language versions of text templates

  Create foreign-language versions of customer printouts directly in the text template.

  1. Go to the  Templates tab in the function bar and select  Text templates >  Search .

  As of version 12.1:

  2. Click on  Add language to open an additional tab for the foreign language template. All languages that have been created under  Administration >  Languages and activated for  Mail/Email will be available here.
  3. Enter the foreign-language text template and edit it if necessary using the  Dictionary. If no text is entered, the tab for this language is automatically removed again when closing.
  4. Select a corresponding  Text template to assign a suitable Cover letter to the letter template. If a letter is created on the basis of the multilingual template, the cover letter is automatically given out in the same language.
  5. Click on  Subject based on formula to customise the subject of a multilingual mail, and enter a suitable  Formula (using the "Dictionary Translate" and "Current Language" functions).

  Versions prior to 12.1:

  2. Click on File > Save in the toolbar of the  Text tab to save the template externally.
  3. Select the target language in the Language field of the template.
  4. Re-open the template by clicking on File > Open in the toolbar of the  Text tab.
     Note: If you copy the original text from one language to another using Ctrl+A, Ctrl+C and Ctrl+V, the texts and database references are retained, but not the page layout.

   Save your input by clicking on the icon in the top left-hand corner of the input window.

• Insert translations into text documents

  Translate only real text in the text templates, not database references. Item texts or other texts that originate from database references should be added to the respective items or templates (Create foreign-language item texts).

  1. Display the  4D expressions in a text document to distinguish between database references and pure text (prior to Version 12.1: on the toolbar of the  Text tab).
  2. A  Dictionary matching the selected language will automatically appear in the toolbar (prior to Version 12.1: select first).
  3. Highlight the text you want to translate and click on  Dictionary.
  4. In the field Translation text , mark the word or compound term for which you need a translation suggestion, or enter the term directly in the field Search words .
  5. Double-click to select the best of the suggested translations or enter  New translation.
  6.  Save your input by clicking on the icon in the top left-hand corner of the input window.
• Insert dictionary references in text documents

  Translations can also be entered as references to your own dictionary. If the approved translation of an original text changes, it is not necessary to correct each translation individually, but only the entry in the dictionary. References are particularly suitable for templates, but can also be used in text documents.

  1. Show the  4D expressions in a text document to distinguish between database references and pure text (prior to Version 12.1: on the toolbar of the  Text tab).
  2. A  Dictionary matching the selected language will automatically appear in the toolbar (prior to Version 12.1: select first).
  3. Highlight the text you want to translate and click on  Dictionary >  Replace with dictionary reference.
  4. To ensure that the translation is capitalised at the beginning of the sentence, select  Dictionary reference (first letter upper case).
  5.  Save your input by clicking on the icon in the top left-hand corner of the input window.
• Check the quality of dictionary references in the template

  With longer text templates, it can be difficult to ensure the quality of the automatic translations. The automatic check of entries inserted as dictionary references can help here.
  Note: Translations that have been inserted as text are not included here.

  1. Go to the  Configurations tab and select  Translations >  Check .
  2. Select which dictionary references you would like to show:
       the references for which no translation was found
      the references for which only an incomplete translation was found
       the references for which a one hundred per cent suitable translation has been found
     Multiple selection is possible.
  3. Only then open the text template in the correct language.
  4. In the results window, you will see the references found in the order in which they appear.
  5.  Sort the results alphabetically or  Copy them to the clipboard for easier editing.
  6. Click on  Details to show the template or formula in which the reference appears.
  7. Correct and complete the dictionary references and call up the text template again.
• Assign suitable attachments to foreign-language templates

  Many templates for customer correspondence are linked to attachments that are automatically sent with an email. Attachments are also useful for foreign-language emails.

  1. Create the translations of the attachment templates (Create foreign-language versions of text templates).
  2. Add both the German and foreign-language attachments to the email template on the  Attachments tab:
     1. Don't set a language filter for multilingual Bp attachement templates, as they are automatically attached in the language of the account/mail.
        Example: Bp text template with translations "Quote incl net totals"
     2. For data sheets or external documents, select the languages for which they are to be attached in the Language filter column.
        E.g.: "How to find us.pdf" for the mail languages English, Dutch and Polish, "Où nous trouver.pdf" for French
     3. Picture files, business cards, calendar entries and such do not need a language filter, they are always attached.