api.naming Правила нумерации объектов
-
api.naming.set(metaClass, rule, number)
Устанавливает следующий номер, который будет возвращен последовательностью N, ND, RND.
Использовать этот метод стоит только тогда, когда в системе не создаются объекты, при создании которых используются изменяемые последовательности. Типовое использование этого метода — выставление правильных номеров после первоначального импорта системы.
При использовании метода необходимо учитывать уникальность атрибута "Номер" (number):
- Если значения атрибута являются не уникальными и есть созданные объекты указанного класса, то "Номер" может дублироваться.
- Если значения атрибута являются уникальными и есть созданные объекты указанного класса, то "Номер" не может дублироваться и попытка создания объектов с не уникальным номером не будет успешной.
Параметры метода:
- metaClass — FQN метакласса;
-
rule — строка, определяет для какой последовательности будет устанавливаться значение.
Возможные значения:
- N — будет заменено системой на уникальный идентификатор;
- ND — будет заменено системой на уникальный номер в рамках дня;
- RND — будет заменено системой на случайный уникальный идентификатор.
- number — число, с которого начнется нумерация – number + 1.
Пример 1. number = 100, следующий запрос, у которого правило нумерации {N}, будет создан с номером 101:
api.naming.set('serviceCall', 'N', 100)
Пример 2. number = 100, следующий запрос, у которого правило нумерации {ND}, для текущей даты будет создан с номером 101, со следующего дня будет 1:
api.naming.set('serviceCall', 'ND', 100)