Codeunit 3712 Translation Implementation
src/System Application/App/Translation/src/TranslationImplementation.Codeunit.al251 lines, Copyright (c) Microsoft Corporation. MIT
// ------------------------------------------------------------------------------------------------// Copyright (c) Microsoft Corporation. All rights reserved.// Licensed under the MIT License. See License.txt in the project root for license information.// ------------------------------------------------------------------------------------------------namespace System.Globalization;using System.Reflection;codeunit 3712 "Translation Implementation"{ Access = Internal; InherentEntitlements = X; InherentPermissions = X; Permissions = tabledata Translation = rimd; var CannotTranslateTempRecErr: Label 'Translations cannot be added or retrieved for temporary records.'; DifferentTableErr: Label 'The records cannot belong to different tables.'; NoRecordIdErr: Label 'The variant passed is not a record.'; NotAValidRecordForTranslationErr: Label 'Translations cannot be added for the record on table %1.', Comment = '%1 - Table number'; MaxLenghtErr: Label 'The provided translation "%1" must not exceed %2 characters (Current Length: %3).', Comment = '%1 = Translation, %2 = Max Length for translation, %3 = Current Length of Translation'; procedure Any(): Boolean var Translation: Record Translation; begin exit(not Translation.IsEmpty()); end; procedure Get(RecVariant: Variant; FieldId: Integer; LanguageId: Integer; FallbackToWindows: Boolean): Text var Translation: Record Translation; SystemId: Guid; TableNo: Integer; begin GetSystemIdFromVariant(RecVariant, SystemId, TableNo); if Translation.Get(LanguageId, SystemId, FieldId) then exit(Translation.Value); if FallbackToWindows then if Translation.Get(WindowsLanguage(), SystemId, FieldId) then exit(Translation.Value); exit(''); end; procedure Get(RecVariant: Variant; FieldId: Integer; LanguageId: Integer): Text begin exit(Get(RecVariant, FieldId, LanguageId, false)); end; procedure Set(RecVariant: Variant; FieldId: Integer; Value: Text[2048]) begin Set(RecVariant, FieldId, GlobalLanguage(), Value); end; procedure Set(RecVariant: Variant; FieldId: Integer; LanguageId: Integer; Value: Text[2048]) var Translation: Record Translation; Exists: Boolean; SystemId: Guid; TableNo: Integer; begin GetSystemIdFromVariant(RecVariant, SystemId, TableNo); Exists := Translation.Get(LanguageId, SystemId, FieldId); if Exists then begin if Translation.Value <> Value then begin Translation.Value := Value; Translation.Modify(true); end; end else begin Translation.Init(); Translation."Language ID" := LanguageId; Translation."System ID" := SystemId; Translation."Table ID" := TableNo; Translation."Field ID" := FieldId; Translation.Value := Value; Translation.Insert(true); end; end; procedure Delete(RecVariant: Variant) var Translation: Record Translation; begin DeleteTranslations(RecVariant, Translation); end; procedure Delete(RecVariant: Variant; FieldId: Integer) var Translation: Record Translation; begin Translation.SetRange("Field ID", FieldId); DeleteTranslations(RecVariant, Translation); end; procedure Delete(TableID: Integer) var Translation: Record Translation; begin Translation.SetRange("Table ID", TableID); Translation.DeleteAll(true); end; procedure Copy(FromRecVariant: Variant; ToRecVariant: Variant; FieldId: Integer) var Translation: Record Translation; FromRecordRef: RecordRef; ToRecordRef: RecordRef; begin GetRecordRefFromVariant(FromRecVariant, FromRecordRef); GetRecordRefFromVariant(ToRecVariant, ToRecordRef); if FromRecordRef.Number() <> ToRecordRef.Number() then Error(DifferentTableErr); Translation.SetRange("System ID", GetSystemIdFromRecordRef(FromRecordRef)); Translation.SetRange("Table ID", FromRecordRef.Number()); if FieldId <> 0 then Translation.SetRange("Field ID", FieldId); if Translation.FindSet() then repeat Set(ToRecVariant, Translation."Field ID", Translation."Language ID", Translation.Value); until Translation.Next() = 0; end; procedure Copy(FromRecVariant: Variant; FromFieldId: Integer; ToRecVariant: Variant; ToFieldId: Integer) var Translation: Record Translation; FromRecordRef: RecordRef; begin GetRecordRefFromVariant(FromRecVariant, FromRecordRef); Translation.SetRange("System ID", GetSystemIdFromRecordRef(FromRecordRef)); Translation.SetRange("Field ID", FromFieldId); if Translation.FindSet() then repeat Set(ToRecVariant, ToFieldId, Translation."Language ID", Translation.Value); until Translation.Next() = 0; end; local procedure DeleteTranslations(RecVariant: Variant; var TranslationWithFilters: Record Translation) var RecordRef: RecordRef; begin GetRecordRefFromVariant(RecVariant, RecordRef); TranslationWithFilters.SetRange("Table ID", RecordRef.Number()); TranslationWithFilters.SetRange("System ID", GetSystemIdFromRecordRef(RecordRef)); TranslationWithFilters.DeleteAll(true); end; procedure Show(RecVariant: Variant; FieldId: Integer; CheckFieldLength: Boolean) var Translation: Record Translation; TranslationPage: Page Translation; SystemID: Guid; TableNo: Integer; begin GetSystemIdFromVariant(RecVariant, SystemID, TableNo); Translation.SetRange("System ID", SystemID); Translation.SetRange("Field ID", FieldId); TranslationPage.SetTableId(TableNo); TranslationPage.SetCaption(GetRecordIdCaptionFromVariant(RecVariant)); TranslationPage.SetTableView(Translation); TranslationPage.SetCheckFieldLength(CheckFieldLength); TranslationPage.Run(); end; procedure ShowForAllRecords(TableId: Integer; FieldId: Integer) var Translation: Record Translation; begin Translation.SetRange("Table ID", TableId); Translation.SetRange("Field ID", FieldId); Page.Run(Page::Translation, Translation); end; procedure CheckLengthOfTranslationValue(var Translation: Record Translation) var Field: Record Field; begin Field.Get(Translation."Table ID", Translation."Field ID"); if StrLen(Translation.Value) > Field.Len then Error(MaxLenghtErr, Translation.Value, StrLen(Translation.Value), Field.Len); end; procedure GetTranslations(RecVariant: Variant; FieldId: Integer; var TranslationBuffer: Record "Translation Buffer"): Boolean var Translation: Record Translation; FromRecordRef: RecordRef; begin TranslationBuffer.Reset(); TranslationBuffer.DeleteAll(); GetRecordRefFromVariant(RecVariant, FromRecordRef); Translation.SetRange("System ID", GetSystemIdFromRecordRef(FromRecordRef)); Translation.SetRange("Table ID", FromRecordRef.Number()); if FieldId <> 0 then Translation.SetRange("Field ID", FieldId); if Translation.FindSet() then repeat TranslationBuffer.Init(); TranslationBuffer.TransferFields(Translation); TranslationBuffer.Insert(); until Translation.Next() = 0; exit(TranslationBuffer.FindFirst()); end; local procedure GetRecordIdCaptionFromVariant(RecVariant: Variant): Text var RecordId: RecordId; RecordRef: RecordRef; begin GetRecordRefFromVariant(RecVariant, RecordRef); RecordId := RecordRef.RecordId(); exit(Format(RecordId, 0, 1)); end; local procedure GetSystemIdFromVariant(RecVariant: Variant; var SystemId: Guid; var TableNo: Integer) var RecordRef: RecordRef; begin GetRecordRefFromVariant(RecVariant, RecordRef); SystemId := GetSystemIdFromRecordRef(RecordRef); TableNo := RecordRef.Number(); end; local procedure GetSystemIdFromRecordRef(RecordRef: RecordRef) SystemId: Guid begin Evaluate(SystemId, Format(RecordRef.Field(RecordRef.SystemIdNo()).Value())); // TODO: Uptake new method to directly get SystemID from record ref as soon as it is available end; local procedure GetRecordRefFromVariant(RecVariant: Variant; var RecordRef: RecordRef) begin if RecVariant.IsRecord() then begin RecordRef.GetTable(RecVariant); if RecordRef.IsTemporary() then Error(CannotTranslateTempRecErr); if RecordRef.Number() = 0 then Error(NotAValidRecordForTranslationErr, 0); exit; end; if RecVariant.IsRecordRef() then begin RecordRef := RecVariant; exit; end; Error(NoRecordIdErr); end;}