Интеграция Lucid с Confluence Data Center

Для администраторов: инструкции по установке и настройке

Только владелец или администраторы учетной записи «Для команды» или «Корпоративный» могут устанавливать и настраивать приложение Lucidchart в Confluence Data Center или приложение Lucidspark в Confluence Data Center.
Следуйте этим инструкциям по установке:

1. Войдите в свой экземпляр Confluence как администратор.
2. Откройте административное меню.
3. Нажмите Дополнения на левой боковой панели.
4. Выберите Найти новые дополнения.
5. Найдите «Lucidchart» или «Lucidspark» в маркетплейсе Atlassian. 
6. Нажми на плитку Lucidchart Diagrams Connector или Lucidspark Boards Connector.
7. Выберите Установить сейчас в правом верхнем углу.
8. Если вы устанавливаете приложение Lucidchart, нажмите Установить сейчас в Data Center во всплывающем окне.

Приложение будет скачано на ваше устройство. 

Выполните следующие шаги в загруженном приложении, чтобы настроить его под свой экземпляр:

1. Нажмите Управление и Настройка, чтобы предоставить Lucid доступ к Confluence.
2. Войдите в свою учетную запись Lucid, если вы еще этого не сделали.
3. Выберите Привязать учетную запись, чтобы соединить свой экземпляр Confluence с учетной записью Lucid.

Чтобы настроить приложение Lucidchart для Confluence Data Center для среды Lucidchart for Gov, перейди по адресу <baseUrl>/admin/plugins/lucidchart/environmentconfig.action, где <baseUrl> — базовый URL экземпляра Confluence, и выберите lucidgov.app из раскрывающегося списка.

Добавление документа на страницу Confluence

Чтобы добавить диаграмму Lucidchart или доску Lucidspark на страницу Confluence, выполните следующие действия:

1. Создайте страницу Confluence или откройте существующую. 
2. Нажмите Редактировать в верхней части страницы.
3. Нажмите + в меню в верхней части страницы. 
4. Выберите Добавить диаграмму Lucidchart или Добавить доску Lucidspark. 
   • Если вы не видите эту опцию, свяжитесь с администратором своего аккаунта Lucidchart и попросите его установить и настроить соответствующее приложение Lucid для вашего экземпляра Confluence.
   • Если добавляемый документ находится в репозитории, нужно открыть этот репозиторий перед переходом к следующему шагу. Нажми Repositories на панели навигации слева, затем выбери нужный репозиторий.
5. Наведите курсор на документ, который хотите добавить, и нажмите Выбрать. 
   • Также можно создать новый документ, нажав + Документ в левом верхнем углу.
6. После выбора документ будет загружен на вашу страницу Confluence.
7. Нажмите Обновить в правом нижнем углу страницы Confluence, чтобы опубликовать документ.

После публикации все, у кого есть разрешения для этой страницы, смогут просмотреть документ.

Управление встроенными документами

Редактирование досок Lucidspark прямо со страницы Confluence

При встраивании доски Lucidspark в Confluence Data Center можно выбрать следующие настройки доступа, которые будут доступны непосредственно в Confluence:

• Только просмотр: пользователи Confluence могут только просматривать встроенную доску Lucidspark.
• Только комментирование: пользователи Confluence могут просматривать и оставлять комментарии на встроенной доске Lucidspark.
• Редактирование: пользователи Confluence могут редактировать встроенную доску Lucidspark. 

Редактирование доски Lucidspark непосредственно в Confluence предоставит широкий спектр возможностей, таких как добавление фигур и линий или участие в визуальной активности. Если вы новичок в Lucidspark и хотите научиться работать с различными доступными вам функциями, ознакомьтесь с нашей статьей Добро пожаловать в Lucidspark.

Редактирование документа Lucidchart при его открытии в Lucid

Если у вас есть доступ к редактированию страницы Confluence со вставленными документами Lucidchart, вы можете отредактировать документы в Lucid и перенести изменения обратно в Confluence.

Чтобы отредактировать документ, который уже был добавлен на страницу Confluence, выполните следующие действия:

1. На опубликованной странице Confluence наведите курсор на вставленную диаграмму Lucidchart или доску Lucidspark. 
2. Нажмите Открыть с помощью Lucidchart.
   • Если вы находитесь в режиме редактирования на странице Confluence, нажмите на вставленный документ и выберите Редактировать на панели опций, которая появится под диаграммой.
3. Документ откроется в редакторе Lucid, и теперь вы можете вносить в него изменения.
4. Когда вы закончите, нажмите Назад к Confluence в левом верхнем углу редактора Lucid.
   • Изменения будут автоматически синхронизированы со встроенным документом в Confluence.
5. Нажмите Обновить в правом нижнем углу страницы Confluence, чтобы опубликовать свои изменения.

Удаление документа со страницы Confluence

Чтобы удалить документ, который уже был добавлен на страницу Confluence, выполните следующие действия:

1. Нажмите Редактировать в верхней части страницы Confluence.
2. Выберите вставленный документ.
3. Нажмите Удалить на панели опций, которая появится под документом.
4. Нажмите Обновить в правом нижнем углу страницы Confluence, чтобы опубликовать свои изменения.

Настройте свойства отображения диаграммы

Чтобы получить доступ к свойствам отображения вставленного документа:

1. Нажмите Редактировать в верхней части страницы Confluence.
2. Выберите документ. 
3. Нажмите Свойства на панели опций, которая появляется под документом, чтобы открыть модальное окно свойств отображения.
4. Нажмите Сохранить после внесения изменений в свойства отображения.

В этом модальном окне можно увидеть следующие настройки, в зависимости от того, какое приложение Lucid вы используете:

• Изменение ширины и высоты вставленного документа.
• Включение или выключение авторазмера.
• Настройка выравнивания диаграмм, отображаемых на странице Confluence.
• Для документов Lucidchart: возможность указать, какие страницы будут доступны зрителям страницы Confluence (например, 3 или 2–3). 
  • Выбор страницы или диапазона страниц возможен только в том случае, если вы используете расширенный просмотр. 
• Переключение между расширенным и простым просмотром.
• Включение автообновления при обновлении документов в Lucid. 
  • Включение автообновления возможно только в том случае, если вы используете расширенный просмотр .

Простой и расширенный просмотр

Для отображения документов Lucid в Confluence Data Center доступны два вида просмотра: простой и расширенный.

Вы можете переключаться между простым и расширенным просмотром для конкретного документа в модальном окне макронастроек.

Простой просмотр

Простой просмотр размещается на серверах Confluence и предоставляет собой статичный PNG-файл документа. 

При наведении курсора на документ в режиме простого просмотра пользователи могут:

• Редактировать диаграммы в программе Lucid;
• Удалить диаграмму со страницы Confluence;
• Переключиться на расширенный просмотр;
• Обновить документ Lucid до последней версии;
• Увеличить и уменьшить масштаба диаграммы.

Если вставленный документ содержит несколько страниц, вы можете переключаться между ними, нажимая на соответствующую стрелку, которая появляется сбоку от средства просмотра, когда вы наводите курсор на документ.

Расширенный просмотр

Расширенный просмотр размещается на серверах Lucid и для работы требует доступа в интернет. Он обеспечивает полную интерактивность в документах Lucid. 

Рамка будет появляться при наведении курсора на документы при расширенном просмотре. 

Из верхней части рамки пользователи могут:

• Открыть документ Lucid в новой вкладке браузера;
• Просмотреть название документа;
• Представить любые слайды, которые были созданы в документе;
• Войти в полноэкранный режим;
• Открыть модальную панель «Параметры просмотра»
  • Эта модальная панель для приложения Lucidchart содержит возможность показать заметки, горячие точки, включить WebGL и обновить диаграмму до последней версии.

Из нижней части рамки пользователи могут: 

• Выбирать различные вкладки страниц для просмотра в документе Lucidchart;
• Просматривать различные слои диаграммы в документе Lucidchart;
• Увеличить и уменьшить масштаба диаграммы.

Преобразование диаграмм Draw.io в документы Lucidchart

Чтобы преобразовать диаграммы Draw.io в документы Lucidchart в Confluence Data Center, выполните следующие действия:

1. Перейдите на страницу с документами, которые вы хотите преобразовать.
2. Откройте файл в Draw.io и скачайте его в виде XML-файла.
3. Перейдите в режим редактирования на своей странице Confluence.
4. Используя значок с плюсом на панели инструментов в верхней части редактора, вставьте новый документ Lucidchart, выбрав «Lucidchart» в выпадающем списке.
5. После того как откроется редактор Lucidchart, вы можете импортировать диаграмму через меню импорта.
6. Как только диаграмма импортируется, выберите ее в списке документов, и она будет добавлена на вашу страницу Confluence. В этот момент вы будете перенаправлен обратно в Confluence.
7. Теперь преобразование завершено, и вы можете удалить свою оригинальную диаграмму Draw.io со своей страницы Confluence.

Перенос из Confluence Data Center в Confluence Cloud

Перед миграцией из Confluence Data Center в Confluence Cloud учти следующее: 

• Документы преобразуются по пространствам, а не по страницам.
• Эту миграцию нельзя отменить массово без восстановления предыдущей резервной копии экземпляра Confluence.
• Преобразование можно отменить отдельно для каждого документа, перейдя в документ и восстановив страницу из истории страниц.

При миграции с Confluence Data Center на Confluence Cloud для приложения Lucidchart выполните следующие действия, чтобы сбросить настройки документы для их повторного отображения:

1. Перейди в раздел конфигурации дополнения Lucidchart.
2. Выберите вкладку «Преобразование Confluence».
3. Нажми Поиск, чтобы найти диаграммы, которые необходимо конвертировать.
4. Выберите Преобразовать.

После переноса документов ознакомьтесь с нашей статьей Интеграция Lucid с Confluence Cloud, где приведены инструкции по использованию этой интеграции.

Часто задаваемые вопросы

Кто может просматривать и редактировать документы Lucid, встроенные в страницу Confluence?
Разрешения на просмотр документов Lucid в Confluence Data Center будут наследоваться от страницы Confluence. Это означает, что если можешь просматривать страницу Confluence, сможешь просматривать документы на странице Confluence независимо от того, есть ли у тебя учетная запись Lucid. 

Приложение Lucidchart в Confluence также получает разрешения на редактирование со страницы Confluence. Это означает, что если вы можете просматривать и редактировать страницу Confluence и являетесь лицензированным пользователем Lucid, то сможете просматривать и редактировать диаграммы в приложении Lucid, нажав на кнопку Открыть в Lucidchart на каждом документе.

Приложение Lucidspark в Confluence требует, чтобы у вас был как доступ к редактированию в Confluence, так и доступ к редактированию во встроенной доске Lucidspark, чтобы редактировать документ в Confluence.

Почему я застреваю в цикле входа в систему при попытке получить доступ к интеграции?
Если вы столкнулись с циклом входа, когда вам постоянно предлагается войти в Lucid при использовании этой интеграции, это, скорее всего, связано с блокировкой сторонних файлов cookie в вашем браузере. Ознакомьтесь с нашей статьей Устранение неполадок: включение сторонних файлов cookie для получения подробной информации о том, как изменить эту настройку, чтобы они больше не блокировались. 

Почему я вижу белые поля вокруг моих встроенных диаграмм Lucid в Confluence?
Пустое пространство вокруг документа при вставке диаграмм в Confluence — это нормально. Ознакомьтесь с этим постом сообщества Белое пространство во вставленных диаграммах (на английском языке) для получения инструкций по оптимизации внешнего вида встроенных документов.

Почему я вижу ошибку «Временная метка OAuth» при попытке установить приложение Lucidchart для Confluence Data Center?
Если при попытке установить и настроить коннектор 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. Войдите в свою учетная запись Lucid, которая в настоящее время неправильно связана с Confluence. 
2. Нажмите на изображение своего профиля или инициалы в правом верхнем углу своей учетной записи Lucid.
3. Выберите Настройки учетной записи.
4. Выберите Приложения и интеграция в левом меню.
5. Поставьте галочку напротив пункта «Confluence».
6. Нажмите кнопку Удалить. Это приведет к отключению учетной записи.
7. Чтобы восстановить правильное соединение, выйдите из Lucid. 
8. Вставьте любой документ Lucid на страницу Confluence. 
9. Когда появится запрос на вход в Lucid, убедитесь, что вы входите в систему с адресом электронной почты, связанной с аккаунтом Lucid вашей организации.

Что произойдет с подключением Confluence на уровне учетной записи, если настроивший его администратор уйдет?
Если администратор уйдет, подключение останется активным, поскольку оно установлено на уровне учетной записи. Разрешения администратора требуются только во время первоначальной настройки для создания подключения.
 

Оставьте отзыв об этой статье