UBi3

문서의 이전 판입니다!

개발환경을 아래와 순서로 진행 됩니다.

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

 1. SVN 설치

윈도우용 클라이언트를 다운로드 받는다.
설치를마친 후 탐색기를 열고 솔루션 루트가 될 폴더에서 마우스 우클릭으로 Check-out을 한다.

Check-out을 선택한다.

SVN 주소(EndPoint)와 사용자ID / Password 를 관리자로부터 제공 받는다.
ex) svn://svc1.trustsys.net/UBi3Project

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

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

1. SVN Check-out

https://110.45.156.44/svn/UBi3FrameWork

  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폴더를 지정

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

→

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 등을 수시로 수정할 수 있으며 바뀐 내용은 즉시 적용된다.

  
  UX화면을 개발환경에서 열게되면 자동으로 아래창이 활성화 된다.
  만일 그렇지 않다면 UBI_SERVER 환경변수에 서비스가 있는 폴더를 지정해야 한다.
  또한 dotnet-sdk-3.1.425-win-x64가 설치됬는지 확인해야 한다. 
  
  실행하게 되면 우선 폴더안에 있는 모든 서비스를 바인딩한다.    
  이 프로그램은 단축 아이콘으로 작업표시줄에 넣고 실행하는 것을 추천한다.

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

* 서버에 배치될 Release서비스는 디버그 메세지를 만들지 않는다.

예외로 Exception 발생은 log파일에 기록 된다.

↑ 상위로 가기