# Post 데이터 명령(SendHTTPRequestCommand)

## Content

타사 데이터 연결을 완료하기 위해 SendHTTPRequestCommand 플러그인을 사용합니다.

일반적으로 타사에서 데이터 연결을 위한 API 문서를 아래와 같이 제공합니다.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4e3bfc58-e2a1-41a1-ac75-a0e383260d93/image-518.png)

1. 명령창에서 "POST 데이터 명령"을 선택하고 아래와 같이 설정합니다.

>type=note
> 일반명령과 서버단 명령에서 사용할 수 있습니다.

![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4f96589d-8403-419e-b2a1-4f6776199cb9/image-20260701.d216f6.png)

| 항목 | 설명 |
| --- | --- |
| URL | 사용자는 요청을 보낼 대상 URL을 지정해야 합니다. url 사용자 입력 또는 계산 결과가 ' http://' 로 시작하지 않고 ' https://' 로 시작하지 않는 경우 현재 웹사이트 기본 URL을 연결합니다. |
| Method | Http 메서드(GET,POST,PUT,DELETE) - GET / DELETE : 매개변수는 URL의 문자열에 있습니다. - POST/PUT: 매개변수는 요청의 본문의 내용입니다. JSON 직렬화가 선택되지 않은 경우, 컨텐츠 유형은 application /x-www- form - urlencoded '이고, 그렇지 않으면 콘텐츠 유형은 'application/json'이 됩니다. |
| 데이터유형 | \- 값 혹은 공식 : 데이터를 원격 서버로 보낼 단순 값\(키 값 쌍 없음\)임을 의미합니다\.<br>\- 복합구조 : 서버로 보내는 데이터에 어떤 속성이 있음을 의미합니다\.<br>\- 정렬 : 원격 서버에 값의 배열을 보낼 것임을 의미합니다\.<br>\- 자동: 디자이너에서 디자인한 개수와 동일한 포스트 데이터 배열<br>개수를 의미합니다.<br>\- 지정된 수: 데이터 배열 개수가 지정되었음을 의미합니다\.<br>일반적으로 페이지의 상수 또는 공식(목록 보기 횟수)입니다.<br>4\. 리스트뷰데이터 : 포건시 리스트뷰에서 데이터를 사용합니다\. 리스트이름과 열이름이 필요합니다\. |
| Json직렬화 | 값이 json 문자열로 직렬화되는지 여부를 의미합니다. |
| POST 성공콜백 | POST 성공 후 실행할 자바스크립트 코드. 결과 데이터는 ' result ' 변수에 저장됩니다. |
| POST 오류콜백 | POST 실패 후 실행할 자바스크립트 코드. 오류 정보는 ' error ' 변수에 저장됩니다. |

2-1. 일반적으로 데이터 양식을 아래와 같이 입력합니다.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4e3bfc58-e2a1-41a1-ac75-a0e383260d93/image-626.png)

2-2. JSON 직렬화에 체크를 하면 Content Type이 "application/json; charset=UTF-8"인 것을 확인할 수 있습니다.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4e3bfc58-e2a1-41a1-ac75-a0e383260d93/image-1666.png)

2-3. 복합구조의 값을 복합구조로 사용하려면 아래와 같이 사용할 수 있습니다.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4e3bfc58-e2a1-41a1-ac75-a0e383260d93/image-1793.png)

2-4. 원격 API에 Json 배열을 게시하는 경우 아래와 같 사용할 수 있습니다.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4e3bfc58-e2a1-41a1-ac75-a0e383260d93/image-1766.png)

2-5. 리스트뷰를 아래와 같이 사용할 수 있습니다.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4e3bfc58-e2a1-41a1-ac75-a0e383260d93/image-1134.png)

리스트뷰 데이터의 모든 행을 가져와야 할 경우 아래와 같이 적용합니다.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4e3bfc58-e2a1-41a1-ac75-a0e383260d93/image-1647.png)

3\. 요청 결과를 셀 값으로 설정 할 수 있습니다\.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4e3bfc58-e2a1-41a1-ac75-a0e383260d93/image-2006.png)

요청 반환이 json인 경우 "**,**"속성을 이용하여 값을 얻을 수 있습니다.

>type=note
> 반환 데이터값은 단순 값 또는 Json 형식이어야 합니다.
> 
> XML형식은 지원되지 않습니다.

예를 들어:

반환 데이터가 *{ Name: 'Jobs Smith', Age: 52, Sex: 'Male', Company: { Name: 'Apple', Location: 'USA' } }* 이고 새 매개변수가 'result'인 경우, "**result.Comapny.Location**" 으로 json 내부 속성 값을 가져옵니다.

### 서버단 명령 지원

사용자가 서버에서 요청을 보내야하는 경우가 있습니다. 브라우저에서 요청하면 교차 도메인 문제가 발생할 수 있기 때문입니다. 사용법은 일반 명령과 거의 동일하지만 몇 가지 차이점이 있습니다.

1.서버 단 명에서 리스트뷰 데이터를 지원하지 않습니다.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4e3bfc58-e2a1-41a1-ac75-a0e383260d93/image-1732.png)

2\. 결과는 파라미에 의해 나옵니다\. 다른 명령에서 해당 파라미터를 사용할 수 있습니다\.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4e3bfc58-e2a1-41a1-ac75-a0e383260d93/image-1762.png)

요청 반환이 json인 경우 ","속성을 이용하여 값을 얻을 수 있습니다.

예를 들어:

반환 데이터가 *{ Name: 'Jobs Smith', Age: 52, Sex: 'Male', Company: { Name: 'Apple', Location: 'USA' } }* 이고 새 매개변수가 'result'인 경우 사용할 수 있습니다

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4e3bfc58-e2a1-41a1-ac75-a0e383260d93/image-592.png)

### 기타

기존 Json 구조를 명령으로 구분 분석하는 것을 지원합니다.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4e3bfc58-e2a1-41a1-ac75-a0e383260d93/image-1733.png)