Studio Developers Q&A - Recent Threads

Verification plugin triggered when confirming a segment even if disabled

Arturo Vazquez Rodriguez — Fri, 17 Apr 2026 09:07:28 GMT

Hello,

I have developed a custom verification plugin for Trados Studio.

When I disable it in the project settings, it won't be triggered when pressing F8, which is expected and completely normal.

The problem is that confirming a segment triggers the verifications performed by that plugin even if the plugin is completely disabled (that is, unchecked in the Verification options node).

I am using Trados Studio 2024 SR1 18.1.3.6657

I cannot share the source code publicly or the plugin, but I can privately, please get in touch with me for that.

Thanks!

Kind regards,

Arturo

MultiTerm COM API Termbases.New() fails when Croatian is present in XDT, but MultiTerm Desktop can create the termbase

Adam Csillag — Fri, 10 Apr 2026 11:16:49 GMT

Hello,

I’m seeing a reproducible issue with MultiTerm COM automation when creating a local termbase from an .xdt definition.

Environment

MultiTerm Desktop 2022 SR2 - 17.2.5.2838
Trados Studio 2022 SR2 - 17.2.12.19268
C# app running as x86 (Environment.Is64BitProcess = False)
Interop: Sdl.MultiTerm.TMO.Interop

Code

Sdl.MultiTerm.TMO.Interop.Application oMt = new Sdl.MultiTerm.TMO.Interop.Application();
TermbaseRepository oLocalRep = oMt.LocalRepository;
oLocalRep.Connect("", "");

Termbases oTbs = oLocalRep.Termbases;
oTbs.New(name, "", definition, sdltbPath);

Example values used

name = "Test"
definition = C:\Users\...\Temp\Test_20260409_141955534\Test.xdt
sdltbPath = C:\Users\...\Temp\Test_20260409_141955534\Test.sdltb

What I tested

The process is 32-bit (Environment.Is64BitProcess = False)
definition exists
sdltbPath does not exist before calling New(...)
Creating in %TEMP% gives the same result as other local paths
Opening an existing .sdltb through COM works:

oLocalRep.Termbases.Add(existingTbPath, "", "");
var tb = oLocalRep.Termbases[existingTbPath];

MultiTerm Desktop can successfully create the termbase from the same .xdt

Observed behavior

Termbases.New(...) throws:
- System.Runtime.InteropServices.COMException: 'MultiTerm is unable to create the termbase.'
After a lot of testing, I found that the problem is related to Croatian in the .xdt
If I remove Croatian from the termbase definition, Termbases.New(...) succeeds
If Croatian is present, Termbases.New(...) fails
However, MultiTerm Desktop is able to create the same termbase from the same .xdt

Question

Is this a known issue in the MultiTerm COM API with Croatian language handling during termbase creation?
Is there a specific Croatian language code/locale that COM expects here?
Could this be related to SH-HR vs hr-HR handling?

Since Desktop can create the termbase, but COM cannot when Croatian is included, this looks like an API-specific issue rather than a broken .xdt.

Thanks in advance for any guidance.

API calls to pretranslate files using DeepL plugin no longer work

TTS Team — Wed, 01 Apr 2026 14:25:52 GMT

Hello,

Since DeepL changed their authentication methods, we no longer can pretranslate our files using API calls to Trados 2024. It still work when pretranslating "manually" from within Trados Studio, but when using the API call

project.RunAutomaticTask(targetFiles.GetIds(), AutomaticTaskTemplateIds.PreTranslateFiles)

, it won't work.

We've narrowed it down to DeepL API key authentication: when adding the DeepL provider manually in Trados Studio, the API key is automatically authenticated when you enter it in the settings dialog for DeepL, but when our external tool uses Trados API to add the DeepL provider to the project using our API key, no such validation occurs, and that's what blocks the pretranslation task from working.

So my question is: is there any way to make it work, it worked just fine before the authentication change? We even tried duplicating the API key authentication when adding the provider to the project, but no luck there.

Thanks for any help on this subject.

Create Project Via API shows files as Reference

Mark Owens — Mon, 30 Mar 2026 11:05:15 GMT

I've recently upgraded to Trados 2024, and am running code that creates a new project from a Studio 2024 template, add files, and machine translates. All VS references are for Studio 2024 assemblies.

The template is setup exactly as you'd expect to do this. There is no memory selected, and the DeepL translation configuration is correct. The file types for the template have most entries in the list unticked, but XML2: MadCap Compliant is ticked.

The program steps are:

Create project
AddFolderWithFiles (recursively)
Save project
Scan files
Save project
ConvertToTranslatableFormat (via RunAutomatiobTask)
CopyToTargetLanguages (via RunAutomatiobTask)
Save project
Modify settings to applyAutomatedTranslation
Save settings
Save project
PreTranslateFiles (via RunAutomatiobTask)
Save project

It never seems to use the project template setting to recognise the .htm files are translatable.

If I create the project manually, with the same template, same source files, it performs the MT as expected.

There must be some sort of gotcha going on. Can anyone tell me where I'm going wrong?
Thanks

Mark

Request for meeting to clarify TM matching behavior with Lara integration

Giulia Ceccacci — Thu, 05 Mar 2026 09:18:45 GMT

My name is Giulia Ceccacci and I work at Translated, where I focus on technical support for Lara, our AI translation platform.

I've recently been running several tests on the integration between Lara and Trados Studio, and I’ve noticed a few behaviors regarding translation memory matching and segment confirmation that I would like to better understand from your side.

In particular, I’m seeing some inconsistencies in how TM matches (including 90% matches) are recognized by Trados depending on whether the TM is selected in Trados, in Lara, or in both. In some cases Lara correctly retrieves a match from the TM, but Trados does not recognize it as a TM match, which means the segment still needs to be manually confirmed.

Additionally, I’m observing a bug where the suggested translation reverts to the source language when the segment is confirmed, which we are currently investigating on our side.

Since some of these behaviors may depend on how Trados handles TM matches, pre-translation settings (e.g. Keep Existing Translations), and external providers, I think it would be very helpful to schedule a short meeting to walk through the scenarios together and clarify what we should expect from the Trados side.

Would you be available for a quick call in the coming days?

Let me know,

Giulia

TradosAPI within Plunet Ran out of Memory message

David McDermit — Tue, 03 Mar 2026 14:54:35 GMT

Hello

Have been having an issue with the TradosAPI within Plunet to run analysis of translation requests.

Presently have updated the server and all programs within Plunet and the TradosAPI. This seems to have fixed the Critical error message we would get when running jobs over 1100 words. After getting everything up-to-date we are now running into a Ran out of Memory message when running larger jobs.

What can I supply that might help solve this issue?

GroupShare: Adding Translation Units directly via Trados API always results in Discard – expected behaviour?

Damien Morard — Mon, 09 Feb 2026 15:43:36 GMT

Hello everyone,

I’m currently experimenting with the Trados APIs to programmatically populate a server-based GroupShare TM (GS 2020 / Studio 2021), and I’ve run into a behaviour that I’d like to better understand or confirm.

Context

GroupShare 2020
Trados Studio 2021
Server-based TM created specifically for testing
User has admin roles in GroupShare
Importing a TMX manually via Studio works
Importing a TMX programmatically via the API also works

However, when trying to add Translation Units directly via the API, nothing is persisted.

What I’m trying to do

I’m using ServerBasedTranslationMemoryLanguageDirection.AddTranslationUnit(...) to insert a simple TU (plain text, no tags).

Below is a simplified example of the code I’m using.
(It does not contain all variables/constants, but should give a clear idea of the approach.)

private static void Main()
{
try
{
AssemblyResolver.Resolve();

  var server = new TranslationProviderServer(
   new Uri(GROUPSHARE_TM_ENDPOINT),
   useWindowsAuthentication: true,
   userName: null,
   password: null);

var tms = server.GetTranslationMemories(TranslationMemoryProperties.None).ToList();
Console.WriteLine($"Connection OK. Found {tms.Count} TM(s) on the server:");

  foreach (var t in tms)
  {
   Console.WriteLine($"- {t.Name} | {t.Id}");
  }

var tmRef = tms.FirstOrDefault(t =>
string.Equals(t.Name, TM_NAME, StringComparison.OrdinalIgnoreCase));

  if (tmRef == null)
  {
   return;
  }

  var tm = server.GetTranslationMemory(tmRef.Id, TranslationMemoryProperties.None);
  if (tm == null)
  {
   return;
  }

var sourceCulture = new CultureInfo("en-GB");
var targetCulture = new CultureInfo("fr-FR");

  var ld = tm.LanguageDirections.GetLanguageDirection("en-GB", "fr-FR");
  if (ld == null)
  {
   return;
  }

  var tu = new TranslationUnit
  {
   SourceSegment = BuildPlainTextSegment(sourceCulture, "Hello world!"),
   TargetSegment = BuildPlainTextSegment(targetCulture, "Bonjour le monde !")
  };

var importSettings = new ImportSettings();
var result = ld.AddTranslationUnit(tu, importSettings);

  Console.WriteLine($"Cached TU count: {tm.CachedTranslationUnitCount}");
  Console.WriteLine($"Actual TU count: {tm.GetTranslationUnitCount()}");
  Console.WriteLine($"TM IsReadOnly: {tm.IsReadOnly}");
  Console.WriteLine($"TM SupportsUpdate: {tm.SupportsUpdate}");
  Console.WriteLine($"Has Delete permission: {tm.HasPermission(TranslationMemoryPermissions.Delete)}");
Console.WriteLine($"Has Add permission: {tm.HasPermission(TranslationMemoryPermissions.Add)}");
Console.WriteLine($"Has Edit permission: {tm.HasPermission(TranslationMemoryPermissions.Edit)}");
Console.WriteLine($"ImportResult: {result}");
}
catch (Exception ex)
{
Console.WriteLine("Error while inserting TU:");
Console.WriteLine(ex);
}
}

private static Segment BuildPlainTextSegment(CultureInfo culture, string text)
{
var segment = new Segment(culture);
segment.Add(new SdlText(text));
return segment;
}

Output

After running this code, I consistently get the following output:

Cached TU count: 0
Actual TU count: 0
TM IsReadOnly: False
TM SupportsUpdate: True
Has Delete permission: True
Has Add permission: True
Has Edit permission: True
ImportResult: Discard-(0, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)-OK

So:

No exception is thrown
Permissions look fine
The TM is writable
But no TU is added
ImportResult always comes back as Discard

Additional observation / question

When switching to a TMX-based approach (i.e. generating a TMX file and importing it via the API), the import works correctly and the TUs are effectively added to the server-based TM.
In contrast, inserting TUs one by one via AddTranslationUnit consistently results in a Discard without any explicit error, even when using an admin account.
This makes me wonder whether direct TU insertion via the API is intentionally restricted in GroupShare, or if there is some server-side policy or design decision that silently discards such inserts.

Is this behaviour expected for server-based GroupShare TMs, and is the recommended or supported approach to populate them exclusively via batch TMX imports rather than direct TU insertion?

Thanks in advance!

Damien

Trados API Extraction Failure: File Version Could Not Be Identified: New Case Comment

Dpto. Tecnico Linguaserve — Mon, 02 Feb 2026 12:22:46 GMT

Hello:

We are launching a process from the Trados API to read the contents of an SDLXLIFF file, and it is returning an error that we are unable to identify:

Error while extracting data from 8950d65b-9b65-4160-9389-410ee8109862: An error occurred while trying to determine the file version.
at Sdl.ProjectAutomation.FileBased.FileBasedProject..ctor(String projectFilePath)
at ApiTAO.Tasks.FileExtractionData.FileExtractionDataTask.ExtractData(String projectPath, String fileId)

We are unable to determine the cause of the error because, apparently, everything in the SDLXLIFF file looks correct.

How can we get more information about the possible issue? Could you help us?

There is an event (SegmentsConfirmationLevelChanged) that is triggered for a single segment. Is there an equivalent event that is triggered once for multiple segments after a multi-selection?

Usman Asif — Wed, 17 Dec 2025 19:37:54 GMT

There is an event called SegmentsConfirmationLevelChanged that is triggered when the confirmation level of a segment changes. However, when multiple segments are selected and their status is changed in bulk, this event is fired separately for each individual segment. There does not appear to be a single event that represents the completion of the bulk action. Because of this, it is difficult to determine when all selected segments have finished updating. Is there an equivalent document-level or bulk event that is triggered once after the confirmation level is changed for multiple selected segments?

Scan batch task on Trados API randomly fails with message "The file exists."

Stelios Mathioulakis — Wed, 26 Nov 2025 11:21:47 GMT

Hello,

I have a typical function to add files to a project. I have a very large catalog of html files that I need to convert, around 70k files. I have set up multiple Python workers for this task and they invoke the C# code with the relevant parameters like source, target lang, output path, input file path. However, this typical code here randomly fails:

private void AddFiles(FileBasedProject project, string sourceFilePath)
{
// AddFiles expects an array of strings
string[] sourceFilePaths = { sourceFilePath };
project.AddFiles(sourceFilePaths);

ProjectFile[] projectFiles = project.GetSourceLanguageFiles();

AutomaticTask scan = project.RunAutomaticTask(projectFiles.GetIds(), AutomaticTaskTemplateIds.Scan);

}

the problem is that the scan object has the message "The file exists.". This Add files function sits here in a typical sequence of calls for Trados automation:

newProject = new FileBasedProject(this.GetProjectInfo(srcLocale, trgLocale, outputpath));
var settings_ = newProject.GetSettings();
var xliffSettings = settings_.GetSettingsGroup("SDL XLIFF 1.0 v 1.0.0.0");
xliffSettings.GetSetting<bool>("ValidateXliff").Value = false;
newProject.UpdateSettings(settings_);

this.AddFiles(newProject, sourceFilePath);

What does this "The file exists." even mean? Can you see where this could come from?

If I shut the process off and then try only a failed task on its own, then it works. Can someone help me on this? I have never encountered this before. I am using Trados 2022.

" HRESULT E_FAIL-Error" during deletion of entries in a MultiTerm termbase

Nils Jörn — Fri, 14 Nov 2025 10:43:15 GMT

Dear all,

I'm creating a little command line tool with Visual Basic which shall delete all entries from a MultiTerm termbase which has about 4000 entries.
I'm using MultiTerm 18.1.2.3594 and have set a reference to "C:\Program Files (x86)\Common Files\Trados\MultiTerm18\Sdl.MultiTerm.TMO.dll".

Im using the following for... next loop:

For entryCount = 1 To oTb.Entries.Count
    Console.WriteLine($"EntryCount: {entryCount}")
    If oTb IsNot Nothing Then
        If oTb.Entries IsNot Nothing Then
            oTb.Entries.Item(oTb.Entries.GetEntryIDs(entryCount)).Delete()
        End If
    End If
Next

Unfortunately, runnnig that loop leads to the following error message after running some time and deleting entries as expected.

"An HRESULT E_FAIL error was returned when calling a COM component.
StackTrace: at MultiTermIX.IEntryIDs.get_Item(Int32 Index)
at MultiTerm_BatchImportExport.DatabaseImportExport._Closure$__6-0._Lambda$__1() in C:\tmp\MultiTerm-BatchImportExport.vb:Line 168."

What I'm really wondering about is, that the error is gone, if I'm exchanging the context of line 168, which is "oTb.Entries.Item(oTb.Entries.GetEntryIDs(entryCount)).Delete()", by "Console.WriteLine($"Content: {oTb.Entries.Item(oTb.Entries.GetEntryIDs(entryCount)).Content.Content}")".

I don't have any clue, why deleting the entries leads to that error, but listing the context of each entry does not.

Please be so kind to let me know, what I'm doing wrong.
Any help and even a hint, pointing me in the right direction is very much appreciated.

If you have any further question or if you need any further information, please don't hesitate to let me know.

Best regards and have a nice day.
Nils

How to Invoke Native Find/Replace with Highlighting and Reset Display Filter Actions from Plugin Code?

Sameh Elsharkawy — Tue, 11 Nov 2025 17:15:15 GMT

Hello RWS Developer Community,

My name is Sameh Ragab, and I'm the developer of the TWAS Studio Assistant plugin (available on RWS AppStore). I'm reaching out to get guidance on implementing native Trados Studio behaviors within my plugin's Find/Replace and Display Filter functionality.

Background

My plugin includes a Regex Manager with Find/Replace and Display Filter features. While I can successfully navigate to segments and apply custom display filters using the public API, I'm unable to replicate certain native Studio behaviors that would significantly improve user experience.

Specific Technical Questions

1. Find Next with Native Text Highlighting

Current Implementation: I use EditorController.ActiveDocument.SetActiveSegmentPair(paragraphUnitId, segmentId, true) to navigate to matching segments, but the matched text is not highlighted like it is when using Studio's native Find (Ctrl+F → F4).
Question: Is there an Action class or API method I can invoke to trigger Studio's native Find Next functionality with text highlighting? I've tried SendKeys with F4, but this feels like a workaround rather than a proper integration.
Desired Behavior: When my plugin finds a match (plain text or regex), the matching text should be highlighted in orange, just like Studio's native Find dialog.

2. Reset Display Filter Action

Current Implementation: I call ActiveDocument.ApplyFilterOnSegments(null) to clear filters programmatically, and use SendKeys.SendWait("^%{F6}") to invoke the native Reset Filters command.
Question: Is there an Action class (similar to how Studio uses ExecuteAction<TAction>()) for the Reset Display Filter command? What's the proper way to invoke this natively without relying on SendKeys?
Desired Behavior: A single API call that performs the complete filter reset, just like Ctrl+Alt+F6.

3. Access to Advanced Display Filter Implementation

Observation: The Studio's Advanced Display Filter is very powerful, but I couldn't find its source code in the Sdl-Community GitHub repository.
Question: Is the Advanced Display Filter implementation available publicly? If so, where can I find it? Understanding how Studio implements this feature would help me better integrate my custom IDisplayFilter implementation.

4. General Editor Integration Guidance

Question: Is there documentation or sample code demonstrating how plugins can invoke Studio's native editor commands/actions programmatically? Specifically:
- Find/Replace operations with highlighting
- Filter management (apply, clear, reset)
- Search scope configuration (source/target, case-sensitive, regex mode)

What I've Already Tried

✅ Successfully implemented IDisplayFilter for custom segment filtering
✅ Using EditorController and ActiveDocument API for segment navigation
✅ Reviewed the Sdl-Community repository for similar implementations
✅ Studied the Studio API Documentation
❌ Unable to find Action classes or command IDs for Find Next and Reset Filters
❌ No examples of native Find/Replace invocation with highlighting in public plugins

Development Environment

Language: C# (.NET Framework 4.8)
Target: Trados Studio 2024 (Studio 18)
Referenced Assemblies:
- Sdl.TranslationStudioAutomation.IntegrationApi
- Sdl.FileTypeSupport.Framework.BilingualApi
- Sdl.Desktop.IntegrationApi

Request

If anyone from the RWS development team or experienced plugin developers could point me to:

The correct Action classes or API methods for native Find/Replace and Reset Filters
Documentation on Studio's command/action system
Source code references for Advanced Display Filter (if publicly available)
Any code samples demonstrating proper editor command integration

I would be extremely grateful. My goal is to provide users with a seamless experience that feels native to Studio rather than relying on workarounds like SendKeys.

Thank you in advance for your help!

Best regards,
Sameh Ragab
Developer, TWAS Studio Assistant

How to update the STAGE of a project via the Trados API

Intrawelt Flow Handler — Fri, 07 Nov 2025 09:39:02 GMT

Hello, i need to update the stage of a Trados project via the API. However, I do not find anything on the official documentation. With stages I mean how can I pass from the "Preprocessing" stage to the "Translation" stage. Can you help me? 🙂

Error when setting value in import task settings

Bram van der Steen — Fri, 31 Oct 2025 16:43:38 GMT

Good day,

In our plugin with Studio 2024, we are trying to run the automatic task “UpdateFromExternalReview” via the Studio API. However, when preparing the task settings, we receive an error. See the following code snippet:

ISettingsBundle settings = project.GetSettings();
Sdl.ProjectApi.Settings.ImportFromReviewTaskSettings importTaskSettings = settings.GetSettingsGroup<Sdl.ProjectApi.Settings.ImportFromReviewTaskSettings>();
importTaskSettings.ExternalReviewMappingItems.Value = reviewedItems;

When setting this value, we receive the following error:

No set method for property 'IsoAbbreviation' in type 'Sdl.Core.Globalization.LanguageBase'. ---> System.Runtime.Serialization.InvalidDataContractException: No set method for property 'IsoAbbreviation' in type 'Sdl.Core.Globalization.LanguageBase'.
at System.Runtime.Serialization.DataContract.DataContractCriticalHelper.ThrowInvalidDataContractException(String message, Type type)
at WriteLanguageToXml(XmlWriterDelegator , Object , XmlObjectSerializerWriteContext , ClassDataContract )
at System.Runtime.Serialization.ClassDataContract.WriteXmlValue(XmlWriterDelegator xmlWriter, Object obj, XmlObjectSerializerWriteContext context)
at System.Runtime.Serialization.XmlObjectSerializerWriteContext.WriteDataContractValue(DataContract dataContract, XmlWriterDelegator xmlWriter, Object obj, RuntimeTypeHandle declaredTypeHandle)
at System.Runtime.Serialization.XmlObjectSerializerWriteContext.SerializeWithoutXsiType(DataContract dataContract, XmlWriterDelegator xmlWriter, Object obj, RuntimeTypeHandle declaredTypeHandle)
at System.Runtime.Serialization.XmlObjectSerializerWriteContext.InternalSerialize(XmlWriterDelegator xmlWriter, Object obj, Boolean isDeclaredType, Boolean writeXsiType, Int32 declaredTypeID, RuntimeTypeHandle declaredTypeHandle)
at WriteExternalReviewMappingItemToXml(XmlWriterDelegator , Object , XmlObjectSerializerWriteContext , ClassDataContract )
at System.Runtime.Serialization.ClassDataContract.WriteXmlValue(XmlWriterDelegator xmlWriter, Object obj, XmlObjectSerializerWriteContext context)
at System.Runtime.Serialization.XmlObjectSerializerWriteContext.WriteDataContractValue(DataContract dataContract, XmlWriterDelegator xmlWriter, Object obj, RuntimeTypeHandle declaredTypeHandle)
at System.Runtime.Serialization.XmlObjectSerializerWriteContext.SerializeWithoutXsiType(DataContract dataContract, XmlWriterDelegator xmlWriter, Object obj, RuntimeTypeHandle declaredTypeHandle)
at System.Runtime.Serialization.XmlObjectSerializerWriteContext.InternalSerialize(XmlWriterDelegator xmlWriter, Object obj, Boolean isDeclaredType, Boolean writeXsiType, Int32 declaredTypeID, RuntimeTypeHandle declaredTypeHandle)
at WriteArrayOfExternalReviewMappingItemToXml(XmlWriterDelegator , Object , XmlObjectSerializerWriteContext , CollectionDataContract )
at System.Runtime.Serialization.CollectionDataContract.WriteXmlValue(XmlWriterDelegator xmlWriter, Object obj, XmlObjectSerializerWriteContext context)
at System.Runtime.Serialization.XmlObjectSerializerWriteContext.WriteDataContractValue(DataContract dataContract, XmlWriterDelegator xmlWriter, Object obj, RuntimeTypeHandle declaredTypeHandle)
at System.Runtime.Serialization.XmlObjectSerializerWriteContext.SerializeWithoutXsiType(DataContract dataContract, XmlWriterDelegator xmlWriter, Object obj, RuntimeTypeHandle declaredTypeHandle)
at System.Runtime.Serialization.DataContractSerializer.InternalWriteObjectContent(XmlWriterDelegator writer, Object graph, DataContractResolver dataContractResolver)
at System.Runtime.Serialization.DataContractSerializer.InternalWriteObject(XmlWriterDelegator writer, Object graph, DataContractResolver dataContractResolver)
at System.Runtime.Serialization.XmlObjectSerializer.WriteObjectHandleExceptions(XmlWriterDelegator writer, Object graph, DataContractResolver dataContractResolver)
at System.Runtime.Serialization.DataContractSerializer.WriteObject(XmlWriter writer, Object graph)

This error is mysterious to us, as there's no obvious connection to what we're trying to do.

The error occurred both in versions 18.0.1.2259 and 18.1.2.6370.

Any help would be greatly appreciated.

Best regards,
Bram van der Steen

What is the best way for a Trados Studio Translation Service Provider plugin to access and search an sdltb (MultiTerm termbase) file?

hiroshi kameya — Wed, 29 Oct 2025 06:30:20 GMT

I am currently developing an
Translation Service Provider plugin for Trados Studio using C#. I would like the plugin to directly access and search the sdltb (MultiTerm termbase) file, and automate terminology recognition and replacement during translation.

- Goal: The plugin should be able to obtain terminology recognition results from the sdltb file and automatically apply the recognized terms to the translation process.
- What I've tried: I have searched the official SDK documentation and past threads in the Developer Community. The MultiTerm SDK is rather old, and it seems hard to get sufficient information using only the newer Studio API.
- What I am looking for: Please share recommended approaches, API references, sample code, examples from existing plugins, or direct readout techniques (OLEDB, etc.).
- Environment: Trados Studio 2024/ C#

Any insights from those who have tackled similar challenges, or the latest official API information, would be very appreciated.
I appreciate any code snippets or implementation details from your experience.
Thank you!

Translation Provider Exception when testing Studio 2024 (SR1)

Johan Lapasset — Mon, 06 Oct 2025 14:49:49 GMT

Context

Since few weeks we are facing an issue (translation provider exception, see details below) which prevents to perform the Finalization in our internal application using Studio 2024 (SR1) APIs.

We have already performed several tests in order to try to identify the cause but without success.

Someone would have an idea what could be the cause and how to solve it?

Here are the environment details :

 The code is executed in a separate application (CAT Client), it is not executed in a Plugin.

 Finalization, when launched in CAT Client, triggers the translation provider exception (see details below)

 Finalization, when launched directly in studio 2024, works correctly

 Groupshare version: GS:15.1.13.14280 - GS 2020 SR1 CU13

 Studio Version: Studio 2021 SR2 - 16.2.9.9198

 Studio Version: Studio 2024 SR1 (18.0.2.3255)

Here are the main tests already done:

 CAT Client 3.2.1 with Studio 2021 works without issue

 CAT Client 4.0.0 (last version of our internal application adapted to studio 2024) but using Studio 2021 works without issue

 CAT Client 4.0.0 using Studio 2024 finalization doesn’t work (triggers the translation provider exception)

Description of the issue:

In our C# application, the API method to update the main memory generate a fatal exception if some Groupshare memories are attached and enabled in the project.

The only way to avoid this exception is to disable all remote memories attached to the project before executing the update main memory batch task.

This exception occurs only when the application uses the Studio 2024 API, on a specific set of groupshare servers.

NB: groupshare server are correctly setup in Trados Studio, correctly enabled in the project, and the connection to the servers is correctly established.

C# code used to update the main memory in our application :

ProjectAutomaticTaskRunner taskRunner = new ProjectAutomaticTaskRunner(project); taskRunner.addTemplateTaskId(AutomaticTaskTemplateIds.UpdateMainTranslationMemories); taskRunner.addTemplateTaskId(AutomaticTaskTemplateIds.GenerateTargetTranslations); taskRunner.runTasks(fileIdList);

(optional) List of automatic task used by our application, possibly affected by the issue:

AutomaticTaskTemplateIds.PerfectMatch

AutomaticTaskTemplateIds.Scan

AutomaticTaskTemplateIds.ConvertToTranslatableFormat

AutomaticTaskTemplateIds.CopyToTargetLanguages

AutomaticTaskTemplateIds.AnalyzeFiles

AutomaticTaskTemplateIds.UpdateMainTranslationMemories

AutomaticTaskTemplateIds.GenerateTargetTranslations

Error returned by the exception:

ProjectAutomationException: Unexpected exception when configuring file multiFileConverter for task 'Update Main Translation Memories': Failed to create an instance of translation provider 'sdltm.gsweb-prd-09.net1.cec.eu.int/.../NormativeMem_EN-FR'

NB: in this example, gsweb-prd-09.net1.cec.eu.int is the correct URL of our groupshare server. "/Public/Resources/NormativeMem_EN-FR" is the path where is store the memory, defined in the CSPROJ this way:

<CascadeEntryItem PerformConcordanceSearch="true" Penalty="2" PerformUpdate="true" PerformNormalSearch="true"> <MainTranslationProviderItem Uri="sdltm.">gsweb-prd-09.net1.cec.eu.int/.../NormativeMem_EN-FR" Enabled="true" /> </CascadeEntryItem>

The server is correctly setup in Studio, using the Windows default user authentication (without password).

The content of this memory is correctly accessible in the translation, in Studio Editor.

Complete stacktrace

   at Sdl.ProjectApi.AutomaticTasks.UpdateTm.AbstractUpdateTmContentProcessor.ProcessBuffer()
   at Sdl.ProjectApi.AutomaticTasks.UpdateTm.AbstractUpdateTmContentProcessor.ProcessWaitingParagraphs()
   at Sdl.ProjectApi.AutomaticTasks.UpdateTm.AbstractUpdateTmContentProcessor.ProcessParagraphUnit(IParagraphUnit paragraphUnit)
   at Sdl.FileTypeSupport.Framework.BilingualApi.AbstractBilingualContentProcessor.ProcessParagraphUnit(IParagraphUnit paragraphUnit)
   at Sdl.FileTypeSupport.Filters.Processors.SegmentRenumberingBilingualProcessor.ProcessParagraphUnit(IParagraphUnit paragraphUnit)
   at Sdl.FileTypeSupport.Framework.Core.Utilities.BilingualApi.BilingualContentHandlerAdapter.ProcessParagraphUnit(IParagraphUnit paragraphUnit)
   at Sdl.FileTypeSupport.Framework.Core.Utilities.BilingualApi.BilingualContentHandlerAdapter.ProcessParagraphUnit(IParagraphUnit paragraphUnit)
   at Sdl.FileTypeSupport.Framework.Integration.AbstractBilingualProcessorContainer.ProcessParagraphUnit(IParagraphUnit paragraphUnit)
   at Sdl.FileTypeSupport.Framework.BilingualApi.AbstractBilingualContentProcessor.ProcessParagraphUnit(IParagraphUnit paragraphUnit)
   at Sdl.FileTypeSupport.Framework.Integration.LocationMarkerLocator.ProcessParagraphUnit(IParagraphUnit paragraphUnit)
   at Sdl.FileTypeSupport.Framework.Integration.AbstractBilingualProcessorContainer.ProcessParagraphUnit(IParagraphUnit paragraphUnit)
   at Sdl.FileTypeSupport.Framework.Integration.FileExtractor.ProcessParagraphUnit(IParagraphUnit paragraphUnit)
   at Sdl.FileTypeSupport.Framework.Core.Utilities.BilingualApi.ParagraphUnitBuffer.Release()
   at Sdl.FileTypeSupport.Bilingual.SdlXliff.XliffFileReader.OutputParagraphUnit(IParagraphUnit pu)
   at Sdl.FileTypeSupport.Bilingual.SdlXliff.XliffFileReader.ParseLocalizableParagraphUnit(transunit transunit, LockTypeFlags lockFlags)
   at Sdl.FileTypeSupport.Bilingual.SdlXliff.XliffFileReader.ParseTransUnit(transunit transunit)
   at Sdl.FileTypeSupport.Bilingual.SdlXliff.XliffFileReader.ParseGroup(group group)
   at Sdl.FileTypeSupport.Bilingual.SdlXliff.XliffFileReader.OnGroup(XmlElement group)
   at Sdl.FileTypeSupport.Bilingual.SdlXliff.SdlXliffFeeder.<ContinueScanning>b__14_11(ISdlXliffStreamContentHandler handler)
   at System.Collections.Generic.List`1.ForEach(Action`1 action)
   at Sdl.FileTypeSupport.Bilingual.SdlXliff.SdlXliffFeeder.ContinueScanning()
   at Sdl.FileTypeSupport.Bilingual.SdlXliff.XliffFileReader.ContinueParsing()
   at Sdl.FileTypeSupport.Bilingual.SdlXliff.XliffFileReader.ParseNext()
   at Sdl.FileTypeSupport.Framework.Integration.FileExtractor.ParseNext()
   at Sdl.FileTypeSupport.Framework.Integration.MultiFileConverter.ParseNext()
   at Sdl.FileTypeSupport.Framework.Integration.MultiFileConverter.Parse()
   at Sdl.ProjectApi.Implementation.TaskExecution.ContentProcessingTaskImplementation.TaskFileExecuter.Parse(String targetFilePath)'.

Plugin buttons missing when Comments are not displayed

Thomas CORDONNIER — Mon, 06 Oct 2025 14:28:20 GMT

[RibbonGroup("DGTQATButtonsGroup", ContextByType = typeof(EditorController))]

[RibbonGroupLayout(LocationByType = typeof(TranslationStudioDefaultRibbonTabs.EditorReviewRibbonTabLocation))]

class DGTQATButtonsGroup : AbstractRibbonGroup

{

}

[Action("CountComents", Icon = "trad19_view-evaluation_icon")]

[ActionLayout(typeof(DGTQATButtonsGroup), 1, DisplayType.Large)]

class StatsButton : AbstractAction

{

…

}

When we open a document in review mode, it initially appears correctly:

Our problem is the following:

On Studio 2021, the ribbon group disappears unless the “Translation results” pane is selected
On Studio 2024, the ribbon group disappears unless the “Comments” pane is selected:

I don’t see any logical relation between selected results pane and ribbons, but multiple users have experimented this and came to same conclusion.

I also did not find anything in the API doing such a link:

[AttributeUsage(AttributeTargets.Class)]

[ExtensionPointInfo("Ribbon Groups", ExtensionPointBehavior.Static)]

public class RibbonGroupAttribute : AbstractCommandBarItemAttribute

{

public RibbonGroupAttribute(string id);

public RibbonGroupAttribute(string id, string name);

public RibbonGroupAttribute(string id, Type contextByType);

public RibbonGroupAttribute(string id, string name, Type contextByType);

}

[AttributeUsage(AttributeTargets.Class, AllowMultiple = true)]

public sealed class RibbonGroupLayoutAttribute : AbstractLayoutAttribute

{

[EditorBrowsable(EditorBrowsableState.Never)]

public RibbonGroupLayoutAttribute();

public RibbonGroupLayoutAttribute(Type locationType);

}

The only parameter indicating ribbon’s location is “contextByType”, all the samples I saw were using TranslationStudioDefaultRibbonTabs.EditorReviewRibbonTabLocation

I do not see any parameter related to tabs in the editor.

Also the class AbstractRibbonGroup is empty, no parameter to be set without C#’s annotations.

Is there any way to have the ribbon group appearing each time the "Review" part is selected, independently from what is selected in the part which contains translation results or comments?

Adding comments to sdlxliff file target segments

Arturo Vazquez Rodriguez — Tue, 30 Sep 2025 14:06:29 GMT

Hello,

I'm looking for some examples about adding comments to target segments. I have looked in the community Github repo, but I could only find how to read the comments from segments using a segment visitor.

Therefore, I was wondering if there was anything exposed to add comments to target segments, if possible, without using the editor controller. Could you point me into the right direction?

Thanks!

Kind regards,
Arturo

Sdl.MultiTerm.TMO.Interop + Trados studio 2024 SR1

Helena Grulichova — Wed, 03 Sep 2025 08:57:51 GMT

Hello,

We have used a reference to Sdl.MultiTerm.TMO.Interop in our custom terminology provider for Trados Studio. But it stops working after the SR1 update. I can see that the dll was removed from the Trados Studio folder (and it is mentioned in the Release Notes). How can I use the MultiTerm API now? I tried to reference the .dll from $(MSBuildProgramFiles32)\Common Files\Trados\MultiTerm18\Sdl.MultiTerm.TMO.Interop.dll but it throws an error when starting the plugin.

Thanks,
Helena

TerminologyProvider does not reliably generate scores for Fuzzy Search

Lukas Ley — Mon, 01 Sep 2025 09:42:43 GMT

Hello,

I am using Trados Studio 2024 (not SR1) and I have another question.

After getting the search with the TerminologyProviderManager Singleton to work (see the answers in this question) I noticed some strange behavior.
My goal is to get the scores for terms like they are displayed in the "Term Recognition" view in the Editor UI. Ideally I want to put the whole segment string in and get the scores.

When I search via ITerminologyProivder.Search() the scores never line up. Even if I put in only a single term it only lines up when there is a 100% match.

When I put in a longer sentence the score for the best fitting term decreases with the length of the sentence.

For example see this code from the other question:

var sourceLanguage = new CultureInfo("en-US");
var targetLanguage = new CultureInfo("de-DE");
string segmentText = "...";
int maxResultsCount = 10;
bool targetRequired = true;

var searchResults = terminologyProvider.Search(
    segmentText,
    sourceLanguage,
    targetLanguage,
    maxResultsCount,
    SearchMode.Fuzzy,
    targetRequired
);

If I have a Termbase with the word "Gefahrstoff" in it and when I set the segmentText to "Gefahrstoff" the top searchResult has a score of 100.

If i set the segmentText to "Gefahrstoffen" it has a score of 90. In the Term Recognition view in the Editor UI, "Gefahrstoff" has a Score of 87. The sentence in the Editor is "Die Nutzung von Gefahrstoffen ist gefährlich".
When I set the segmentText to "Die Nutzung von Gefahrstoffen ist gefährlich" the term "Gefahrstoff" has only a score of 63.

Do i really need to parse the thext and search for each token? I would like to avoid doing that. And even if i did that the scores do not line up.

Is there any method for getting the same scores?

Best,
Lukas

Trados Studio 2024: SearchSegment is called multiple times for a single active segment, and provider cannot access active/neighbor segments’ context?

hiroshi kameya — Tue, 26 Aug 2025 09:21:06 GMT

Context
I’m developing a custom MT translation provider plug-in for Trados Studio 2024 (Studio18).
The provider implements ITranslationProvider and ITranslationProviderLanguageDirection, and returns SearchResults from SearchSegment.

Environment
• Trados Studio: 18.0.1.2259 (Studio18)
• Sdl.Core.PluginFramework.Build: 18.0.1
• .NET Framework: 4.8
• OS: Windows 10 Enterprise
• Language pair: ja-JP → en-US

Goal
I want to build a context-aware MT provider that uses surrounding segments (previous/next) to improve translation quality during interactive editing in the Studio editor.

Observations
• When the first segment becomes active in the editor, SearchSegment is called multiple times (4+), even without navigating to another segment.
• The API does not expose which segment is currently active, nor does it allow querying adjacent segments from within SearchSegment.
• I also observe parallel calls on different threads, and calls for the next segment (likely prefetch), which I assume are part of editor optimizations.

Minimal code surface
• SearchSegment signature I use: public SearchResults SearchSegment(SearchSettings settings, Segment segment)
• I log each invocation with a correlation id and thread id. Example excerpt: [DEBUG] SearchSegment start. mode=NormalSearch, sourceText(len)=29 [DEBUG] SearchSegment start. mode=NormalSearch, sourceText(len)=36
• GetLanguageDirection is also called repeatedly; I cache the language direction instance on my side.

What I expected
• Either a way to:
• Know which segment is currently active in the editor (e.g., an index/id or context object), and/or
• Retrieve adjacent segments (previous/next) from within SearchSegment for better context handling,
• Or official guidance on the intended pattern to access reliable context for interactive MT in the editor.

What I tried already
• Implemented only SearchSegment for interactive use (SearchSegments is used in batch; I can see order there).
• Confirmed SupportsTranslation = true; removed all NotImplementedException from the pipeline methods.
• Added logging; observed that SearchSegment is invoked multiple times for what appears to be the active segment and also for its neighbor (prefetch).
• Considered heuristics (thread-local last query cache), but they are not reliable because of prefetch and parallel execution.

Questions
1. Is it expected that SearchSegment is called multiple times for a single active segment and also for neighboring segments (prefetch) in the editor?
2. Is there any supported API to:
• Identify which segment is currently active in the editor from within SearchSegment?
• Retrieve previous/next segment text (or broader paragraph context) during interactive translation?
3. If direct editor context is not available by design, what are the recommended best practices for building a context-aware MT provider in Studio (e.g., leveraging structure context, different interfaces, or another extension point)?
4. Are there sample providers or documentation that demonstrate accessing reliable context during interactive editing?

Thanks in advance for any pointers or references to official docs/samples.

My plugin's translation results are not displayed alongside those from other plugins in Trados 2024.

NICT Dev — Fri, 22 Aug 2025 00:03:55 GMT

I'm currently developing an add-in for Trados 2024.

I've been informed of an issue where translation results cannot be retrieved simultaneously when other companies' add-ins are also in use.

========================

Is it possible to use third-party add-ins in order to test this issue?

Currently, when I try to use another company's add-in, I receive the following message upon launching the application:

"You are not currently subscribed to a machine translation package.
To select a package, please access your account."

========================

Could setting TranslationProviderInfo.TranslationMethod to "Other" be related to the issue?

class TranslationProviderFactory : ITranslationProviderFactory
{

public TranslationProviderInfo GetTranslationProviderInfo(Uri translationProviderUri, string translationProviderState)
{
TranslationProviderInfo info = new TranslationProviderInfo();
info.TranslationMethod = TranslationMethod.Other;
info.Name = "MyAddinName";
return info;
}

Direct Upload of Add-in Updates to RWS AppStore?

NICT Dev — Thu, 21 Aug 2025 23:35:16 GMT

At present, is there any method available for developers to directly upload updated versions of their own add-ins to the RWS AppStore?

How do you usually upload the latest version of your add-in?

Do you contact someone at RWS by email to request the update?

Plugin manifest versioning

Helena Grulichova — Mon, 18 Aug 2025 12:35:02 GMT

Hello,

I am testing our custom terminology provider plugin on different machines and using versioning in pluginpackage.manifest.xml. If I want to test a new version of the plugin, I increase the version number, for example:

Then I copy the new .sdlplugin file to another machine. I uninstall all previous versions of my plugin in Trados Studio, close it, and remove all plugin files from:
%AppData%\Trados\Trados Studio\18\Plugins\

After that, I copy the .sdlplugin file to:
%AppData%\Trados\Trados Studio\18\Plugins\Packages\

Then I double-click to install the plugin and start Trados Studio. At this point, I get a dialog message about loading the custom plugin three times (why three times?).

In Trados Studio, under Add-Ins → RWS AppStore → Installed plug-ins, I can see three instances of my plugin, all showing the correct version number. However, in Project Settings → Termbases → Use, the plugin is also listed three times, but they are all old versions, not the latest one.

I expect to see only one instance of my plugin—the latest version. What am I doing wrong?

Best regards,
Helena

Why is my custom Global Verifier being instantiated multiple times during a single "Verify Files" batch task?

hiroshi kameya — Mon, 18 Aug 2025 08:12:42 GMT

I’m developing a custom global verifier for Trados Studio 2024 (v18.0.1.2259), implementing both IGlobalVerifier and IBilingualVerifier. My goal is to maintain shared state across multiple files during a batch verification task.

However, during a "Verify Files" batch run, I observed that the Verifier class is instantiated three times, even though I expected a single instance for the entire batch. This was confirmed by adding logging to the constructor.

Here are my questions:

Is this expected behavior within Studio’s verification lifecycle?
Could it be related to how merged bilingual documents are processed during batch tasks?
Is the plugin instantiation tied to each merged document or file?
I want to know if Studio intentionally creates separate instances per document for lifecycle or isolation reasons.
What’s the best practice for maintaining shared state across files?
For example, should I use ISharedObjectsAware, or perhaps use static/shared storage keyed by batch or project ID.

Any insights or guidance about when and why multiple instances are created, or how to reliably share state across the verification process, would be greatly appreciated!