Activiteiten importeren uit CSV-bestand
U kunt meerdere activiteiten van een externe bron importeren in Maintain door een tekstbestand in CSV-formaat met activiteitsgegevens te uploaden en het bestand in activiteiten op te nemen. De activiteiten kunnen worden gevisualiseerd en gewijzigd als activiteiten die zijn aangemaakt in Maintain.
Download de CSV-bestandssjabloon
Het geïmporteerde CSV-bestand moet overeenkomen met uw projectspecifieke sjabloon. U downloadt maintain-import-template.csv als volgt:
- Ga naar Activiteiten en selecteer Activiteit toevoegen.
- Selecteer Activiteiten importeren.
- Selecteer Sjabloon downloaden.
Vul de CSV-bestandssjabloon in
De CSV-sjabloon bevat slechts één rij waarden die de mogelijke waarden vertegenwoordigen die u voor een geïmporteerde activiteit kunt opgeven. Deze rij wordt de kopregel genoemd en mag niet worden verwijderd bij het invullen van de sjabloon.
Hoewel de kopregel niet mag worden verwijderd, kunt u specifieke waarden uit de kop verwijderen of de volgorde van de waarden wijzigen. Als een bepaald veld bijvoorbeeld niet relevant is om te importeren in een specifiek scenario, kunt u het verwijderen uit de kopregel en de daaropvolgende rijen. Hierdoor blijft het veld leeg voor alle geïmporteerde activiteiten.
Om een enkele activiteit te importeren, voegt u een nieuwe rij toe aan de sjabloon en voert u de juiste waarden in, gescheiden door komma's. Elke waarde in de nieuwe rij moet de waarde bevatten die u wilt invullen op de respectieve kopregel die in de sjabloon werd verstrekt.
Als uw sjabloon bijvoorbeeld de volgende kopregel bevat: title,status,department, maak dan een CSV-bestand met een extra rij:
title,status,department
Erect scaffolding,Done,Rigging
Bij het importeren maakt u een activiteit met de titel 'Steiger opzetten', de status 'Klaar' en de afdeling 'Riggen'.
Datumvelden formatteren
Sommige activiteitsvelden in ~~Maintain ~~vertegenwoordigen datums en moeten een specifiek formaat hebben om goed te kunnen worden geïmporteerd. Datumvelden kunnen in de CSV-sjabloon worden geïdentificeerd door een speciale headerwaarde in de vorm startTime (DD/MM/YYYY). In dit voorbeeld is startTime de naam van het veld, terwijl DD/MM/YYYY de datumnotatie is die moet worden gebruikt in de volgende rijen van het CSV-bestand.
Het importeren van het volgende bestand zal er bijvoorbeeld toe leiden dat de activiteit wordt gemaakt met startTime ingesteld op 10 december 2023.
title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023
Booleaanse velden formatteren
Sommige activiteitsvelden in ~~Maintain ~~vertegenwoordigen booleaanse waarden, zoals true of false. Datumvelden kunnen in de CSV-sjabloon worden geïdentificeerd door een speciale headerwaarde in de vorm isActive (true/false). Deze velden hebben slechts twee geldige waarden, true of false.
Als u bijvoorbeeld het volgende bestand importeert, wordt de activiteit gemaakt met isActve ingesteld op false.
title,isActive (true/false)
Erect scaffolding,false
Formaatwaarden met komma's
Vanwege het CSV-formaat dat waarden met komma's scheidt, moet u voorzichtig zijn wanneer een activiteitsveld ook een komma moet bevatten. In ~~Maintain ~~ worden CSV-bestanden verwerkt volgens de RFC 4180-standaard, die vereist dat waarden met komma's tussen dubbele aanhalingstekens worden gezet.
Als u bijvoorbeeld het volgende bestand importeert, wordt de activiteit gemaakt met de city ingesteld op Boston, MA.
title,city
Erect scaffolding,"Boston, MA"
Niet-ingestelde waarden
U kunt het veld leeg laten bij niet-verplichte activiteitsvelden om ontbrekende of irrelevante waarden voor de specifieke activiteit weer te geven.
Als u bijvoorbeeld het volgende bestand importeert, wordt de activiteit gemaakt met de state ingesteld op New York, maar heeft het geen waarde in het veld city.
title,city,state
Erect scaffolding,New York
Een activiteit koppelen aan een asset
In ~~Maintain~~ wordt het koppelen van activiteiten aan CDF-assets ondersteund, wat wordt gebruikt om de activiteit te contextualiseren in 3D-modellen, documenten, PSN en meer. Om in Maintain de juiste koppeling naar een asset in CDF te maken, moet u de externe ID van het CDF-asset in de importsjabloon opgeven.
Als u assetcontextualisatie in uw project hebt, is er een speciaal assetExternalId-veld in de sjabloon dat u moet invullen met de externe ID van de asset van de activiteit.
Als u bijvoorbeeld het volgende bestand importeert en ervan uitgaat dat er een CDF-asset bestaat met de externe ID NY_BUILDING_23, wordt de activiteit gecontextualiseerd naar dit asset wanneer deze wordt opgenomen in Maintain.
title,assetExternalId
Erect scaffolding,NY_BUILDING_23
Als de opgegeven externe ID niet wordt geëxporteerd, ziet de gebruiker een fout tijdens het importeren.
Eindgebruikers kennen mogelijk niet de externe ID van de asset waaraan de activiteit is gekoppeld. Als het nodig is om eindgebruikers een lijst te geven van de mogelijke assets en hun externe ID's, raden we aan om deze gegevens op te halen met behulp van de asset API van CDF of andere gegevensextractors.
Een ingevuld CSV-bestand importeren
Zodra u een ingevulde CSV-sjabloon hebt, kunt u deze importeren in Maintain:
- Ga naar Activiteiten > Activiteit toevoegen.
- Selecteer Activiteiten importeren.
- Selecteer het veld Klik hierop om CSV-bestand te selecteren om te importeren.
- Selecteer en upload het ingevulde CSV-bestand van uw computer.
- Ga na of u het bestand hebt geïmporteerd door het gedeelte File Inspector te controleren. Een groen bericht moet het aantal te importeren rijen weergeven en of er waarschuwingen of fouten zijn.
- Als er geen fouten zijn, selecteert u Importeren om het importproces te starten.
- Als het importeren is geslaagd, ziet u een groene melding met de knop Activiteiten weergeven.
- Optioneel. Selecteer Activiteiten weergeven om naar de geïmporteerde activiteiten te navigeren en te controleren of ze er correct uitzien volgens het CSV-bestand.