모두의 지식 저장고

작업패키지를 (일감) 을 OpenProject 에 일괄 업로드 하는 방법에 대해 알아봅니다. 

공식문서는 아래 링크를 참고 합니다. 

https://www.openproject.org/docs/system-admin-guide/integrations/excel-synchronization/

작업패키지 일감 일괄 등록 방법

• OpenProjectExcel 유틸을 이용해서 일괄적으로 일감을 일괄 등록 하는 방법에 대해 설명합니다.

OpenProjectExcel 다운로드

• https://github.com/opf/OpenProjectExcel 에 업로드된 유틸을 다운로드 받습니다.

• 압축해제후 OpenProjectAPI.xlsm 파일을 실행 합니다. 

OpenProjectExcel 실행(OpenProjectAPI.xlsm)

• 콘텐츠 사용 버튼을 클릭합니다. 

• ctl+b 버튼을 클릭하면 업로드할 프로젝트 설정 정보 창이 오픈된다.
• URL 텍스트 입력창에 프로젝트 URL 을 입력 하면 Intance URL , Project 항목이 자동 셋팅 된다.
• API 토큰 정보는 우측 상단 계정설정 -> 액세스 토큰 메뉴를 선택후 접속 토큰을 생성 한다. 

• OpenProject  프로젝트 정보를 모두 입력 하고 Accept 버튼을 클릭 하면 아래와 같이 컴파일 에러가 발생 한다. 
  • Tested on: Windows 10, Excel 16.0, VBA 7.1 에서 테스트 버전과 호환이 안되는것으로 보임 
  • 테스트한 버전은 Excel 2013 버전 
• 코드 수정후 비주얼 베이직을 재실행 한다. 
  • "? -> "?" 수정

TextStr = Replace(TextStr, "\u00A1", "?", , , vbBinaryCompare) TextStr = Replace(TextStr, "\u00A2", "?", , , vbBinaryCompare)

OpenProjectAPI 작업 패키지 동기화 및 업로드 

• 다운로드 workpackages 를 누르면 작업패키지 항목이 다운로드 된다.

• 항목을 추가 하고 싶다면 데이터생성후 Upload/Update 버튼을 클릭 한다.
  • 버전 잠금, ID 값을 미입력 하면 신규 작업패키지가 추가 되고 
  • 내용을 수정 하면 작업패키지가 수정 된다. 

• 정상 업로드 되면 아래와 같이 Updatestatus 항목의 컬럼 값이 수정 된다. 
  • 수정 사항 발생 시 : Updatestatus -> 200-OK , 버전잠금 -> 숫자 증가.
  • 신규 추가 사항 반영시 : Updatestatus -> 201-Created ,  버전잠금 -> 숫자 1 생성 .

• OpenProject 접속후 작업패키지를 확인시 추가 및 수정한 작업패키지 내용에 대한 변경 사항이 반영된것을 확인 할수 있다. 

작업 패키지 사용자 정의 필드 추가 작업 적용 

• 업로드할 컬럼 정보(사용자 정의 필드) 를 추가 하고자 할경우 엑셀의 드랍다운 박스를 이용해 추가할 항목을 선택한다. 
• 컬럼정보는 Attributes 시트에 작성 되어 있다. 

OpenProject가 정상 설치되었다면 이제 OpenProject 를 사용하기 위한 기본 사용 환경 설정 방법에 대해 알아본다. 

OpenProject 한글 설정 방법

• Account setting -> Setting ->Language 설정 -> 한국어 변경 

OpenProject 프로젝트 생성 

• 좌측 상단 + 버튼을 클릭해서 프로젝트 관리하기 위한 신규 프로젝트를 생성 할수 있다. 

• 릴리즈 이름으로 프로젝트가 생성 된다. 

• OpenProject 는 작업 패키지 단위로 일감을 관리 할수 있다. 
• 작업패키지 매뉴를 클릭해서 해야할 일을 등록 한다. 

• 등록한 일감은 Gantt 차트 형식으로도 일정 관리를 할수 있다. 
• 일감의 진행 시작 일자와, 종료일자를 등록 하고 현재 일감 상태를 변경 하면서 일감(작업패키지) 을 관리 한다.

• 담당자 할당을 위해서는 사용자 등록/관리가 필요하다 . 
• 사용자 등록 관리 방법에 대해 알아본다.

사용자관리 방법

• 우측 상단 관리 매뉴를 선택한다.

• 프로젝트를 관리하기 위한 다양한 기능을 지원한다. 
• 사용자 및 권환 매뉴를 선택해서 openproject 에서 업무를 수행할 맴버를 추가 하고 관리 권한을 추가 한다. 

• 계정이 생성되면 접속 비빌 번호를 설정 한다. 
• 다음로그인 암호 변경 적용 체크 박스를 클릭하면 최초 사용자 접속시에 비밀번호 변경을 할수 있닷.

• 사용자가가 접근 가능 한 프로젝트 항목을 선택하고 추가 버튼을 눌러서 역할 및 프로젝트 접근 권한을 부여 한다. 

• 역할및 권한 메뉴에서는 역할 별로 프로젝트 관리 접근 권한을 설정 할수 있다. 

사용자 정의 필드

• 작업패키지를 생성 하면 기본 제공 하는 필드로 충분히 업무 내용을 구분 할수 있지만 , 사용자 필드를 사용함으로서 
• 프로젝트를 진행 하기 위해 필요한 항목을 추가 할수 있다. 
• 관리 -> 사용자 저으이 필드 메뉴을 선택 해서 추가하고자 하는 사용자 정의 컬럼을 추가 한다. 
  • 아래 예시는 회의록 프로젝트에서 사용할 업무 필드에 대하 설정을 예시로 한다. 

• 추가된 사용자 정의 필드를 사용하기 위해서는  업무 유형에 메뉴에서 추가된 업무 구분 필드를 추가해 주어야 한다. 
  • 관리-> 작업 패키지 -> 유형 이름 선택(Task) -> 양식 구성(탭) 

• 프로젝트로 돌아와 작업패키지에서 컬럼 보기 설정 (톱니바퀴) 을 클릭해서 추가된 사용자 정의 필드를 추가 한다. 
• 추가된 컬럼을 드래그&드랍 을 통해 컬럼 보기 순서를 지정할수 있다. 

• 지정한 사용자 정의 컬럼을 다른 사용자와 공유 하기 위해서는 보기 저장 기능을 사용해서 업무 리스트를 같이 볼수 있다. 

• 사용자가 지정한 필터를 추가 해서 새로운 이름의 보기형식을 저장 할수도 있다. 

사전 환경 구성 

Openproject 다운로드 

• openproject 를 git clone 으로 다운로드 받는다.
  • 설치 버전은 openproject 15 버전을 다운로드 받아 설치 한다.  

• 다운로드 받은 openproject 폴더로 이동후 docker pull 을 통해 openproject 이미지를 다운로드 받는다. 

git clone https://github.com/opf/openproject-deploy --depth=1 --branch=stable/15 openproject

cd openproject/

#도커 이미지를 내려받는다.
docker-compose pull

# 설정 파일 복사 
#OpenProject 설정 파일을 복사후 설치할 환경 정보에 맞게 수정을 한다.
cp .env.example .env

#openproject 컨테이너를 기동한다. 
docker-compose up -d

• openproject 디렉토리 

docker-compose pull

.env 파일 수정 

• OPENPROJECT_HOST__NAME : openproject 설치 호스트 ip 정보 
• PORT=5055 : 접속 포트 (접속 포트 변경 필요시 수정 필요)
• PGDATA="./pgdata" : postsgresql data 경로 
• OPDATA="./opdata/assets" : openproject 데이터 경로
  • 접근권한 에러가 발생 하기 때문에  openproject 디렉토리 접근 권한을 변경 한다. 
  • chmod -Rf 777 opdata/ 
  • sudo chown -Rf openprj.openprj opdata pgdata    
    • seeder_1    | Errno::EACCES: Permission denied @ dir_s_mkdir - /var/openproject/assets/files (Errno::EACCES)

TAG=15-slim
OPENPROJECT_HTTPS=false
OPENPROJECT_HOST__NAME=192.168.116.12
PORT=5055
OPENPROJECT_RAILS__RELATIVE__URL__ROOT=
IMAP_ENABLED=false
DATABASE_URL=postgres://postgres:p4ssw0rd@db/openproject?pool=20&encoding=unicode&reconnect=true
RAILS_MIN_THREADS=4
RAILS_MAX_THREADS=16
PGDATA="./pgdata"
OPDATA="./opdata/assets"

openproject container 기동 

• docker-compose up  -d       
• 정상 기동되면 아래와 같이 컨테이너가 실행 된다. 
  • docker-compose ps -a  : openproject 컨테이너 기동 상태 확인 

Openproject  접속

• http://xxx.xxx.xxx.xxx:[port] 로 접속을 한다. 
• admin/admin 으로 접속 한다. 

• 최초 접속후 admin 비번을 수정해줘야 한다. 

• 비밀번호를 변경하고 접속 하게 되면 openproject 메인 화면을 확인 할수 있다. 

• 한국어 설정을 원할경우 My account -> settting -> Language 에서 한국어를 선택 한다.