Локализация используется на 2 уровнях:
Чтобы включить/выключить режим работы языков, необходимо в процедуре as_getLayoutInfo установить параметр enableLang = 1.
Для локализации интерфейса используются метки из таблицы as_langText
Примечание.
Для локализации некой таблицы (в примере as_menu) используются дополнительные таблицы. Для каждой подобной таблицы создается своя таблица данных с именем as_lang_{tableName}.
tableName - это название соответствующей таблицы для которой мы хотим внедрить локализацию (она содержит строковые столбцы-аналоги первичной таблицы, строки в ней имеют значения для разных языков для этих полей)
В запросе бизнес-логики указываем примерно такой код (ожидаем что на входе в процедуру пришел @langID int):
ALTER PROCEDURE procedure [dbo].[as_getMenu]
@roles nvarchar(256),
@langID int = 0
AS
BEGIN
select m.id,
isnull(lm.name, m.name) as name,
m.url,
m.pattern,
m.parentID,
isnull(lm.title,m.title) as title,
m.preTitle,
m.cssclass,
m.ord
from as_menu m
left join as_lang_menu lm on lm.itemID = m.id and langID = @langID
where [dbo].[sec_hasAccessByUsersRoles] (@username, '', m.roles) = '1'
and (@username<>'' and isnull(isNotAuthMenu, '0')='0' or @username=''
and isNotAuthMenu='1')
Обратите внимание, как извлекаем значение текстового поля (через isnull - берем либо языковое поле, либо если его нет, то поле по умолчанию и основной таблицы)
Также обратите внимание, что делаем left join с таблицей as_lang_{tableName} по 2 условиям (langID и itemID).
Очень рекомендуется придерживаться этой схемы локализации - это упростит в дальнейшем сопровождение проекта.
Для этого создаем процедуру наподобие указанной ниже с именем as_lang_{tableName}_createTexts.
Она создаст недостающие элементы для языка.
ALTER PROCEDURE procedure [dbo].[as_lang_menu_createTexts]
@lang nvarchar(16)
AS
BEGIN
declare @langID int
select @langID = id from as_langs where code = @lang
insert into as_lang_menu (itemID, langID, name, title)
select id, @langID, name, title
from as_menu
where id not in (select itemID from as_lang_menu where [langID] = @langID)
END
В большинстве случаев langID вы можете взять из таблицы as_users по @username.
В некоторых случаях параметр языка будет передаваться в хранимую процедуру напрямую как langID.
Перевод сущностей делается через универсальную форму перевода отдельных полей под разные языки.
Есть некая сущность (entityCode), у которой есть поля (field).
Чтобы дать возможность перевода некоего поля сущности на разные языки, необходимо добавить универсальную форму редактирования языков для поля.
<a href="#" class="as-form-modal btn btn-success" data-code="langField" data-itemid="page_1054_title"><i class="fa fa-language" aria-hidden="true"></i></a>itemID - это {entityCode}_{entityID}_{fieldCode}
Для новой сущности необходимо реализовать доработки процедур (по примеру сущности page): для таблицы fieldLangValues хранимые процедуры GetItems и UpdateField (прописать в них логику по сохранению полей для pages).
Таким образом для каждого поля, которое требуется перевести на другие языки, добавляется подобная ссылка на модальную форму.
Если вам необходимо использовать некую строковую константу, которая должна быть локализована на другие языки, то используйте возможности, указанные ниже:
В хранимой процедуре используем @langID, извлеченный из @urlParameters и функцию dbo.as_lang.
Используйте именно функцию dbo.as_lang для вставки меток. Не используйте конструкцию iif(@langID=1, 'eng', ' rus') - в дальнейшем будет проблематично подключить 3 язык. При вставке as_lang одновременно сразу заносите в таблицу langTexts соответствующие значения.
Для этого передавайте ссылку с кодом языка - параметр lang=en-us.
Например, https://falconspace.ru/?lang=en-us
Также вы можете установить принудительно язык в процедуре GetLayout параметр SELECT 1 - defaultLang и дополнительно в appsettings.json параметр defaultLang (дело в том, что некоторые метки загружаются до получения данных GetLayout).
В процедуру search в параметре @filters передается спецпараметр langID.
В процедуру getItem можно передавать дополнительный необязательный параметр @parameters типа DictionaryParameter, в котором также передается langID.
Решение проблем при внедрении локализации:
Используйте процедуру as_lng для перевода отдельных строк (это позволит потом проще создавать переводные версии на другие языки, т.к. все эти метки будут храниться в таблице as_langTexts).
Пример использования:
declare @s1 nvarchar(max)
exec dbo.as_lng @code = 'textCode', @text='Default value', @langID=1, @part='part1', @res = @s1 output
Используя подобный подход вы автоматически сохраняете все значения в таблице для данного языка. Затем легко будет скопировать эти значения для другого языка и быстро перевести через таблицу langTexts.
Код процедуры as_lng:
CREATE OR ALTER PROCEDURE [dbo].[as_lng]
@code nvarchar(128),
@text nvarchar(max),
@langID int = 0,
@part nvarchar(32) = '',
@res nvarchar(max) OUTPUT
AS
BEGIN
if(@langID is null) begin
return @text
end
select @res=[text] from as_langTexts where langID = @langID and code = @code and partCode = @part
if(@res is null) begin
insert into as_langTexts(langID, code, partCode, [text]) values(@langID, @code, @part, @text)
set @res = @text
end
END