본문 바로가기

Excel2Json

[Excel2Json] 엑셀 파일을 json으로 변환해주는 툴. (1.1.0.0 Release)

반응형

최신버전[1.3.0] 보러가기

 

Excel2Json 의 1.1.0.0 버전을 출시했습니다.

크게 달라진 기능은 없지만 엑셀 시트 부분을 조금 수정했습니다.

엑셀 시트에 테이블 명을 삽입할 수 있습니다.

이 테이블 명이 json 파일의 이름이 되고, C# 파일로 생성될 때 C# 파일의 클래스 이름으로 생성됩니다.

C# 파일의 클래스가 생성 될 때 자동으로 json 파일을 로드해주는 BaseMasterDataManager.cs 파일도 같이 생성이 됩니다

json을 클래스로 생성하여 값을 가져오기 편한 방식으로 구현하였으며

BaseMasterDataManager.cs 클래스를 상속받아서 기능을 더 추가하는 클래스를 생성할 수 있습니다.

나머지 기능은 기존과 동일합니다.

샘플 엑셀 파일도 포함하여 공유하겠습니다.



1. 도움말 기능을 추가하였습니다. (옵션 : -h/-help)

2. -o  옵션을 추가했습니다. 기존에 -o 옵션없이 output_directory를 사용하였으나, 이제부터는 -o 옵션을 사용해야만 output_directory를 사용할 수 있습니다.

기존 : -d/-f <input_dir/input_file>  형식으로 사용하였음.

변경 : -d/-f <input_dir/input_file> -o  방법으로 사용해야 함.

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

ex) -d/-f <input_dir/input_file> -o  or -o  -d/-f <input_dir/input_file> 모두 사용 가능


4. 엑셀 시트의 기능

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

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

3) 3번 행 : 기존의 Json 키 값을 입력. (C# 파일에서 변수명으로 사용됨)

4) 3번 행의 셀에 메모를 삽입할 수 있습니다.(C# 파일의 변수명에 주석으로 사용.)


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

ex) -d  -o  -cs 

*.cs 파일은 시트이름으로 생성됨

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

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

BaseMasterDataManager.cs 클래스를 상속받아 기능을 추가할 수도 있습니다.



6. 변환하지 않는 시트 설정 가능. (시트이름에 !을 추가하면 해당 시트는 Json으로 변환하지 않는다.)

ex) 로직시트-> !로직시트

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



7. enum 타입 

enum 타입이 필요한 경우가 있음. 

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

C# 파일이 생성될 때 enum 타입 및 초기값으로 설정해준다.

ex) C# 파일에 선언되어 있는 enum 

public enum SEX_TYPE
{
     NONE = 0,
     MALE,
     FEMALE,
     UNI_SEX
}

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

① enum : enum 타입을 사용하겠다는 선언

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

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

④ 구분자는 : 으로 구분한다.


8. json 파일명(또는 클래스 이름) 추가 (A1 셀에 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 파일 생성 배치파일(build_encrypt.bat) 파일 공유

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

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

 

샘플 엑셀 데이터

 

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

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

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

 

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

가능한 기능이고, 저도 필요한 기능일 경우 추가 가능합니다.

아래 다운로드 링크

Excel2Json_ver_1.1.0.0.zip
0.05MB

반응형