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
- Aide
- Cas d'usage
- Liste des commandes d'importation
- Liste des commandes d'exportation
- Guide des appels d'API
- Conseils et limitations
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] --helpCas 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_refimport-static --cintoo-uri=$job_uri --file-ref=$file_refCommandes pour importer des données de scan terrestre. Les instructions pour obtenir le jeton et les identifiants se trouvent dans la section
import-mobile --cintoo-uri=$job_uri --file-ref $local_file_path --device "$device_name" --position-sampling $position_samplingCommandes 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_samplingCommandes 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_floatCommande 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_refCommande 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
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
Commentaires envoyés
Nous apprécions vos efforts et nous allons corriger l'article