Cintoo Connect CLI (Interface en ligne de commande)

Cet article décrit les nouvelles opportunités disponibles avec la sortie de Cintoo Connect CLI (interface de ligne de commande) - une version sans interface graphique mais avec de fortes capacités de personnalisation. Cet outil pourrait être utilisé pour automatiser certaines tâches d'importation/exportation, remplaçant l'interface classique de Cintoo Connect pour les utilisateurs qui ne le connaissent pas.

Une fois que l'environnement et les paramètres sont configurés, les tâches répétitives d'import/export deviennent simples et fluides. De plus, la mise en œuvre de procédures internes spécifiques et de normes de données devient réelle.

Note : la version de Cintoo Connect doit être supérieure à 2.13 pour avoir le fichier CLI exécutable dans le dossier d'installation. Utilisez le lien suivant pour télécharger la dernière version de Cintoo Connect.

TABLE DES MATIÈRES

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

Permissions

Pour utiliser Cintoo Connect CLI, les rôles des utilisateurs doivent inclure :

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

Aide

Utilisez Aide pour découvrir plus d'informations sur le processus d'utilisation de Cintoo Connect CLI avec ces commandes en ligne de commande.

./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

Avec des possibilités de :

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-image --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.

Liste des commandes d'exportation

export --cintoo-uri=$job_uri --structured False --destination $destination_path --decimation $float_decimation

Commande pour exporter des données de scan non structurées avec une décimation définie.

export --cintoo-uri=$job_uri  --structured False --destination $destination_path

Commande pour exporter des données de scan non structurées.

Pour choisir le format de fichier, ajoutez-le à la fin de $destinationPath (par exemple : export/file.e57).
Formats supportés E57,POD, RCS, RCP.

export --cintoo-uri=$job_uri  --structured True --destination $destination_path

Commande pour exporter des données de scan structurées.
Pour choisir le format de fichier, ajoutez-le à la fin de $destinationPath (par exemple : export/file.rcp).
Formats supportés E57, 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.
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.

Ajoutez le paramètre suivant avec un entier supérieur à 2 (par défaut) pour augmenter le nombre de cœurs afin d'exécuter l'import/export plus rapidement (si la capacité du PC le permet).
```
--nb-threads INTERVALLE D'ENTIERS
```