Управление изменениями функций

Prev Next

Who can use Functions

As of r380, Functions is generally available.

Read more in the Community thread.


Изменения входных или выходных данных

Breaking change alert:

Adding, removing, or renaming inputs and outputs requires changes to app trigger actions that call the function.

Для изменения сигнатуры функции следуйте этой процедуре:

  1. Тщательно продумайте структуру входных и выходных данных, прежде чем широко внедрять функцию.
  2. Входные данные: при создании функции для создания новой записи в таблице учитывайте все типичные столбцы, которые функция должна заполнять при создании записи, а не только столбцы для первого варианта использования.
  3. Выходные данные: к типичным выходным данным, которые можно включить в функцию, относятся:
    • Идентификаторы записей таблицы, создаваемых функцией
    • Сообщения, видимые операторам (записываемые в переменную в соответствии с логикой функции)
  4. Перед внесением изменений уведомьте всех разработчиков приложений.
  5. Систематически обновляйте функцию:
  6. Измените функцию.
  7. Протестируйте функцию с помощью кнопки «Тест», используя типичные входные данные.
  8. Проведите сквозное тестирование функции в одном приложении-разработке.
  9. Обновите каждое приложение, чтобы сопоставить новые входные и выходные данные.
    • Начиная с версии r351, доступна ограниченная информация о том, где используется функция (как в каких приложениях, так и в каких местах внутри приложения). На вкладке «Версии» приложения можно увидеть, какие функции использует данная версия.
    • Для приложений, использующих данную функцию, нажмите кнопку «Просмотреть ошибки» в редакторе приложения. В модальном окне отобразятся все неработающие ссылки на функцию в приложении.
  10. Протестируйте каждое приложение в режиме разработчика.
  11. Опубликуйте приложения.

Альтернативный подход при внесении значительных изменений

Создайте новую функцию с обновленной сигнатурой и постепенно перенесите приложения:

  1. Создайте новую версию функции с новыми входными данными (например, CreateSample_v2).
  2. Перенесите приложения с высоким приоритетом на новую версию.
  3. Постепенно перенесите остальные приложения.
  4. Объявите старую версию функции устаревшей и заархивируйте её.

Изменение внутренней логики функции

Info

Changes to internal function logic (decision trees, calculations, table operations) do not break apps. However, you need to publish apps with a new version to associate the new function logic.

Действуйте следующим образом:

  1. Обновите логику функции.
  2. Протестируйте функцию с помощью кнопки «Тест», используя типичные входные данные.
  3. Протестируйте функцию в одном приложении для разработчиков от начала до конца.
  4. Опубликуйте новую версию приложения ( version ), чтобы связать его с обновленной функцией.
  5. Отслеживайте производственные приложения на предмет непредвиденного поведения.

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


Дополнительные ресурсы

{{snippet.Нашли ли вы то, что искали}}