Arbeitsaufträge aus CSV-Datei importieren
Sie können mehrere Arbeitsaufträge aus einer externen Quelle in Maintain importieren, indem Sie eine Textdatei im CSV-Format mit Arbeitsauftragsdaten hochladen und die Datei in Arbeitsaufträge aufnehmen. Die Arbeitsaufträge können als in Maintain angelegte Arbeitsaufträge visualisiert und modifiziert werden.
CSV-Dateivorlage herunterladen
Die importierte CSV-Datei muss Ihrer projektspezifischen Vorlage entsprechen. So laden Sie die Datei maintain-import-template.csv herunter:
- Navigieren Sie zu Arbeitsaufträge und wählen Sie Arbeitsauftrag hinzufügen aus.
- Wählen Sie Arbeitsaufträge importieren aus.
- Wählen Sie Vorlage herunterladen aus.
CSV-Dateivorlage ausfüllen
Die CSV-Vorlage enthält nur eine einzige Wertezeile, die die möglichen Werte darstellt, die Sie für einen importierten Arbeitsauftrag 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 beispielsweise ein bestimmtes Feld für den Import 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 Arbeitsaufträgen leer bleibt.
Um einen einzelnen Arbeitsauftrag 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 ausfüllen möchten, die in der Vorlage bereitgestellt wurde.
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
Beim Import wird ein Arbeitsauftrag mit dem Titel „Erect scaffolding“, dem Status „Fertig“ und der Abteilung „Rigging“ erstellt.
Datumsfelder formatieren
Einige Tätigkeitsfelder in ~~Maintain ~~stellen Daten dar und müssen ein bestimmtes Format haben, um ordnungsgemäß importiert zu werden. Datumsfelder können in der CSV-Vorlage durch einen speziellen Kopfzeilenwert im Format startTime (DD/MM/YYYY) gekennzeichnet 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 der Arbeitsauftrag mit der startTime 10. Dezember 2023 erstellt.
title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023
Boolesche Felder formatieren
Einige Arbeitsauftragsfelder in Maintain stellen boolesche Werte dar, z. B. true oder false. Datumsfelder können in der CSV-Vorlage durch einen speziellen Kopfzeilenwert im Format isActive (true/false) gekennzeichnet werden. Diese Felder haben nur zwei gültige Werte: true oder false.
Wenn Sie beispielsweise die folgende Datei importieren, wird der Arbeitsauftrag so erstellt, dass isActive auf false festgelegt ist.
title,isActive (true/false)
Erect scaffolding,false
Formatwerte mit Kommas
Da das CSV-Format Werte durch Kommas trennt, seien Sie vorsichtig, wenn ein Arbeitsauftrag ebenfalls ein Komma enthält. Maintain verarbeitet CSV-Dateien gemäß dem RFC 4180 Standard, der vorschreibt, dass Werte mit Kommas in doppelte Anführungszeichen eingeschlossen werden müssen.
Wenn Sie beispielsweise die folgende Datei importieren, wird der Arbeitsauftrag so erstellt, dass für city der Wert Boston, MA festgelegt wird.
title,city
Erect scaffolding,"Boston, MA"
Werte nicht festlegen
Sie können ein Feld leer lassen, wenn es für einen Arbeitsauftrag nicht erforderlich ist, um fehlende oder irrelevante Werte für den spezifischen Arbeitsauftrag darzustellen.
Wenn Sie beispielsweise die folgende Datei importieren, wird der Arbeitsauftrag so erstellt, dass state auf New York festgelegt ist, wobei das Feld city jedoch keinen Wert enthält.
title,city,state
Erect scaffolding,New York
Arbeitsauftrags mit einem Anlagenteil verknüpfen
Maintain unterstützt die Verknüpfung von Arbeitsaufträgen mit CDF-Assets, die zur Kontextualisierung des Arbeitsauftrags in 3D-Modellen, Dokumenten, PSN usw. verwendet werden. Damit Maintain die entsprechende Verknüpfung zu einem Anlagenteil in CDF erstellen kann, müssen Sie die externe ID des CDF-Anlagenteils in der Importvorlage angeben.
Wenn Sie eine Anlagenteil-Kontextualisierung in Ihrem Projekt haben, gibt es ein spezielles Feld, assetExternalId, in der Vorlage, das Sie mit der externen ID des Anlagenteils des Arbeitsauftrags ausfüllen müssen.
Wenn Sie beispielsweise die folgende Datei importieren und davon ausgehen, dass ein CDF-Anlagenteil mit der externen ID NY_BUILDING_23 existiert, wird der Arbeitsauftrag bei der Aufnahme in Maintain mit diesem Anlagenteil kontextualisiert.
title,assetExternalId
Erect scaffolding,NY_BUILDING_23
Wenn die angegebene externe ID nicht exportiert wird, wird dem Benutzer beim Importieren ein Fehler angezeigt.
Endbenutzer kennen die externe ID des Anlagenteils möglicherweise nicht, mit dem der Arbeitsauftrag verknüpft ist. Wenn es notwendig ist, Endnutzern eine Liste der möglichen Anlagenteile und deren externen IDs zur Verfügung zu stellen, empfehlen wir, diese Daten über die Anlagen-API von CDF oder andere Datenextraktoren abzurufen.
Ausgefüllte CSV-Datei importieren
Sobald Sie eine ausgefüllte CSV-Vorlage haben, können Sie sie in Maintain importieren:
- Navigieren Sie zu Arbeitsaufträge > Arbeitsauftrag hinzufügen.
- Wählen Sie Arbeitsaufträge importieren aus.
- Wählen Sie das Feld zum Auswählen einer CSV-Datei aus, die Sie importieren möchten****.
- Wählen Sie die ausgefüllte CSV-Datei auf dem Computer aus und laden Sie sie hoch.
- Überprüfen Sie, ob die Datei importiert wurde, indem Sie den Abschnitt File Inspector (Dateiinspektor) aktivieren. Eine grüne Meldung sollte die Anzahl der zu importierenden Zeilen und eventuelle Warnungen oder Fehler anzeigen.
- Wenn keine Fehler vorliegen, wählen Sie Importieren aus, um den Importvorgang zu starten.
- Wenn der Import erfolgreich war, sehen Sie eine grüne Erfolgsmeldung mit der Schaltfläche Arbeitsaufträge anzeigen.
- Optional. Wählen Sie Arbeitsaufträge anzeigen aus, um zu den importierten Arbeitsaufträgen zu navigieren und zu überprüfen, ob sie gemäß der CSV-Datei korrekt aussehen.