Documentation

Action Flow Parameters

실행 시점에 데이터를 주입받는 재사용 가능한 플로우

3 min read

같은 동작을 여러 곳에서 조금씩 다른 값으로 실행하고 싶을 때가 있습니다. 예를 들어 "상세 화면으로 이동" 이라는 플로우는 항상 같지만, 어떤 항목 의 상세인지는 그때그때 다릅니다.

ParametersAction Flow 가 실행되는 시점에 외부에서 값을 받을 수 있게 해 줍니다. 덕분에 하나의 플로우를 여러 상황에서 재사용할 수 있습니다.

입력 파라미터 정의하기

Action Flow 에 입력 파라미터의 모양(Schema)을 정의합니다. 그러면 그 플로우는 실행될 때 그 모양의 데이터를 받습니다. 플로우 안에서는 이 값을 {Parameters.필드} 토큰으로 참조할 수 있습니다.

값 주입하기: 바인딩 소스

플로우를 호출하는 쪽에서 실제 값을 연결합니다. 값은 세 가지 범위에서 가져올 수 있습니다.

  • Project — 프로젝트 전체에서 공유하는 데이터
  • Page — 현재 화면에 속한 데이터
  • CellList 셀 하나하나에 해당하는 항목 데이터

예를 들어 List 셀의 Touch 이벤트에서 상세 이동 플로우를 호출하면서 그 셀의 항목 데이터(Cell)를 파라미터로 주입하면, 누른 항목의 상세 화면으로 이동하게 만들 수 있습니다.

API 의 입력 파라미터

API 도 같은 방식으로 입력 파라미터를 가집니다. API Call 액션은 연결된 입력 데이터를 API 에 주입하고, API 의 URL·헤더·본문에서 {Parameters.필드} 토큰으로 그 값을 사용합니다. (API 응답을 화면에 바인딩하기 참고)

자주 쓰는 동작을 파라미터가 있는 Action Flow 로 만들어 두면, 여러 화면과 이벤트에서 재사용할 수 있어 프로젝트가 훨씬 깔끔해집니다.