[WebSquare] Submission 테스트

🤔개요

websquare에서 submission을 이용한 api 연동 테스트를 해보고자 한다. 

🌐개발환경

WebSquare Studio
jdk17
api는 공공데이에서 제공하는 데이터 아무거나 가져옴
https://www.vworld.kr/dev/v4dv_2ddataguide2_s002.do?svcIde=smalllibrary 

https://smart.incheon.go.kr/server/rest/services/Hosted/%EB%85%B8%EC%9D%B8_%EB%B3%B5%EC%A7%80%EC%8B%9C%EC%84%A4_%EC%A0%95%EB%B3%B4/FeatureServer/192/query?where=1%3D1&outFields=*&outSR=4326&f=json

 

👣 Submission이란?

일단 그대로 번역하자면 "제출하다"라는 뜻이다. 여기서는 api request & response 를 하는 처리 방법이라고 보면 될 듯 하다.
실제로도 submission을 생성할 때 아래와 같은 창이 있는데 항목을 보면 제법 이해가 간다.

Reference : request 항목(DataCollection 형이며 id를 선택하여 보내줄 항목을 정해줄 수 있다.)
Target : response 항목(DataCollection 형이며 id를 선택하여 값을 바인딩할 항목을 정해줄 수 있다.)
URL Action : 서블릿 항목 (우리는 여기서 API URL을 넣어줄 것이다.)
Process Message : 조회중입니다... 라는 문구 같이 로딩중에 뜰 문구를 지정해준다.
Submit : 통신 전처리
Submit-done : 통신 후처리
Submit-error : 통신 중 에러처리

 

👣 Submission 생성 및 처리 방법

1. 생성하는 방법은 Outline > Head > Submission우클릭 > Submission 추가 

2. 아래와 같이 항목들 입력해줌
항목에 대한 설명은 위에 적혀있다. API URL은 CORS 문제로 추후에 로컬에 프록시 API서버를 만들어줄 예정이다.

3. submission이 잘 되는 지 테스트를 할 수도 있다. submission 창에 우측 상단 submission Test 버튼을 클릭하면 아래와 같이 테스트를 할 수 있는 항목을 제공한다.

4. 테스트 후 Submission을 생성하면 script 코드에 아래와 같이 실행 코드를 추가해준다.

scwin.onpageload = function() { 

    $p.executeSubmission("submission1");
};