Lucid와 Confluence Data Center 통합

관리자: 설치와 구성

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

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

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

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

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

루시드차트 포 정부 환경에 대한 루시드차트 데이터 센터용 루시드차트 앱을 설정하려면 <baseUrl> /admin/plugins/lucidchart/environmentconfig .action으로 이동하고, 여기서 <baseUrl> 은 Confluence 인스턴스의 기본 URL이며 드롭다운에서 lucidgov.app을 선택합니다.

Confluence 페이지에 문서 추가

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

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

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

삽입된 문서 관리

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

컨플루언스 데이터 센터에 Lucidspark 보드를 임베드하는 경우, 다음 액세스 설정 중에서 선택할 수 있으며, 이 설정은 컨플루언스에서 바로 사용할 수 있습니다:

• 보기 전용: Confluence 사용자는 내장된 Lucidspark 보드만 볼 수 있습니다.
• 댓글만 작성할 수 있습니다: Confluence 사용자는 내장된 Lucidspark 보드를 보고 댓글을 달 수 있습니다.
• 편집: Confluence 사용자는 내장된 Lucidspark 보드를 편집할 수 있습니다. 

Confluence에서 직접 Lucidspark 보드를 편집하면 도형과 선을 추가하거나 Visual Activity 에 참여하는 등 다양한 옵션이 제공됩니다. Lucidspark 을 처음 사용하며 다양한 기능을 사용하는 방법을 배우고 싶다면 웰컴 투 Lucidspark 문서를 참조하세요.

다음에서 Lucidchart 문서를 열어 편집합니다. Lucid

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

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

1. 게시된 Confluence 페이지에서 삽입된 Lucidchart 다이어그램 또는 Lucidspark 보드 위로 커서를 가져갑니다. 
2. 루시드차트로 열기를 클릭합니다.
   • 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 Data Center에서 Lucid 문서를 표시하는 데 사용할 수 있는 뷰어는 심플과 리치 두 가지입니다.

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

단순 뷰어

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

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

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

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

고급 뷰어

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

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

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

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

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

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

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

Draw.io 다이어그램을 Confluence Data Center에서 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 인스턴스의 이전 백업을 복원하지 않고는 일괄적으로 실행 취소할 수 없습니다.
• 문서로 이동하여 페이지 기록에서 페이지를 복원하면 문서별로 변환을 취소할 수 있습니다.

루시드차트 앱용 Confluence Data Center에서 Confluence Cloud로 마이그레이션하는 경우, 아래 단계에 따라 문서가 다시 표시되도록 문서를 재설정하세요:

1. 루시드차트 애드온의 구성 섹션으로 이동합니다.
2. "Confluence 전환" 탭을 선택합니다.
3. 검색을 클릭하여 변환해야 하는 다이어그램을 찾습니다.
4. 변환을선택합니다.

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

자주 묻는 질문(FAQ)

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

Confluence의 Lucidspark 앱은 Confluence 페이지에서 편집 권한을 가져옵니다. 즉, Confluence 페이지를 보고 편집할 수 있고 라이선스가 있는 Lucid 사용자라면 각 문서에서 Lucidchart에서 열기 단추를 클릭하여 Lucid 앱에서 다이어그램을 보고 편집할 수 있습니다.

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

통합에 액세스하려고 할 때 로그인 루프 현상이 발생하는 이유는 무엇인가요?
이 통합을 사용할 때 Lucid에 로그인하라는 메시지가 계속해서 표시되는 로그인 루프 문제가 발생한다면 브라우저에서 제삼자 쿠키가 차단되었기 때문일 가능성이 큽니다.문제 해결: 제삼자 쿠키 사용 문서에서 쿠키 차단을 해제하도록 설정을 변경하는 방법을 살펴볼 수 있습니다. 

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

Confluence Data Center용 Lucidchart 앱을 설치하려고 할 때 OAuth 타임스테이크 오류가 표시되는 이유는 무엇인가요?
루시드차트 Confluence 데이터 센터 커넥터를 설치하고 구성하려고 할 때 다음과 같은 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 연결은 어떻게 되나요?
관리자가 퇴사하더라도 계정 수준에서 설정된 연결은 활성 상태로 유지됩니다. 관리자 권한은 연결을 만들기 위한 초기 설정 프로세스 중에만 필요합니다.
 

이 문서에 관한 피드백 공유