Integracja z Autodesk — dokumentacja użytkownika
Ta dokumentacja opisuje, jak korzystać z integracji Autodesk w MyCompany: jak połączyć się z Autodesk Platform Services (APS), jak przesyłać i konwertować modele 3D oraz jak przeglądać te modele w Projektach, Zestawieniach materiałów i Zamówieniach produkcji.
Integracja jest zbudowana na bazie Autodesk Platform Services (dawniej Autodesk Forge) i wykorzystuje APS Viewer do wyświetlania modeli SVF2 w przeglądarce.
Spis treści
Sekcje:
- Konfiguracja — utworzenie aplikacji APS i wprowadzenie danych uwierzytelniających.
- Buckety i modele — przesyłanie plików źródłowych, konwersja do SVF2, widoki i elementy.
- Przeglądarka w formularzach — wyświetlanie modelu 3D w projekcie, zestawieniu materiałów lub zamówieniu produkcji.
Szybki start
Typowy scenariusz „podłącz APS → prześlij model → zobacz go w projekcie”:
- Utwórz aplikację Autodesk Platform Services i skopiuj jej Client ID oraz Client Secret. Zobacz: Konfiguracja.
- W MyCompany otwórz formularz integracji, znajdź panel Autodesk i wklej Key (Client ID) oraz Secret (Client Secret).
- Włącz Autodesk w swoim profilu użytkownika: otwórz Edytuj profil, zaznacz Autodesk i zapisz.
- Utwórz bucket (kontener na pliki źródłowe w APS) — zobacz: Buckety i modele.
- Załaduj plik Revit / IFC / DWG / NWD do bucketa i kliknij Put (przesłanie binarne do APS).
- Skonwertuj model do SVF2 i klikaj Get status, dopóki nie pojawi się success.
- Powiąż model z Projektem, Zestawieniem materiałów lub Zamówieniem produkcji poprzez zakładkę Autodesk w odpowiednim formularzu.
- Otwórz ten formularz — przeglądarka 3D wyrenderuje model bezpośrednio na stronie.
Nawigacja
Funkcjonalność Autodesk pojawia się w trzech miejscach:
- Dane podstawowe → Autodesk — samodzielna strona, na której znajdują się buckety, modele, widoki, elementy i właściwości.
- formularz integracji (administracja) — gdzie konfigurowane są Client ID / Client Secret oraz lista bucketów.
- Zakładka Autodesk w formularzach Projektu, Zestawienia materiałów i Zamówienia produkcji — gdzie użytkownicy końcowi faktycznie oglądają model.
Dokładne położenie w menu i widoczność zależą od uprawnień użytkownika oraz od tego, czy użytkownik ma włączoną opcję Autodesk w swoim profilu.
Role użytkowników i uprawnienia
- Administrator — konfiguruje aplikację APS, wprowadza dane uwierzytelniające, tworzy buckety, przesyła pliki źródłowe i uruchamia konwersję. Zobacz: Konfiguracja i Buckety i modele.
- Inżynier / uczestnik projektu — łączy istniejący model z projektem / zestawieniem materiałów / zamówieniem produkcji i przegląda go w osadzonej przeglądarce. Zobacz: Przeglądarka w formularzach.
- Użytkownik tylko do odczytu — widzi model w formularzu, ale nie zmienia powiązań ani nie uruchamia konwersji.
Jeśli zakładka Autodesk nie pojawia się w formularzu, sprawdź: (a) znacznik Autodesk w swoim profilu użytkownika, (b) czy z obiektem powiązano model, (c) czy konwersja zakończyła się powodzeniem (model musi mieć status success).
Terminy
Bucket
Bucket to kontener APS przechowujący pliki źródłowe. Klucze bucketów są unikalne w obrębie całego APS (a nie tylko Twojego tenanta), więc wymagają unikalnego prefiksu.
Model
Model to jeden plik źródłowy (Revit, IFC, DWG, NWD itp.) przesłany do bucketa. Każdy model ma własny status konwersji oraz pochodną SVF2.
Widok
Widok to jedna renderowalna prezentacja modelu — zwykle scena 3D lub arkusz 2D. Pojedynczy plik Revit może wygenerować wiele widoków.
Element
Element to jeden obiekt w widoku — ściana, kolumna, instalacja. Drzewo elementów odzwierciedla hierarchię Revit / IFC.
Towar
Towar może mieć powiązany jeden lub więcej modeli Autodesk — zobacz: Powiązanie z towarem. Jest to najszersze powiązanie: model powiązany z towarem automatycznie pojawia się w formularzu towaru, w każdym zestawieniu materiałów dla tego towaru oraz w każdym zamówieniu produkcji dla tego towaru.
Zestawienie materiałów (BoM)
Zestawienie materiałów w MyCompany może być powiązane z jednym lub wieloma modelami Autodesk — zobacz: Powiązanie z zestawieniem materiałów — dzięki czemu odpowiednia geometria 3D jest wyświetlana obok komponentów zestawienia. Modele powiązane z towarem zestawienia również pojawiają się w tym miejscu.
Zamówienie produkcji
Zamówienie produkcji wyświetla model Autodesk powiązany z jego zestawieniem materiałów lub z jego towarem, dzięki czemu użytkownik na hali produkcyjnej widzi geometrię odpowiadającą zamówieniu produkcji — zobacz: W zamówieniu produkcji.
Projekt
Projekt może mieć powiązanych jeden lub więcej modeli Autodesk, oglądanych w jego zakładce Autodesk — zobacz: W projekcie.