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: Ingestieren Sie Aktivitäten mithilfe der Cognite Toolkit-Datenmodellierung (APM- und IDM/CDM-Modi).
Transformationen: Konvertieren Sie Daten aus RAW-Tabellen oder anderen Quellen mithilfe von CDF Transformationen (APM- und IDM/CDM-Modi).

Import über CSV-Upload (APM-Modus)

Verfügbarkeit des Modus: 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 als in Maintain erstellte Aktivitäten bearbeitet werden.

Laden Sie die CSV-Datei-Vorlage herunter

Die importierte CSV-Datei muss Ihrer projektspezifischen Vorlage entsprechen. So laden Sie maintain-import-template.csv herunter:

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

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 nicht entfernt werden darf, können Sie bestimmte Werte aus der Kopfzeile entfernen oder die Reihenfolge der Werte ändern. 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 beispielsweise die folgende Kopfzeile enthält: title,status,department, erstellen Sie eine CSV-Datei mit einer zusätzlichen Zeile:

title,status,department
Erect scaffolding,Done,Rigging

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 Datumsangaben dar und müssen ein bestimmtes Format aufweisen, um ordnungsgemäß importiert zu werden. Datumsfelder können in der CSV-Vorlage anhand eines speziellen Kopfzeilenwerts 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 erstellt.

title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023

Boolean-Felder formatieren

Einige Aktivitätsfelder in Maintain stellen boolesche Werte dar, wie z. B. true oder false. Boolesche Felder können in der CSV-Vorlage anhand eines speziellen Kopfzeilenwerts 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 erstellt.

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

Formatieren Sie Werte, die Kommas enthalten

Da das CSV-Format Werte durch Kommas trennt, seien Sie vorsichtig, wenn ein Aktivitätsfeld ebenfalls ein Komma enthalten muss. Maintain 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 city auf Boston, MA gesetzt erstellt.

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 state auf New York gesetzt erstellt, aber sie hat keinen Wert im Feld city.

title,city,state
Erect scaffolding,New York

Eine Aktivität mit einem Asset verbinden

Maintain unterstützt die Verknüpfung von Aktivitäten mit CDF-Assets, was dazu verwendet wird, die Aktivität in 3D-Modellen, Dokumenten, PSN und mehr zu kontextualisieren. Damit Maintain die entsprechende Verknüpfung zu einem Asset in CDF erstellen kann, müssen Sie die externe ID des CDF-Assets in der Importvorlage angeben. Wenn Sie eine Asset-Kontextualisierung in Ihrem Projekt haben, gibt es ein spezielles assetExternalId-Feld in der Vorlage, das Sie mit der externen ID des Assets der Aktivität fü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 bei der Aufnahme in Maintain 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 ihrer externen 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 eine ausgefüllte CSV-Vorlage haben, können Sie diese in Maintain importieren:

Navigieren Sie zu Aktivitäten > Aktivität hinzufügen.
Wählen Sie Aktivitäten importieren.
Wählen Sie das Feld Klicken, um CSV-Datei zum Import auszuwählen 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 Bereich Dateiinspector kontrollieren. Eine grüne Nachricht sollte die Anzahl der zu importierenden Zeilen sowie eventuelle Warnungen oder Fehler anzeigen.
Wenn keine Fehler vorliegen, wählen Sie Import, um den Importvorgang 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 Cognite Toolkit

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

Verwenden Sie 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 Cognite Toolkit importieren, stellen Sie sicher, dass Sie Folgendes haben:

Eine benutzerdefinierte Aktivitätsansicht, die in Ihrem Datenmodellbereich 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 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, damit sie auf Ihre benutzerdefinierte Ansicht verweist:

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

Erfahren Sie mehr über das Erweitern von Datenmodellen und das Konfigurieren von Ansichtszuordnungen.

Aktivitäten aufnehmen mit dem Cognite Toolkit

Verwenden Sie den Cognite Toolkit als empfohlenen Ansatz für die Aufnahme 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 Ansichtseigenschaften und -beziehungen
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 Maintain enthalten:

Feld	Beschreibung	Erforderlich
`externalId`	Eindeutiger Bezeichner für die Aktivität	Ja
`title`	Aktivitätstitel	Ja
`status`	Aktivitätsstatus (zum Beispiel „Offen“, „In Bearbeitung“, „Erledigt“)	Empfohlen
`startTime`	Startdatum/-uhrzeit	Empfohlen
`endTime`	Enddatum/-uhrzeit	Empfohlen
`rootLocation`	Bezeichner 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 Field Configuration-Einstellungen in Maintain hinzu.

Setzen Sie die Aktivitäten um

Stellen Sie Ihre Aktivitätsdaten mithilfe von 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 deployment flags.

Überprüfen Sie in der Wartung

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

Aktivitäten mit Transformationen erfassen

Verfügbarkeit des Modus: 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 korrekten Bereich, die korrekte Ansicht und die korrekte Version verweist
Fehlende Felder	Prüfen Sie, dass Ihre Feldkonfiguration alle Felder enthält, die Sie aufnehmen
Asset-Links defekt	Stellen Sie sicher, dass `assetExternalId`- oder `mainAsset`-Beziehungen auf vorhandene Assets verweisen
Falscher Stammspeicherort	Überprüfen Sie, ob `rootLocation` mit Ihrer Standortkonfiguration übereinstimmt

Flows

InField

Maintain

Externe Ressourcen

Aktivitäten in Maintain importieren

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 Cognite Toolkit

Voraussetzungen

Konfigurieren Sie die Zuordnung der Aktivitätsansicht

Aktivitäten aufnehmen mit dem Cognite Toolkit

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 Cognite Toolkit

​Voraussetzungen

​Konfigurieren Sie die Zuordnung der Aktivitätsansicht

​Aktivitäten aufnehmen mit dem Cognite Toolkit

​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 Cognite Toolkit

Voraussetzungen

Konfigurieren Sie die Zuordnung der Aktivitätsansicht

Aktivitäten aufnehmen mit dem Cognite Toolkit

Aktivitäten mit Transformationen erfassen

Problembehandlung