Dieser Artikel beschreibt die neuen Möglichkeiten, die mit der Veröffentlichung von Cintoo Connect CLI (Befehlszeilenschnittstelle) verfügbar geworden sind. Dabei handelt es sich um eine Version ohne grafische Oberfläche, aber mit umfangreichen Anpassungsmöglichkeiten. Mit diesem Tool lassen sich bestimmte Import-/Exportaufgaben automatisieren; es ersetzt damit die klassische Oberfläche von Cintoo Connect für Nutzer, die mit dieser nicht vertraut sind.
Sobald Umgebung und Parameter eingerichtet sind, werden wiederkehrende Import-/Exportaufgaben einfach und nahtlos. Außerdem wird die Umsetzung spezifischer interner Verfahren und Datenstandards realisierbar.
Hinweis: Die Version von Cintoo Connect muss höher als 2.13 sein, damit sich im Installationsordner eine ausführbare CLI-Datei befindet. Verwenden Sie den folgenden Link, um die neueste Version von Cintoo Connect herunterzuladen.
INHALTSVERZEICHNIS
- Berechtigungen
- Hilfe
- Anwendungsfälle
- Liste der Importbefehle
- Liste der Exportbefehle
- Leitfaden zu API-Aufrufen
- Tipps und Einschränkungen
Berechtigungen
Um Cintoo Connect CLI zu verwenden, müssen die Rollen der Nutzer Folgendes umfassen:
- Die Berechtigung Importieren oder Löschen der Reality Data für den Scan-Import
- Die Berechtigung Exportieren oder Herunterladen von Reality Data für den Scan-Export
Hilfe
Verwenden Sie die Hilfe, um weitere Informationen zur Verwendung von Cintoo Connect CLI mit diesen Befehlen in der Befehlszeile zu erhalten.
./cintooconnect-cli.exe --help
./cintooconnect-cli.exe [IMPORT-TYPE] --helpAnwendungsfälle
- Erstellen Sie ein Python-Skript zum Batch-Import von Scans. Skriptbeispiel mit Kommentaren.
- Erstellen Sie ein Python-Skript zum Batch-Export von Scans
- Erstellen Sie organisationsspezifische Workflows
Dabei können Sie:
- den Importpfad festlegen (innerhalb eines Projekts)
- für den Export eine bestimmte Arbeitszone als Ziel festlegen
- ereignisgesteuerte Skripte erstellen (z. B. automatischer Import in Cintoo, sobald ein Scan in einem Ordner abgelegt wird)
Liste der Importbefehle
import-static --token=$token --tenant=$tenant --accountId=$accout_Id --projectId=$project_Id --workzoneId=$workzone_Id --file-ref=$file_refimport-static --cintoo-uri=$job_uri --file-ref=$file_refBefehle zum Importieren terrestrischer Scandaten. Anweisungen zum Abrufen von Token und IDs finden Sie im Abschnitt
import-mobile --cintoo-uri=$job_uri --file-ref $local_file_path --device "$device_name" --position-sampling $position_samplingBefehle zum Importieren mobiler Scandaten ohne Scanpfad.
$device_name kann die folgenden Werte annehmen:
- GeoSLAM Zeb Structured
- Leica BLK2GO
- NavVis Ivion
import-mobile --cintoo-uri=$job_uri --file-ref $local_file_path --device "$device_name" --scanning-path $scanning_path --position-sampling $position_samplingBefehle zum Importieren mobiler Scandaten mit Scanpfad.
$device_name kann die folgenden Werte annehmen:
- NavVis VLX and M6
- GeoSLAM Zeb series
- Viametris Backpack Mobile Scanner
- Emesent Hovermap
- Generic E57/LAS/LAZ
import-drone --cintoo-uri=$job_uri --file-ref $local_file_path --distance $distance_floatBefehl zum Importieren von Drohnen-Scandaten.
import-360-images --cintoo-uri=$job_uri --tenant=$tenant --accountId=$accout_Id --projectId=$project_Id --workzoneId=$workzone_Id --file-ref=$file_refBefehl zum Importieren von 360°-Bilddaten.
Hinweis: Die ergänzende CSV-Datei muss im selben Ordner wie die Bilder gespeichert werden.
Liste der Exportbefehle
export scans --cintoo-uri=$job_uri --type structured --format E57/RCP--destination-folder PATH --destination-name TEXT
Befehl zum Exportieren strukturierter Scandaten.
Unterstützte Formate: E57, RCP.
export scans --cintoo-uri=$job_uri --type unified --format E57/POD/RCS/RCP --decimation-spacing FLOAT RANGE --destination-folder PATH --destination-name TEXT
Befehl zum Exportieren vereinheitlichter Scandaten.
Unterstützte Formate: E57, POD, RCS, RCP.
Leitfaden zu API-Aufrufen
- Token abrufen
Besuchen Sie die API-Dokumentation, um zu erfahren, wie das geht.
Hier finden Sie die bewährten Vorgehensweisen für die Verwendung von Token.
- Konto-ID abrufen
Verwenden Sie den folgenden API-Aufruf, um alle Konten aufzulisten, und werten Sie das Ergebnis anschließend aus, um die Konto-ID zu ermitteln.
- Projekt-ID abrufen
Wenn bereits ein Projekt vorhanden ist, verwenden Sie den folgenden API-Aufruf, um alle Projekte aufzulisten, und werten Sie das Ergebnis anschließend mit diesem API-Aufruf aus, um die Projekt-ID zu ermitteln.
Wenn das Projekt erstellt werden soll, verwenden Sie den folgenden API-Aufruf, um ein neues Projekt zu erstellen, und werten Sie das Ergebnis anschließend aus, um dessen ID zu ermitteln.
- Arbeitszonen-ID abrufen
Wenn bereits eine Arbeitszone vorhanden ist, verwenden Sie den folgenden API-Aufruf, um die Liste der Arbeitszonen abzurufen. Ermitteln Sie aus der Liste die benötigte Arbeitszonen-ID.
Wenn die Arbeitszone erstellt werden soll, verwenden Sie den folgenden API-Aufruf, um eine neue Arbeitszone zu erstellen und deren ID zu ermitteln.
Tipps und Einschränkungen
- Daten können sowohl aus dem lokalen Speicher als auch aus dem Cloud-Blob-Speicher importiert werden, sodass sowohl ein lokaler Dateipfad als auch eine Cloud-URL verwendet werden kann.
Für den Zugriff auf Cloud-Daten (AWS, Azure usw.) muss der Link eine Signatur enthalten, und es werden nur Dateien im E57-Format akzeptiert.
Beispiele für Pfade:
C:\data\Scans\Mobile\Scan
https://myaccount.blob.core.windows.net/mycontainer/myblob.txt?sv=2021-08-06&st=2024-02-28T10%3A00%3A00Z&se=2024-02-29T10%3A00%3A00Z&sr=b&sp=r&sig=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx%3D
- Beachten Sie die Kapazität des Abonnements für Scans und 360°-Bilder. Für den Import über Cintoo Connect CLI gelten dieselben Einschränkungen wie für das Standardverfahren.
Die Kapazitäten für Scans/360°-Bilder dürfen nicht überschritten werden. - Fügen Sie den folgenden Parameter mit einer beliebigen ganzen Zahl größer als 2 (Standardwert) hinzu, um die Anzahl der Kerne zu erhöhen und Import/Export schneller auszuführen (sofern die Leistung des PCs dies zulässt).
--nb-threads INTEGER RANGE
- Um für einen beliebigen Job festzulegen, wo die Protokolle (Logs) gespeichert werden, fügen Sie den folgenden Befehl hinzu.
--log-path FILE
War dieser Artikel hilfreich?
Das ist großartig!
Vielen Dank für das Feedback
Leider konnten wir nicht helfen
Vielen Dank für das Feedback
Feedback gesendet
Wir wissen Ihre Bemühungen zu schätzen und werden versuchen, den Artikel zu korrigieren