変更管理機能

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. 1つの開発用アプリで、関数をエンドツーエンドでテストしてください。
  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. 開発用アプリ1つで、エンドツーエンドのテストを実施します。
  4. 更新された関数に関連付けるため、アプリの新しいversion を公開します。
  5. 本番環境のアプリで予期しない動作がないか監視します。

**ベストプラクティス:**本番アプリで使用される関数については、承認ワークフローの手順に従ってください。


追加リソース