이벤트 서비스 스크립트 API 액션 추가

기능 설명

이벤트가 호출되면 실행되는 액션으로 Event, Script, Service, API 로 구성됩니다. 아이콘을 클릭하여 액션을 추가 할 수 있습니다.

추가한 액션은 위에서 아래로 순차적으로 실행됩니다. Skip 버튼을 활성화 하면 해당 액션이 실행 시에 Skip됩니다.

이벤트 추가 (Linked Event)

시나리오에 등록된 다른 이벤트를 호출할 수 있습니다.

서비스 추가

서비스를 바로 정의하거나 기존 서비스 사용을 통해 시나리오에 등록된 서비스를 호출하여 데이터를 주고 받을 수 있습니다.

서비스를 바로 정의하는 경우 카테고리 타입으로만 호출 가능합니다.

서버와의 데이터 교환은 '보내는 데이터(ParamBlock)'로 정의된 파라미터를 통해 이루어지며, 서버의 응답은 '받는 데이터(ResultBlock)' 설정을 기준으로 처리됩니다. 카테고리 사용 옵션에 따라 이 설정들이 조정될 수 있습니다.

시나리오 개발의 복잡도 관리를 위해 카테고리 사용을 권장합니다.

서비스 주고 받기(카테고리)

[시스템 정보]

각 시스템에서 필요로 하는 필수값과 추가 설정을 할 수 있습니다.

[보내는 데이터]

서비스에 전송할 데이터를 지정합니다.

  • 사용자 데이터 : 사용자정보가 필요한 경우 사용자정보를 지정해 보낼 수 있습니다.

  • 카테고리 명 : 지정한 카테고리 데이터를 보내며, 필터를 사용하여 원하는 데이터만 전송할 수 있습니다.

  • 필터 설정 : 필터 조건에 부합하는 데이터만 보내게 됩니다. 필터에 대한 더 자세한 설명은 [심화] Filter - 섹터(Sector) Status, Condition 을 참고해주세요

[필터 결과가 없어도 수집하기]가 활성화되어 있으면 필터 된 결과 데이터가 없더라도 사용자 데이터를 수집합니다.

  • 보내는 데이터블록 추가 : 여러 카테고리에 값들을 같이 전송할 수 있습니다. 여기서 설정된 데이터 블록들은 JSON 배열로 묶어 paramBlocks라는 이름으로 보내지며 FlexSQL에서 아래의 예시와 같이 사용해 데이터에 접근합니다.

paramBlocks 형식

[
  //paramBlock1
  [
    {
      "key": "value"
    }
  ],
  //paramBlock2
  [
    {
      "key": "value"
    }
  ]
]

FlexSQL에서 paramBlock에 접근할때

<%let paramsBlock1 = paramBlocks[0];%>
<%let paramsBlock2 = paramBlocks[1];%>

[받은 데이터]

서비스 실행 결과 데이터를 처리하는 방법은 3가지 옵션이 있습니다.

  • 화면에 반영하기: 받은 데이터를 설정된 카테고리들이 데이터가 연결된 영역에 반영합니다. 이때, 해당 카테고리가 최상위 데이터 연결된 그룹/레이아웃에 반영됩니다.

  • 추가: 지정한 카테고리에 결과 데이터를 추가합니다. 화면에 반영하기 시, 화면에 표시되지 않는 카테고리 섹터들도 추가로 그려줍니다.

  • 덮어쓰기: 지정한 카테고리에 결과 데이터를 덮어씁니다. 화면에 반영하기 시, 해당 카테고리와 연결된 영역을 리로드합니다.

  • 병합(merge): 지정한 카테고리와 병합 기준 컬렉션키를 기준으로 합칩니다. 화면에 반영하기 시, 해당 카테고리와 연결된 영역을 리로드합니다.

서비스 주고 받기(이너블럭 - Ksystem 전용 데이터 공유 방식)

[보내는 데이터]

카테고리 명을 명시하지 않으면 전체 컬렉션을 수집합니다.

  • 사용자 데이터 : 사용자정보가 필요한 경우 사용자 정보를 지정해 보낼 수 있습니다.

[받는 데이터]

  • 기존 섹터 내부 값을 모두 삭제

  • 보내는 섹터 삭제하지 않기 : 보내는 컬렉션을 그대로 유지합니다.

  • 기준 키 별도설정 : 받아온 데이터를 콜렉션에 반영하기 위한 기준 키 값을 별도로 지정할 수 있습니다.별도 설정을 하지 않으면 SUID 기준으로 섹터에 값이 반영됩니다.

스크립트 추가

Javascript로 직접 코드를 작성해 데이터와 UI를 제어합니다.

  • 스크립트 에티터 : 플렉스튜디오 용 스크립트를 직접 작성할 수 있습니다. 스크립트에 대한 자세한 설명은 스크립트 명세서에서 확인할 수 있습니다. 스크립트 도우미를 활용해 쉽게 스크립트를 작성할 수도 있습니다.

  • 함수 자동 생성 : 함수 자동 생성을 이용해 푸시 알림, GPS와 같은 복잡한 기능을 간편하게 구현할 수 있습니다.

API 추가

API연동에서 추가한 API들을 호출 할 수 있습니다.

  • API 명 : 호출할 API의 이름입니다.

  • 모듈명 : 호출할 모듈의 이름입니다.

  • Event Config Key : 지정한 Event Config Key가 나타납니다.

  • 보내는 데이터 / 받는 데이터 : 사용자 데이터, 카테고리 정보를 보내고 받을 수 있습니다.

순서 변경

Last updated