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)