Cintoo Connect CLI (Interface en ligne de commande)

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.

TABLE DES MATIÈRES

Autorisations
Aide
Cas d'utilisation
Liste des commandes d'importation
Liste des commandes d'exportation
Guide des appels API
Conseils et limitations

Autorisations

To use Cintoo Connect CLI users' roles must include:

Télécharger ou Supprimer les données de réalité autorisation pour l'importation de scan
Exporter ou Télécharger les données de réalité autorisation pour l'exportation de scan

Aide

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

Cas d'utilisation

Créez un script Python pour importer des scans en lot. Exemple de script avec des commentaires.
Créez un script Python pour exporter des scans en lot
Créez des flux de travail spécifiques à l'organisation

With possibilities to:

acheminer le chemin d'importation à l'intérieur d'un projet
cibler une zone de travail spécifique pour l'exportation
créer des scripts déclenchés par des événements (par exemple, l'importation automatique dans Cintoo dès qu'un scan est placé dans un dossier)

Liste des commandes d'importation

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

Commandes pour importer des données de scan terrestre. Les instructions pour obtenir token et IDs peuvent être trouvées dans

Guide des appels API section.

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

Commandes pour importer des données de scan mobile sans chemin de scan.

$device_name pourrait prendre les valeurs suivantes:

GeoSLAM Zeb Structuré
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

Commandes pour importer des données de scan mobile avec un chemin de scan.

$device_name pourrait prendre les valeurs suivantes:

NavVis VLX et M6
Série GeoSLAM Zeb
Scanner mobile Viametris Backpack
Emesent Hovermap
Générique E57/LAS/LAZ

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

Commande pour importer des données de scan par drone.

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

Commande pour importer des données d'images à 360 degrés.

Note: le fichier CSV complémentaire doit être stocké dans le même dossier que les images.

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.

Guide des appels API

Obtenir un token

Le token est obtenu lors de l'authentification à Cintoo.
Veuillez visiter la documentation de l'API pour savoir comment faire.
Trouvez ici les meilleures pratiques pour l'utilisation des tokens.

Obtenir l'ID de compte

Veuillez utiliser l'appel API suivant pour lister tous les comptes, puis analyser pour récupérer l'ID du compte.

Obtenir l'ID de projet

S'il existe un projet, veuillez utiliser l'appel API suivant pour lister tous les projets puis analyser avec cet appel API pour récupérer l'ID du projet.

Si le projet doit être créé, veuillez utiliser l'appel API suivant pour créer un nouveau projet, puis analyser pour récupérer son ID.

Obtenir l'ID de la zone de travail

S'il existe une zone de travail, veuillez utiliser l'appel API suivant pour récupérer la liste des zones de travail. Dans la liste, récupérez l'ID de la zone de travail nécessaire.

Si la zone de travail doit être créée, veuillez utiliser l'appel API suivant pour créer une nouvelle zone de travail et récupérer son ID.

Conseils et limitations

Les données peuvent être importées à la fois depuis un stockage local et un stockage en nuage, donc à la fois un chemin de fichier local et une URL de nuage peuvent être utilisés.
Pour accéder aux données en nuage (AWS, Azure, etc.), le lien doit inclure une signature et seuls les fichiers au format E57 sont acceptés.
Exemples de chemins :

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

Veuillez être conscient de la capacité de scan et d'images à 360 degrés pour l'abonnement. Les mêmes limitations s'appliquent pour l'importation via Cintoo Connect CLI que pour la procédure standard.
Les capacités de scan/360 images ne peuvent pas être dépassées.
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
```