Встраиваемый Viewer
Embeddable Viewer позволяет добавить интерактивный просмотр PCB и схем в ваше веб-приложение, чтобы заинтересованные стороны вне вашего Workspace в Altium 365 могли проверять проекты без установки каких-либо ECAD-инструментов.
Когда использовать
-
Customer or supplier portals – позвольте внешним партнерам просматривать снимки проекта в контексте, без необходимости получать доступ к Altium.
-
Review and approval workflows – встраивайте просмотр проекта в тикеты, чек-листы релиза или инструменты согласования, чтобы команды производства, закупок или управления могли напрямую просматривать проект.
-
Internal engineering tools – связывайте требования, проблемы или позиции BOM с интерактивным представлением проекта в реальном времени.
Как это работает
Средство просмотра встраивается с помощью библиотеки JavaScript и контейнера <div>, указывающего на ZIP-файл проекта. ZIP-файл должен быть доступен по публичному URL-адресу — обычно он размещается в вашем Personal Space в Altium 365 или в собственном хранилище.
Добавьте скрипт встраивания на свою страницу <head>:
<script src="<https://viewer.altium.com/client/static/js/embed.js>"></script>
Добавьте контейнер viewer в тело страницы:
<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>
Встроенный viewer будет оставаться активным до тех пор, пока доступен исходный файл проекта. Чтобы источник был постоянным, сохраните проект в вашем Personal Space в 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>
Получение кода для встраивания из Viewer
Если вы загрузили проект в Altium 365 Online Viewer, вы можете сразу скопировать готовый фрагмент кода для встраивания:
-
Откройте проект в viewer.
-
Нажмите Share и выберите Embed this design anywhere on the web.
-
Скопируйте сгенерированный HTML-фрагмент.
Этот фрагмент использует data-project-token для ссылки на проект, загруженный в хостинг Altium. Чтобы указать собственный ZIP-файл, замените data-project-token на data-project-src и URL-адрес вашего файла.
Дополнительные материалы
-
Standalone Viewer – полное описание возможностей viewer, включая все варианты встраивания и сведения об атрибутах
-
Standalone Gerber Compare – сравнение файлов Gerber в viewer
-
Embedding Personal Uploads – проекты и данные проекта, которые вы загрузили в свой Altium Personal Space, можно встроить в веб-сайт для интерактивного просмотра любым пользователем с помощью встроенного Altium Viewer.
-
Viewers Troubleshooting Guide – устранение распространенных проблем со viewer и встроенными проектами