Importera aktiviteter från CSV-fil
Du kan importera flera aktiviteter från en extern källa till Maintain genom att ladda upp en textfil i CSV-format som innehåller aktivitetsdata och inta filen i aktiviteter. Aktiviteterna kan visas och ändras som aktiviteter som skapats i Maintain.
Ladda ner CSV-filmallen
Den importerade CSV-filen måste överensstämma med din projektspecifika mall. Ladda ned maintain-import-template.csv:
- Gå till Aktiviteter och välj Lägg till aktivitet.
- Välj Importera aktiviteter.
- Välj Ladda ned mall.
Fyll i CSV-filmallen
CSV-mallen kommer endast att innehålla en enda rad med värden som representerar de möjliga värden du kan ange för en importerad aktivitet. Denna rad kallas rubrikraden och bör inte tas bort när mallen fylls i.
Även om rubrikraden inte får tas bort kan du ta bort specifika värden från rubriken eller ändra värdenas ordningsföljd. Om ett visst fält till exempel inte är relevant att importera i ett visst scenario kan du ta bort det från rubriken och efterföljande rader. Detta resulterar i att fältet lämnas tomt på alla importerade aktiviteter.
Om du vill importera en enskild aktivitet lägger du till en ny rad i mallen och anger lämpliga värden separerade med kommatecken. Varje värde i den nya raden ska innehålla det värde du vill fylla i på respektive rubrikrad som angavs i mallen.
Om din mall till exempel innehåller följande rubrikrad: title, status, department, skapa en CSV-fil med en extra rad:
title,status,department
Erect scaffolding,Done,Rigging
Du kommer att skapa en aktivitet med titeln ”Skapa ställning”, status ”Klar” och avdelning ”Riggning” vid import.
Datumformatfält
Vissa aktivitetsfält i Maintain representerar datum och måste ha ett specifikt format för att kunna importeras korrekt. Datumfält kan identifieras i CSV-mallen med ett speciellt rubrikvärde i formatet startTime (DD/MM/YYYY). I det här exemplet är startTime fältets namn, medan DD/MM/YYYY är det datumformat som ska användas i efterföljande rader i CSV-filen.
Om du till exempel importerar följande fil kommer aktiviteten att skapas med startTime inställd på 10 december 2023.
title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023
Formatera booleska fält
Vissa aktivitetsfält i ~~ Maintain~~ representerar booleska värden, som true eller false. Datumfält kan identifieras i CSV-mallen med ett speciellt rubrikvärde i formen isActive (true/false). Dessa fält har endast två giltiga värden, true eller false.
Om du till exempel importerar följande fil kommer aktiviteten att skapas med isActive inställd på false.
title,isActive (true/false)
Erect scaffolding,false
Formatvärden som innehåller kommatecken
På grund av att CSV-formatet separerar värden med kommatecken ska du vara försiktig när ett aktivitetsfält också måste innehålla ett kommatecken. Maintain processer CSV-filer enligt RFC 4180-standarden, som kräver att värden som innehåller kommatecken ska vara inslagna i dubbla citat.
Om du till exempel importerar följande fil skapas aktiviteten med city inställd på Boston, MA.
title,city
Erect scaffolding,"Boston, MA"
Ej inställda värden
Du kan lämna fältet tomt på ej obligatoriska aktivitetsfält för att representera saknade eller irrelevanta värden för den specifika aktiviteten.
Om du till exempel importerar följande fil kommer aktiviteten att skapas med state New York, men den kommer inte att ha något värde i fältet city.
title,city,state
Erect scaffolding,New York
Koppla en aktivitet till en tillgång
Maintain stöder länkning av aktiviteter till CDF-tillgångar, vilket används för att kontextualisera aktiviteten i 3D-modeller, dokument, PSN med mera. För Maintain för att skapa lämplig länk till en tillgång i CDF måste du ange CDF-tillgångens externa ID i importmallen.
Om du har tillgångskontextualisering i ditt projekt kommer det att finnas ett särskilt fält assetExternalId i mallen som du måste fylla i med det externa ID:t för aktivitetens tillgång.
Om du till exempel importerar nedanstående fil och antar att det finns en CDF-tillgång med externt ID NY_BUILDING_23 kommer aktiviteten att kontextualiseras till denna tillgång när den tas in i Maintain.
title, assetExternalId
Erect scaffolding,NY_BUILDING_23
Om det angivna externa ID:t inte exporteras får användaren ett felmeddelande under importen.
Slutanvändare kanske inte känner till det externa ID för den tillgång som aktiviteten är kopplad till. Om det är nödvändigt att förse slutanvändare med en lista över möjliga tillgångar och deras externa ID:n rekommenderar vi att dessa data hämtas med hjälp av CDF:s tillgångs-API eller andra dataextraktor.
Importera en ifylld CSV-fil
När du har en ifylld CSV-mall kan du importera den till Maintain:
- Gå till Aktiviteter > Lägg till aktivitet.
- Välj Importera aktiviteter.
- Välj fältet Klicka för att välja CSV-fil att importera.
- Välj och ladda upp den ifyllda CSV-filen från din dator.
- Kontrollera att du har importerat filen genom att markera avsnittet Filinspektör. Ett grönt meddelande ska visa antalet rader som ska importeras och om du har några varningar eller fel.
- Om det inte finns några fel väljer du Importera för att starta importprocessen.
- När importen har slutförts visas ett grönt meddelande med knappen Visa aktiviteter.
- Valfritt. Välj Visa aktiviteter för att navigera till de importerade aktiviteterna och kontrollera att de ser korrekta ut enligt CSV-filen.