Importarea activităților dintr-un fișier CSV
Puteți importa multiple activități dintr-o sursă externă în Maintain încărcând un fișier text în format CSV care conține date referitoare la activități și puteți integra fișierul în activități. Activitățile pot fi vizualizate și modificate ca activități create în Maintain.
Descărcarea șablonului de fișier CSV
Fișierul CSV importat trebuie să se conformeze la șablonul specific proiectului. Pentru a descărca maintain-import-template.csv:
- Navigați la Activități și selectați Adăugați activitate.
- Selectați Importați activități.
- Selectați Descărcați șablonul.
Completarea șablonului de fișier CSV
Șablonul CSV va conține un singur rând cu tipurile de valori pe care le puteți introduce pentru o activitate importată. Acest rând poartă denumirea de rând de antet și trebuie păstrat la completarea șablonului.
În vreme ce eliminarea rândului de antet este interzisă, puteți elimina anumite valori din antet sau puteți modifica ordinea valorilor. De exemplu, dacă un anumit câmp nu este relevant pentru a fi importat într-un anumit scenariu, îl puteți elimina din antet și din rândurile următoare. Astfel, câmpul va rămâne necompletat pentru toate activitățile importate.
Pentru a importa o singură activitate, adăugați un nou rând în șablon și introduceți valorile corespunzătoare, separate prin virgule. Fiecare valoare din rândul nou trebuie să conțină valoarea pe care doriți să o completați în rândul de antet corespunzător, inclus în șablon.
De exemplu, dacă șablonul conține următorul rând de antet: title,status,department, creați un fișier CSV cu un rând suplimentar:
title,status,department
Erect scaffolding,Done,Rigging
Veți crea o activitate cu titlul „Montaj schele”, stadiul „Finalizat” și departamentul „Manevre” la importare.
Formatarea câmpurilor de date
Unele câmpuri de activitate din Maintain reprezintă date calendaristice și trebuie să aibă un anumit format pentru a fi importate corespunzător. Câmpurile de date pot fi identificate în șablonul CSV printr-o valoare specială a antetului, de forma startTime (DD/MM/YYYY). În acest exemplu, startTime este denumirea câmpului, în vreme ce DD/MM/YYYY este formatul de dată care trebuie folosit în rândurile următoare din fișierul CSV.
De exemplu, importarea următorului fișier va duce la crearea activității cu startTime stabilită la 10 decembrie 2023.
title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023
Formatarea câmpurilor booleene
Unele câmpuri de activități din Maintain sunt reprezentate de valori booleene, cum ar fi true sau false. Câmpurile de date pot fi identificate în șablonul CSV printr-o valoare specială a antetului, de forma isActive (true/false). Aceste câmpuri pot conține doar două valori, true sau false.
De exemplu, importarea următorului fișier va duce la crearea activității cu isActive având valoarea false.
title,isActive (true/false)
Erect scaffolding,false
Formatarea valorilor care conțin virgule
Deoarece formatul CSV separă valorile folosind virgule, trebuie să aveți grijă la situația în care un câmp de activitate trebuie să conțină o virgulă. Maintain procesează fișierele CSV conform standardului RFC 4180, care impune ca valorile care conțin virgule să fie cuprinse între ghilimele duble.
De exemplu, importarea următorului fișier va duce la crearea activității cu city având valoarea Boston, MA.
title,city
Erect scaffolding,"Boston, MA"
Valori nesetate
Puteți lăsa necompletate câmpurile care nu sunt obligatorii pentru a reflecta valori lipsă sau irelevante pentru activitatea respectivă.
De exemplu, importarea următorului fișier va determina crearea activității cu state având valoarea New York, dar fără să aibă nicio valoare în câmpul city.
title,city,state
Erect scaffolding,New York
Conectarea unei activități la un activ
Maintain acceptă asocierea activităților cu active CDF, aspect care se folosește pentru contextualizarea activității în modele 3D, documente, PSN și altele. Pentru ca Maintain să creeze asocierea corespunzătoare cu un activ în CDF, trebuie să furnizați ID-ul extern al activului CDF în șablonul de importare.
Dacă aveți contextualizări de active în proiectul dvs., va exista un câmp assetExternalId special în șablon pe care va trebui să-l completați cu ID-ul extern al activului activității.
De exemplu, când importați următorul fișier, presupunând că există un activ CDF cu ID-ul extern NY_BUILDING_23, activitatea va fi contextualizată la acest activ când este integrată în Maintain.
title,assetExternalId
Erect scaffolding,NY_BUILDING_23
Dacă ID-ul extern furnizat nu se exportă, utilizatorul va vedea o eroare în timpul importării.
Este posibil ca utilizatorii finali să nu cunoască ID-ul extern al activului cu care este asociată activitatea. Dacă e necesar să le oferiți utilizatorilor finali o listă cu activele posibile și ID-urile lor externe, vă recomandăm să obțineți aceste date folosind API-ul activului CDF sau alte extractoare de date.
Importarea unui fișier CSV completat
Odată ce ați completat șablonul CSV, îl puteți importa în Maintain:
- Navigați la Activități > Adăugați activitate.
- Selectați Importați activități.
- Selectați câmpul Dați clic pentru a selecta fișierul CSV de importat.
- Selectați și încărcați fișierul CSV completat din computer.
- Confirmați că ați importat fișierul verificând secțiunea Inspector fișier. Un mesaj verde ar trebui să afișeze numărul de rânduri care se vor importa, precum și dacă aveți avertismente sau erori.
- Dacă nu există erori, selectați Importați pentru a începe procesul de importare.
- Când importarea reușește, veți vedea un mesaj verde cu butonul Afișați activitățile.
- Opțional. Selectați Afișați activitățile pentru a naviga la activitățile importate și a vă asigura că arată corect conform fișierului CSV.