E1334 DeepL error in task log is missing concrete error message - improve glossary error handling

XMLWordPrintable

    • High
    • None
    • Some DeepL errors did not properly write the error to the task log
    • None

      problem

      The following DeepL error did happen: 

                id: 487906
             level: ERROR
           created: 2026-08-10 10:45:45
             ecode: E9999
            domain: plugin.matchanalysis
           message: DeepL\NotFoundException: Not found, check server_url, message: Bad request. Reason: Glossary 2e4b23c0-c9c8-49c3-b7cd-d1dfd7c88556 not found
       file (line): /var/www/instances-local/instance-1000/vendor/deeplcom/deepl-php/src/Translator.php (766)
              URL:  cli://localhost/editor/index
             Trace: #0 /var/www/instances-local/instance-1000/vendor/deeplcom/deepl-php/src/Translator.php(173): DeepL\Translator->checkStatusCode()
      #1 /var/www/instances-local/instance-1000/application/modules/editor/Plugins/DeepL/Api/DeepLApi.php(216): DeepL\Translator->translateText()
      #2 /var/www/instances-local/instance-1000/application/modules/editor/Plugins/DeepL/Connector.php(343): MittagQI\Translate5\Plugins\DeepL\Api\DeepLApi->translate()
      #3 /var/www/instances-local/instance-1000/application/modules/editor/Plugins/DeepL/Connector.php(182): editor_Plugins_DeepL_Connector->createTranslateResponse() 

      But in the task log there was only: 

      MittagQI\Translate5\Plugins\DeepL\Service\Exception: DeepL is returning an error: {message}

      So the "message" data field was not properly set for the final log message and the user did not know what did happen. 

      full trace of the log

      Log ID: 487907
      Created: 2026-08-10 10:45:45
      Level: 2
      Event Code: E1334
      Domain: editor.languageresource.service.connector
      Message: MittagQI\Translate5\Plugins\DeepL\Service\Exception: DeepL is returning an error:
      
      {message}
      
      App Version: not defined yet
      application/modules/editor/Plugins/DeepL/Api/DeepLApi.php (263)
      Duplicates: 187
      Last Seen: 2026-08-10 10:45:49
      
      Trace:
      #0 application/modules/editor/Plugins/DeepL/Api/DeepLApi.php(229): MittagQI\Translate5\Plugins\DeepL\Api\DeepLApi->transformException()
      #1 application/modules/editor/Plugins/DeepL/Connector.php(343): MittagQI\Translate5\Plugins\DeepL\Api\DeepLApi->translate()
      #2 application/modules/editor/Plugins/DeepL/Connector.php(182): editor_Plugins_DeepL_Connector->createTranslateResponse()
      #3 application/modules/editor/Services/Connector/BatchTrait.php(260): editor_Plugins_DeepL_Connector->batchSearch()
      #4 application/modules/editor/Services/Connector/BatchTrait.php(182): editor_Plugins_DeepL_Connector->handleBatchQuerys()
      #5 application/modules/editor/Services/Connector.php(361): editor_Plugins_DeepL_Connector->batchQuery()
      #6 application/modules/editor/Plugins/MatchAnalysis/BatchWorker.php(151): editor_Services_Connector->__call()
      #7 application/modules/editor/Plugins/MatchAnalysis/BatchWorker.php(97): editor_Plugins_MatchAnalysis_BatchWorker->processLegacyBatchQuery()
      #8 library/ZfExtended/Worker/Abstract.php(513): editor_Plugins_MatchAnalysis_BatchWorker->work()
      #9 library/ZfExtended/Worker/Abstract.php(428): ZfExtended_Worker_Abstract->_run()
      #10 Translate5/MaintenanceCli/Command/WorkerRunCommand.php(142): ZfExtended_Worker_Abstract->runQueued()
      #11  vendor/symfony/console/Command/Command.php(326): Translate5\MaintenanceCli\Command\WorkerRunCommand->execute()
      #12  vendor/symfony/console/Application.php(1098): Symfony\Component\Console\Command\Command->run()
      #13  vendor/symfony/console/Application.php(324): Symfony\Component\Console\Application->doRunCommand()
      #14  vendor/symfony/console/Application.php(175): Symfony\Component\Console\Application->doRun()
      #15  Translate5/maintenance-cli.php(342): Symfony\Component\Console\Application->run()
      #16
      
      

      additional problems

      On trying to re-run the glossary sync in the sys log was - the user unfortunately did not see that: 

       2026-08-10 12:57:54 ERROR E9999 (# 488062) editor.languageresource.deepl.glossary → DeepL\GlossaryNotFoundException: Glossary not found, message: Not found
      
       2026-08-10 12:57:54 ERROR E1386 (# 488063) editor.languageresource.service.connector → MittagQI\Translate5\Plugins\DeepL\Service\Exception: DeepL Glossary does not exist
      
       2026-08-10 12:57:54 ERROR E1389 (# 488064) editor.languageresource.service.connector → MittagQI\Translate5\Plugins\DeepL\Service\Exception: DeepL Unable to delete glossary. 

      This is currently not directly shown to the user - there should be exist another issue already for reporting worker errors into the UI.

      solution

      Adopt the underlying error message correctly as message into the logged and shown log entry to the task. Obviously message is just not set. 

       

      Test instructions

      In theory try to reproduce that by adding a TermCollection as Glossary and then manually delete that Glossary in DeepL.

      If we really need UI tests should be decided on code review since fix should be trivial.

            Assignee:
            Sanya Mikhliaiev
            Reporter:
            Thomas Lauria
            None
            None
            Thomas Lauria
            NO-FRONTEND-TESTING NEEDED
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved:
              None
              None