变更管理功能

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. **输出:**可集成到函数中的常见输出包括:
    • 该函数创建的表记录的记录 ID
    • 操作员可见的消息(由函数逻辑赋值给变量)
  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. 监控生产环境中的应用,以检查是否存在意外行为。

**最佳实践:**对于在生产应用中使用的函数,请采用审批工作流流程。


其他资源