Importeer activiteiten in Maintain

Maintain ondersteunt drie methoden voor het importeren van activiteiten:

CSV-upload: Importeer activiteiten met de gebruikersinterface (alleen APM-modus).
Cognite Toolkit: Verwerk activiteiten met behulp van Cognite Toolkit datamodellering (APM- en IDM/CDM-modi).
Transformaties: Converteer gegevens uit RAW-tabellen of andere bronnen met behulp van CDF Transformaties (APM- en IDM/CDM-modi).

Importeer via CSV-upload (APM-modus)

Beschikbaarheid van modus: Alleen APM-modus. IDM/CDM-modus ondersteunt geen CSV-import in de gebruikersinterface.

Activiteiten die via CSV zijn geïmporteerd, kunnen worden gevisualiseerd en gewijzigd als activiteiten die zijn gemaakt in Maintain.

Download het CSV-bestand sjabloon

Het geïmporteerde CSV-bestand moet voldoen aan uw projectspecifieke sjabloon. Om maintain-import-template.csv te downloaden:

Navigeer naar Activiteiten en selecteer Activiteit toevoegen.
Selecteer Activiteiten importeren.
Selecteer Sjabloon downloaden.

Vul het CSV-bestand sjabloon in

De CSV-sjabloon bevat alleen een enkele rij waarden die de mogelijke waarden vertegenwoordigen die u kunt opgeven voor een geïmporteerde activiteit. Deze rij wordt de koprij genoemd en mag niet worden verwijderd bij het invullen van de sjabloon.

Hoewel de rij met kopteksten niet mag worden verwijderd, kunt u specifieke waarden uit de koptekst verwijderen of de volgorde van de waarden wijzigen. Bijvoorbeeld, als een bepaald veld niet relevant is om te importeren in een specifieke situatie, kunt u het uit de kop en de daaropvolgende rijen verwijderen. Dit resulteert erin dat het veld leeg blijft bij 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 koprij die in de sjabloon is gegeven. Als uw sjabloon bijvoorbeeld de volgende koptekstrij bevat: title,status,department, maakt u een CSV-bestand met een extra rij:

title,status,department
Erect scaffolding,Done,Rigging

U zult een activiteit creëren met de titel “Steigers opzetten”, status “Voltooid” en afdeling “Rigging” wanneer deze wordt geïmporteerd.

Formateer datumvelden

Sommige activiteitsvelden in Maintain vertegenwoordigen datums en moeten een specifieke indeling hebben om correct te kunnen worden geïmporteerd. Datumvelden kunnen in het CSV-sjabloon worden herkend aan een speciale koptekstwaarde 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 in de daaropvolgende rijen van het CSV-bestand moet worden gebruikt. 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

Formateer boolean-velden

Sommige activiteitsvelden in Maintain vertegenwoordigen booleaanse waarden, zoals true of false. Booleaanse velden kunnen in het CSV-sjabloon worden herkend aan een speciale koptekstwaarde in de vorm isActive (true/false). Deze velden hebben slechts twee geldige waarden, true of false. Bijvoorbeeld, het importeren van het volgende bestand zal ertoe leiden dat de activiteit wordt aangemaakt met isActive ingesteld op false.

title,isActive (true/false)
Erect scaffolding,false

Formatteer waarden die komma’s bevatten

Vanwege het CSV-formaat dat waarden scheidt met komma’s, moet u voorzichtig zijn wanneer een activiteitsveld ook een komma moet bevatten. Maintain verwerkt CSV-bestanden volgens de RFC 4180-standaard, die vereist dat waarden die komma’s bevatten, tussen dubbele aanhalingstekens worden geplaatst. Bijvoorbeeld, het importeren van het volgende bestand zal ertoe leiden dat de activiteit wordt aangemaakt met city ingesteld op Boston, MA.

title,city
Erect scaffolding,"Boston, MA"

Unset waarden

U kunt het veld leeg laten op niet-verplichte activiteit velden om ontbrekende of irrelevante waarden voor de specifieke activiteit weer te geven. Bijvoorbeeld, het importeren van het volgende bestand zal ertoe leiden dat de activiteit wordt aangemaakt met state ingesteld op New York, maar het zal geen waarde hebben in het city veld.

title,city,state
Erect scaffolding,New York

Verbind een activiteit met een activum

Maintain ondersteunt het koppelen van activiteiten aan CDF assets, wat wordt gebruikt om de activiteit te contextualiseren in 3D-modellen, documenten, PSN en meer. Voor Maintain om de juiste koppeling naar een asset in CDF te maken, moet u de externe ID van de CDF asset opgeven in het importsjabloon. Als u asset-contextualisering in uw project hebt, zal er een speciaal assetExternalId veld in het sjabloon staan dat u moet invullen met de externe ID van de asset van de activiteit. Bijvoorbeeld, wanneer u het volgende bestand importeert en ervan uitgaat dat er een CDF asset bestaat met externe ID NY_BUILDING_23, zal de activiteit worden gecontextualiseerd naar deze asset wanneer deze wordt opgenomen in Maintain.

title,assetExternalId
Erect scaffolding,NY_BUILDING_23

Als de opgegeven externe ID niet exporteert, zal de gebruiker een fout zien tijdens de import.

Eindgebruikers weten mogelijk niet de externe ID van het activum waaraan de activiteit is gekoppeld. Als het nodig is om eindgebruikers een lijst met de mogelijke assets en hun externe ID’s te verstrekken, raden we aan deze gegevens op te halen met behulp van de asset API van CDF of andere gegevensextractoren.

Importeer een ingevuld CSV-bestand

Zodra u een ingevuld CSV-sjabloon hebt, kunt u dit importeren in Maintain:

Navigeer naar Activiteiten > Activiteit toevoegen.
Selecteer Activiteiten importeren.
Selecteer het veld Klik om CSV-bestand te selecteren voor import.
Selecteer en upload het ingevulde CSV-bestand van uw computer.
Controleer of u het bestand hebt geïmporteerd door het gedeelte Bestandsinspecteur te bekijken. Een groene boodschap zou het aantal rijen dat geïmporteerd moet worden tonen en of u waarschuwingen of fouten heeft.
Als er geen fouten zijn, selecteert u Importeren om het importproces te starten.
Wanneer de import slaagt, ziet u een groen succesbericht 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.

Importeren via Cognite Toolkit

Beschikbaarheid van modus: APM- en IDM/CDM-modi. Dit is de aanbevolen aanpak voor programmatic activiteitinvoer.

Gebruik de Cognite Toolkit om activiteiten op te nemen via de datamodelleringsmogelijkheden van CDF. Deze methode werkt voor beide implementatiemodi en biedt versiebeheer en reproduceerbare implementaties.

Vereisten

Voordat u activiteiten importeert via de Cognite Toolkit, moet u ervoor zorgen dat u beschikt over:

Een aangepaste activiteitsweergave geconfigureerd in uw datamodelruimte (of gebruik de standaard CogniteMaintenanceOrder weergave van cdf_idm)
De activiteitsweergave toegewezen in uw Maintain configuratie onder viewMappings
Toegang tot de Cognite Toolkit

Configureer de mapping van de activiteitweergave

Controleer in uw Maintain configuratie of de viewMappings sectie naar uw activiteitsweergave wijst:

"viewMappings": {
  "activity": {
    "type": "view",
    "space": "cdf_idm",
    "version": "v1",
    "externalId": "CogniteMaintenanceOrder"
  }
}

Als u een aangepaste activiteitsweergave hebt gemaakt (bijvoorbeeld APM_Activity of ExtendedActivity), werk dan de toewijzing bij om naar uw aangepaste weergave te wijzen:

"viewMappings": {
  "activity": {
    "type": "view",
    "space": "maintain_schema_extention",
    "version": "v1",
    "externalId": "APM_Activity"
  }
}

Lees meer over het uitbreiden van datamodellen en het configureren van weergavetoewijzingen.

Activiteiten opnemen met de Cognite Toolkit

Gebruik de Cognite Toolkit als de aanbevolen aanpak voor het opnemen van activiteiten in IDM-modus.

Creëer de activiteit gegevensstructuur

Als u dit nog niet heeft gedaan, maak dan Container-, Weergave- en Node-YAML-bestanden voor uw activiteiten. Volg de standaard datamodelstructuur:

APM_Activity.Container.yaml - Definieert het containerschema
APM_Activity.View.yaml - Definieert de weergave-eigenschappen en relaties
apmActivities.Node.yaml - Bevat uw activiteitsinstanties Zie de Cognite Toolkit documentatie voor gedetailleerde voorbeelden en sjablonen.

Configureer de veldkoppelingen

Zorg ervoor dat uw activiteitsknooppunten de vereiste velden bevatten voor Maintain:

Veld	Beschrijving	Vereist
`externalId`	Unieke identificatie voor de activiteit	Ja
`title`	Activiteitstitel	Ja
`status`	Activiteitsstatus (bijvoorbeeld “Open”, “In uitvoering”, “Gereed”)	Aanbevolen
`startTime`	Startdatum/-tijd	Aanbevolen
`endTime`	Einddatum/-tijd	Aanbevolen
`rootLocation`	Identificatie van de hoofdlocatie	Aanbevolen
`assetExternalId`	Externe ID van gekoppeld activum	Optioneel
`mainAsset`	Directe relatie met asset	Optioneel

Voeg extra velden toe op basis van uw Veldconfiguratie instellingen in Maintain.

Implementeer de activiteiten

Implementeer uw activiteitsgegevens met Cognite Toolkit:

cdf deploy --env dev

Gebruik de --drop-data vlag als u bestaande activiteiten moet vervangen:

cdf deploy --env dev --drop-data

Lees meer over de Cognite Toolkit deployment flags.

Verifieer in Maintain

Meld u aan bij Maintain.
Navigeer naar Activiteiten (Activities).
Controleer of uw geïmporteerde activiteiten met de juiste gegevens verschijnen.

Implementeer activiteiten met Transformaties

Beschikbaarheid van modus: APM- en IDM/CDM-modi. Dit is de aanbevolen aanpak voor bulkgegevens.

U kunt ook CDF Transformaties gebruiken om gegevens uit RAW-tabellen of andere bronnen naar activiteitsknooppunten te converteren.

Probleemoplossing

Als u problemen ondervindt met activiteiten na inname, zie dan de tabel voor oorzaken en oplossingen.

Probleem	Oplossing
Activiteiten niet zichtbaar	Controleer of de `viewMappings` configuratie naar de juiste space, view en versie verwijst
Ontbrekende velden	Controleer dat uw Veldconfiguratie alle velden bevat die u opneemt
Asset-koppelingen verbroken	Zorg ervoor dat `assetExternalId` of `mainAsset` relaties naar bestaande assets verwijzen
Verkeerde hoofdlocatie	Controleer of `rootLocation` overeenkomt met uw locatieconfiguratie

Flows

InField

Maintain

Externe bronnen

Importeer activiteiten in Maintain

Importeer via CSV-upload (APM-modus)

Formateer datumvelden

Formateer boolean-velden

Formatteer waarden die komma’s bevatten

Unset waarden

Verbind een activiteit met een activum

Importeren via Cognite Toolkit

Vereisten

Configureer de mapping van de activiteitweergave

Activiteiten opnemen met de Cognite Toolkit

Implementeer activiteiten met Transformaties

Probleemoplossing

​Importeer via CSV-upload (APM-modus)

​Formateer datumvelden

​Formateer boolean-velden

​Formatteer waarden die komma’s bevatten

​Unset waarden

​Verbind een activiteit met een activum

​Importeren via Cognite Toolkit

​Vereisten

​Configureer de mapping van de activiteitweergave

​Activiteiten opnemen met de Cognite Toolkit

​Implementeer activiteiten met Transformaties

​Probleemoplossing

Importeer via CSV-upload (APM-modus)

Formateer datumvelden

Formateer boolean-velden

Formatteer waarden die komma’s bevatten

Unset waarden

Verbind een activiteit met een activum

Importeren via Cognite Toolkit

Vereisten

Configureer de mapping van de activiteitweergave

Activiteiten opnemen met de Cognite Toolkit

Implementeer activiteiten met Transformaties

Probleemoplossing