가져오기·내보내기·마이그레이션

Mattermost v11.11번역일: 2026-09-02원본 보기

Entry, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다(Professional에서는 사용할 수 없습니다).

보드 아카이브 가져오기와 내보내기

Board(보드)를 백업하거나 다른 팀 또는 채널 워크스페이스에서 재사용하고 싶다면 아카이브 파일로 내보낸 뒤 원하는 팀이나 채널 워크스페이스에서 그 아카이브 파일을 가져오면 됩니다. 내보내고 가져오는 보드 아카이브에는 Property(속성), 댓글, 설명, 이미지 첨부 파일 같은 모든 Card(카드) 콘텐츠가 포함됩니다.

이렇게 하려면 보드 맨 위 New(새로 만들기) 버튼 왼쪽의 옵션 메뉴 더 보기 아이콘를 선택하세요. 그런 다음 Export board archive(보드 아카이브 내보내기)를 선택합니다. 아카이브 파일을 내려받으세요. 내보낸 보드를 추가할 팀이나 채널 워크스페이스로 이동한 뒤 프로필 사진 옆의 톱니바퀴 아이콘을 선택하고 Import archive(아카이브 가져오기)를 선택하세요. 내보낸 보드가 이 팀 또는 채널 워크스페이스에 추가됩니다.

Import archive 옵션은 보드를 현재 팀으로 가져옵니다. 가져온 보드에 대한 접근은 보드 권한으로 제어하세요. 기존 .focalboard 형식은 향후 릴리스에서 지원이 중단되지만 그때까지는 가져오기를 지원합니다. 현재 가져오기 대화 상자는 .boardarchive를 찾습니다. .focalboard 파일을 선택해 가져오려면 Select all files(모든 파일 선택)를 사용하세요.

CSV로 내보내기

보드를 CSV 파일로 내보내려면 보드 맨 위 New 버튼 왼쪽의 옵션 메뉴 더 보기 아이콘를 선택하세요. 그런 다음 Export to CSV(CSV로 내보내기)를 선택합니다.

다른 애플리케이션에서 가져오고 내보내기

다른 도구의 데이터를 Boards에서 사용할 수 있도록 가져올 수 있습니다.

Asana에서 가져오기

이 node 앱은 Asana JSON 아카이브를 .boardarchive 파일로 변환합니다.

  1. Asana 계정에 로그인합니다.
  2. Asana 보드 이름 옆의 드롭다운 메뉴를 선택합니다. 그런 다음 Export/Print > JSON을 선택합니다. 그러면 Boards에서 사용할 아카이브 파일이 만들어집니다.
  3. 파일을 로컬에 저장합니다(예: asana.json).
  4. 로컬 머신에서 터미널 창을 열고 focalboard 저장소를 로컬 디렉터리(예: focalboard)에 클론합니다.
git clone https://github.com/mattermost/focalboard focalboard
  1. focalboard/webapp으로 이동합니다.
  2. npm install을 실행합니다.
  3. focalboard/import/asana로 디렉터리를 옮깁니다.
  4. npm install을 실행합니다.
  5. 같은 폴더에서 npx ts-node importAsana.ts -i <asana.json> -o archive.boardarchive를 실행합니다. 그러면 다음과 같은 데이터가 생성됩니다.
 asana macbook$ npx ts-node importAsana.ts -i ~/Downloads/asana.json -o archive.boardarchive
 Board: 1:1 Meeting Agenda Test
 Card: [READ ME] Instructions for using this project
 Card: [EXAMPLE TASK] Feedback on design team presentation
 Card: [EXAMPLE TASK] Finalize monthly staffing plan
 Card: [EXAMPLE TASK] Review Q2 launch video outline
 Card: [EXAMPLE TASK] Mentor a peer

 Found 5 card(s).
 Exported to archive.boardarchive
  1. Boards에서 내보낸 데이터를 사용할 보드를 엽니다.
  2. Settings > Import archive(설정 > 아카이브 가져오기)를 선택하고 archive.boardarchive를 고릅니다.
  3. Upload(업로드)를 선택합니다.
  4. 보드로 돌아가 Asana 데이터가 표시되는지 확인합니다.

Asana 데이터가 보이지 않으면 오류가 표시됩니다. 로그 파일에서 오류를 확인할 수도 있습니다.

가져오기 범위

현재 이 스크립트는 단일 보드의 모든 카드를 섹션(열) 소속, 이름, 메모와 함께 가져옵니다.

Notion에서 가져오기

이 node 앱은 Notion의 CSV 및 마크다운 내보내기 결과를 .boardarchive 파일로 변환합니다.

  1. Notion 보드에서 보드 오른쪽 위의 ... 메뉴를 엽니다.
  2. Export를 선택하고 내보내기 형식으로 Markdown & CSV를 고릅니다.
  3. 생성된 파일을 로컬에 저장하고 폴더의 압축을 풉니다.
  4. 로컬 머신에서 터미널 창을 열고 focalboard 저장소를 로컬 디렉터리(예: focalboard)에 클론합니다.
git clone https://github.com/mattermost/focalboard focalboard
  1. focalboard/webapp으로 이동합니다.
  2. npm install을 실행합니다.
  3. focalboard/import/notion으로 디렉터리를 옮깁니다.
  4. npm install을 실행합니다.
  5. 같은 폴더에서 npx ts-node importNotion.ts -i <path to the notion-export folder> -o archive.boardarchive를 실행합니다.
  6. Boards에서 내보낸 데이터를 사용할 보드를 엽니다.
  7. Settings > Import archive(설정 > 아카이브 가져오기)를 선택하고 archive.boardarchive를 고릅니다.
  8. Upload(업로드)를 선택합니다.
  9. 보드로 돌아가 Notion 데이터가 표시되는지 확인합니다.

가져오기 범위

현재 이 스크립트는 단일 보드의 모든 카드를 속성과 마크다운 콘텐츠와 함께 가져옵니다.

Notion 내보내기 형식은 속성 유형을 보존하지 않으므로, 현재 스크립트는 모든 카드 속성을 Select 유형으로 가져옵니다. Focalboard로 가져온 뒤에 유형을 바꿀 수 있습니다.

Jira에서 가져오기

이 node 앱은 Jira .XML 내보내기 결과를 .boardarchive 파일로 변환합니다.

  1. Jira 고급 검색을 열고 내보낼 항목을 모두 검색합니다.
  2. Export > Export XML을 선택합니다.
  3. 생성된 파일을 로컬에 저장합니다(예: jira_export.xml).
  4. 로컬 머신에서 터미널 창을 열고 focalboard 저장소를 로컬 디렉터리(예: focalboard)에 클론합니다.
git clone https://github.com/mattermost/focalboard focalboard
  1. focalboard/webapp으로 이동합니다.
  2. npm install을 실행합니다.
  3. focalboard/import/jira로 디렉터리를 옮깁니다.
  4. npm install을 실행합니다.
  5. 같은 폴더에서 npx ts-node importJira.ts -i <path-to-jira.xml> -o archive.boardarchive를 실행합니다.
  6. Boards에서 내보낸 데이터를 사용할 보드를 엽니다.
  7. Settings > Import archive(설정 > 아카이브 가져오기)를 선택하고 archive.boardarchive를 고릅니다.
  8. Upload(업로드)를 선택합니다.
  9. 보드로 돌아가 Jira 데이터가 표시되는지 확인합니다.

가져오기 범위와 알려진 제한 사항

현재 이 스크립트는 각 항목을 카드로 만들어 단일 보드에 가져옵니다. Jira .XML 내보내기는 한 번에 최대 1000개 이슈로 제한된다는 점에 유의하세요.

사용자는 사용자 이름을 값으로 하는 Select 속성으로 가져옵니다.

다음 항목은 현재 가져오지 않습니다.

  • 커스텀 속성
  • 댓글
  • 포함된 파일

Trello에서 가져오기

이 node 앱은 Trello .json 아카이브를 .boardarchive 파일로 변환합니다.

  1. Trello 보드 메뉴에서 ...Show Menu를 선택합니다.
  2. More > Print and Export > Export to JSON을 선택합니다.
  3. 생성된 파일을 로컬에 저장합니다(예: trello.json).
  4. 로컬 머신에서 터미널 창을 열고 focalboard 저장소를 로컬 디렉터리(예: focalboard)에 클론합니다.
git clone https://github.com/mattermost/focalboard focalboard
  1. focalboard/webapp으로 이동합니다.
  2. npm install을 실행합니다.
  3. focalboard/import/trello로 디렉터리를 옮깁니다.
  4. npm install을 실행합니다.
  5. 같은 폴더에서 npx ts-node importTrello.ts -i <path-to-trello.json> -o archive.boardarchive를 실행합니다.
  6. Boards에서 내보낸 데이터를 사용할 보드를 엽니다.
  7. Settings > Import archive(설정 > 아카이브 가져오기)를 선택하고 archive.boardarchive를 고릅니다.
  8. Upload(업로드)를 선택합니다.
  9. 보드로 돌아가 Trello 데이터가 표시되는지 확인합니다.

가져오기 범위

현재 이 스크립트는 단일 보드의 모든 카드를 리스트(열) 소속, 이름, 설명과 함께 가져옵니다.

Todoist에서 가져오기

이 node 앱은 Todoist .json 아카이브를 .boardarchive 파일로 변환합니다.

  1. 오픈 소스 Todoist 데이터 내보내기 서비스 https://darekkay.com/todoist-export/에 접속합니다.
  2. Options 메뉴에서 Export As > JSON (all data)를 선택합니다.
  3. Archived 옵션이 체크되어 있다면 체크를 해제합니다.
  4. Authorize and Backup을 선택합니다. Todoist 계정으로 이동하니 화면의 안내를 따르세요.
  5. 내려받은 .json 파일의 이름과 위치를 기억해 둡니다.
  6. 로컬 머신에서 터미널 창을 열고 focalboard 저장소를 로컬 디렉터리(예: focalboard)에 클론합니다.
git clone https://github.com/mattermost/focalboard focalboard
  1. focalboard/webapp으로 이동합니다.
  2. npm install을 실행합니다.
  3. focalboard/import/todoist로 디렉터리를 옮깁니다.
  4. npm install을 실행합니다.
  5. 같은 폴더에서 npx ts-node importTodoist.ts -i <path-to-todoist.json> -o archive.boardarchive를 실행합니다.
  6. Boards에서 내보낸 데이터를 사용할 보드를 엽니다.
  7. Settings > Import archive(설정 > 아카이브 가져오기)를 선택하고 archive.boardarchive를 고릅니다.
  8. Upload(업로드)를 선택합니다.
  9. 보드로 돌아가 Todoist 데이터가 표시되는지 확인합니다.