기능 변경 관리

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. 개발 중인 앱 하나에서 함수를 종단 간(end-to-end)으로 테스트하십시오.
  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. 개발 중인 앱 하나에서 기능을 종단 간(end-to-end)으로 테스트하십시오.
  4. 업데이트된 함수와 연동할 앱의 새 version 버전을 게시합니다.
  5. 프로덕션 앱에서 예기치 않은 동작이 발생하는지 모니터링하십시오.

모범 사례: 프로덕션 앱에서 사용되는 함수에 대해서는 승인 워크플로 절차를 따르십시오.


추가 리소스

{{snippet.원하는 정보를 찾으셨나요?}}