Confluence에서 가져오기

데이터를 모두 한 곳에 모아두는 것은 중요해요. Confluence 스페이스를 Notion으로 가져오는 방법을 차근차근 소개해 드릴게요. 필요에 따라 두 가지 방법으로 Confluence에서 Notion으로 가져올 수 있습니다.

• Zip 파일 가져오기 도구: 워크스페이스의 일부만 가져올 때 사용할 수 있습니다. 최대 5GB의 소규모 워크스페이스만 가져올 수 있습니다(요청 시 15GB까지).

• API 통합 가져오기 도구: 전체 워크스페이스만 가져올 수 있습니다. 최대 30GB의 워크스페이스를 가져올 수 있습니다. 댓글과 사용자 매핑이 유지됩니다.

멀티스페이스 가져오기: UI를 통해 한 번에 최대 10개의 Confluence 스페이스를 직접 가져올 수 있습니다. 선택한 각 Confluence 스페이스는 자체 로그 페이지를 생성하며, 필요에 따라 서로 다른 Notion 팀스페이스에 별도의 최상위 개인 페이지로 가져옵니다. 이 기능은 비즈니스 및 엔터프라이즈 요금제를 이용하는 경우에만 지원됩니다.

• Confluence 사이트 → Notion 조직

• Confluence 스페이스 → Notion 워크스페이스

• Confluence 페이지 → Notion 페이지

• 매크로 → 단순화된 콘텐츠 또는 가장 유사한 Notion 블록 유형(예: Confluence 펼치기 기능 → Notion 토글)

• 최대 5만 개 페이지 또는 30GB크기까지 가져오기할 수 있습니다. 더 많이 가져오면 작업이 실패할 수 있습니다.

  • 팁: 대용량 스페이스의 경우, 하위 스페이스나 섹션별로 내보내기를 분할하고 ZIP 가져오기 도구를 사용하세요. 워크스페이스 크기가 100GB를 초과하는 경우, 계정 관리자에게 문의하세요.

• 가져오기가 시작되면 안심하고 브라우저를 닫을 수 있습니다. 가져오기가 완료되면 이메일로 알려드립니다.

• 설정 → 가져오기에서 가져오기 진행 상황을 확인하세요. 여기에서 가져오기 상태와 완료된 가져오기 작업을 확인할 수 있습니다.

Confluence 스페이스를 HTML로 내보내기

1. Confluence 워크스페이스에서 오른쪽 상단 사이드바에 있는 스페이스 설정으로 이동하세요.

2. 상단 툴바에서 콘텐츠 도구를 선택한 다음 내보내기를 선택하세요. 옵션이 보이지 않는다면 워크스페이스 관리자에게 내보내기 권한을 요청해야할 수 있어요.

3. 형식 목록에서 HTML을 선택하세요.

4. 사용자 지정 내보내기를 선택하고 댓글 포함 확인란의 체크 표시를 해제하세요.

5. 내보낼 페이지를 선택하세요. 대용량 첨부 파일이 포함된 페이지의 경우 내보내기 크기와 복잡성이 크게 증가할 수 있으니 참고하시기 바랍니다.

6. 내보내기가 끝날 때까지 기다려 주세요. 대규모 워크스페이스의 경우 시간이 다소 걸릴 수 있습니다.

7. 내보내기가 완료되면 다운로드하기를 클릭하여 내보낸 파일을 컴퓨터에 저장하세요. 파일 이름은 Confluence-space-export-XXXXXX.html.zip과 같이지정됩니다.

Notion으로 가져오기

1. Confluence 콘텐츠를 가져오려는 Notion 워크스페이스로 이동하세요.

2. 사이드바의 설정 → 가져오기 → 제3자 앱에서 가져오기 → Confluence로 이동하세요.

3. Confluence에서 내보낸 .zip 파일로 이동하여 해당 파일을 선택하고 업로드하세요. 파일의 압축을 해제하지 않아도 되니 전체 압축 파일 그대로 업로드하세요.

4. 브라우저에서 파일을 업로드하면 '업로드 중'이라는 메시지가 표시된 다음, 상태 메시지에 가져오기 진행률이 나타납니다.

5. 가져오기가 완료되면 새로 가져온 콘텐츠로 이동합니다.

Confluence와 Notion 연결하기

1. 사이드바의 설정 → 가져오기 → Confluence로 이동하세요.

2. API로 가져오기를 선택하세요.

3. 클라우드 또는 서버 중에서 Confluence 인스턴스 유형을 선택하세요. 인스턴스 유형을 찾으려면 Confluence를 열고 프로필 옆에 있는 도움말 → ?(물음표) → Confluence 정보를 클릭합니다. Notion은 클라우드와 서버 인스턴스만 지원합니다.

Confluence 클라우드로 인증

1. Confluence 이메일과 사이트를 입력하세요.

2. Atlassian 계정에서 API 토큰을 생성하고 이 토큰을 필드에 입력하세요. Confluence에서 토큰을 만드는 방법에 관해 자세히 알아보세요.

3. 인증을 클릭하세요.

Confluence 서버로 인증

1. Confluence 버전을 찾아 선택하세요.

2. Confluence 이메일과 사이트를 입력하세요.

3. 버전 7.9 이상의 Confluence를 실행 중인 경우 개인 액세스 토큰을 만들어 붙여넣으세요. 이전 버전을 사용하고 있으면 Confluence 사용자 이름과 비밀번호를 입력하세요.

4. 인증을 클릭하세요.

가져오기

1. 가져오기 메뉴에서 Confluence를 클릭하세요.

2. 가져오기 진행 상황을 모니터링하세요. 이 단계는 대용량 스페이스의 경우 몇 시간이 걸릴 수도 있습니다.

   • 페이지 가져오는 중… 메시지가 표시되면 안심하고 브라우저 창을 닫을 수 있습니다. 가져오기가 완료되면 이메일로 알려드려요.

3. 또 다른 Confluence 스페이스를 가져오려면 이 섹션을 반복하세요.

• Notion은 모든 항목을 개인 페이지 섹션의 단일 루트 또는 상위 페이지로 가져오거나, 가져오기를 수행하는 사용자가 선택한 팀스페이스로 가져옵니다.

• 사용자는 다른 사용자를 초대하기 전에 워크스페이스 아키텍처를 정리하고 설정해야 합니다.

• Notion에서 권한을 다시 적용해야 합니다. Confluence 그룹과 제한 사항을 Notion 그룹, 팀스페이스, 페이지 수준 권한에 매핑하기 위해 가져오기 후 작업을 계획하세요.

• Confluence 표에 파일이나 첨부 파일이 있으면 해당 표가 Notion 데이터베이스가 되고, 그렇지 않은 경우에는 간단한 표가 됩니다.

• 표 스타일 적용 및 매크로/플러그인이 기본 상태로 바뀌는 경우가 많습니다(예: UI 단계, 콜아웃, 이미지 캡션).

• 대부분의 매크로는 지원되지 않습니다. Notion은 데이터를 가장 가까운 Notion 블록에 매핑하려고 합니다.

• Confluence API의 불안정성으로 인해 일시적 오류가 발생하여 전체를 가져오는 작업이 실패하거나 일부 페이지를 가져오지 못할 수 있습니다. 가져오기 전체를 재시도해야 할 수도 있습니다.

• 멀티스페이스의 경우, 멀티스페이스 가져오기(비즈니스/엔터프라이즈 전용)를 사용하지 않는 한 가져오기를 순차적으로(한 번에 스페이스 하나씩) 실행하세요.

• 복잡한 Confluence 데이터(예: 병합 셀, 표 안에 있는 표)의 경우 가져오기 작업이 실패할 수 있습니다.

• Notion은 범위 설정 토큰이 아닌, 사용자 범위 설정 API 토큰만 지원합니다. 인증 시 개인 API 토큰 옵션을 사용하세요.

• 페이지에서 참조되지 않는 첨부 파일과 미디어는 가져올 수 없습니다.

• 계층 구조가 완전히 유지되지 않는 경우가 있을 수 있습니다. 시범 운영으로 가져오기하여 제대로 작동하는지 확인하세요.

• LaTeX 수학 블록이 잘못 가져오기됨

  • 이러한 현상이 발생하는 이유: Confluence LaTeX 플러그인의 블록 매크로 형식은 인라인 수학 공식과 다릅니다. Notion은 인라인 LaTeX 매크로는 지원하지만 블록 매크로 변형은 지원하지 않습니다.

  • 해결 방법: Confluence에서 LaTeX 블록 매크로를 인라인 매크로로 변환한 후 다시 가져오거나, LaTeX를 코드 블록에 배치하고 가져오기 후 수동으로 수학 공식 블록으로 변환합니다.

• Gliffy 콘텐츠를 가져올 수 없음

  • 이러한 현상이 발생하는 이유: Notion은 파일 가져오기 도구를 이용한 Gliffy 이미지 가져오기를 지원하지 않습니다.

  • 해결 방법: Gliffy 블록을 올바른 파일을 참조하는 이미지 블록으로 바꾸도록 HTML을 수정한 후 다시 가져옵니다.

• 가져오기 실패

  • 이러한 현상이 발생하는 이유: 대용량 스페이스, 잘못된 형식의 내보내기 파일, 속도 제한 또는 시간 초과로 인한 것일 수 있습니다.

  • 해결 방법: 한 번에 스페이스를 하나씩 가져오거나, 대용량 스페이스를 여러 섹션으로 분할하거나, 오류 없는 ZIP 파일을 다시 내보내거나, 범위가 지정된 실행으로 API 가져오기 도구를 사용하세요.

• 가져오기 시 이미지 또는 첨부 파일이 누락됨

  • 이러한 현상이 발생하는 이유: 자산이 내보내기 번들에 포함되지 않았거나 API 토큰으로 접근할 수 없기 때문일 수 있습니다.

  • 해결 방법: 내보내기 시 '첨부 파일 포함' 옵션이 선택되어 있는지 확인하거나, ZIP 파일에서 상대 경로를 그대로 유지하거나, 가져오기 후 주요 자산을 다시 업로드합니다.

• 가져오기 후 Jira 링크 미리보기가 제대로 작동하지 않음

  • 이러한 현상이 발생하는 이유: Jira 링크 미리보기는 마이그레이션을 시작하기 전에 사용자가 인증된 경우에만 작동합니다.

  • 해결 방법: 마이그레이션을 실행하기 전에 Jira 인증을 완료합니다.

• 파일 계층 구조가 예상대로 유지되지 않음

  • 이러한 현상이 발생하는 이유: 내보내기 구조에서 예외적인 경우 또는 깊은 중첩 구조로 인한 것일 수 있습니다.

  • 해결 방법: 먼저 대표적인 하위 집합으로 테스트하고, 가져오기 후에 Notion에서 다시 구성합니다.

• Confluence 매크로 및/또는 특수 형식이 손상됨:

  • 이러한 현상이 발생하는 이유: 지원되지 않는 매크로나 앱 콘텐츠로 인한 것일 수 있습니다.

  • 해결 방법: Notion의 기본 블록(펼치기 → 토글, 액션 아이템 → 할 일)으로 매핑합니다. 복잡한 표를 단순화하거나 CSV로 내보낸 후, Notion 데이터베이스로 가져옵니다.

• Confluence 권한이 Notion에 복제되지 않음:

  • 이러한 현상이 발생하는 이유: 직접 가져오기한 경우 이러한 현상이 발생할 수 있습니다.

  • 해결 방법: 콘텐츠를 Notion에 가져오면 Notion 그룹, 팀스페이스, 페이지 수준 권한을 사용하여 권한 매핑을 계획하고 실행하세요.