Politik der Vorwärtskompatibilität

Wir bei coolOrange sind der Meinung, dass Software die Entwicklungsteams unterstützen und nicht einschränken sollte. Unsere Politik der Vorwärtskompatibilität gibt unseren Kunden die Gewissheit, dass ihre Automatisierungen und Integrationen auch dann noch funktionieren, wenn Autodesk-Software (wie Vault / Inventor) weiterentwickelt wird - ohne Überraschungen oder versteckte Kosten.

Was bedeutet Kompatibilität?

In diesem Zusammenhang bedeutet Vorwärtskompatibilität, dass Ihre Anpassungen weiterhin wie erwartet funktionieren werden, wenn

• Beim Upgrade auf eine neue Autodesk-Software-Version
• Aktualisierung auf eine neue Version der coolOrange Software

Diese Richtlinie definiert:

• Welche Anpassungen abgedeckt sind
• Wann die Kompatibilität gewährleistet ist
• wo Anpassungen erforderlich sein können
• Welcher Support in jedem Fall verfügbar ist

Unser Ziel ist es, Upgrades zu einem reibungslosen und unkomplizierten Erlebnis zu machen, ohne die übliche Komplexität.

Wie coolOrange das API-Problem löst

Autodesk Software API (wie Vault / Inventor) ist leistungsstark, aber auch versionsabhängig. Selbst kleine API-Änderungen zwischen Versionen können bestehende Anpassungen zerstören, was zu unerwarteten Ausfallzeiten, Kosten und Frustration führt.

Bei coolOrange lösen wir dieses Problem, indem wir die Autodesk-API in ein stabiles Set unserer eigenen coolOrange-API abstrahieren.

Unsere eigenen coolOrange APIs:

• Umhüllen die am häufigsten verwendeten Autodesk-API-Aufrufe
• Vereinfachen komplexe Operationen ohne Verlust von Fähigkeiten
• Ermöglicht Anpassungen, die sich auf die Geschäftslogik konzentrieren, anstatt auf unnötige technische API-Details

Mit diesem Ansatz:

• Es ist weniger Code erforderlich, und er ist leichter zu pflegen
• Kompatibilitätsprobleme, die durch Vault-API-Änderungen für die am häufigsten verwendeten Autodesk-API-Aufrufe entstehen, werden von coolOrange intern behandelt.
• Wir reduzieren die Komplexität und die Kosten für Upgrades

Wenn native APIs erforderlich sind

Während unsere coolOrange API die meisten Anwendungsfälle abdeckt, erfordern einige Szenarien dennoch einen direkten Zugriff auf:

• Spezifische Vault- oder Inventor-APIs, die noch nicht abgedeckt sind
• Externe Systeme wie SharePoint oder ERP-Systeme

In solchen Fällen werden neben unserer API auch native API-Aufrufe verwendet.

Dies macht Upgrades komplexer, da Autodesk oder andere Anbieter diese Komponenten möglicherweise ändern, was sich auf die langfristige Stabilität auswirkt.

Die gute Nachricht:

• Wenn sich die API nicht ändert, sind unsere Anpassungen so entwickelt, dass sie ohne zusätzlichen Aufwand weiterlaufen.
• Wenn sich die API geändert hat, müssen nur die spezifischen Aufrufe angepasst werden, und der Rest der Anpassung bleibt intakt.

Um unseren Kunden vor jeder Änderung vollständige Klarheit zu verschaffen, gehen wir wie folgt vor:

• liefern wir für jedes Projekt eine Kompatibilitätsanalyse
• Bieten auf Anfrage eine kostenlose Kompatibilitätsanalyse an

Je mehr Ihre Anpassung auf unserer coolOrange API aufbaut, desto zukunftssicherer und wartungsärmer wird sie.

Wenn Workflows oder neue Funktionen Änderungen erfordern

Einige Autodesk Software-Upgrades führen neue Funktionen oder Änderungen im Workflow ein.

In den meisten Fällen bleiben bestehende Anpassungen davon unberührt. Es gibt jedoch zwei Ausnahmen:

1. Obligatorische Änderungen
   Eine neue Funktion kann eine Änderung in der Funktionsweise eines Workflows erfordern, so dass eine Anpassung der zugehörigen Anpassung notwendig ist.
2. Optionale Verbesserungen
   Eine neue Funktion kann eine bessere Möglichkeit zur Implementierung eines bestehenden Workflows bieten. Die Anpassung der Anpassung ist zwar nicht erforderlich, kann aber die Leistung oder die Wartbarkeit verbessern.

Diese Situationen sind:

• Weniger häufig als API-Änderungen
• Nicht im Voraus vorhersehbar
• Nicht durch die Kompatibilitätsgarantie abgedeckt

Umfang der Kompatibilität

✅ Vollständig abgedeckt: Anpassungen, die nur coolOrange API verwenden

• Garantierte Kompatibilität über Autodesk-Upgrades und -Updates hinweg
• Kostenlose Korrektur im Falle von Fehlern aufgrund von Cmdlet-Änderungen (selten und meist syntaktisch bedingt)
• Vereinfachter Support und langfristige Wartbarkeit

⚠️ Teilweise abgedeckt: Anpassungen, die coolOrange APIs und native APIs mischen

• coolOrange-API-Logik wird gepflegt und ist vorwärtskompatibel
• Native API-Teile können von Versionsaktualisierungen betroffen sein, und damit verbundene Anpassungen sind kostenpflichtig.

❌ Nicht abgedeckt: Kundenspezifische Spezialfunktionen (.NET-Implementierungen), die nur native APIs verwenden

• Vollständige Add-Ins für Vault, Inventor, Office oder ERP, die mit .NET und nativen APIs geschrieben wurden
• Die Kompatibilität mit zukünftigen Autodesk-Versionen kann nicht garantiert werden.
• Korrekturen werden in Rechnung gestellt

Eine Kompatibilitätsanalyse wird dem Kunden für jedes Projekt zur Verfügung gestellt.

Upgrade-Timing-Empfehlung

Um die Kontrolle zu behalten und das Testen zu vereinfachen, empfehlen wir unseren Kunden Folgendes:

• Anpassungen mindestens 6 Wochen vor oder nach einem Vault-Upgrade durchzuführen

Die gleichzeitige Durchführung von Upgrades und benutzerdefinierten Änderungen kann zu Unsicherheiten führen. Wenn ein Problem auftritt, ist es schwieriger, die Ursache zu finden. Die Trennung beider Vorgänge gewährleistet Transparenz und minimiert den Aufwand für die Fehlerbehebung.

Kompatibilitätsbewertung

Wenn Sie sich nicht sicher sind, ob Ihre Skripte auf nativen APIs beruhen oder unter unsere Kompatibilitätsgarantie fallen, bieten wir eine kostenlose Kompatibilitätsanalyse an.

Auf diese Weise können Sie vorab einschätzen, wie sich ein Upgrade auf Ihre Konfiguration auswirken könnte, und sich in aller Ruhe darauf vorbereiten, bevor Sie fortfahren.

Optionen für die Upgrade-Ausführung

Wir bieten drei Upgrade-Pfade an, je nach Ihren internen Möglichkeiten:

Wie beim Streichen eines Zimmers - Sie können es selbst machen, es mit einem Coach machen oder einen Profi beauftragen. In allen drei Fällen gehört der Raum Ihnen und Sie müssen das Ergebnis abnehmen.

Prüfung und Endabnahme

Wir führen umfassende Tests in unseren eigenen Laborumgebungen durch. In Kundenumgebungen führen wir technische Rauchtests durch, die bestätigen, dass:

• Anpassungen werden korrekt geladen
• Funktionen ohne Fehler ausgeführt werden

Wir verifizieren nicht:

• ob Workflows die richtigen Ergebnisse liefern
• ob die Ergebnisse mit Ihrer internen Prozesslogik übereinstimmen

Die Endabnahme liegt immer beim Kunden, basierend auf seinen eigenen Daten und Qualitätserwartungen.