[BC Idea]: Add GetTranslations Method to Translation Codeunit

[diveshbora]

Summary

This pull request extends the System Application Translation module with a new public API for programmatic retrieval of translation data, addressing the requirements of partners and ISVs for custom translation workflows and data integration scenarios.

Current Gap: The existing Translation module API lacks bulk retrieval capabilities needed for:

• Adding translation to the custom tables and workflows
• Exporting translations for external processing

Technical Approach

Introduces a read-only query API following established System Application patterns, returning results via a temporary buffer table to ensure no database impact and maintain performance standards.

API Design

Public Procedure: GetTranslations

Location: codeunit 3711 "Translation" (System Application)

Signature:

procedure GetTranslations(RecVariant: Variant; FieldId: Integer; var TranslationBuffer: Record "Translation Buffer"): Boolean

Parameters:

Parameter	Type	Description
RecVariant	Variant	Source record (supports Record, RecordRef, or RecordId)
FieldId	Integer	Field number to query (0 = all fields)
TranslationBuffer	Record "Translation Buffer" (var)	Output buffer populated with results

Returns: Boolean - True if translations found, False otherwise

Design Rationale:

• Variant parameter - Maintains consistency with existing Translation.Set() and Translation.Get() APIs
• Temporary buffer output - Enables efficient batch processing without database writes
• Boolean return - Provides explicit success/failure indication for error handling
• Zero FieldId convention - Allows bulk retrieval across all translated fields

Work Item(s)

Fixes #5434

[github-actions]

Issue #5434 is not valid. Please make sure you link an issue that exists, is open and is approved.

[diveshbora]

@diveshbora please read the following Contributor License Agreement(CLA). If you agree with the CLA, please reply with the following information.

@microsoft-github-policy-service agree [company="{your company}"]

Options:

• (default - no company specified) I have sole ownership of intellectual property rights to my Submissions and I am not making Submissions in the course of work for my employer.

@microsoft-github-policy-service agree

• (when company given) I am making Submissions in the course of work for my employer (or my employer has intellectual property rights in my Submissions by contract or applicable law). I have permission from my employer to make Submissions and enter into this Agreement on behalf of my employer. By signing below, the defined term “You” includes me and my employer.

@microsoft-github-policy-service agree company="Microsoft"

Contributor License Agreement
@microsoft-github-policy-service agree company="Microsoft"

[pri-kise]

Could you please add some tests:

    [Test]
    [Scope('OnPrem')]
    procedure GetTranslationsForOneFieldFromRecord()
    var
        TranslationTestTable: Record "Translation Test Table";
        TranslationBuffer: Record "Translation Buffer"
        DestRecRef: RecordRef;
        SourceRecRef: RecordRef;
    begin
        // [SCENARIO] Translation must retrieved correctly for one field

        Initialize();
        PermissionsMock.Set(TranslationEditRoleTok);

        // [GIVEN] Create a record in TableA and set a translation for the fields FieldA and FieldB
        CreateRecord(TranslationTestTable);
        Translation.Set(TranslationTestTable, TranslationTestTable.FieldNo(TextField), Text1Txt);
        Translation.Set(TranslationTestTable, TranslationTestTable.FieldNo(SecondTextField), Text2Txt);

        // [WHEN] Translations are retrieved
        Translation.GetTranslations(SourceRecRef, TranslationTestTable.FieldNo(TextField), TranslationBuffer);

        // [THEN] Verify Translations
        //TODO:
    end;

    [Test]
    [Scope('OnPrem')]
    procedure GetTranslationsForAllFieldsFromRecord()
    var
        TranslationTestTable: Record "Translation Test Table";
        TranslationBuffer: Record "Translation Buffer"
        DestRecRef: RecordRef;
        SourceRecRef: RecordRef;
    begin
        // [SCENARIO] Translation must retrieved correctly for all fields when FieldId is 0 

        Initialize();
        PermissionsMock.Set(TranslationEditRoleTok);

        // [GIVEN] Create a record in TableA and set a translation for the fields FieldA and FieldB
        CreateRecord(TranslationTestTable);
        Translation.Set(TranslationTestTable, TranslationTestTable.FieldNo(TextField), Text1Txt);
        Translation.Set(TranslationTestTable, TranslationTestTable.FieldNo(SecondTextField), Text2Txt);

        // [WHEN] Translations are retrieved
        Translation.GetTranslations(SourceRecRef, 0, TranslationBuffer);

        // [THEN] Verify Translations
        //TODO:
    end;

[diveshbora]

@JesperSchulz Apologies for the inconvenience, but could we please expedite this?