Action Flow Parameters
실행 시점에 데이터를 주입받는 재사용 가능한 플로우
3 min read
같은 동작을 여러 곳에서 조금씩 다른 값으로 실행하고 싶을 때가 있습니다. 예를 들어 "상세 화면으로 이동" 이라는 플로우는 항상 같지만, 어떤 항목 의 상세인지는 그때그때 다릅니다.
Parameters 는 Action Flow 가 실행되는 시점에 외부에서 값을 받을 수 있게 해 줍니다. 덕분에 하나의 플로우를 여러 상황에서 재사용할 수 있습니다.
입력 파라미터 정의하기
Action Flow 에 입력 파라미터의 모양(Schema)을 정의합니다. 그러면 그 플로우는 실행될 때 그 모양의 데이터를 받습니다. 플로우 안에서는 이 값을 {Parameters.필드} 토큰으로 참조할 수 있습니다.
값 주입하기: 바인딩 소스
플로우를 호출하는 쪽에서 실제 값을 연결합니다. 값은 세 가지 범위에서 가져올 수 있습니다.
- Project — 프로젝트 전체에서 공유하는 데이터
- Page — 현재 화면에 속한 데이터
- Cell — List 셀 하나하나에 해당하는 항목 데이터
예를 들어 List 셀의 Touch 이벤트에서 상세 이동 플로우를 호출하면서 그 셀의 항목 데이터(Cell)를 파라미터로 주입하면, 누른 항목의 상세 화면으로 이동하게 만들 수 있습니다.
API 의 입력 파라미터
API 도 같은 방식으로 입력 파라미터를 가집니다. API Call 액션은 연결된 입력 데이터를 API 에 주입하고, API 의 URL·헤더·본문에서 {Parameters.필드} 토큰으로 그 값을 사용합니다. (API 응답을 화면에 바인딩하기 참고)
자주 쓰는 동작을 파라미터가 있는 Action Flow 로 만들어 두면, 여러 화면과 이벤트에서 재사용할 수 있어 프로젝트가 훨씬 깔끔해집니다.