Zum Inhalt

Importanforderungen

Die Importfunktion hilft Benutzern, Bilder und entsprechende Betriebsmittel in einem benutzerfreundlichen Modul hochzuladen. Darüber hinaus ist es ein wichtiger Bestandteil des restlichen Produktes und dient als logischen Ausgangspunkt für alle Inspektionen.

Anforderungen für den Import

Um einen Import in Grid Vision Inspect durchzuführen, benötigt der Benutzer Metadaten für Betriebsmittel und Bilder. Die Metadaten für Betriebsmittel werden normalerweise in einer Betriebsmittel-Informationsdatei gespeichert. Metadaten für Bilder sind normalerweise in den Bildern eingebettet. Andernfalls sollten sie in einer Bildinformationsdatei gespeichert werden.

Anforderungen an Bilder

  • Die Bilder müssen im Format jpg/jpeg vorliegen.
  • Die Bilder müssen EXIF-Informationen enthalten, mindestens den GPSStandort, an dem das Bild aufgenommen wurde, und das Aufnahmedatum, an dem das Bild aufgenommen wurde.
  • Die Bilder müssen maximal 1000 m von der nächsten Anlage entfernt sein.

Asset-Informationsdatei

Die Asset-Informationsdatei enthält Referenzinformationen zu dem im Bild erfassten Betriebsmittel. Sie enthält im Wesentlichen: - Kennung, - Name, - Gruppen-Identifikator, - Gruppentyp, - Breitengrad, - Längengrad, - AssetType, - Quellsystem, - und Höhe.

Das Format der Betriebsmittel-Informationsdatei sollte der folgenden Anweisung entsprechen: - Unterstütztes Dateiformat: csv, json - Unterstütztes File-Trennzeichen: Komma (,) - Unterstütztes Dezimaltrennzeichen in der Datei: Punkt (.)

Feldname Definition Unterstützte Namen (der erste ist Standard) Feldwert Max. Länge Erforderlich/Optional Beispiel
Identifier Eine eindeutige Kennung (eindeutig pro Quellsystem), die dem Betriebsmittel zugeordnet ist. Die Kennung ist eine externe Referenz auf das Betriebsmittel und nicht die interne Betriebsmittel-ID von eSmart. identifier Zeichenfolge 256 Erforderlich 0001001
Name Der Name des Betriebsmittels, z. der Strukturname/-nummer. name Zeichenfolge 256 Optional Pol 1
GroupIdentifier Ein Betriebsmittelgruppierungsschlüssel könnte für Leitungsname oder -nummer verwendet werden. group identifier Zeichenfolge 256 Optional Leitung1100
GroupType Die Art der Komponente, in der das Betriebsmittel gruppiert werden soll. Nur "Line" wird unterstützt group type, grouptype Zeichenfolge Optional Line
Breitengrad Gibt den Breitengrad des Elements an. Der Breitengrad wird in Dezimalgrad ausgedrückt (-90 bis 90). SRID: 4326 WGS 84 latitude, lat (deg), lat(deg), lat Zahl Erforderlich 59.125832
Längengrad Gibt den Längengrad des Elements an. Der Längengrad wird in Dezimalgrad ausgedrückt (-180 bis 180). SRID: 4326 WGS 84 longitude, lon (deg), lon (deg), lon Zahl Erforderlich 11.38942
AssetType Der Typ des Assets, wie von eSmart definiert. Nur „PowerLineStructure“ wird unterstützt asset type, assettype Zeichenfolge Erforderlich PowerLineStructure
Quellsystem Quellsystem bezieht sich auf den Namen des Systems, aus dem das Asset stammt. Wird verwendet, um die Eindeutigkeit zu gewährleisten, falls der Kunde Daten aus mehreren Systemen mit sich überschneidenden Identifikatoren importiert. z.B. "Arbeitsauftrag" oder "ERP" source system, sourcesystem Zeichenfolge 256 Erforderlich ERPSystem
Höhe Repräsentiert die Höhe der Struktur in Metern. Vom Boden aus gemessen. height Zahl Optional 12,5

Beispiel für CSV

Identifier,Name,GroupIdentifier,GroupType,Latitude,Longitude,AssetType,SourceSystem,Height
0001001,Pole 1,Line1100,Line,59.125832,11.38942,PowerLineStructure,ERPSystem,12.5
0001002,Pole 2,Line1100,Line,59.125834,11.38942,PowerLineStructure,ERPSystem,12.65
Identifier Name GroupIdentifier GroupType Latitude Longitude AssetType SourceSystem Height
0001001 Pole 1 Line1100 Line 59.125832 11.38942 PowerLineStructure ERPSystem 12.5
0001002 Pole 2 Line1100 Line 59.125834 11.38942 PowerLineStructure ERPSystem 12.65

Beispiel für JSON

[
{
        "assetType": "PowerLineStructure",
        "groupIdentifier": "Line1100",
        "groupType": "Line",
        "height": 12.5,
        "identifier": "0001001",
        "latitude": 59.125832,
        "longitude": 11.38942,
        "name": "Pole 1",
        "sourceSystem": "ERPSystem"
},
{
        "assetType": "PowerLineStructure",
        "groupIdentifier": "Line1100",
        "groupType": "Line",
        "height": 12.65,
        "identifier": "0001002",
        "latitude": 59.125834,
        "longitude": 11.38942,
        "name": "Pole 2",
        "sourceSystem": "ERPSystem"
    }
]

Fehlende erforderliche Komponenten

Um zu überprüfen, ob ein Betriebsmittel Komponenten enthält, die im Rahmen regulatorischer Anforderungen erforderlich sind, sollten leicht abweichende Betriebsmittel-Dateien erstellt werden. Derzeit gibt es zwei Komponenten, um fehlende erforderliche Komponenten zu identifizieren.

  1. Sicherheitszeichen
  2. Kletterschutz

Hinweis: Für fehlende erforderliche Komponenten sollte die Asset-Informationsdatei etwas anders sein

Beispiel für CSV

Identifier  Name    GroupIdentifier GroupType   Latitude    Longitude   AssetType         SourceSystem  Height  SafetySign.MinCount AntiClimbingDevice.MinCount
ID1         H-1              Line          60.7283977   11.1166493  PowerLineStructure  Workorder            2                1
ID2         H-2              Line          60.7279055   11.1170625  PowerLineStructure  Workorder            2                0
ID3         H-3              Line          60.7278896   11.117063   PowerLineStructure  Workorder          
 0                    1
ID4         H-4              Line          60.7271815   11.1175399  PowerLineStructure  Workorder            2                1

Beispiel für JSON

[
    {
        "identifier": "ID1",
        "name": "H-1",
        "groupIdentifier": null,
        "groupType": "Line",
        "latitude": 60.7283977,
        "longitude": 11.1166493,
        "assetType": "PowerLineStructure",
        "sourceSystem": "Workorder",
        "height": null,
        "requirements": [
            {
                "key": "SafetySign",
                "minCount": 2
            },
            {
                "key": "AntiClimbingDevice",
                "minCount": 1
            }
        ]
    },
    {
        "identifier": "ID2",
        "groupIdentifier": null,
        "groupType": "Line",
        "latitude": 60.7279055,
        "longitude": 11.1170625,
        "assetType": "PowerLineStructure",
        "sourceSystem": "Workorder",
        "height": null,
        "requirements": [
            {
                "key": "SafetySign",
                "minCount": 2
            }
        ]
    },
    {
        "identifier": "ID3",
        "name": "H-3",
        "groupIdentifier": "",
        "groupType": "Line",
        "latitude": 60.7278896,
        "longitude": 11.117063,
        "assetType": "PowerLineStructure",
        "sourceSystem": "Workorder",
        "height": null,
        "requirements": [
            {
                "key": "AntiClimbingDevice",
                "minCount": 1
            }
        ]
    },
    {
        "identifier": "ID4",
        "name": "H-4",
        "groupType": Line,
        "latitude": 60.7271815,
        "longitude": 11.1175399,
        "assetType": "PowerLineStructure",
        "sourceSystem": "Workorder",
        "height": null,
        "requirements": [
            {
                "key": "AntiClimbingDevice",
                "minCount": 1
            },
            {
                "key": "SafetySign",
                "minCount": 2
            }
        ]
    }
]

Bildinformationsdatei

Enthält Referenzinformationen eines Bildes. Es enthält Dateiname, Breitengrad, Längengrad, Höhe, CapturedAt, Yaw, Pitch, Roll, CameraTag und AssetIdentifier.

Eine Bildinformationsdatei sollte verwendet werden, wenn die Bilder keine Informationen zu Breitengrad, Längengrad und Aufnahmedatum enthalten. Es kann auch verwendet werden, wenn Benutzer genau wissen, welche Bilder zu welchen Assets gehören. In diesem Fall sollte die für jedes Bild relevante Asset-ID ausgefüllt werden.

Das Format der Bildinformationsdatei sollte den folgenden Anweisungen folgen:

  • Unterstütztes Dateiformat: CSV, JSON
  • Unterstütztes Dateitrennzeichen: Komma (,)
  • Unterstütztes Dezimaltrennzeichen in der Datei: Punkt (.)
Feldname Definition Unterstützte Namen (der erste ist Standard) Feldwert Max. Länge Erforderlich/Optional Beispiel
Filename Beim Dateinamen wird zwischen Groß- und Kleinschreibung unterschieden und er muss mit dem tatsächlichen Bilddateinamen übereinstimmen filename, file name, image name, imagename, image Zeichenfolge Einschränkung nur im Betriebssystem (Windows und MAC) -> 255 Erforderlich MISSION1001_2020_000001.jpg
AssetIdentifier Die eindeutige Kennung, die dem Asset zugeordnet ist. Die Kennung ist eine externe Referenz auf das Asset und nicht die interne Asset-ID von eSmart asset identifier, assetidentifier Zeichenfolge 256 Optional 0001001
CapturedAt Datum und Uhrzeit der Bildaufnahme (in UTC). Das Datum sollte ISO_8601 entsprechen.
Format: YYYY-MM-DDTHH:MM:SS.SSSSSSSSZ
Y: Jahr
M: Monat
W : Woche < br /> D : Tag
T : Zeitbezeichner, der den Zeitkomponenten der Darstellung vorangeht.
H : Stunde
M : Minute
S : Sekunde
captured at, capturedat Terminzeit Erforderlich, wenn Exif-Tag den Wert nicht enthält 2020-02-26T08:48:44.7747628Z
Latitude Gibt den Breitengrad des Elements an. Der Breitengrad wird in Dezimalgrad ausgedrückt (-90 to 90). SRID: 4326 WGS 84 latitude, lat (deg), lat(deg), lat Zahl Erforderlich, wenn Exif-Tag den Wert nicht enthält 59.125832
Longitude Gibt den Längengrad des Elements an. Der Längengrad wird in Dezimalgrad ausgedrückt (-180 to 180). SRID: 4326 WGS 84 longitude, lon (deg), lon (deg), lon Zahl Erforderlich, wenn Exif-Tag den Wert nicht enthält 11.38942
Altitude Zeigt die Höhe an, in der das Bild aufgenommen wird. Die Referenzeinheit Meter. Gemessen vom Meeresspiegel. SRID: 4326 WGS 84 altitude, alt (m), alt(m), alt Zahl Optional 1.53
Yaw Die Himmelsrichtung, in der das Bild erfasst wird. Gemessen in Grad (-180 to 180). 0 Grad zeigt Norden an camera heading, cameraheading, yaw (deg), yaw(deg), yaw Zahl Optional 122.5
Pitch Der vertikale Winkel der Kamera (-90 bis 90) zum Aufnahmezeitpunkt camera pitch, camerapitch, pitch (deg), pitch(deg), pitch Zahl Optional 10.2
Roll Der Horizontalwinkel der Kamera (-180 bis 180) zum Aufnahmezeitpunkt camera roll, camera roll, roll (deg), roll (deg), roll Zahl Optional 2.5
CameraTag Dies ist ein freier Text, der zum Identifizieren der Kamera verwendet wird, die das Bild aufzeichnet, und der zum Erstellen von Kamerafiltern in Grid Vision verwendet wird. z.B. nach vorne oder nach hinten gerichtete Kameras unterscheiden camera tag, cameratag Zeichenfolge 36 Optional Thermal

Beispiel für CSV

Filename,AssetIdentifier,CapturedAt,Latitude,Longitude,Altitude,Yaw,Pitch,Roll,CameraTag
MISSION1001_2020_000001.jpg,0001001,2020-02-26T08:48:44.7747628Z,59.125832,11.38942,1.53,122.5,10.2,2.5,Thermal
MISSION1001_2020_000002.jpg,0001001,2020-02-26T08:48:44.7749421Z,59.125842,11.38943,1.53,50.8,10.2,2.5,Camera1
Filename AssetIdentifier CapturedAt Latitude Longitude Altitude Yaw Pitch Roll CameraTag
MISSION1001_2020_000001.jpg 0001001 2020-02-26T08:48:44.7747628Z 59.125832 11.38942 1.53 122.5 10.2 2.5 Thermal
MISSION1001_2020_000002.jpg 0001001 2020-02-26T08:48:44.7749421Z 59.125842 11.38943 1.53 50.8 10.2 2.5 Camera1

Beispiel für JSON

[
    {
        "altitude": 1.53,
        "assetIdentifier": "0001001",
        "cameraTag": "Thermal",
        "capturedAt": "2020-02-26T08:48:44.7747628Z",
        "filename": "MISSION1001_2020_000001.jpg",
        "latitude": 59.125832,
        "longitude": 11.38942,
        "pitch": 10.2,
        "roll": 2.5,
        "yaw": 122.5,

    },
    {
        "altitude": 1.53,
        "assetIdentifier": "0001001",
        "cameraTag": "Camera1",
        "capturedAt": "2020-02-26T08:48:44.7749421Z",
        "filename": "MISSION1001_2020_000002.jpg",
        "latitude": 59.125842,
        "longitude": 11.38943,
        "pitch": 10.2,
        "roll": 2.5,
        "yaw": 50.8, 
    }
]