Lucid와 Confluence Data Center 통합

관리자: 설치와 구성

팀 또는 기업 계정의 계정 소유자 또는 계정 관리자만 Confluence Data Center에서 Lucidchart 앱이나 Confluence Data Center에서 Lucidspark 앱을 설치하고 구성할 수 있습니다.
다음 설치 지침을 따르세요.

1. Confluence 인스턴스에 관리자로 로그인합니다.
2. 관리 메뉴를 엽니다.
3. 왼쪽 사이드바에서 추가 기능을 클릭합니다.
4. 새 추가 기능 찾기를 선택합니다.
5. Atlassian 마켓플레이스에서 'Lucidchart' 또는 'Lucidspark'를 검색합니다. 
6. Lucidchart 다이어그램 커넥터 타일 또는 Lucidspark 보드 커넥터 타일을 클릭합니다.
7. 오른쪽 상단에서 지금 다운로드를 선택합니다.
8. Lucidchart 앱을 설치하려는 경우 팝업 창의 Data Center 아래에 있는 지금 다운로드를 클릭합니다.

앱이 로컬 장치에 다운로드됩니다. 

다운로드한 앱에서 다음 단계에 따라 각자의 인스턴스에 맞게 앱을 구성합니다.

1. 관리와 구성을 클릭해 Lucid에 Confluence 액세스를 부여합니다.
2. 로그인하지 않은 경우 Lucid 계정에 로그인합니다.
3. 계정 연결 을 선택해 Confluence 인스턴스를 Lucid 계정에 연결합니다.

Confluence Data Center용 Lucidchart 앱을 정부 기관용 Lucidchart 환경에 설치하려면 <baseUrl>을 Confluence 인스턴스의 기본 URL로 사용하는 <baseUrl>/admin/plugins/lucidchart/environmentconfig.action으로 이동해 드롭다운에서 lucidgov.app을 선택합니다.

Confluence 페이지에 문서 추가

Confluence 페이지에 Lucidchart 다이어그램 또는 Lucidspark 보드를 추가하는 방법은 다음과 같습니다.

1. Confluence 페이지를 새로 만들거나 기존 페이지를 엽니다. 
2. 페이지 상단에서 편집을 클릭합니다.
3. 페이지 상단 메뉴에서 +를 클릭합니다. 
4. Lucidchart 다이어그램 추가 또는 Lucidspark 보드 추가를 선택합니다. 
   • 이 옵션이 표시되지 않는 경우 Lucidchart 계정 관리자에게 문의해 Confluence 인스턴스에 적합한 Lucid 앱을 설치해 구성하도록 요청하세요.
   • 추가하려는 문서가 리포지토리에 있는 경우, 다음 단계로 이동하기 전에 해당 리포지토리를 열어야 합니다. 왼쪽 탐색 메뉴에서 리포지토리를 클릭한 다음, 특정 리포지토리를 선택합니다.
5. 추가하려는 문서 위로 커서를 가져간 후 선택을 클릭합니다. 
   • 왼쪽 상단 모서리에 있는 + 문서를 클릭하여 새 문서를 만들 수도 있습니다.
6. 선택하면 문서가 Confluence 페이지에 로드됩니다.
7. Confluence 페이지 오른쪽 하단에 있는 업데이트를 클릭해 문서를 게시합니다.

게시되면 해당 페이지에 대한 권한이 있는 모든 사용자가 문서를 볼 수 있습니다.

삽입된 문서 관리

Confluence 페이지에서 직접 Lucidspark 보드 편집

Lucidspark 보드를 Confluence Data Center에 임베드하는 경우 다음 액세스 설정 중에서 선택할 수 있으며, 이 설정은 Confluence에서 바로 사용할 수 있습니다.

• 보기 전용: Confluence 사용자는 임베드된 Lucidspark 보드만 볼 수 있습니다.
• 코멘트 전용: Confluence 사용자는 임베드된 Lucidspark 보드를 보고 코멘트를 할 수 있습니다.
• 편집: Confluence 사용자는 임베드된 Lucidspark 보드를 편집할 수 있습니다. 

Confluence에서 Lucidspark 보드를 직접 편집하면 도형과 선을 추가하거나 시각적 활동에 참여하는 등 다양한 옵션을 사용할 수 있습니다. Lucidspark를 처음 사용하거나 다양한 기능을 활용하는 방법을 알고 싶으시다면 Lucidspark에 오신 것을 환영합니다 문서를 참조하세요.

Lucid에서 Lucidchart 문서를 열어 편집

Lucidchart 문서가 삽입된 Confluence 페이지를 편집할 권한이 있는 경우 Lucid에서 문서를 편집하고 변경 사항을 Confluence로 다시 푸시할 수 있습니다.

Confluence 페이지에 이미 추가된 문서를 편집하는 방법은 다음과 같습니다.

1. 게시된 Confluence 페이지에서 삽입된 Lucidchart 다이어그램 또는 Lucidspark 보드 위로 마우스 커서를 가져갑니다. 
2. Lucidchart로 열기를 클릭합니다.
   • Confluence 페이지에서 편집 모드를 사용 중인 경우 삽입된 문서를 클릭한 후 다이어그램 아래에 표시된 옵션 막대에서 편집을 선택합니다.
3. 문서가 Lucid 편집기에서 열리면 이제 문서를 편집할 수 있습니다.
4. 완료되면 Lucid 편집기의 왼쪽 상단에서 Confluence로 돌아가기를 클릭합니다.
   • 변경 사항이 있을 경우 Confluence에 삽입된 문서에 변경 사항이 자동으로 동기화됩니다.
5. Confluence 페이지 오른쪽 하단에 있는 업데이트 를 클릭해 변경 사항을 게시합니다.

Confluence 페이지에서 문서 삭제

Confluence 페이지에 이미 추가된 문서를 삭제하는 방법은 다음과 같습니다.

1. Confluence 페이지 상단에서 편집을 클릭합니다.
2. 삽입된 문서를 선택합니다.
3. 문서 아래에 표시되는 옵션 막대에서 제거를 클릭합니다.
4. Confluence 페이지 오른쪽 하단에 있는 업데이트를 클릭해 변경 사항을 게시합니다.

다이어그램 디스플레이 속성 조정

삽입된 문서의 디스플레이 속성에 액세스하는 방법은 다음과 같습니다.

1. Confluence 페이지 상단에서 편집을 클릭합니다.
2. 문서를 선택합니다. 
3. 문서 아래 표시되는 옵션 막대에서 속성을 클릭해 디스플레이 속성 모달을 엽니다.
4. 디스플레이 속성을 변경한 후 저장을 클릭합니다.

이 모달에서는 사용 중인 Lucid 앱에 따라 다음과 같은 설정이 표시될 수 있습니다.

• 삽입된 문서의 너비와 높이를 조정합니다.
• 자동 크기 조정을 켜거나 끕니다.
• Confluence 페이지에 표시된 다이어그램의 정렬을 조정합니다.
• Lucidchart 문서인 경우, Confluence 페이지 뷰어에서 열람인이 볼 수 있는 페이지(예: 3 또는 2~3)를 지정합니다. 
  • 페이지 또는 페이지 범위를 선택하는 기능은 고급 뷰어에서만 사용할 수 있습니다. 
• 고급 뷰어와 단순 뷰어 사이를 전환합니다.
• Lucid에서 문서가 업데이트될 때 자동 업데이트를 활성화합니다. 
  • 자동 업데이트는 고급 뷰어를 사용하는 경우에만 활성화할 수 있습니다.

단순 뷰어와 고급 뷰어 비교

Confluence 데이터 센터에서 Lucid 문서를 표시할 때 사용할 수 있는 뷰어에는 단순 뷰어와 고급 뷰어가 있습니다.

매크로 설정 모달에서 특정 문서에서 단순 뷰어를 사용할 것인지 고급 뷰어를 사용할 것인지 설정할 수 있습니다.

단순 뷰어

단순 뷰어는 Confluence 서버에서 호스팅되며 정적 PNG를 제공합니다. 

문서 위로 마우스 커서를 올리면 단순 뷰어를 사용해 다음과 같은 작업을 수행할 수 있습니다.

• Lucid에서 다이어그램 편집
• Confluence 페이지에서 다이어그램 제거
• 고급 뷰어로 전환
• Lucid 문서 최신 버전으로 새로 고침
• 다이어그램 확대/축소

삽입된 문서에 여러 페이지가 있는 경우 문서 위에 마우스 커서를 가져갔을 때 뷰어 측면에 표시되는 화살표를 클릭해 페이지를 전환할 수 있습니다.

고급 뷰어

고급 뷰어는 Lucid 서버에서 호스팅되며, 고급 뷰어를 실행하려면 인터넷에 접속되어 있어야 합니다. 고급 뷰어는 Lucid 문서와 완전하게 상호 작용합니다. 

고급 뷰어로 표시된 문서 위로 마우스 커서를 가져가면 프레임이 나타납니다. 

프레임 상단에서는 다음 작업을 수행할 수 있습니다.

• 새 브라우저 탭에서 Lucid 문서 열기
• 문서 제목 보기
• 문서에서 생성된 슬라이드 표시
• 전체 화면 모드로 전환
• 뷰어 옵션 모달 열기
  • Lucidchart 앱용 모달에는 메모와 핫스팟을 표시하고, WebGL을 활성화하고, 최신 버전의 다이어그램으로 업데이트하는 기능이 포함되어 있습니다.

프레임 하단에서는 다음 작업을 수행할 수 있습니다. 

• Lucidchart 문서에서 볼 다른 페이지 탭 선택
• Lucidchart 문서에서 다이어그램의 다른 레이어 보기
• 다이어그램 확대/축소

Draw.io 다이어그램을 Lucidchart 문서로 변환

Confluence Data Center에서 Draw.io 다이어그램을 Lucidchart 문서로 변환하는 방법은 다음과 같습니다.

1. 변환할 문서가 포함된 페이지로 이동합니다.
2. Draw.io에서 파일을 열고 XML 파일로 다운로드합니다.
3. Confluence 페이지에서 편집 모드로 전환합니다.
4. 편집기 상단 도구 모음에 있는 더하기 아이콘을 클릭한 후 드롭다운에서 Lucidchart를 선택해 새 Lucidchart 문서를 삽입합니다.
5. Lucidchart 편집기를 연 후 불러오기 메뉴를 통해 다이어그램을 불러올 수 있습니다.
6. 다이어그램을 불러온 후 문서 목록에서 해당 다이어그램을 선택하면 Confluence 페이지에 추가됩니다. 그러면 화면이 Confluence로 다시 리디렉션됩니다.
7. 변환이 완료되었습니다. 이제 Confluence 페이지에서 원본 Draw.io 다이어그램을 삭제할 수 있습니다.

Confluence Data Center에서 Confluence Cloud로 마이그레이션

Confluence Data Center에서 Confluence Cloud로 마이그레이션하기 전에 다음 사항을 유의하세요. 

• 문서는 페이지 단위가 아닌 스페이스 단위로 변환돼요.
• 이 마이그레이션은 Confluence 인스턴스의 이전 백업을 복원하지 않으면 일괄 취소할 수 없습니다.
• 문서로 이동한 후 페이지 기록에서 페이지를 복원하여 문서별로 변환을 취소할 수 있습니다.

Lucidchart 앱을 Confluence Data Center에서 Confluence Cloud로 마이그레이션하는 경우, 아래 단계를 따라 문서를 재설정하여 다시 표시되도록 하세요.

1. Lucidchart 추가 기능의 구성 섹션으로 이동합니다.
2. “Confluence Conversion” 탭을 선택합니다.
3. 변환해야 하는 다이어그램을 찾으려면 검색을 클릭하세요.
4. 전환을 선택합니다.

문서를 마이그레이션한 후에는 Lucid와 Confluence Cloud 통합 문서를 참조하여 통합 사용 방법 지침을 확인하세요.

자주 묻는 질문(FAQ)

Confluence 페이지에 임베드된 Lucid 문서는 누가 보고 편집할 수 있나요?
Confluence Data Center에서 Lucid 문서 보기 권한은 Confluence 페이지에서 상속됩니다. 즉, Confluence 페이지를 볼 수 있는 경우 Lucid 계정 보유 여부와 관계없이 Confluence 페이지에서 문서를 볼 수 있습니다. 

Confluence의 Lucidchart 앱도 Confluence 페이지에서 편집 권한을 가져옵니다. 즉, Confluence 페이지를 보고 편집할 수 있고 라이선스가 있는 Lucid 사용자인 경우 각 문서에서 Lucidchart에서 열기 버튼을 클릭해 Lucid 앱에서 다이어그램을 보고 편집할 수 있습니다.

Confluence의 Lucidspark 앱에서 Confluence에서 문서를 편집하려면 Confluence 편집 권한과 삽입된 Lucidspark 보드 편집 권한이 모두 있어야 합니다.

통합에 액세스하려고 할 때 로그인 루프에 갇히는 이유는 무엇인가요?
이 통합을 사용할 때 Lucid에 로그인하라는 메시지가 계속 표시되는 로그인 루프가 발생하는 경우, 이는 브라우저에서 타사 쿠키가 차단되었기 때문일 가능성이 큽니다. 문제 해결: 타사 쿠키 활성화 문서를 참조하여 더 이상 차단되지 않도록 해당 설정을 변경하는 방법에 대한 자세한 내용을 확인하세요. 

Confluence에 임베드된 Lucid 다이어그램 주위로 흰색 여백이 표시되는 이유는 무엇인가요?
Confluence에 다이어그램을 삽입할 때 문서 주위에 여백이 생기는 것은 정상입니다. 삽입된 다이어그램의 여백 에 관한 이 커뮤니티 게시글(영어)에서 임베드된 문서를 최적화하는 방법을 확인할 수 있습니다.

Confluence Confluence Data Center용 Lucidchart 앱을 설치하는 과정에서 OAuth 타임스탬프 오류가 발생하는 이유는 무엇인가요?
Lucidchart Confluence Data Center 커넥터를 설치해 구성할 때 다음과 같은 OAuth 타임스탬프 오류가 표시될 수 있습니다.

“org.scribe.exceptions.OAuthException: Response body is incorrect. Can't extract token and secret from this: 'oauth_problem=expired_timestamp,_yours_1359614629,_ours_1359585813'”

이는 Confluence를 호스팅하는 서버의 타임스탬프가 정확하지 않다는 의미일 수 있습니다. 서버 시간이 적절해 보이더라도 15~30초 정도의 간극으로 인해 두 서버의 통신이 이루어지지 않을 수 있습니다. 서버 시간은 수동으로 정밀하게 조정할 수 없기 때문에 타임스탬프를 NTP 서버와 동기화해야 합니다.

'이 인스턴스와 연결된 팀에 속해 있지 않습니다' 오류가 발생하는 이유는 무엇인가요?
이 오류는 사용자가 잘못된 Lucid 계정에 연결되었을 가능성이 있음을 의미합니다. 이를 수정하려면 다음 단계를 따르세요.

1. 현재 Confluence에 잘못 연결되어 있는 Lucid 계정에 로그인합니다. 
2. Lucid 계정 오른쪽 상단에 있는 프로필 이미지 또는 이니셜을 클릭합니다.
3. 계정 설정을 선택합니다.
4. 왼쪽 메뉴에서 앱 및 통합을 선택합니다.
5. 'Confluence' 옆에 있는 확인란을 선택합니다.
6. 제거 버튼을 클릭합니다. 그러면 계정 연결이 끊어집니다.
7. 올바른 연결을 다시 설정하려면 Lucid에서 로그아웃합니다. 
8. Lucid 문서를 Confluence 페이지에 삽입합니다. 
9. Lucid에 로그인하라는 메시지가 표시되면 조직의 Lucid 계정과 연결된 이메일로 로그인합니다.

초기에 Confluence 연결을 설정한 관리자가 탈퇴하면 계정 전체의 해당 연결은 어떻게 되나요?
관리자가 탈퇴하더라도 계정 수준에서 설정된 연결은 계속 활성 상태로 유지됩니다. 관리자 권한은 연결을 생성하는 초기 설정 과정에서만 필요합니다.
 

이 문서에 관한 피드백 공유