Autodesk-Forge / forge-bim360.asset.exchange.excel

Descriere

Acest esantion demonstreaza urmatoarele cazuri de utilizare:

• Exportati active, definitii de categorii, definitii ale atributelor personalizate si definitii de stare in fisier Excel. Valorile atributelor personalizate vor fi, de asemenea, extrase. In plus, resursele legate (emisiune, lista de verificare, atasament) ale activului sunt extrase de API-ul de relatii . Acestea vor fi listate ca colectie. In vizualizarea web, fiecare resursa este inclusa cu hyperlink pentru ca utilizatorul final sa poata naviga direct.
• Creati active noi sau modificati active vechi din lista Excel
• Stergeti activele din lista Excel

Aplicatia web ofera doua optiuni pentru a afisa proprietatile ID fie in date brute, cat si sub forma lizibila pentru om .

Acest esantion este implementat pe baza versiunii Node.js a Learn Forge Tutorial, va rugam sa consultati https://learnforge.autodesk.io/ pentru detalii despre cadru.

Miniatura

Demonstratie

Demo live

https://bim360-asset-exchange-excel.herokuapp.com/

Urmariti acest videoclip despre cum sa redati demonstratia.

Conditii prealabile

1. Cont Forge : Aflati cum sa creati un cont Forge, activati abonamentul si creati o aplicatie la acest tutorial.
2. Cont BIM 360 : trebuie sa fie Administrator cont pentru a adauga integrarea aplicatiei. Aflati despre aprovizionare.
3. BIM 360 Asset Management : Creati proiectul BIM 360, activati modulul Asset Management, configurati proiectul pentru a crea definitii de categorii , definitii ale setului de stare si definitii ale atributelor personalizate conform ghidului
4. Node.js : cunostinte de baza cu Node.js .
5. Cunostinte de baza JavaScript cu jQuery

Pentru a utiliza acest esantion, aveti nevoie de acreditari de dezvoltator Autodesk. Accesati Forge Developer Portal, creati un cont, apoi creati o aplicatie. Pentru aceasta noua aplicatie, utilizati http: // localhost: 3000 / api / forge / callback / oauth ca adresa URL de apel invers. In cele din urma, luati nota de ID-ul clientului si secretul clientului .

Alergand local

Instalati NodeJS, versiunea 8 sau mai recenta.

Clonati acest proiect sau descarcati-l (numai aceasta ramura nodejs). Se recomanda instalarea desktopului GitHub. Pentru a-l clona prin linia de comanda, utilizati urmatoarele ( Terminal pe MacOSX / Linux, Git Shell pe Windows):

Instalati pachetele necesare folosind npm install.

Variabile de mediu

Setati variabilele de mediu cu ID-ul si secretul clientului si porniti-l in cele din urma. Prin linia de comanda, navigati la folderul in care a fost clonat acest depozit si utilizati urmatoarele:

Mac OSX / Linux (Terminal)

Windows (utilizati linia de comanda Node.js din meniul Start)

SAU, setati variabile de mediu pentru launch.json pentru depanare.

Definiti acelasi punct final socket pentru gazda dvs. la aceasta linie, de exemplu

Cazuri de utilizare

1. Deschideti browserul: http: // localhost: 3000.

Urmariti videoclipul pentru configurarea si utilizarea detaliilor sau urmati pasii.

1. Dupa inregistrarea utilizatorului, selectati un proiect. Codul va incepe sa extraga prima pagina a inregistrarilor de active (aproximativ 50 de inregistrari) si sa le afiseze in vizualizarea web. Comutati datele brute si citite de oameni pentru a verifica datele ID-urilor .
2. Faceti clic pe optiunea Export si excutati pentru a exporta toate activele, categoriile, starea, definitiile atributelor personalizate pentru a excel.
3. Faceti clic pe optiunea Import si executati. Selectati unul excel care contine date despre active. Va rugam sa va asigurati ca aceste coloane sunt disponibile:
   • clientAssetId
   • ID categorie
   • ID de stare

Recomandarea este reutilizarea scheletului la pasul 1. Pentru a crea noi active parasesc coloana id goleasca. Dupa import, noile active vor fi create, vechile active vor fi actualizate cu noi valori. Va aparea o notificare in coltul din dreapta sus al partii clientului. Acesta indica modul in care activele pot fi importate cu succes. Accesati BIM 360 UI pentru a va perfectiona.

1. Faceti clic pe optiunea Stergeti si executati. Selectati un excel care contine date despre active (cel putin coduri). Recomandarea este reutilizarea scheletului la pasul 1. Dupa stergere, accesati BIM 360 UI pentru a va confirma. Va aparea o notificare in coltul din dreapta sus al partii clientului. Acesta indica modul in care materialele pot fi sterse cu succes.

Implementare

Pentru a implementa aceasta aplicatie pe Heroku, adresa URL de apel invers pentru Forge trebuie sa utilizeze adresa dvs. .herokuapp.com. Dupa ce faceti clic pe butonul de mai jos, pe pagina Heroku Creati o aplicatie noua, setati ID-ul clientului, secretul si adresa URL de apelare pentru Forge.

Prescriptie

1. In Excel, deoarece o celula nu accepta mai multe hyperlinkuri, resursele legate exportate (problema / lista de verificare / atasament) sunt doar siruri cu nume de resurse.

Sfaturi si trucuri

1. Pentru a importa sau sterge active, metoda sugerata este sa exportati mai intai un fisier Excel, sa actualizati proprietatile din fisier, apoi sa il importati inapoi in BIM 360 Asset.
2. Importul (crearea sau corectia) si stergerea utilizeaza puncte finale Batch-xxx din versiunea 2. Acesta este un mod foarte recomandat daca doriti sa importati / stergeti in serie. Va rugam sa NU utilizati un singur post / patch / stergere pentru un numar mare de active, deoarece va atinge limita de rata. Celalalt avantaj al utilizarii punctelor finale Batch-xxx este ca performanta este foarte buna.
3. Din versiunea 2, unele atribute standard ale activelor (cum ar fi data garantiei, furnizorul etc.) sunt acum mutate in atribute personalizate. Cu toate acestea, aceste definitii nu sunt create in mod implicit, asa ca va rugam sa va asigurati ca definitiile au fost create.
4. Din versiunea 2, tipurile de selectare sau selectare multipla de atribute personalizate vor returna valorile optiunilor ca ghid. De asemenea, necesita ghid in cazul actualizarii valorilor. Deci, codul mapeaza optiunea nume afisat si ID-uri.

Depanare

1. Nu pot vedea proiectele mele BIM 360 : asigurati-va ca furnizati ID-ul Forge App Client in contul BIM 360, aflati mai multe aici. Acest lucru necesita permisiunea administratorului contului.

Lecturi suplimentare

Document

Tutoriale :

• Vizualizati modelele BIM 360

Bloguri :

• Forge Blog
• Field of View, un blog axat pe BIM

Licenta

Acest esantion este licentiat in conditiile licentei MIT. Va rugam sa consultati fisierul LICENTA pentru detalii complete.

Scris de

Xiaodong Liang @coldwood, Forge Advocate and Support