Conectar un espacio de trabajo de Altium 365 a sistemas externos

Design data in Altium 365 does not have to stay in Altium 365. The Altium 365 API gives external systems programmatic access to Workspace data – for reading, writing, and reacting to changes.

La API de Altium 365 proporciona acceso del lado del servidor a toda la gama de entidades del Workspace: componentes, diseños, BOM, metadatos de proyectos, usuarios, permisos y estados del ciclo de vida. Los sistemas externos pueden consultar estos datos, enviar actualizaciones e integrar eventos de Altium Workspace en flujos de trabajo empresariales más amplios. El acceso se basa en tokens; las operaciones se ejecutan del lado del servidor sin requerir que Altium Designer esté abierto ni que haya un usuario presente.

Este es el punto de integración correcto para cualquier caso de uso en el que un sistema externo necesite intercambiar datos con Altium 365 de forma programática: paneles, sincronización con ERP, canalizaciones de informes personalizadas, sistemas de auditoría y automatizaciones que se ejecutan fuera del entorno de diseño.

Patrones comunes de integración

• Data extraction and reporting – extraer datos de componentes, contenido de BOM, metadatos de proyectos y estados del ciclo de vida hacia sistemas externos de informes, paneles o almacenes de datos. Resulta útil para la visibilidad de la gestión de ingeniería, la planificación de compras y los informes de cumplimiento que necesitan datos de Altium pero residen en un sistema separado.

• ERP and inventory synchronization – enviar cambios del ciclo de vida de componentes y listas de piezas aprobadas desde Altium 365 al ERP. Extraer materiales aprobados y datos de inventario hacia Altium para mostrarlos en el entorno de diseño. La API es la capa de sincronización entre ambos sistemas.

• Automation pipelines – activar acciones posteriores cuando ocurren eventos en Altium 365 – se publica un diseño, cambia el estado del ciclo de vida de un componente o se completa una revisión de proyecto. La API permite que los sistemas externos de orquestación respondan al estado de Altium Workspace sin sondeos ni activadores manuales.

• Custom tooling and portals – crear herramientas internas que muestren datos de Altium en contextos donde la interfaz completa de Workspace no sea adecuada – un portal de aprobación de componentes, un panel de estado de liberaciones, una vista de compras que muestre solo los datos que necesita el área de compras. La API proporciona la capa de datos; su herramienta proporciona la interfaz.

• User and permission management – gestionar programáticamente la pertenencia al Workspace, los niveles de acceso y la estructura de equipos. Resulta útil para organizaciones en las que el aprovisionamiento de Altium Workspace debe mantenerse sincronizado con un sistema central de identidad o de RR. HH.

Qué no reemplaza la API

La API de Altium 365 brinda acceso a datos y operaciones en el nivel de Workspace. No expone el modelo del editor de diseño – primitivas de PCB, objetos esquemáticos, topología de red – que reside dentro de Altium Designer. Para casos de uso que requieren acceso a datos a nivel de diseño durante una sesión de edición activa, la herramienta adecuada es el SDK de Altium Designer. Para casos de uso que requieren acceso a primitivas de diseño de PCB para procesamiento posterior, la API de datos de diseño de Nexar proporciona una vía de acceso independiente.

Consideraciones sobre el enfoque de integración

• Token management – la API utiliza autenticación basada en tokens. Los tokens de acceso personal están asociados al usuario y atribuyen las acciones a ese usuario. Los tokens de aplicación están asociados a una aplicación con nombre y son adecuados para canalizaciones automatizadas e integraciones de servidor a servidor. Elija en función de si la integración representa a una persona actuando o a un sistema actuando.

• Eventual consistency – en algunos casos, los cambios en los datos del Workspace se propagan de forma asíncrona. Las integraciones que dependen del estado en tiempo real deben tener en cuenta la latencia entre el momento en que ocurre un cambio y el momento en que ese cambio se hace visible a través de la API.

• Error handling and retries – las integraciones de producción deben implementar lógica de reintento con backoff para fallos transitorios. Las operaciones de Workspace son duraderas, pero las condiciones de red y los límites de tasa no están garantizados.