Política de compatibilidad

En coolOrange, creemos que el software debe capacitar a los equipos de ingeniería, no restringirlos. Nuestra política de compatibilidad con el futuro ofrece a los clientes la confianza de que sus automatizaciones e integraciones seguirán siendo funcionales a medida que el software de Autodesk (como Vault / Inventor) evolucione sin sorpresas ni costes ocultos.

Qué significa compatibilidad

En este contexto, compatibilidad con el futuro significa que sus personalizaciones seguirán funcionando como se espera cuando

• Actualice a una nueva versión de Autodesk Software
• Actualización a una nueva versión del software coolOrange

Esta política define:

• Qué personalizaciones están cubiertas
• Cuándo se garantiza la compatibilidad
• Cuándo puede ser necesaria una adaptación
• Qué soporte está disponible en cada caso

Nuestro objetivo es eliminar los riesgos y la complejidad asociados habitualmente a las actualizaciones.

Cómo coolOrange resuelve el problema de la API

La API del software de Autodesk (como Vault / Inventor) es potente pero también sensible a la versión. Incluso pequeños cambios en la API entre versiones pueden romper las personalizaciones existentes, lo que lleva a tiempos de inactividad inesperados, costes y frustración.

En coolOrange, resolvemos este problema abstrayendo la API de Autodesk en un conjunto estable de nuestra propia API coolOrange.

Nuestras propias API coolOrange

• Envuelven las llamadas a la API de Autodesk más utilizadas
• Simplifican las operaciones complejas sin perder capacidades
• Permiten que las personalizaciones se centren en la lógica empresarial en lugar de en detalles técnicos innecesarios de la API

Con este enfoque

• Se requiere menos código y es más fácil de mantener
• Los problemas de compatibilidad causados por los cambios en la API de Vault, para las llamadas a la API de Autodesk más utilizadas, son gestionados internamente por coolOrange
• Reducimos la complejidad y los costes de las actualizaciones

Cuando se requieren API nativas

Aunque nuestra API coolOrange cubre la mayoría de los casos de uso, algunos escenarios aún requieren acceso directo a:

• APIs específicas de Vault o Inventor aún no envueltas
• Sistemas externos como SharePoint o sistemas ERP

En estos casos, se utilizan llamadas a API nativas junto con las nuestras.

Esto aumenta la complejidad y los riesgos de las actualizaciones, ya que estas partes pueden ser modificadas por Autodesk u otros proveedores.

La buena noticia:

• Si la API no cambia, nuestras personalizaciones están desarrolladas para que sigan funcionando sin esfuerzos adicionales.
• Si la API ha cambiado, sólo hay que adaptar esas llamadas específicas, y el resto de la personalización permanece intacto.

Para ayudar a los clientes a evaluar el riesgo, nosotros

• Entregamos un análisis de compatibilidad para cada proyecto
• Ofrecemos un análisis de compatibilidad gratuito previa solicitud

Cuanto más dependa su personalización de nuestra API coolOrange, más compatible será y menos mantenimiento requerirá.

Cuando los flujos de trabajo o las nuevas funciones requieren cambios

Algunas actualizaciones de Autodesk Software introducen nuevas funciones o cambios en el flujo de trabajo.

En la mayoría de los casos, las personalizaciones existentes no se ven afectadas. Sin embargo, hay dos excepciones:

1. Cambios obligatorios
   Una nueva característica puede requerir un cambio en la forma en que funciona un flujo de trabajo, por lo que es necesario adaptar la personalización relacionada.
2. Mejoras opcionales
   Una nueva función puede ofrecer una forma mejor de implementar un flujo de trabajo existente. Aunque no sea obligatorio, adaptar la personalización podría mejorar el rendimiento o la facilidad de mantenimiento.

Estas situaciones son

• Menos frecuentes que los cambios de API
• No predecibles de antemano
• No están cubiertas por la garantía de compatibilidad

Ámbito de aplicación de la compatibilidad

✅ Totalmente cubierto: Personalizaciones que utilizan únicamente la API de coolOrange

• Compatibilidad garantizada a través de actualizaciones y mejoras de Autodesk
• Corrección gratuita en caso de rotura debido a cambios en los cmdlets (poco frecuentes y normalmente sintácticos)
• Soporte simplificado y mantenimiento a largo plazo

⚠️ Parcialmente cubierto: Personalizaciones que mezclan APIs coolOrange y APIs nativas

• La lógica de la API coolOrange se mantiene y es compatible con el futuro
• Las partes de la API nativa están expuestas a riesgos de versión, las correcciones se cobrarán

❌ No cubierto: Funciones especiales personalizadas (implementaciones .NET) que utilicen únicamente API nativas

• Complementos completos para Vault, Inventor, Office o ERP escritos utilizando .NET y API nativas
• Alto riesgo de no ser compatible con las nuevas versiones de Autodesk
• Las correcciones se cobrarán

Se entregará al cliente un análisis de compatibilidad para cada proyecto.

Recomendación de calendario de actualización

Para aislar los riesgos y simplificar las pruebas, recomendamos a los clientes

• Realizar las personalizaciones al menos 6 semanas antes o después de una actualización de Vault.

Realizar actualizaciones y cambios simultáneamente crea ambigüedad. Si algo se rompe, no está claro si la causa es la actualización o la personalización. Separarlos reduce el riesgo y el esfuerzo.

Evaluación de riesgos gratuita

Si no está seguro de si sus scripts dependen de API nativas o entran dentro de nuestra garantía de compatibilidad, le ofrecemos un análisis de compatibilidad gratuito.

Esto le permite comprender su riesgo de actualización y planificar en consecuencia, antes de tomar ninguna medida.

Opciones de actualización

Ofrecemos tres vías de actualización en función de sus capacidades internas:

Como pintar una habitación - Puede hacerlo usted mismo, hacerlo con un tutor o contratar a un profesional. En los tres casos, la habitación es suya y debe aprobar el resultado.

Pruebas y aceptación final

Realizamos pruebas exhaustivas en nuestros propios laboratorios. En entornos de clientes, realizamos pruebas técnicas de humo, confirmando que

• Las personalizaciones se cargan correctamente
• Las funciones se ejecutan sin errores

No verificamos

• Si los flujos de trabajo producen los resultados correctos
• Si los resultados se ajustan a la lógica de su proceso interno

La aceptación final corresponde siempre al cliente, en función de sus propios datos y expectativas de calidad.