Встраиваемый просмотрщик
Краткий обзор
- Узнайте о сценариях использования в клиентских порталах, процессах согласования и внутренних инженерных инструментах.
- Ознакомьтесь с основными требованиями к настройке, включая размещение ZIP-архива проекта по общедоступному URL-адресу.
- Узнайте, как настроить доступные режимы просмотра, форматы экспорта и скачивание исходных файлов.
Встраиваемый просмотрщик позволяет добавить интерактивный просмотр печатных плат и схем в ваше веб-приложение, чтобы участники проекта за пределами вашего рабочего пространства Altium 365 могли изучать проекты без установки каких-либо ECAD-инструментов.
Когда это полезно
-
Customer or supplier portals – дайте внешним партнерам возможность просматривать снимки проекта в нужном контексте без доступа к Altium.
-
Review and approval workflows – встройте просмотр проектов в заявки, контрольные списки выпуска или инструменты согласования, чтобы сотрудники производственного отдела, отдела закупок или руководство могли изучать проект непосредственно в них.
-
Internal engineering tools – свяжите требования, замечания или позиции спецификации с интерактивным представлением проекта.
Как это работает
Просмотрщик встраивается с помощью библиотеки JavaScript и контейнера <div>, ссылающегося на ZIP-файл проекта. ZIP-файл должен быть доступен по общедоступному URL-адресу — обычно его размещают в личном пространстве Altium 365 или в собственном хранилище.
Добавьте скрипт встраивания на свою страницу <head>:
<script src="<https://viewer.altium.com/client/static/js/embed.js>"></script>
Добавьте контейнер просмотрщика в тело страницы:
<div class="altium-ecad-viewer"
data-project-src="<https://example.com/mydesign.zip>"
style="height: 500px; max-width: 1280px; max-height: 700px; box-sizing: border-box;">
<a href="<https://www.altium365.com/viewer/>">PCB File Viewer by Altium</a>
</div>
Встроенный просмотрщик будет работать, пока доступен исходный файл проекта. Чтобы обеспечить постоянную доступность источника, сохраните проект в личном пространстве Altium 365 — для файлов в нем создаются постоянные URL-адреса.
Настройка
Управляйте отображаемыми представлениями и доступными выходными данными с помощью атрибутов data-* контейнера:
Атрибут |
Описание |
Значения |
|
Отображаемые представления (через запятую) |
|
|
Начальное представление при загрузке |
|
|
Ограничение допустимого типа файлов |
|
|
Доступные форматы экспорта |
|
|
Отключение скачивания исходного файла |
(наличие атрибута отключает скачивание) |
|
Альтернативный файл для скачивания (отличается от источника предварительного просмотра) |
URL-адрес |
Example – PCB and 3D views only, with Gerber and PDF export:
<div class="altium-ecad-viewer"
data-project-src="<https://example.com/mydesign.zip>"
data-enabled-views="pcb,3d"
data-active-view="pcb"
data-project-outputs="Gerber,pdf"
style="height: 500px; max-width: 1280px; box-sizing: border-box;">
<a href="<https://www.altium365.com/viewer/>">PCB File Viewer by Altium</a>
</div>
Получение кода встраивания из просмотрщика
Если вы загрузили проект в Altium 365 Online Viewer, вы можете скопировать готовый фрагмент кода для встраивания прямо из просмотрщика:
-
Откройте проект в просмотрщике.
-
Нажмите Share и выберите Embed this design anywhere on the web.
-
Скопируйте сгенерированный фрагмент HTML-кода.
В этом фрагменте используется data-project-token для ссылки на проект, загруженный на хостинг Altium. Чтобы указать собственный ZIP-файл, замените data-project-token на data-project-src и URL-адрес вашего файла.
Дополнительные материалы
-
Автономный просмотрщик – полный справочник по функциям просмотрщика, включая все параметры встраивания и подробное описание атрибутов
-
Автономный инструмент сравнения Gerber – сравнение файлов Gerber в просмотрщике
-
Встраивание личных загрузок – проекты и проектные данные, загруженные в ваше личное пространство Altium, можно встроить на веб-сайт с помощью встроенного просмотрщика Altium Viewer, чтобы любой пользователь мог просматривать их в интерактивном режиме.
-
Руководство по устранению неполадок просмотрщиков – решение распространенных проблем с просмотрщиком и встроенными проектами