Codeunit 3711 Translation

System Application, System.Globalization

src/System Application/App/Translation/src/Translation.Codeunit.al211 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;/// <summary>/// Exposes function\alitys to add and retrieve translated texts for table fields./// </summary>codeunit 3711 Translation{    Access = Public;    var        TranslationImplementation: Codeunit "Translation Implementation";    /// <summary>    /// Checks if there any translations present at all.    /// </summary>    /// <returns>True if there is at least one translation; false, otherwise.</returns>    procedure Any(): Boolean    begin        exit(TranslationImplementation.Any());    end;    /// <summary>    /// Gets the value of a field in the global language for the record.    /// </summary>    /// <param name="RecVariant">The record to get the translated value for.</param>    /// <param name="FieldId">The ID of the field for which the translation is stored.</param>    /// <returns>The translated value.</returns>    /// <error>If the RecVariant parameter is the type Record, and it is temporary.</error>    /// <error>If the RecVariant parameter is the type Record, and the table number is 0.</error>    /// <example>    /// To get the value of the description field for an item record, call GetValue(Item, Item.FIELDNO(Description)).    /// </example>    /// <remarks>    /// If a translated record for the global language cannot be found it finds the Windows language translation.    /// If a Windows language translation cannot be found, return an empty string.    /// </remarks>    procedure Get(RecVariant: Variant; FieldId: Integer): Text    begin        exit(TranslationImplementation.Get(RecVariant, FieldId, GlobalLanguage(), true));    end;    /// <summary>    /// Gets the value of a field in the language that is specified for the record.    /// </summary>    /// <param name="RecVariant">The record to get the translated value for.</param>    /// <param name="FieldId">The ID of the field to store the translation for.</param>    /// <param name="LanguageId">The ID of the language in which to get the field value.</param>    /// <returns>The translated value.</returns>    /// <error>If the RecVariant parameter is the type Record, and it is temporary.</error>    /// <error>If the RecVariant parameter is the type Record, and the table number is 0.</error>    /// <example>    /// To get the value of the Description field for an item record in Danish, call GetValue(Item, Item.FIELDNO(Description), 1030).    /// </example>    procedure Get(RecVariant: Variant; FieldId: Integer; LanguageId: Integer): Text    begin        exit(TranslationImplementation.Get(RecVariant, FieldId, LanguageId));    end;    /// <summary>    /// Sets the value of a field to the global language for the record.    /// </summary>    /// <param name="RecVariant">The record to store the translated value for.</param>    /// <param name="FieldId">The ID of the field to store the translation for.</param>    /// <param name="Value">The translated value to set.</param>    /// <error>If the RecVariant parameter is the type Record, and it is temporary.</error>    /// <error>If the RecVariant parameter is the type Record, and the table number is 0.</error>    procedure Set(RecVariant: Variant; FieldId: Integer; Value: Text[2048])    begin        TranslationImplementation.Set(RecVariant, FieldId, Value);    end;    /// <summary>    /// Sets the value of a field to the language specified for the record.    /// </summary>    /// <param name="RecVariant">The record to store the translated value for.</param>    /// <param name="FieldId">The ID of the field to store the translation for.</param>    /// <param name="LanguageId">The language id to set the value for.</param>    /// <param name="Value">The translated value to set.</param>    /// <error>If the RecVariant parameter is the type Record, and it is temporary.</error>    /// <error>If the RecVariant parameter is the type Record, and the table number is 0.</error>    procedure Set(RecVariant: Variant; FieldId: Integer; LanguageId: Integer; Value: Text[2048])    begin        TranslationImplementation.Set(RecVariant, FieldId, LanguageId, Value);    end;    /// <summary>    /// Deletes all translations for a persisted (non temporary) record.    /// </summary>    /// <param name="RecVariant">The record for which the translations will be deleted.</param>    /// <error>If the RecVariant parameter is the type Record, and it is temporary.</error>    /// <error>If the RecVariant parameter is the type Record, and the table number is 0.</error>    procedure Delete(RecVariant: Variant)    begin        TranslationImplementation.Delete(RecVariant);    end;    /// <summary>    /// Deletes the translation for a field on a persisted (non temporary) record.    /// </summary>    /// <param name="RecVariant">The record with a field for which the translation will be deleted.</param>    /// <param name="FieldId">Id of the field for which the translation will be deleted.</param>    /// <error>If the RecVariant parameter is the type Record, and it is temporary.</error>    /// <error>If the RecVariant parameter is the type Record, and the table number is 0.</error>    procedure Delete(RecVariant: Variant; FieldId: Integer)    begin        TranslationImplementation.Delete(RecVariant, FieldId);    end;    /// <summary>    /// Deletes all the translation for a table ID.    /// </summary>    /// <param name="TableID">The table that the translations will be deleted for.</param>    procedure Delete(TableID: Integer)    begin        TranslationImplementation.Delete(TableID);    end;    /// <summary>    /// Copies the translation for a field from one record to another record on a persisted (non-temporary) record.    /// </summary>    /// <param name="FromRecVariant">The record from which the translations are copied.</param>    /// <param name="ToRecVariant">The record to which the translations are copied.</param>    /// <error>If the RecVariant parameter is of type Record, and it is temporary.</error>    /// <error>If the RecVariant parameter is of type Record, and the table number is 0.</error>    /// <error>If the FromRecVariant parameter is of type Record, the ToRecVariant parameter is of type Record and they are different.</error>    procedure Copy(FromRecVariant: Variant; ToRecVariant: Variant)    begin        TranslationImplementation.Copy(FromRecVariant, ToRecVariant, 0);    end;    /// <summary>    /// Copies the translation for a field from one record to another record on a persisted (non-temporary) record.    /// </summary>    /// <param name="FromRecVariant">The record from which the translations are copied.</param>    /// <param name="ToRecVariant">The record to which the translations are copied.</param>    /// <param name="FieldId">Id of the field for which the translation will be copied.</param>    /// <error>If the RecVariant parameter is of type Record, and it is temporary.</error>    /// <error>If the RecVariant parameter is of type Record, and the table number is 0.</error>    /// <error>If the FromRecVariant parameter is of type Record, the ToRecVariant parameter is of type Record and they are different.</error>    /// <error>If RecVariant passed is not of type Record.</error>    /// <error>If the FieldId is 0.</error>    procedure Copy(FromRecVariant: Variant; ToRecVariant: Variant; FieldId: Integer)    begin        TranslationImplementation.Copy(FromRecVariant, ToRecVariant, FieldId);    end;    /// <summary>    /// Copies the translation from one record's field to another record's field on a persisted (non-temporary) record.    /// </summary>    /// <param name="FromRecVariant">The record from which the translations are copied.</param>    /// <param name="FromFieldId">The id of the field from which the translations are copied.</param>    /// <param name="ToRecVariant">The record to which the translations are copied.</param>    /// <param name="ToFieldId">The id of the field to which the translations are copied.</param>    procedure Copy(FromRecVariant: Variant; FromFieldId: Integer; ToRecVariant: Variant; ToFieldId: Integer)    begin        TranslationImplementation.Copy(FromRecVariant, FromFieldId, ToRecVariant, ToFieldId);    end;    /// <summary>    /// Shows all language translations that are available for a field in a new page.    /// </summary>    /// <param name="RecVariant">The record to get the translated value for.</param>    /// <param name="FieldId">The ID of the field to get translations for.</param>    /// <error>If the RecVariant parameter is the type Record, and it is temporary.</error>    /// <error>If the RecVariant parameter is the type Record, and the table number is 0.</error>    procedure Show(RecVariant: Variant; FieldId: Integer)    begin        Show(RecVariant, FieldId, false);    end;    /// <summary>    /// Shows all language translations that are available for a field in a new page.    /// </summary>    /// <param name="RecVariant">The record to get the translated value for.</param>    /// <param name="FieldId">The ID of the field to get translations for.</param>    /// <param name="CheckFieldLength">If this value is true, then it's checked that the translation isn't longer than the field length.</param>    /// <error>If the RecVariant parameter is the type Record, and it is temporary.</error>    /// <error>If the RecVariant parameter is the type Record, and the table number is 0.</error>    procedure Show(RecVariant: Variant; FieldId: Integer; CheckFieldLength: Boolean)    begin        TranslationImplementation.Show(RecVariant, FieldId, CheckFieldLength);    end;    /// <summary>    /// Shows all language translations available for a given field for all the records in that table in a new page.    /// </summary>    /// <param name="TableId">The table ID to get translations for.</param>    /// <param name="FieldId">The ID of the field to get translations for.</param>    procedure ShowForAllRecords(TableId: Integer; FieldId: Integer)    begin        TranslationImplementation.ShowForAllRecords(TableId, FieldId);    end;    /// <summary>    /// Gets all available translations for a record into a temporary buffer.    /// If FieldId is 0, it retrieves translations for all fields.    /// </summary>    /// <param name="RecVariant">Source record variant</param>    /// <param name="FieldId">Field ID to get translations for. Use 0 to retrieve translations for all fields.</param>    /// <param name="TranslationBuffer">Output: Temporary buffer with translations</param>    /// <returns>True if translations were found</returns>    procedure GetTranslations(RecVariant: Variant; FieldId: Integer; var TranslationBuffer: Record "Translation Buffer"): Boolean    begin        exit(TranslationImplementation.GetTranslations(RecVariant, FieldId, TranslationBuffer));    end;}