| Easy Heading Macro | ||||||
|---|---|---|---|---|---|---|
|
작성자 : 김원정 / 검수자 : -
Release No. 7.0.500.20260122-11
변수 개요
변수는 변하는 데이터(값)을 저장할 수 있는 메모리 공간입니다.
변수에는 데이터가 한 개만 저장됩니다.
| 참고사항 |
|---|
전역변수와 지역변수 변수 선언 시 변수의 유효 범위를 가리킵니다.코드 작성 시 같은 이름의 변수나 함수를 사용하여 충돌할 경우를 방지하기 위해 전역과 지역을 나눕니다.
|
변수 지정하기 (참조할 객체 지정하기)
변수로 사용할 컨트롤명을 변수명과 동일하게 변수명을 지정합니다.
| 참고사항 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
변수 바인딩 규칙변수의 유형에 따라 바인딩 규칙이 다르기 때문에, 유형에 맞는 예약어로 데이터 유형별 변수 예약어 가이드 시스템이 데이터(문자/숫자)를 올바르게 인식할 수 있도록, 반드시 유형에 맞는 예약어를 사용해 변수명을 지정해야 합니다.
: VN_ 로 시작하는 변수는 SQL 바인딩 시 단순 치환으로 선언됩니다. 예) AND AGE = :VN_AGE → AND AGE = 28
[변수명, 왜 데이터 타입에 맞춰 지정해야 하나요?] · 문자형( · 수치형( [변수명 앞에 콜론(:)을 왜 붙이나요?] 쿼리 작성 시 변수를 활용하려면 반드시 변수명 앞에 콜론(:)이 작성 되어야 합니다. · 잘못된 예: WHERE NAME = VS_USER_NAME 시스템은 VS_USER_NAME이라는 글자 자체를 이름으로 인식하여 데이터를 찾으려 합니다. (결과가 나오지 않음) · 올바른 예: WHERE NAME = :VS_USER_NAME 시스템이 콜론을 인식하고, 변수값임을 인식합니다.
|
2. 변수 사용
지정한 변수값을 데이터의 검색 조건으로 지정하기 위해서는 변수를 선언해야 합니다.
변수를 사용하는 방법에는 스크립트를 통해 변수를 선언하는 방법과 변수편집기 메뉴를 통한 방법이 있습니다.
2.1 컨트롤을 참조한 변수 선언
1) 참조할 컨트롤 객체를 지정하여 변수명을 지정합니다.
2) Jscript에서 해당 변수를 사용하기 위한 변수를 선언합니다.
변수 선언 방법
Matrix.GetVariable(name); → 특정 변수의 값을 반환합니다.
Matrix.SetVariable(name ,value); → 특정 변수의 값을 value값으로 셋팅합니다.
Matrix.AddGlobalParams(name ,value ,type); → 전역 쿼리 파라미터 값 객체를 추가합니다.
3) 선언한 변수를 데이터의 검색 조건 (쿼리의 where절)으로 지정합니다.
4) 데이터의 검색 조건에 맞게 데이터가 조회됩니다.
변수 바인딩 확인하기
[ SQL Log Viewer ]를 통해 해당 변수가 바인딩된 것을 확인할 수 있습니다.
3. 변수편집기를 활용한 변수 선언
1) 참조할 컨트롤 객체를 지정하여 변수명을 지정합니다.
2) [ 변수 편집기 ] 를 통해 해당 변수를 지정합니다.
3) 변수 편집기를 통해 지정한 변수를 넘기기 위해 [ Process Bot ]을 활용해 버튼에 동작을 지정해줍니다.
| title | Description |
|---|
"변수값 넘기기" Module은 Process Bot의 Module을 Drag&Drop한 후, 파라미터 및 상세 옵셜을 설정합니다.
Refresh는 Process Bot의 Refresh를 Module을 Drag&Drop한 후, 대상 컨트롤을 선택합니다.
4) 선언한 변수를 데이터의 검색 조건 (쿼리의 where절)으로 지정합니다.
5) 데이터의 검색 조건에 맞게 데이터가 조회됩니다.
변수 바인딩 확인하기
[ SQL Log Viewer ]를 통해 해당 변수가 바인딩된 것을 확인할 수 있습니다.
변수 바인딩 확인하기
[ 변수 편집기 ]를 통해 해당 변수가 바인딩된 것을 확인할 수 있습니다.
AUD플랫폼에서 기본 제공하는 세션 변수는 i-MATRIX, i-AUD, i-MEATA에서 Script 및 SQL 작성 시 사용 할 수 있습니다.
세션 변수는 AUD플랫폼을 실행하면 시스템이 기동 되면서 생성되는 변수로 별도 변수 등록 없이 전역에서 사용 가능 합니다.
1. 변수 목록
이름(고정)
i-AUD Server Script /
Dynamic SQL 사용 서식
SQL 사용 서식
(i-META 조회 조건 값 서식)
i-AUD JScript 사용시
세션 변수 값(예시)
설명
IP_ADDR
session.getAttribute("IP_ADDR")
<%=IP_ADDR$%>
:VS_IP_ADDR$
Matrix.GetUserInfo().IPAddress
192.168.xxx.xxx
접속 아이피
USER_CODE
session.getAttribute("USER_CODE")
<%=USER_CODE$%>
:VS_USER_CODE$
Matrix.GetUserInfo().UserCode
matrix
사용자 코드
USER_NAME
session.getAttribute("USER_NAME")
<%=USER_NAME$%>
:VS_USER_NAME$
Matrix.GetUserInfo().UserName
매트릭스
사용자명
ORG_CODE
session.getAttribute("ORG_CODE")
<%=ORG_CODE$%>
:VS_ORG_CODE$
Matrix.GetUserInfo().DeptCode
B060000
사용자 부서 코드
ORG_NAME
session.getAttribute("ORG_NAME")
<%=ORG_NAME$%>
:VS_ORG_NAME$
-
전사
사용자 부서명
DeptCode
session.getAttribute("DeptCode")
<%=DeptCode$%>
:VS_DeptCode$
Matrix.GetUserInfo().DeptPath
'B060000',DEFAULT,-1
사용자 부서 경로 정보
USER_DEPT_PATH
session.getAttribute("USER_DEPT_PATH")
<%=USER_DEPT_PATH$%>
:VS_USER_DEPT_PATH$
-
|B060000|DEFAULT|-1
사용자 부서 경로 정보
USER_ROLE
session.getAttribute("USER_ROLE")
<%=USER_ROLE$%>
:VS_USER_ROLE$
Matrix.GetUserInfo().UserRole
SU;3;V0;SV;ST;M0;1;
사용자 권한 그룹
LANG_CODE
session.getAttribute("LANG_CODE")
<%=DeptCode$%>
:VS_LANG_CODE$
Matrix.GetUserInfo().LangCode
ko
다국어 언어 코드
(Admin 내 PORTAL 설정에서 선택한 다국어 코드 값)
LANG_IDX
session.getAttribute("LANG_IDX")
<%=DeptCode$%>
:VS_LANG_IDX$
-
1
다국어 언어 컬럼 인덱스
(MTX_LANG 테이블 > LANG_NAME_COLUMN 데이터의 'COMMENTS' 뒤에 붙은 숫자값)
2. 활용 방법
2.1. i-AUD 디자이너의 JScript에서 사용 예제
| language | js |
|---|---|
| firstline | 1 |
| title | JScript |
| linenumbers | true |
/**************************************
*
문서
로드
된
후
AutoRefresh
수행
전에
발생합니다.
*
*
arguments
:
**************************************/
var
OnDocumentLoadComplete
=
function(sender,
args){
var
SessionValues
=
"";
SessionValues
+=
"IPAddress
:
"+Matrix.GetUserInfo().IPAddress+"\n";
//접속
아이피
SessionValues
+=
"UserCode
:
"+Matrix.GetUserInfo().UserCode+"\n";
//사용자
코드
SessionValues
+=
"UserName
:
"+Matrix.GetUserInfo().UserName+"\n";
//사용자명
SessionValues
+=
"DeptCode
:
"+Matrix.GetUserInfo().DeptCode+"\n";
//사용자
부서
코드
SessionValues
+=
"DeptPath
:
"+Matrix.GetUserInfo().DeptPath+"\n";
//사용자
부서
경로
정보
SessionValues
+=
"UserRole
:
"+Matrix.GetUserInfo().UserRole+"\n";
//사용자
권한
그룹
SessionValues
+=
"LangCode
:
"+Matrix.GetUserInfo().LangCode;
//다국어
언어
코드
Matrix.getObject("RichTextBox").Text
=
SessionValues;
};
2.2. i-AUD디자이너의 데이터 소스/ i-MATRIX 디자이너 및 MX-GRID의 데이터셋 관리자에서 SQL작성 예제
| language | js |
|---|---|
| title | Dynamic SQL 활용 - SQL 분기처리 |
| linenumbers | true |
<%
var
req
=
Matrix.getRequest();
var
res
=
Matrix.getResponse();
var
session
=
Matrix.getSession();
var
util
=
Matrix.getUtility();
//권한
허용
목록
Javascript
구문
var
AUTH_DEPTS
=
["ORG-001",
"ORG_002",
"ORG_003"];//
판매
단가를
볼
수
있는
부서
목록
%>
SELECT
SALE_DATE
,
CUSTOMER_NAME
,
PRODUCT_CODE
,
SALE_CNT
<%
if(AUTH_DEPTS.indexOf(ORG_CODE$)
>=
0){
//권한이
있는
경우
%>
,
SALE_PRICE
AS
SALE_PRICE
,
SALE_AMT
AS
SALE_AMT
<%
}else{
//권한
없을
경우
0으로
설정
%>
,
0.0
AS
SALE_PRICE
,
0.0
AS
SALE_AMT
<%
}
%>
FROM
SALES
| language | js |
|---|---|
| title | Dynamic SQL 활용 - 변수 바인딩 |
| linenumbers | true |
<%
var
req
=
Matrix.getRequest();
/*
Request
*/
var
session
=
Matrix.getSession();
/*
Session
*/
var
USER_CODE
=
session.getAttribute("USER_CODE");
req.setParam("VS_USER_CODE",
USER_CODE);
%>
SELECT
*
FROM
MTX_REPORT
WHERE
OWNER_CODE
=
:VS_USER_CODE
AND
ORG_CODE
=
'<%=session.getAttribute("ORG_CODE")%>'
※ 상세 내역은 Dynamic SQL 사용 가이드를 참고 바랍니다.
| language | sql |
|---|---|
| firstline | 1 |
| title | 파라미터 바인딩 |
| linenumbers | true |
SELECT
SALE_DATE,
CUSTOMER_NAME
FROM
SALES
WHERE
USER_CODE
=
:VS_USER_CODE$
--
세션의
사용자
코드를
바인딩
합니다.
2.3. i-META에서 사용 예제
조건 컨트롤에 ":전역변수명$" 값으로 사용 할 수 있습니다.
| title | 참고사항 |
|---|
세션 변수는 읽기 전용으로 값을 설정해도 세션 값이 변경되지 않습니다.
변수명 뒤에 $ 가 있을 경우 동일한 변수명이어도 세션 변수를 가져 옵니다.
| hidden | true |
|---|
관련 이슈