UBi3

이 문서는 읽기 전용입니다. 원본을 볼 수는 있지만 바꿀 수는 없습니다. 문제가 있다고 생각하면 관리자에게 문의하세요.
**개발환경을 아래와 순서로 진행 됩니다.**

 설치 순서는 다음과 같습니다.

   1. SVN 설치
윈도우용 클라이언트를 [[https://tortoisesvn.net/downloads.html?utm_source=chatgpt.com#google_vignette|다운로드]] 받는다.\\
설치를마친 후 탐색기를 열고 솔루션 루트가 될 폴더에서 마우스 우클릭으로 Check-out을 한다.

{{:svn_checkout.png?200|}}
     * Check-out을 선택한다.
{{:svn_checkout_popup.png?300|}}
     * SVN 주소(EndPoint)와 사용자ID / Password 를 관리자로부터 제공 받는다. 
     * ex) <nowiki>svn://svc1.trustsys.net/UBi3Project</nowiki>

UBi3의 Root가 될 폴더를정한다.\\
이후 전부 그 하위에 위치하게 된다.\\
일부 디렉토리는 꼭 지정된 이름을 사용해야 한다.\\

    root(UBi3)\
      + UBi3FrameWork
        + FrameWorkReference {프레임워크 UX 개발에 사용되는 Control과 컴포넌트 dll}
        + Server ------------{개발 디버그용 local server}
        + sw ----------------{프로젝트에 사용되는 설치프로그램들... : VisualStudio 2019, DevExpress 20.1.x 등}
      + UBI3Projects---------{프로젝트가 위치할 최상위 폴더}
        + MyProject1---------{프로젝트폴더}
        + TestProject--------{프로젝트 2}
        + .. 


===== 1. SVN Check-out =====
===   https://110.45.156.44/svn/UBi3FrameWork ===
      svnuser=guest, password=1


    FrameWork를 처음 Check-out 했을때 폴더내에 생기는 하위구조
    UBi3 --------------------[프레임워크의 최상위 Folder]
      + UBi3Framework
        + FrameWorkReference {프레임워크 UX 개발에 사용되는 Control과 컴포넌트 dll}
        + Server ------------{개발 디버그용 local server}
        + sw ----------------{프로젝트에 사용되는 설치프로그램들... : VisualStudio 2019, DevExpress 20.1.x 등}

  2. VisualStudio 2019 설치
     * svn 체크아웃 후에 생성된 sw폴더에서 찾을수 있음
     * 설치시에 워크로드 탭의 구성은 **ASP.NET 및 웹개발, .NET 테스크톱 개발, Office/SharePoint 개발**  등 을 선택하고 설치한다.
     * 개별구성요소는 **.NET Framework 4.7.2** 와 **ClickOnce 게시** 을 선택하여 설치한다.


  3. DevExpress 20.1.7 설치
     * svn 체크아웃 후에 생성된 sw폴더에서 찾을수 있음


  4. SVN 설치 for Visual Studio
     * VisualStudio SVN 플러그인 설치
     * VisualStudio 메뉴>확장(X)>확장관리(M)> 에서 "visualSVN"을 검색하여 설치한다.
     * 설치가 끝난 후 메뉴에서 /도구/옵션/소스제어 항목에 VisualSVN을 선택한다.

===   5. Project Check-out ===
Projects 하위에 체크아웃 한다.\\
Projects 하위 폴더는 실제 사이트의 개발Project가 되며 프로젝트 ID를 폴더이름으로 사용하도록 한다.\\
 예) 서울전선 => SEC, 등...

    UBi3
      + Projects
         + SEC-------> 서울전선 프로젝트
           + Comm ---> 공통화면
           + Main ---> 진입점{Program.cs}
           + Menual--> 각 화면에서 호출될 설명서.pdf
           + Screens-> Release로 컴파일된 개별화면.dll
           + SYS-----> 시스템 기본기능 화면
           + UX------> 각 업무용 화면(내주 하위 업무구조 구성)
         + BComp-----> B사 프로젝트
           + Comm ---> 공통화면
           + Main ---> 진입점{Program.cs}
           + Menual--> 각 화면에서 호출될 설명서.pdf
           + Screens-> Release로 컴파일된 개별화면.dll
           + SYS-----> 시스템 기본기능 화면
           + UX------> 각 업무용 화면(내주 하위 업무구조 구성)
         + CComp-----> C사 프로젝트
           + Comm ---> 공통화면
           + Main ---> 진입점{Program.cs}
           + Menual--> 각 화면에서 호출될 설명서.pdf
           + Screens-> Release로 컴파일된 개별화면.dll
           + SYS-----> 시스템 기본기능 화면
           + UX------> 각 업무용 화면(내주 하위 업무구조 구성)


  6. 로컬서버 환경변수 등록
     - 변수이름 : UBI3_SERVER
     - 변수값   : svn-Checkout한 디렉토리의 Server폴더를 지정
{{:시스템속성.png?300|}}
{{:환경변수지정.png? 350|}}

  7. Visual Studio 툴박스 설정
     1) 새 도구상자 탭을 만든다. 이름은 'UBi3'로 한다.
     2) 도구상자에 Framework 컨드롤을 등록한다.
       - UBi3 탭을 마우스 오른족으로 선택하여 '항목선택'을 누르고 
        '찾아보기(R)'을 눌러 checkout했던 svn 솔루션 포더에서 'FrameWorkReference' 폴더안에 
        'UBi.Winform.Controls.dll' 파일을 찾아 선택하고 등록하면 된다
     * 도구상자 등록은 Winform 디자인이 열린상태에서만 가능
{{:도구상자.png?300|}} ->  {{:도구상자_항목추가.png?400|}}



  7. 개발 디버그환경 구축하기
     1) svn 루트 및에 Server폴더가 있는지 확인한다. 이 폴더는 Checkout시에 자동으로 생성된다.
     
     2) 서버 기본정보 파일확인
     UBI3/UBi3FrwmeWork/Server/
       ../Data ------------------------------- 서버환경 기본디텍토리
         +file ---------------------------- 클라이언트에서 어플케이션에서 파일 저장용도로 사용하는 폴더
         +logs ---------------------------- 시스템로그
         +menual -------------------------- UX 메뉴얼
         +settings ------------------------ 서버가동 환경지정
           f: ServiceSettings.json
            => {"LoginID":"a","Password":"a","EncryptKey":"salte69","Certificate":""}
            => {"접속ID":"a","접속패스워드":"a","구간암호화 키":"salte69","인증서":""} : 인증서 없이는 Localhost만 운용가능
           +service ----------------------- 개발중인 데이터베이스의 환경이 구성되는 폴더
            f: 서비스명.json -------------- 개발중인 사이트 갯수만큼 등록됨
             => **아래 내용중 주어진 정보에 따라 #으로 코멘트한 내용을 적절하게 수정해야 한다.**
                {
                  "ServiceInfo": {
                  "Name": "서비스ID",
                  "Url": "http://localhost:5000/api",
                  "Port": 5000,
                  "UserID": "a",
                  "Password": "a"
                },
                "DBInfo": {
                  "DBServerAddress": "localhost",         # DB IP
                  "DBPort": 3306,                         # DB Port
                  "DBSID": "test1",                       # db명
                  "DBUserID": "user1",                    # DB login id
                  "DBPassword": "password",               # DB password
                  "CommandTimeout": 30000,                # time-out
                  "DBType": 3  # 데이터베이스 타입 {1: Oracle, 2 SQLServer, 3:Maria, 4:PostgreSQL}
               },
               "DataPath": "",
               "ServiceStatus": 1,
               "UseDBLog": true,
               "DBLogTableName": "SYS_ERRLOG",
               "SaveDatabaseContent": true,
               "GoogleApiKey":"..."
             }
         +setup --------------------------- 솔루션 배포파일
         +update -------------------------- 화면 배포파일
         
     3) local환경에서 서비스는 무제한으로 등록할수 있습니다.
       참고로 local서버는 local에서만 접속가능 합니다.
       
     4) RESTful Service는 .net 3.1 기반의 서비스 이므로 /UBi3FrameWork/sw 폴더내에 있는
       dotnet-sdk-3.1.425-win-x64를 설치해야 한다. 
         

  8. 개발 디버그 모드
    
    UBI3_SERVER 환경변수에 등록된 path에 'UBi.Net.RestfulServer.exe' 실행 파일을 실행하면
    ../UBi3/UBi3FrameWork/Server/Data/settings/service 폴더에 있는 서비스 파일들이 로딩된다.
    서비스 파일들은 실행중에도 편집과 추가 삭제가 가능하다.
    서비스 파일내용에 DataBase 주소, user, password 등을 수시로 수정할 수 있으며 바뀐 내용은 즉시 적용된다.
    
{{:servicefiles.png?500|}}
    
    UX화면을 개발환경에서 열게되면 자동으로 아래창이 활성화 된다.
    만일 그렇지 않다면 UBI_SERVER 환경변수에 서비스가 있는 폴더를 지정해야 한다.
    또한 dotnet-sdk-3.1.425-win-x64가 설치됬는지 확인해야 한다. 
    
    실행하게 되면 우선 폴더안에 있는 모든 서비스를 바인딩한다.    
    이 프로그램은 단축 아이콘으로 작업표시줄에 넣고 실행하는 것을 추천한다.
    
    
{{:debugcmd.png?600|}}

    테스트 진행중 서비스창에서 호출되는 Procedure내용을 볼수 있으며
    넘어가는 파라메터 값과 실행중 발생하는 오류등이 표시된다.
    DB서버의 Procedure를 디버그 하기에 유용하다.
    
{{:debuglogs.png?600|}}    

   ** 서버에 배치될 Release서비스는 디버그 메세지를 만들지 않는다. 
   예외로 Exception 발생은 log파일에 기록 된다.
   

[[start|↑ 상위로 가기]]