이벤트 서비스 스크립트 API 액션 추가
Last updated
Last updated
이벤트가 호출되면 실행되는 액션으로 Event, Script, Service, API 로 구성됩니다. 아이콘을 클릭하여 액션을 추가 할 수 있습니다.
추가한 액션은 위에서 아래로 순차적으로 실행됩니다. Skip 버튼을 활성화 하면 해당 액션이 실행 시에 Skip됩니다.
시나리오에 등록된 다른 이벤트를 호출할 수 있습니다.
서비스를 바로 정의하거나 기존 서비스 사용을 통해 시나리오에 등록된 서비스를 호출하여 데이터를 주고 받을 수 있습니다.
서비스를 바로 정의하는 경우 카테고리 타입으로만 호출 가능합니다.
서버와의 데이터 교환은 '보내는 데이터(ParamBlock)'로 정의된 파라미터를 통해 이루어지며, 서버의 응답은 '받는 데이터(ResultBlock)' 설정을 기준으로 처리됩니다. 카테고리 사용 옵션에 따라 이 설정들이 조정될 수 있습니다.
시나리오 개발의 복잡도 관리를 위해 카테고리 사용을 권장합니다.
각 시스템에서 필요로 하는 필수값과 추가 설정을 할 수 있습니다.
서비스에 전송할 데이터를 지정합니다.
사용자 데이터 : 사용자정보가 필요한 경우 사용자정보를 지정해 보낼 수 있습니다.
카테고리 명 : 지정한 카테고리 데이터를 보내며, 필터를 사용하여 원하는 데이터만 전송할 수 있습니다.
필터 설정 : 필터 조건에 부합하는 데이터만 보내게 됩니다. 필터에 대한 더 자세한 설명은 [심화] Filter - 섹터(Sector) Status, Condition 을 참고해주세요
[필터 결과가 없어도 수집하기]가 활성화되어 있으면 필터 된 결과 데이터가 없더라도 사용자 데이터를 수집합니다.
보내는 데이터블록 추가 : 여러 카테고리에 값들을 같이 전송할 수 있습니다. 여기서 설정된 데이터 블록들은 JSON 배열로 묶어 paramBlocks라는 이름으로 보내지며 FlexSQL에서 아래의 예시와 같이 사용해 데이터에 접근합니다.
서비스 실행 결과 데이터를 처리하는 방법은 3가지 옵션이 있습니다.
화면에 반영하기: 받은 데이터를 설정된 카테고리들이 데이터가 연결된 영역에 반영합니다. 이때, 해당 카테고리가 최상위 데이터 연결된 그룹/레이아웃에 반영됩니다.
추가: 지정한 카테고리에 결과 데이터를 추가합니다. 화면에 반영하기 시, 화면에 표시되지 않는 카테고리 섹터들도 추가로 그려줍니다.
덮어쓰기: 지정한 카테고리에 결과 데이터를 덮어씁니다. 화면에 반영하기 시, 해당 카테고리와 연결된 영역을 리로드합니다.
병합(merge): 지정한 카테고리와 병합 기준 컬렉션키를 기준으로 합칩니다. 화면에 반영하기 시, 해당 카테고리와 연결된 영역을 리로드합니다.
카테고리 명을 명시하지 않으면 전체 컬렉션을 수집합니다.
사용자 데이터 : 사용자정보가 필요한 경우 사용자 정보를 지정해 보낼 수 있습니다.
기존 섹터 내부 값을 모두 삭제
보내는 섹터 삭제하지 않기 : 보내는 컬렉션을 그대로 유지합니다.
기준 키 별도설정 : 받아온 데이터를 콜렉션에 반영하기 위한 기준 키 값을 별도로 지정할 수 있습니다.별도 설정을 하지 않으면 SUID 기준으로 섹터에 값이 반영됩니다.
Javascript로 직접 코드를 작성해 데이터와 UI를 제어합니다.
스크립트 에티터 : 플렉스튜디오 용 스크립트를 직접 작성할 수 있습니다. 스크립트에 대한 자세한 설명은 스크립트 명세서에서 확인할 수 있습니다. 스크립트 도우미를 활용해 쉽게 스크립트를 작성할 수도 있습니다.
함수 자동 생성 : 함수 자동 생성을 이용해 푸시 알림, GPS와 같은 복잡한 기능을 간편하게 구현할 수 있습니다.
API연동에서 추가한 API들을 호출 할 수 있습니다.
API 명 : 호출할 API의 이름입니다.
모듈명 : 호출할 모듈의 이름입니다.
Event Config Key : 지정한 Event Config Key가 나타납니다.
이벤트 안의 이벤트, 스크립트, 서비스 블록에 마우스를 올리면 버튼이 활성화됩니다. 이 버튼을 드래그 앤 드롭해 블록을 원하는 위치로 이동시킬 수 있습니다.