본문 바로가기

Excel2Json

[Excel2Json] 엑셀 파일을 Json 파일로 변환해 주는 툴(1.2.0 Release)

반응형

최신버전 1.4.0 업데이트 링크

 

Excel2Json 1.2.0 버전을 업데이트 했습니다.

크게 달라진 기능은 없고, 변수 타입 중 double 타입을 추가하였습니다.

 

Excel2 Json의 특징 설명

1. 도움말 (옵션 : -h/-help)

2. input / output directory or file 설정 가능

사용 방법 : -d/-f <iput_dir/input_file> -o <output_dir/output_file>

3. 옵션의 순서에 상관없이 명령줄을 추가할 수 있습니다.

4. 엑셀 시트의 기능

1) A1 셀 : Json 파일 이름 및 C# 클래스 파일명

2) 2번행 : 키의 간단 명칭 및 설명(주석에 사용)

3) 3번행 : C# 파일에서 사용할 변수의 데이터 타입(int, double, string, bool, ENUM 타입 사용 가능)

4) 4번행 : Json 에서 사용할 키 값을 입력(C# 파일에서 변수명으로 사용됨)

5) 4번행의 셀에 메모를 삽입할 경우 C# 파일의 변수 선언에 주석으로 사용됩니다.

6) C#에서 ENUM 타입을 사용할 경우 변수에서 초기화를 선택해야 합니다.(아래 설명)

5. C#(C Sharp) 파일을 자동 생성하는 기능(옵션 : -cs)

사용 방법 : -d <> -o <> -cs

**.cs 파일은 A1 셀에 정의되어 있는 파일명으로 생성됩니다.

엑셀 파일에 정의되어 있는 데이터 타입으로 변수를 선언하고 초기화합니다.

BaseMasterDataManager.cs 파일이 같이 생성이 되며 각 시트별 json 데이터를 각 시트에 지정되어 있는 클래스 이름으로 로딩할 수 있습니다.

BaseMasterDataManager.cs 파일을 상속받아 기능을 확장할 수도 있습니다.

6. 변환하지 않는 시트 설정 가능(시트 이름에 !를 추가하면 해당 시트는 json 변환에 제외됩니다.)

사용 방법 : 로직 시트 -> !로직 시트

위와 같은 방법으로 시트 이름에 ! 문자를 추가해주면 해당 시트는 변환에서 제외됩니다.

7. ENUM 타입

ENUM  필요한 경우가 있음.

ENUM  타입의 경우 json 데이터에서는 int 형식으로 저장이 됨.

C# 파일이 생성될 때 ENUM 타입 및 초기화 값으로 설정해 줘야 합니다.

사용 방법 : C# 파일에 선언되어 있는 ENUM 

public enum SEX_TYPE

{

   NONE = 0,

   MAIL,

   FEMAIL,

   UNI_SEX

}

위와 같이 선언되어 있다면, 엑셀 데이터 타입을 입력하는 셀에 ENUM:SEX_TYPE:NONE으로 입력하면 됩니다.

1) ENUM : 타입을 사용하겠다는 선언

2) SEX_TYPE : C# 파일에 참조 가능한 ENUM의 타입명을 입력해 준다.

3)  NONE : 변수를 초기화시킬 때 사용. 실제 enum에 선언되어 있는 값을 입력해 줘야 한다.(대소문자 구분)

4) 구분자는 : 으로 구분된다.

8.  JSON 파일명(또는 클래스 이름) 추가

A1 위치의 셀에 이름을 입력하면 json 파일의 이름이 해당 셀의 데이터 이름으로 생성됩니다.

C# 파일을 생성할 경우 클래스 이름으로 생성됩니다.

유니티에서 사용하기에 적합한 방식입니다.

9. 패스워드 기능 추가

json 데이터를 암호화합니다.

.NET 4.x Equivalent 를 기준으로 암호화하였기 때문에 해당 버전으로 복호화를 사용해야 합니다.

사용 방법 : -pw [비밀번호 입력]

위의 옵션으로 데이터 암호화를 추가할 수 있습니다.

암호화한 파일을 복호화 해주는 Security.cs 파일을 같이 첨부합니다.

Security.cs 의 8 line에 

private static readonly string SecurityPassword = '[비밀번호 입력]'

이 부분은 암호화 했을 때 사용했던 [비밀번호]를 입력해 주면 복호화가 정상적으로 이루어 집니다.

이 또한 유니티에 최적화 되어 있습니다.

10. 일반 json 파일 생성 배치파일 (build.bat)과 암호화 json 파일 생성 배치 파일(buile_encrypt.bat) 파일 공유

첨부 파일에 일반 json 파일을 생성해주는 build.bat 파일과 암호화를 해주는 buidl_encrypt.bat 파일을 포함하였습니다.

.bat 파일을 참고하여 사용하시면 편리하게 사용할 수 있습니다.

 

 

샘플 엑셀 데이터

 

주로 유니티에서 사용하기 편리한 방법으로 개발되었습니다.

C# 기능을 빼면 어디서든 사용이 가능할 것입니다.

유용하게 사용하시면 좋겠습니다.

 

더 필요한 기능이 있다면 언제든 댓글 달아주세요.

가능한 기능이고, 저도 필요한 기능이라면 가능한 추가 할 예정입니다.

아래 다운로드 링크

Excel2Json_ver_1.2.0.zip
0.05MB

반응형