--- title: "Лучшие практики использования функций" slug: "functions-best-practices" updated: 2026-10-22T11:28:18Z published: 2026-10-22T11:28:18Z canonical: "support.tulip.co/functions-best-practices" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Лучшие практики использования функций Who can use Functions As of r380, Functions is generally available. **Read more in the [Community thread](https://community.tulip.co/t/functions-production-release-available-for-early-access/15658).** --- ## Используйте Functions для записи в таблицы ### Рекомендуемый подход Создавайте функции, когда несколько приложений или шагов приложения записывают данные в одну и ту же таблицу, а также когда необходимо обеспечить: - Обязательные поля - Допустимые значения (например, статус должен входить в утвержденный список) - Согласованность метаданных (создано кем, создано когда) **Почему это важно** Когда разработчики-любители создают записи в таблицах непосредственно в триггерах, они могут: - не соблюдать соглашения об именовании идентификаторов - Пропустить обязательные поля - допускать орфографические ошибки в значениях полей («in progress» вместо «in-progress») - непоследовательно заполнять метаданные Функция обеспечивает соблюдение единой схемы и предотвращает эти ошибки. **Пример** Вместо того чтобы позволять каждому разработчику приложения создавать записи «Образец» с несогласованными полями и содержанием, создайте функцию **«Создать образец»**, которая: - требует ввода согласованных данных (ID задания, тип образца, количество, метка времени, пользователь, название приложения) - проверяет, что тип образца входит в утвержденный список **Функция**:**CreateSample Входные данные:** - job_id (текст) - sample_type (текст) - quantity (число) - app name (текст) - user requesting (пользователь) **Логика**: 1. Проверить, входит ли sample_type в ["A", "B", "C"] 2. Если не входит, вернуть сообщение об ошибке 3. Создать запись в таблице со следующими полями: - ID: сгенерированный внутри функции - ID задания: входные данные - Тип образца: входные данные - Количество: входные данные - Номер партии: входные данные (или пустое поле, если не указано) - Создано: входные данные 4. Вернуть сообщение об успешном выполнении **Результаты**: - статус (текст): «success» или «error» - сообщение (текст): описание ошибки в случае сбоя Если вам нужно создать запись в таблице для образца, передайте входные данные в функцию, а она сама позаботится об остальном. ### Пример, которого следует избегать Не создавайте функцию для каждой операции записи в таблицу, даже для простых. **Почему это вызывает проблемы** - Приводит к разрастанию кода (созданию сотен одноразовых функций) - Усложняет код без особой пользы при выполнении простых операций записи - Усложняет отладку (больше мест, где нужно искать ошибки) **Когда следует избегать использования функций для записи в таблицы** - Обновление существующей записи в таблице (например, обновление статуса или уменьшение количества) - Запись в таблицу из одного приложения - Отсутствие необходимости в управлении или валидации ## Используйте функции для повторяющейся многошаговой логики ### Рекомендуемый подход Если одна и та же последовательность действий триггера повторяется на многих этапах в нескольких приложениях, вынесите её в функцию. **Пример: Получение кода ZPL для печати этикетки** **Функция**: Получить**код** ZPL. Входные данные: - Идентификатор материала (текст) **Переменные**: - Переменная кода ZPL (текст) **Выходные данные**: - Код ZPL (текст) **Логика**: 1. Обновить данные: конфигурация «Переменная кода ZPL» — установить значение: [выражение для кода ZPL, включающее @Inputs.Идентификатор материала] 2. Возвратить: «Код ZPL» из источника данных «Переменная кода ZPL» ### Шаблон, которого следует избегать Не создавайте функции для логики, которая выполняется всего 1–2 раза во всех приложениях. **Почему это вызывает проблемы** - Накладные расходы на управление функцией превышают получаемую выгоду - Заставляет разработчиков приложений изучать интерфейс функции для редкого случая - Усложняет отладку из-за необходимости переключаться между функциями и приложениями ## Встраивайте функции коннекторов в функции ### Рекомендуемый подход При использовании функции коннектора передавайте входные данные этой функции в функцию, которая вызывает функцию коннектора. Тогда эта функция сможет обрабатывать повторные попытки при превышении времени ожидания и ошибки более простым и централизованным способом, что позволит упростить логику приложений во всем решении. Встраивание функций коннекторов в функции также позволяет минимизировать трудозатраты при возможной будущей миграции ERP-системы за счет сокращения объема изменений, которые необходимо внести в отдельные приложения. **Пример** **Функция**: Update Process**OrderВходные данные**: - Идентификатор заказа (текст) - Статус (текст) **Выходные данные**: - Сообщение об ошибке (текст) **Переменные**: - Код HTTP (целое число) - Количество повторных попыток при превышении таймаута (целое число) - Сообщение об ошибке (текст) **Логика**: 1. Запустить функцию коннектора 2. Если HTTP-код указывает на успех, завершить функцию 3. Если код HTTP указывает на таймаут, а значение «Количество попыток при таймауте» меньше или равно заданному значению, увеличить «Количество попыток при таймауте» и вернуться к шагу «Выполнить функцию коннектора» 4. Если код HTTP не может быть обработан с помощью логики функции, вернуть полезное сообщение в поле вывода «Сообщение об ошибке» ## Передавайте идентификаторы записей, а не отдельные поля записей таблицы ### Рекомендуемый подход Если функции требуются данные из записи таблицы, передавайте идентификатор записи и загружайте запись внутри функции. **Пример** Хотя приведенный ниже пример логически верен (где «Идентификатор заказа» — это идентификатор из таблицы «Заказы», а остальные поля — столбцы этой таблицы), существует более простая конфигурация. **Функция**: Обработка**заказа Входные данные**: - Идентификатор заказа (текст) - Имя клиента (текст) - Идентификатор товара (текст) - Количество (число) - Срок выполнения (дата и время) - Приоритет (текст) **Логика**: 1. [Выполнить логику с использованием полей ввода] В приведённом ниже примере для достижения того же результата используется минимальное количество входных данных: **Функция**: Обработка**заказа Входные данные**: - Идентификатор заказа (текст) **Логика**: 1. Получить запись из таблицы: таблица «Заказы», где ID = введенный «Идентификатор заказа» 2. [Выполнить логику с использованием полей записи таблицы] **Почему второй пример является более эффективным подходом:** - Меньшее количество входных данных (1 вместо 6+) - Функция легко адаптируется в случае изменения схемы таблицы - Более лаконичные вызовы функций в приложениях - Снижается вероятность неправильного сопоставления поля и входного параметра ## Называйте и описывайте функции и входные параметры единообразно ### Рекомендуемый подход Используйте единые правила именования для всех функций в вашем рабочем пространстве. **Имена функций** - Используйте формулу «глагол + существительное»: «Создать образец», «Обновить статус задания», «Проверить серийный номер» - Не используйте только существительное: «Образец», «Задание», «Серийный номер» **Описание функции** - Напишите интуитивно понятное описание того, что делает функция. Например, для функции с именем «Создать дефект» напишите описание типа «Создает новую запись в таблице «Дефекты» со статусом OPEN». **Названия входных данных** - Используйте единообразную терминологию: всегда «Идентификатор рабочего заказа» (а не «Идентификатор заказа» или «Work_id») - По возможности используйте названия полей таблиц, соответствующие названиям в таблице **Имена логических блоков** - Будьте конкретны: «Получить запись задания», а не «Получить запись таблицы» - Помогите будущим читателям: «Проверить тип образца», а не «Проверить значение» **Почему это важно** - Разработчики приложений быстро понимают назначение функций - Снижается когнитивная нагрузка при использовании нескольких функций - Упрощает анализ «где используется» - Улучшает документацию и обучение ## Беспроблемная обработка проверки вводимых данных и сообщений об ошибках пользователя ### Рекомендуемый подход Всегда помечайте входные данные функций как обязательные поля и, при необходимости, применяйте правила проверки входных данных. Не проводите проверку входных данных внутри функций. **Почему это важно** - Пользователи приложения получают четкую обратную связь при вводе значений - Упрощает логику функций, поскольку приложение само обрабатывает проверку вводимых данных, а функция запускается с известными и корректными входными данными - Предотвращает повреждение данных из-за некорректных входных данных ### Пример того, чего следует избегать Не проверяйте входные данные внутри самой функции. **Почему это вызывает проблемы** - Дублирует возможности проверки входных данных, доступные в редакторе приложения - Дополнительная ненужная задержка, связанная с повторной проверкой входных данных на валидность внутри функции NOTE App builders can bypass the system by passing blank static values in function inputs. For functions where validated data is critical, it may be best practice to validate inputs in the function itself (in addition to marking required fields in the app). ## Сведите к минимуму количество запросов к таблицам внутри циклов Если ваша функция проходит по массиву в цикле, избегайте запросов к таблицам при каждой итерации. Вместо этого выполните запрос один раз перед циклом и используйте полученный результат. ## Используйте функции для реализации логики, а не для простых ссылок Не создавайте функции, которые просто извлекают одну запись из таблицы — для этого существуют операторы `record placeholders`. Используйте функции исключительно для логики, преобразующей данные. ## Ограничьте размер вывода Если ваша функция возвращает большие объекты или массивы, рассмотрите возможность возврата только тех полей, которые нужны приложению, а не всего массива объектов. --- ## Дополнительные ресурсы {{snippet.Нашли ли вы то, что искали}}