Aktivitäten in Maintain importieren

Maintain unterstützt drei Methoden zum Importieren von Aktivitäten:

CSV-Upload: Aktivitäten über die Benutzeroberfläche importieren (nur APM-Modus).
Cognite Toolkit: Aktivitäten über Cognite Toolkit Datenmodellierung (APM- und IDM/CDM-Modus) ingestieren.
Transformationen: Daten aus RAW-Tabellen oder anderen Quellen mit CDF-Transformationen (APM- und IDM/CDM-Modus) konvertieren.

Import über CSV-Upload (APM-Modus)

Modusverfügbarkeit: Nur APM-Modus. Der IDM/CDM-Modus unterstützt keinen CSV-Import über die Benutzeroberfläche.

Über CSV importierte Aktivitäten können visualisiert und geändert werden wie Aktivitäten, die in Maintain erstellt wurden.

Laden Sie die CSV-Datei-Vorlage herunter

Die importierte CSV-Datei muss Ihrem projektspezifischen Template entsprechen. Um maintain-import-template.csv herunterzuladen:

Navigieren Sie zu Aktivitäten und wählen Sie Aktivität hinzufügen aus.
Wählen Sie Aktivitäten importieren aus.
Wählen Sie Template herunterladen aus.

Füllen Sie die CSV-Datei-Vorlage aus

Die CSV-Vorlage enthält nur eine einzige Zeile von Werten, die die möglichen Werte darstellen, die Sie für eine importierte Aktivität angeben können. Diese Zeile wird als Kopfzeile bezeichnet und sollte beim Ausfüllen der Vorlage nicht entfernt werden.

Während die Kopfzeile row nicht entfernt werden darf, können spezifische Werte aus der Kopfzeile entfernt oder die Reihenfolge der Werte geändert werden. Wenn ein bestimmtes Feld in einem bestimmten Szenario nicht relevant ist, können Sie es aus der Kopfzeile und den nachfolgenden Zeilen entfernen. Dies führt dazu, dass das Feld bei allen importierten Aktivitäten leer bleibt.

Um eine einzelne Aktivität zu importieren, fügen Sie der Vorlage eine neue Zeile hinzu und geben Sie die entsprechenden Werte durch Kommas getrennt ein. Jeder Wert in der neuen Zeile sollte den Wert enthalten, den Sie in der entsprechenden Kopfzeile, die in der Vorlage bereitgestellt wurde, einfüllen möchten. Wenn Ihre Vorlage die folgende Kopfzeile enthält: title,status,department, erstellen Sie eine CSV-Datei mit einer zusätzlichen Zeile:

title,status,department
Gerüst aufstellen,Erledigt,Montage

Sie erstellen eine Aktivität mit dem Titel “Gerüst aufstellen”, dem Status “Erledigt” und der Abteilung “Montage”, wenn sie importiert wird.

Datumsfelder formatieren

Einige Aktivitätsfelder in Maintain stellen Daten dar und müssen ein bestimmtes Format haben, um korrekt importiert zu werden. Datumsfelder können in der CSV-Vorlage durch einen speziellen Kopfzeilenwert in der Form startTime (DD/MM/YYYY) identifiziert werden. In diesem Beispiel ist startTime der Name des Feldes, während DD/MM/YYYY das Datumsformat ist, das in den nachfolgenden Zeilen der CSV-Datei verwendet werden muss. Wenn Sie beispielsweise die folgende Datei importieren, wird die Aktivität mit startTime auf den 10. Dezember 2023 gesetzt.

title,startTime (DD/MM/YYYY)
Gerüst aufstellen,10/12/2023

Boolean-Felder formatieren

Einige Aktivitätsfelder in Maintain stellen boolesche Werte dar, wie true oder false. Boolesche Felder können in der CSV-Vorlage durch einen speziellen Kopfzeilenwert in der Form isActive (true/false) identifiziert werden. Diese Felder haben nur zwei gültige Werte, true oder false. Wenn Sie beispielsweise die folgende Datei importieren, wird die Aktivität mit isActive auf false gesetzt.

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

Formatieren Sie Werte, die Kommas enthalten

Aufgrund des CSV-Formats, das Werte mit Kommas trennt, seien Sie vorsichtig, wenn ein Aktivitätsfeld ebenfalls ein Komma enthalten muss. Wartung verarbeitet CSV-Dateien gemäß dem RFC 4180 Standard, der erfordert, dass Werte, die Kommas enthalten, in doppelte Anführungszeichen gesetzt werden. Wenn Sie beispielsweise die folgende Datei importieren, wird die Aktivität mit Stadt auf Boston, MA gesetzt.

title,city
Erect scaffolding,"Boston, MA"

Nicht gesetzte Werte

Sie können das Feld bei nicht erforderlichen Aktivitätsfeldern leer lassen, um fehlende oder irrelevante Werte für die spezifische Aktivität darzustellen. Wenn Sie beispielsweise die folgende Datei importieren, wird die Aktivität mit Bundesstaat auf New York gesetzt, aber es wird kein Wert im Feld Stadt vorhanden sein.

title,city,state
Erect scaffolding,New York

Eine Aktivität mit einem Asset verbinden

Wartung unterstützt das Verknüpfen von Aktivitäten mit CDF-Assets, die verwendet werden, um die Aktivität in 3D-Modellen, Dokumenten, PSN und mehr zu kontextualisieren. Damit Wartung die entsprechende Verknüpfung zu einem Asset in CDF erstellen kann, müssen Sie die externe ID des CDF-Assets im Import-Template angeben. Wenn Sie eine Asset-Kontextualisierung in Ihrem Projekt haben, gibt es ein spezielles assetExternalId Feld im Template, das Sie mit der externen ID des Assets der Aktivität ausfüllen müssen. Wenn Sie beispielsweise die folgende Datei importieren und davon ausgehen, dass ein CDF-Asset mit der externen ID NY_BUILDING_23 existiert, wird die Aktivität beim Import in Wartung mit diesem Asset kontextualisiert.

title,assetExternalId
Erect scaffolding,NY_BUILDING_23

Wenn die angegebene externe ID nicht exportiert wird, sieht der Benutzer während des Imports einen Fehler.

Endbenutzer wissen möglicherweise nicht, welche externe ID das Asset hat, mit dem die Aktivität verknüpft ist. Wenn es notwendig ist, Endbenutzern eine Liste der möglichen Assets und deren externe IDs zur Verfügung zu stellen, empfehlen wir, diese Daten über die Asset-API von CDF oder andere Datenextraktoren abzurufen.

Importieren Sie eine ausgefüllte CSV-Datei

Sobald Sie ein ausgefülltes CSV-Template haben, können Sie es in Wartung importieren:

Navigieren Sie zu Aktivitäten > Aktivität hinzufügen.
Wählen Sie Aktivitäten importieren aus.
Wählen Sie das CSV-Datei zum Importieren auswählen Feld aus.
Wählen Sie die ausgefüllte CSV-Datei von Ihrem Computer aus und laden Sie sie hoch.
Überprüfen Sie, ob Sie die Datei importiert haben, indem Sie den Abschnitt Dateiinspektor überprüfen. Eine grüne Nachricht sollte die Anzahl der zu importierenden Zeilen sowie eventuelle Warnungen oder Fehler anzeigen.
Wenn keine Fehler vorliegen, wählen Sie Importieren, um den Importprozess zu starten.
Wenn der Import erfolgreich ist, sehen Sie eine grüne Erfolgsmeldung mit der Schaltfläche Aktivitäten anzeigen.
Optional. Wählen Sie Aktivitäten anzeigen, um zu den importierten Aktivitäten zu navigieren und zu überprüfen, ob sie gemäß der CSV-Datei korrekt aussehen.

Import über das Cognite Toolkit

Modusverfügbarkeit: APM- und IDM/CDM-Modi. Dies ist der empfohlene Ansatz für die programmgesteuerte Aktivitätsaufnahme.

Verwenden Sie das Cognite Toolkit, um Aktivitäten über die Datenmodellierungsfunktionen von CDF aufzunehmen. Diese Methode funktioniert für beide Bereitstellungsmodi und bietet Versionskontrolle sowie reproduzierbare Bereitstellungen.

Voraussetzungen

Bevor Sie Aktivitäten über das Cognite Toolkit importieren, stellen Sie sicher, dass Sie Folgendes haben:

Eine benutzerdefinierte Aktivitätsansicht, die in Ihrem Datenmodellraum konfiguriert ist (oder verwenden Sie die Standardansicht CogniteMaintenanceOrder von cdf_idm)
Die Aktivitätsansicht, die in Ihrer Maintain-Konfiguration unter viewMappings zugeordnet ist.
Zugriff auf das Cognite Toolkit

Konfigurieren Sie die Zuordnung der Aktivitätsansicht

Überprüfen Sie in Ihrer Maintain-Konfiguration, ob der Abschnitt viewMappings auf Ihre Aktivitätsansicht verweist:

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

Wenn Sie eine benutzerdefinierte Aktivitätsansicht erstellt haben (zum Beispiel APM_Activity oder ExtendedActivity), aktualisieren Sie die Zuordnung, um auf Ihre benutzerdefinierte Ansicht zu verweisen:

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

Erfahren Sie mehr über die Erweiterung von Datenmodellen und die Konfiguration von Ansichtszuordnungen.

Aktivitäten mit dem Cognite Toolkit erfassen

Verwenden Sie das Cognite Toolkit als empfohlene Methode zur Erfassung von Aktivitäten im IDM-Modus.

Erstellen Sie die Datenstruktur für die Aktivitäten

Wenn Sie dies noch nicht getan haben, erstellen Sie Container-, Ansicht- und Knoten-YAML-Dateien für Ihre Aktivitäten. Befolgen Sie die standardmäßige Datenmodellierungsstruktur:

APM_Activity.Container.yaml - Definiert das Container-Schema
APM_Activity.View.yaml - Definiert die Eigenschaften und Beziehungen der Ansicht
apmActivities.Node.yaml - Enthält Ihre Aktivitätsinstanzen Siehe die Cognite Toolkit-Dokumentation für detaillierte Beispiele und Vorlagen.

Konfigurieren Sie die Feldzuordnungen

Stellen Sie sicher, dass Ihre Aktivitätsknoten die erforderlichen Felder für die Wartung enthalten:

Feld	Beschreibung	Erforderlich
`externalId`	Eindeutiger Identifikator für die Aktivität	Ja
`title`	Titel der Aktivität	Ja
`status`	Status der Aktivität (zum Beispiel “Offen”, “In Bearbeitung”, “Fertig”)	Empfohlen
`startTime`	Startdatum/-uhrzeit	Empfohlen
`endTime`	Enddatum/-uhrzeit	Empfohlen
`rootLocation`	Identifikator des Stammstandorts	Empfohlen
`assetExternalId`	Externe ID des verknüpften Assets	Optional
`mainAsset`	Direkte Beziehung zum Asset	Optional

Fügen Sie zusätzliche Felder basierend auf Ihren Feldkonfiguration Einstellungen in der Wartung hinzu.

Setzen Sie die Aktivitäten um

Stellen Sie Ihre Aktivitätsdaten mit dem Cognite Toolkit bereit:

cdf deploy --env dev

Verwenden Sie das --drop-data Flag, wenn Sie vorhandene Aktivitäten ersetzen müssen:

cdf deploy --env dev --drop-data

Erfahren Sie mehr über die Cognite Toolkit-Bereitstellungsflags.

Überprüfen Sie in der Wartung

Melden Sie sich bei Maintain an. 2. Navigieren Sie zu Activities. 3. Überprüfen Sie, ob Ihre importierten Aktivitäten mit den korrekten Daten angezeigt werden.

Aktivitäten mit Transformationen erfassen

Modusverfügbarkeit: APM- und IDM/CDM-Modi. Dies ist der empfohlene Ansatz für Massendaten.

Alternativ können Sie CDF-Transformationen verwenden, um Daten aus RAW-Tabellen oder anderen Quellen in Aktivitätsknoten zu konvertieren.

Problembehandlung

Wenn Sie nach der Erfassung Probleme mit Aktivitäten haben, sehen Sie sich die Tabelle für Ursachen und Lösungen an.

Problem	Lösung
Aktivitäten nicht sichtbar	Überprüfen Sie, ob die `viewMappings`-Konfiguration auf den richtigen Raum, die richtige Ansicht und die richtige Version verweist.
Fehlende Felder	Stellen Sie sicher, dass Ihre Feldkonfiguration alle Felder umfasst, die Sie erfassen.
Asset-Links defekt	Stellen Sie sicher, dass `assetExternalId` oder `mainAsset`-Beziehungen auf vorhandene Assets verweisen.
Falscher Stammstandort	Überprüfen Sie, ob `rootLocation` mit Ihrer Standortkonfiguration übereinstimmt.

​Import über CSV-Upload (APM-Modus)

​Datumsfelder formatieren

​Boolean-Felder formatieren

​Formatieren Sie Werte, die Kommas enthalten

​Nicht gesetzte Werte

​Eine Aktivität mit einem Asset verbinden

​Import über das Cognite Toolkit

​Voraussetzungen

​Konfigurieren Sie die Zuordnung der Aktivitätsansicht

​Aktivitäten mit dem Cognite Toolkit erfassen

​Aktivitäten mit Transformationen erfassen

​Problembehandlung

Import über CSV-Upload (APM-Modus)

Datumsfelder formatieren

Boolean-Felder formatieren

Formatieren Sie Werte, die Kommas enthalten

Nicht gesetzte Werte

Eine Aktivität mit einem Asset verbinden

Import über das Cognite Toolkit

Voraussetzungen

Konfigurieren Sie die Zuordnung der Aktivitätsansicht

Aktivitäten mit dem Cognite Toolkit erfassen

Aktivitäten mit Transformationen erfassen

Problembehandlung