Labels and Best Practices

[Blog bot]

Источник: http://alexvoy.blogspot.com/2014/11/...practices.html
==============

Guys, please, do not forget that AX is really multilingual system and there are many other languages than English. Happy labelling!

Источник: http://alexvoy.blogspot.com/2014/11/...practices.html

[gl00mie]

А мне кажется, очень стрёмно делать ветвления в коде на основе текстовых строк - метками ли они задаются или нет. Фактически тут в код зашит строковый литерал, который в зависимости от языка, настроенного у пользователя, может быть подменен ядром на другой строковый литерал. Кто-то может залезть и поменять текст метки, потому что ему больше нравится другой вариант, и чего, все сломается?
Текстовые строки надо преобразовывать в Enum, если не преобразовалось - слать куда подальше, а если преобразовалось, то в коде уже принимать решения на основе значения Enum (в switch), включая обработку значений, которые не предусмотрены в коде (в default - выбрасывать ошибку). Если строк может быть очень много для Enum и они могут произвольно меняться, то можно настроечную таблицу завести и логику уже привязывать к найденной записи настроечной таблицы... Строковые литералы приемлемы, если они в макросах зашиты (скажем, названия элементов XML-схемы), а с метками их сравнивать - нафиг...

PS. А еще бывают экзотические языки, на которые те или иные метки еще не перевели, и тогда сравнение будет идти с пустой строкой. В случае преобразования строки в енум мы от таких ситуаций абстрагируемся.

[DSPIC]

Не в защиту такого подхода, но коллега упоминал, если label содержит {locked} в поле "description", то она не переводится на другие языки. Если это так, то для какого языка этот {locked} нужно указать?

[mazzy]

Цитата:

Сообщение от DSPIC

Если это так, то для какого языка этот {locked} нужно указать?

для английского.
первичными считаются метки на en-us

[gl00mie]

В подавляющем большинстве случаев это английский, но отнюдь не всегда, см. @SYS321896 .. @SYS322032 в AX 2012

[wojzeh]

ну, так я о том и написал, что BP не разрешает делать такие трюки с метками!

кстати говоря, а как проверить, что мы при импорте из текстового поля получили существующее значение перечисления (enum)?

как известно, первым идёт значение 0, оно же выбирается по умолчанию. как быть?

вот это вот "если не преобразовалось" - это как?

[S.Kuskov]

Цитата:

Сообщение от wojzeh

а как проверить, что мы при импорте из текстового поля получили существующее значение перечисления (enum)?

как известно, первым идёт значение 0, оно же выбирается по умолчанию. как быть?

Вариант 1.
При создании enum не присваивать ни одному из его значений код 0. Значение по умолчанию, все равно останется ноль, т.к. enum - это int, но теперь оно не будет совпадать ни с одним из его реальных значений.

Вариант 2. Перед использованием явно проинициализировать переменную enum несуществующим значением, например отрицательным.

[gl00mie]

я обычно проверяю так: если enum2str(enumValue) дает пустую строку, значит, предшествующий вызов enumValue = str2enum(...) завершился неудачно, стало быть, метка значения енума, переданная функции str2enum(), была неправильная.

PS. Технически при невозможности по метке определить значение енума функция str2enum() возвращает число 255, при том что максимальное число для значения енума - 250. Но зашивать в код такие особенности реализации типа if (any2int(enumValue) > 250) - это как-то совсем некрасиво, к тому же все может измениться в последующих версиях системы.

[belugin]

Цитата:

Сообщение от S.Kuskov

Вариант 1.
При создании enum не присваивать ни одному из его значений код 0. Значение по умолчанию, все равно останется ноль, т.к. enum - это int, но теперь оно не будет совпадать ни с одним из его реальных значений.

Вариант 2. Перед использованием явно проинициализировать переменную enum несуществующим значением, например отрицательным.

Вариант 3 - добавить в enum значение с 0 под названием None

[Ruff]

Цитата:

Сообщение от gl00mie

Но зашивать в код такие особенности реализации типа if (any2int(enumValue) > 250) - это как-то совсем некрасиво, к тому же все может измениться в последующих версиях системы.

С другой стороны, можно понадеяться на то, что в следующих версиях не забудут поправить строчку

#define.axdUnknownEnumValue(255)

в макросе Axd... Или это наивно?

[wojzeh]

Цитата:

Сообщение от belugin

Вариант 3 - добавить в enum значение с 0 под названием None

речь изначально шла об импорте значений из файла. соответственно нет нужды что-то менять на существующих enum. тем более для таких, как NoYes, например.

[wojzeh]

Цитата:

Сообщение от gl00mie

я обычно проверяю так: если enum2str(enumValue) дает пустую строку, значит, предшествующий вызов enumValue = str2enum(...) завершился неудачно, стало быть, метка значения енума, переданная функции str2enum(), была неправильная.

PS. Технически при невозможности по метке определить значение енума функция str2enum() возвращает число 255, при том что максимальное число для значения енума - 250. Но зашивать в код такие особенности реализации типа if (any2int(enumValue) > 250) - это как-то совсем некрасиво, к тому же все может измениться в последующих версиях системы.

это не совсем то. нужно не по метке найти значение, а по name. но я так понимаю, нет стандартных функций для этого, и единственный вариант это перебор внутри цикла по всем элементам перечисления через DictEnum.

[belugin]

Цитата:

Сообщение от wojzeh

речь изначально шла об импорте значений из файла. соответственно нет нужды что-то менять на существующих enum. тем более для таких, как NoYes, например.

Не важно откуда взялось значение, если оно допустимо, а декларация типа поля показывает, что недопустимо - декларация врет и при использовании поля могут быть ошибки.

Можно еще хранить признак корректности импорта где-то еще - в другом поле или даже в другой таблице. Но лучше не декларировать что в поле может быть только No и Yes и писать туда 3.145928

[wojzeh]

Цитата:

Сообщение от belugin

Не важно откуда взялось значение, если оно допустимо, а декларация типа поля показывает, что недопустимо - декларация врет и при использовании поля могут быть ошибки.

боюсь, я не понял, что ты сказал про декларацию. можешь пример привести?

[belugin]

Когда мы пишем

NoYes value;

Все кто читает этот код ожидает, что в value будет либо No либо Yes.

Введение неявных элементов перечисления нехорошо. Ибо по объявлению переменной становится непонятно, что собственно туда может попасть.

Более того, получается, что мы врем - говорим что там может быть либо No либо Yes, а там может оказаться что-то другое.

Правильнее, по-поему сделать либо так

NoYesEmpty value;

Либо так:

NoYes value;
NoYes valueIsEmpty;

[Ruff]

Цитата:

Сообщение от wojzeh

нет стандартных функций для этого, и единственный вариант это перебор внутри цикла по всем элементам перечисления через DictEnum.

Да ну, зачем цикл... вот так, например:

    info(strfmt('%1', new DictEnum(enumNum(SysDimension)).symbol2Value("Purpose")));

[wojzeh]

Цитата:

Сообщение от Ruff

Да ну, зачем цикл... вот так, например:

    info(strfmt('%1', new DictEnum(enumNum(SysDimension)).symbol2Value("Purpose")));

потому что для symbol2Value это метка, а не name.

[Ruff]

Нет. Метка - dictEnum.name2Value(), name - dictEnum.symbol2Value()
Только что проверил в AX2009:

[wojzeh]

Цитата:

Сообщение от Ruff

Нет. Метка - dictEnum.name2Value(), name - dictEnum.symbol2Value()
Только что проверил в AX2009:

твоя правда!

интересно, то, что мы оба правы: похоже, эта функция всеядна -- берёт и метку и имя.
что name2Value важно лишь совпадение по первым буквам.

[Ruff]

ага, но совпадение именно в метке. В твоем случае просто name совпадает с началом метки. У меня на русском так:

symbol2Value("Purch") = 1
name2Value("Purch") = 255
name2Value("Покупная") = 1