Cintoo Connect CLI (Befehlszeilenschnittstelle)

This article describes new opportunities that became available with release of Cintoo Connect CLI (command line interface) - a version without a graphical interface but with strong customization capabilities. This tool could be used to automate certain import/export tasks replacing classical interface of Cintoo Connect for users not familiar with it.

Once environment and parameters are set up, repetitive import/export tasks become simple and seamless. Moreover, implementation of specific internal procedures and data standards become real.

Note: Cintoo Connect version must be greater than 2.13 to have executable CLI file inside installation folder. Use the following link to download the latest version of Cintoo Connect.

INHALTSVERZEICHNIS

Berechtigungen
Hilfe
Verwendungsfälle
Liste der Importbefehle
Liste der Exportbefehle
API-Aufrufe-Leitfaden
Tipps und Einschränkungen

Berechtigungen

To use Cintoo Connect CLI users' roles must include:

Hochladen oder Löschen von Reality-Daten Berechtigung für den Scanimport
Exportieren oder Herunterladen von Reality-Daten Berechtigung für den Scan-Export

Hilfe

Use Help to discover more information about the process of using Cintoo Connect CLI with these commands in command line.

./cintooconnect-cli.exe --help
./cintooconnect-cli.exe [IMPORT-TYPE] --help

Verwendungsfälle

Erstellen Sie ein Python-Skript für den Batch-Import von Scans. Skriptbeispiel mit Kommentaren.
Erstellen Sie ein Python-Skript für den Batch-Export von Scans
Erstellen von organisation-spezifischen Workflows

With possibilities to:

Importpfad weiterleiten innerhalb eines Projekts
eine bestimmte Arbeitszone für den Export anvisieren
ereignisgesteuerte Skripte erstellen (z. B. automatischer Import in Cintoo, sobald ein Scan in einen Ordner verschoben wird)

Liste der Importbefehle

import-static --token=$token --tenant=$tenant --accountId=$accout_Id --projectId=$project_Id --workzoneId=$workzone_Id --file-ref=$file_ref

import-static --cintoo-uri=$job_uri --file-ref=$file_ref

Befehle zur Importierung von terrestrischen Scandaten. Anleitungen zur Erfassung von Token und IDs finden Sie in

API-Aufrufe-Leitfaden Abschnitt.

import-mobile --cintoo-uri=$job_uri --file-ref $local_file_path --device "$device_name" --position-sampling $position_sampling

Befehle zur Importierung von mobilen Scandaten ohne Scanpfad.

$device_name könnte die folgenden Werte haben:

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_sampling

Befehle zur Importierung von mobilen Scandaten mit Scanpfad.

$device_name könnte folgende Werte haben:

NavVis VLX und M6
GeoSLAM Zeb-Serie
Viametris Backpack Mobile Scanner
Emesent Hovermap
Allgemeine E57/LAS/LAZ

import-drone --cintoo-uri=$job_uri --file-ref $local_file_path --distance $distance_float

Befehl zum Importieren von Drohnenscandaten.

import-360-images --cintoo-uri=$job_uri --tenant=$tenant --accountId=$accout_Id --projectId=$project_Id --workzoneId=$workzone_Id --file-ref=$file_ref

Befehl zum Importieren von 360-Bilderdaten.

Hinweis: Die ergänzende CSV muss im selben Ordner wie die Bilder gespeichert werden.

List of Export Commands

export scans --cintoo-uri=$job_uri  --type structured  --format E57/RCP--destination-folder PATH  --destination-name TEXT

Command to export structured scan data.
Supported formats 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

Command to export unified scan data.

Supported formats E57,POD, RCS, RCP.

Anleitung API-Aufrufe

Token abrufen

Das Token wird bei der Authentifizierung bei Cintoo erhalten.
Besuchen Sie bitte API-Dokumentation um zu erfahren, wie das geht.
Finden Sie hier die besten Praktiken für Token-Nutzung.

Konto-ID abrufen

Bitte verwenden Sie den folgenden API-Aufruf, um alle Konten aufzulisten, und analysieren Sie dann, um die Konto-ID zu erhalten.

Projekt-ID abrufen

Wenn ein bestehendes Projekt vorhanden ist, verwenden Sie bitte den folgenden API-Aufruf, um alle Projekte aufzulisten, und analysieren Sie dann dies mit diesem API-Aufruf um die Projekt-ID abzurufen.

Wenn das Projekt erstellt werden soll, verwenden Sie bitte den folgenden API-Aufruf, um ein neues Projekt zu erstellen und dann seine ID abzurufen.

Arbeitszonen-ID abrufen

Wenn eine bestehende Arbeitszone existiert, verwenden Sie bitte den folgenden API-Aufruf um die Liste der Arbeitszonen abzurufen. Aus der Liste die benötigte Arbeitszonen-ID abrufen.

Wenn die Arbeitszone erstellt werden soll, verwenden Sie bitte den folgenden API-Aufruf, um eine neue Arbeitszone zu erstellen und ihre ID abzurufen.

Tipps und Einschränkungen

Daten können sowohl aus dem lokalen Speicher als auch aus dem Cloud-Speicher importiert werden, sodass sowohl ein lokaler Dateipfad als auch eine Cloud-URL verwendet werden können.
Um auf Clouddaten (AWS, Azure usw.) zuzugreifen, muss der Link eine Signatur enthalten und nur E57-formatierte Dateien werden 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

Bitte beachten Sie die Scan- und 360-Bilder-Kapazität für das Abonnement. Die gleichen Einschränkungen gelten für den Import über Cintoo Connect CLI wie für das Standardverfahren.
Die Kapazitäten der Scans/360-Bilder dürfen nicht überschritten werden.
Add the following parameter with any integer higher than 2 (default) to increase the number of cores to execute import/export faster (if PC capacity allows).
```
--nb-threads INTEGER RANGE
```
To specify a place where logs are saved for any job add the following command.
```
--log-path FILE
```