2026-08-06, MDA: v1 6.8.0.20 2 None Global deepl_api_key DeepL API Key true 2 None Global deepl_api_url DeepL API URL false ClassSettingsOpenExpenseDeepL <!-- =============== Open expense: ExpenseOutlayFurtherInfoPage =============== --> <Page Override="ExpenseOutlayFurtherInfo"> <TextArea Name="TextAreaRemarks" Label="{Translate 'Remarks'}" Lines="3" ValueExpression="remarks" VisibleExpression="not(remarks.asstring='')" PlaceAfter="AdditionalFieldGroup" /> </Page> OpenExpense ClassSettingsOpenOutlayDeepL <!-- =============== Open outlay: ExpenseOutlayFurtherInfoPage =============== --> <Page Override="ExpenseOutlayFurtherInfo"> <TextArea Name="TextAreaRemarks" Label="{Translate 'Remarks'}" Lines="3" ValueExpression="remarks" VisibleExpression="not(remarks.asstring='')" PlaceAfter="AdditionalFieldGroup" /> </Page> OpenOutlay ClassSettingsOpenServiceDeepL <!-- =============== Open service: ServiceFurtherInfoPage =============== --> <Page Override="ServiceFurtherInfo"> <TextArea Name="TextAreaRemarks" Label="{Translate 'Remarks'}" Lines="3" ValueExpression="remarks" VisibleExpression="not(remarks.asstring='')" PlaceAfter="AdditionalFieldGroup" /> </Page> OpenService ScriptDeeplTranslateText DeepL: Translate text OpenOutlay,OpenService,OpenExpense false # coding: windows-1252 # # Name: DeepL: Translate text # SelectedObjectScript: Y # Classes: OpenOutlay,OpenService,OpenExpense # CondExpression: N # ExtendedRights: N # # Description: Translates the text of the project item using DeepL. # # 2025-09-25, CBR: Created. # 2026-08-06, MDA: Reviewed, changed, enhanced import vtcapp import module_deepl def main(cost_item_list): """ Main entry for function. """ # "with" construction guarantees that a session is closed # even when any exception is raised inside of code with module_deepl.DeepL() as deepl: # Create list per language with the cost items, rejecting those with empty project.language languages = cost_item_list.evalocl("oclastype(ProjectCostItem).getProject.language.asstring->asSet" "->reject(s|s='')") # Preparation of dictionary with elements of "language_code": [cost item list] grouped_by_language = {} for language in languages: grouped_by_language[language] = [] # Appending cost items to language lists for cost_item in cost_item_list: language = cost_item.evalocl("getProject.language.asstring") if not language: continue grouped_by_language[language].append(cost_item) # Execute translation per language for language, cost_items in grouped_by_language.items(): texts = [] for cost_item in cost_items: texts.append(cost_item.text) translations = deepl.translate(texts, language) # Replace old text if source language differs from target. Store original in remarks. for cost_item, translation in zip(cost_items, translations): if translation["detected_source_language"] == language: continue if not cost_item.remarks: cost_item.remarks = "" else: cost_item.remarks += "\n" cost_item.remarks += ("{} - {}:\n({}) {}" .format(vtcapp.currentdate(), vtcapp.translate("Text before translation"), translation["detected_source_language"], cost_item.text)) cost_item.text = translation["text"] if (vtcapp.getpropertyvalue("deepl_api_url") and vtcapp.getpropertyvalue("deepl_api_key")): main(selectedobjects) else: vtcapp.msgbox(vtcapp.translate("Please make sure that system settings 'DeepL API URL' and 'DeepL API Key' are set.")) None false false true Python2 ScriptModuleDeepl module_deepl false # coding: windows-1252 # # Name: module_deepl # Klassen: # CondExpression: # ObjectScript: N # ContainerScript: N # EventType: # EventClass: # EventMembers: # ExtendedRights: Y # ModulDescription: Provides functions to translate text using DeepL. # # 2025-09-24, CBR: Created. # 2026-08-06, MDA: Reviewed, changed, enhanced import vtcapp import time import requests MAX_RETRIES = 3 SESSION_VERIFY_SSL = True SESSION_STREAM = True class DeepL(): def __init__(self): self.api_url = vtcapp.getpropertyvalue("deepl_api_url") if not self.api_url: raise Exception("DeepL API URL missing.") self.api_key = vtcapp.getpropertyvalue("deepl_api_key") if not self.api_key: raise Exception("DeepL API KEY missing.") self.session = requests.Session() self.session.verify = SESSION_VERIFY_SSL self.session.stream = SESSION_STREAM self.translate_url = self.api_url.rstrip("/") + "/v2/translate" # two functions below are needed to make it possible # to work with "with" def __enter__(self): return self def __exit__(self, *_): self.session.close() def _post_translate(self, data): """ Sends a POST request to the DeepL translate endpoint. Retries on 429/500, raises on other errors. """ headers = { "Authorization": "DeepL-Auth-Key {}".format(self.api_key), "Content-type": "application/x-www-form-urlencoded", "Accept": "application/json", } retries = 0 while True: response = self.session.post(self.translate_url, headers=headers, data=data, allow_redirects=False, timeout=(5, 15)) if response.status_code in (429, 500): retries += 1 if retries > MAX_RETRIES: raise Exception("DeepL: Request failed with status {}.".format(response.status_code)) time.sleep(2 ** retries) # 2s, 4s, 8s(, ...) continue break if response.status_code == 456: raise Exception("DeepL: Quota exceeded.") if response.status_code < 200 or response.status_code >= 300: error_msg = "DeepL: Unexpected response code {}.".format(response.status_code) # to make sure that a response is of a json type try: response_json = response.json() except Exception: response_json = {} if "message" in response_json: error_msg += " " + response_json["message"] raise Exception(error_msg) return response.json() def translate(self, texts, target_language): """ Translates a list of texts to target_language. Returns a list of dicts with 'text' and 'detected_source_language'. """ data = { "text": texts, "target_lang": target_language.upper(), } response = self._post_translate(data) return response["translations"] None false false false Python2 TranslationDeeplTranslateText DeepL: Text übersetzen DeepL: Translate text DeepL: Traduire le texte DeepL: Traduci il testo DeepL: Text übersetzen DeepL: Tekst vertalen DeepL: Translate text TranslationPleaseMakeSureThatPropertiesDeeplApiUrlAndDeeplApiKeyAreSet Bitte stellen Sie sicher, dass die Systemeinstellungen 'DeepL API URL' und 'DeepL API Key' gesetzt sind. Please make sure that system settings 'DeepL API URL' and 'DeepL API Key' are set. Assurez-vous que les paramètres du système 'DeepL API URL' et 'DeepL API Key' sont définis. Assicurarsi che le impostazioni di sistema 'DeepL API URL' e 'DeepL API Key' siano impostate. Bitte stellen Sie sicher, dass die Systemeinstellungen 'DeepL API URL' und 'DeepL API Key' gesetzt sind. Zorg ervoor dat de systeeminstellingen 'DeepL API URL' en 'DeepL API Key' zijn ingesteld. Please make sure that system settings 'DeepL API URL' and 'DeepL API Key' are set. TranslationTextBeforeTranslation Text vor der Übersetzung Text before translation Texte avant traduction Testo prima della traduzione Text vor der Übersetzung Tekst voor vertaling Text before translation