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.
- Sicherheitszeichen
- 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,
}
]