Создание идентификаторов с последовательными номерами

Prev Next

Эта функция может генерировать идентификатор с последовательным номером

Кто может использовать эту функцию

Начиная с версии r338, Functions находится в стадии раннего доступа к производственной версии. Чтобы запросить доступ, обратитесь к вашему менеджеру по работе с клиентами.

Подробнее читайте в ветке сообщества здесь.

Функция «Создать идентификатор с последовательным номером» настроена для таблицы «Действия» общей модели данных. Если вы хотите использовать её для другой таблицы, вам необходимо настроить коннектор таблицы Tulip для этой конкретной таблицы.

Screenshot 2025-07-22 at 10.59.18.png

Введение

Функции позволяют вашей команде один раз создать общую или стандартизированную логику, а затем повторно использовать её в нескольких приложениях. В этом примере мы демонстрируем функции, с помощью которых можно массово обновлять поле «Статус» в нескольких рабочих заказах.

Поток выполнения функции

Алгоритм работы функции:Running ID flow v2.png

Пошаговое руководство

Функции запускаются триггером в приложении. В функции можно определить входные данные, которые должны быть предоставлены триггером, вызывающим функцию.

В данной конкретной функции требуются два входных параметра.Screenshot 2025-07-21 at 12.41.54.png

Кроме того, у этой функции есть выходные данные, которые можно использовать в приложении.

Screenshot 2025-07-21 at 12.41.59.png

Первым входным параметром является переменная «Префикс», а вторым — переменная «Длина». Эти две переменные передаются при вызове функции триггером. Функция использует эти входные параметры для выполнения. Screenshot 2025-07-21 at 14.01.58.png

Сначала функция вызывается триггером. Первым действием после вызова функции является генерация заполнителя идентификатора длиной 20 символов, что соответствует длине идентификатора SAP. Если в вашей операции используются более длинные идентификаторы, вы можете изменить этот заполнитель идентификатора в соответствии с вашими требованиями.

Screenshot 2025-07-22 at 9.39.26.png

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

Screenshot 2025-07-22 at 11.05.43.png

После того как функция извлечет последний идентификатор, она проверяет, существует ли он.Screenshot 2025-07-22 at 11.07.31.png

Если идентификатор не существует, будет сгенерирован новый. Для генерации нового идентификатора сначала необходимо установить длину идентификатора в соответствии со значением, указанным в поле «Длина идентификатора». Screenshot 2025-07-22 at 11.10.51.png

Второй шаг — генерация самого идентификатора. Функция использует заданный префикс, вновь указанную длину идентификатора и увеличивает номер на единицу.Screenshot 2025-07-22 at 11.13.47.png

Если полученный последний идентификатор существует, функция проверит длину идентификатора (без учета префикса).

Screenshot 2025-07-22 at 11.21.08.png

Далее функция проверяет, пусто ли второе поле ввода — поле «Длина ID».

Screenshot 2025-07-22 at 11.20.05.png

Если оно пустое, это означает, что пользователь хочет лишь увеличить номер существующего идентификатора. Для этого сначала необходимо извлечь число из идентификатора.

Screenshot 2025-07-22 at 11.22.54.png

Далее функция увеличивает ранее извлечённое число на 1.Screenshot 2025-07-22 at 11.24.03.png

Наконец, она генерирует новый ID. Screenshot 2025-07-22 at 11.26.43.png

Если поле «Длина ID» не было пустым, функция проверяет, совпадает ли длина ID с длиной последнего ID.Screenshot 2025-07-22 at 11.29.40.png

Если да, то, опять же, новый ID не будет сгенерирован, а существующий будет просто увеличен на 1. Функция извлечёт номер ID так же, как и в случае, когда поле «Длина ID» пустое, увеличит его на 1 и сгенерирует новый ID.

Если длина ID не совпадает с длиной последнего ID, функция сгенерирует новый ID. Для этого сначала необходимо установить длину ID в соответствии со значением, указанным в поле «Длина ID». Screenshot 2025-07-22 at 11.10.51.png

Второй шаг — генерация самого ID. Действие использует заданный префикс, вновь указанную длину ID и увеличивает число на единицу.Screenshot 2025-07-22 at 11.13.47.png

В конце функции в качестве результата вывода генерируется новая переменная ID. Её можно использовать в

Screenshot 2025-07-22 at 11.36.43.png{height="" width=""}приложении в качестве идентификатора новой записи в таблице.

Дополнительная информация

Если вы хотите узнать о других функциях, ознакомьтесь со следующими документами, чтобы расширить свои знания