# 서버단 명령의 매개변수

## Content

서버 측 명령을 정의할 때 업무 요구에 따라 파라미터를 정의할 수 있습니다. 파라미터를 정의하면 서버단 명령 실행 시 페이지 측의 값을 서버단으로 전달할 수 있습니다. 하나의 서버단 명령 안에서파라미터를 생성하면, 해당 파라미터 이후의 모든 명령에서 해당 파라미터를 사용하거나 업데이트할 수 있습니다. 이 파라미터는 모든 명령 실행이 완료될 때까지 계속 유효합니다.
서버단 명령의 파라미터 유형은 **기초 타입, 배열 타입, 객체 타입** 세 가지입니다.

* **기초 유형:** 문자열, 숫자, 날짜 등 단순한 데이터 유형
* **배열 유:** 테이블, 데이터 테이블 등 배열 형태의 데이터
* **객체 타입:** 하나 이상의 하위 속성을 포함하는 구조체

***

### 매개변수 추가

서버단 명령 생성/편집 대화상자에서 **"파라미터 → 파라미터 추가"** 를 클릭하면 파라미터 이름과 유형을 설정할 수 있습니다. 기본 파라미터 유형은 **기초 타입**입니다.
![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4f96589d-8403-419e-b2a1-4f6776199cb9/image-20260611.b1e30d.png)
↓
![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4f96589d-8403-419e-b2a1-4f6776199cb9/image-20260611.ec6a78.png)

***

### 테이블 열로부터 파라미터 생성

**"파라미터 추가"** 옆의 드롭다운 버튼을 클릭하면 **"테이블 열을 기반으로 파라미터를 생성합니다."** 을 선택할 수 있습니다.
팝업 대화상자에서 데이터 테이블을 선택하면 해당 테이블의 모든 필드가 자동으로 나열됩니다. 필드를 체크하면 자동으로 파라미터가 생성됩니다.
![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4f96589d-8403-419e-b2a1-4f6776199cb9/image-20260611.694282.png)
↓
![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4f96589d-8403-419e-b2a1-4f6776199cb9/image-20260611.335a05.png)

***

### JSON 구조로부터 파라미터 생성

**"파라미터 추가"** 옆의 드롭다운 버튼을 클릭하면 **"JSON 구조로부터 파라미터 생성"** 을 선택할 수 있습니다.
파라미터 생성에 사용할 JSON은 표준적이고 문법이 완전히 올바른 JSON 문자열이어야 하며, 원하는 파라미터의 데이터 구조를 정확하게 표현할 수 있는 구조여야 합니다.
**"JSON 구조로부터 파라미터 생성"** 대화상자에서 JSON 문자열을 입력한 뒤 **"확인"** 을 클릭하면 JSON 구조를 기반으로 파라미터가 자동으로 생성되며, 모든 파라미터가 파라미터 목록에 표시됩니다.
![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4f96589d-8403-419e-b2a1-4f6776199cb9/image-20260611.47dc8b.png?width=400)
↓
![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4f96589d-8403-419e-b2a1-4f6776199cb9/image-20260611.96e846.png?width=600)

<br>