Cintoo Connect CLI (interface en ligne de commande)



Cet article décrit les nouvelles possibilités offertes par la sortie de Cintoo Connect CLI (interface en ligne de commande), une version sans interface graphique mais dotée de fortes capacités de personnalisation. Cet outil peut servir à automatiser certaines tâches d'importation et d'exportation, en remplacement de l'interface classique de Cintoo Connect, pour les utilisateurs qui ne la connaissent pas. 

Une fois l'environnement et les paramètres configurés, les tâches répétitives d'importation et d'exportation deviennent simples et fluides. De plus, la mise en œuvre de procédures internes spécifiques et de standards de données devient réalisable.


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


TABLE DES MATIÈRES


Autorisations

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

  • l'autorisation Importer ou supprimer des Reality Data pour l'importation de scans
  • l'autorisation Exporter ou télécharger des Reality Data pour l'exportation de scans

Aide

Utilisez l'aide pour obtenir plus d'informations sur l'utilisation de Cintoo Connect CLI avec ces commandes en ligne de commande.

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

Cas d'usage

  • Créez un script Python pour importer des scans par lots. Exemple de script avec commentaires.
  • Créez un script Python pour exporter des scans par lots
  • Créez des flux de travail propres à votre organisation


Avec la possibilité de :

  • diriger l'importation vers un chemin au sein d'un projet
  • cibler une zone de travail spécifique pour l'exportation
  • créer des scripts événementiels (par exemple, 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 le jeton et les identifiants se trouvent dans la section 

Guide des appels d'API.


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 trajectoire de scan.

$device_name peut prendre les valeurs suivantes :

  • 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

Commandes pour importer des données de scan mobile avec une trajectoire de scan.

$device_name peut prendre les valeurs suivantes :

  • 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_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°.


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


Liste des commandes d'exportation

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

Commande pour exporter des données de scan structurées. 
Formats pris en charge : 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

Commande pour exporter des données de scan unifiées.

Formats pris en charge : E57, POD, RCS, RCP.



Guide des appels d'API

  • Obtenir le jeton
Le jeton est obtenu lors de l'authentification à Cintoo. 
Veuillez consulter la documentation de l'API pour savoir comment procéder. 
Retrouvez ici les bonnes pratiques d'utilisation des jetons. 

  • Obtenir l'identifiant du compte

Veuillez utiliser l'appel d'API suivant pour lister tous les comptes, puis analyser le résultat afin de récupérer l'identifiant du compte.


  • Obtenir l'identifiant du projet

S'il existe déjà un projet, veuillez utiliser l'appel d'API suivant pour lister tous les projets, puis analyser le résultat avec cet appel d'API afin de récupérer l'identifiant du projet.

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


  • Obtenir l'identifiant de la zone de travail

S'il existe déjà une zone de travail, veuillez utiliser l'appel d'API suivant pour récupérer la liste des zones de travail. Dans cette liste, récupérez l'identifiant de la zone de travail dont vous avez besoin.

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


Conseils et limitations

  • Les données peuvent être importées aussi bien depuis un stockage local que depuis un stockage blob dans le cloud ; il est donc possible d'utiliser aussi bien un chemin de fichier local qu'une URL cloud. 
    Pour accéder à des données dans le cloud (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 tenir compte de la capacité de scans et d'images 360° prévue par l'abonnement. Les mêmes limitations que pour la procédure standard s'appliquent à l'importation via Cintoo Connect CLI. 
    Les capacités de scans et d'images 360° ne peuvent pas être dépassées.
  • Ajoutez le paramètre suivant avec un entier supérieur à 2 (valeur par défaut) pour augmenter le nombre de cœurs afin d'exécuter plus rapidement l'importation ou l'exportation (si la capacité du PC le permet).
    --nb-threads INTEGER RANGE

  • Pour indiquer l'emplacement où les journaux de n'importe quelle tâche sont enregistrés, ajoutez la commande suivante.
    --log-path FILE



Cet article a-t-il été utile ?

C'est super !

Merci pour votre commentaire

Désolé ! Nous n'avons pas pu vous être utile

Merci pour votre commentaire

Dites-nous comment nous pouvons améliorer cet article !

Sélectionner au moins l'une des raisons
La vérification CAPTCHA est requise.

Commentaires envoyés

Nous apprécions vos efforts et nous allons corriger l'article