Cintoo Connect CLI (Interfaz de Línea de Comandos)

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.

ÍNDICE DE CONTENIDOS

Permisos
Ayuda
Casos de Uso
Lista de Comandos de Importación
Lista de Comandos de Exportación
Guía de Llamadas API
Consejos y limitaciones

Permisos

To use Cintoo Connect CLI users' roles must include:

Permiso para Cargar o Borrar Datos de Realidad para la importación de escaneos
Permiso para Exportar o Descargar Datos de Realidad para la exportación de escaneos

Ayuda

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

Casos de Uso

Crear un script en Python para importación por lotes de escaneos. Ejemplo de script con comentarios.
Crear un script en Python para exportación por lotes de escaneos
Crear flujos de trabajo específicos de la organización

With possibilities to:

redirigir la ruta de importación dentro de un proyecto
dirigir a una zona de trabajo específica para exportación
crear scripts impulsados por eventos (por ejemplo, importación automática en Cintoo una vez que el escaneo se coloca en una carpeta)

Lista de Comandos de Importación

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

Comandos para importar datos de escaneo terrestres. Las instrucciones para obtener el token y las IDs se pueden encontrar en

Guía de Llamadas API sección.

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

Comandos para importar datos de escaneo móviles sin ruta de escaneo.

$device_name podría tomar los siguientes valores:

GeoSLAM Zeb Estructurado
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

Comandos para importar datos de escaneo móviles con una ruta de escaneo.

$device_name podría tomar los siguientes valores:

NavVis VLX y M6
Serie GeoSLAM Zeb
Escáner móvil de mochila Viametris
Emesent Hovermap
Genérico E57/LAS/LAZ

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

Comando para importar datos de escaneo de drones.

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

Comando para importar datos de imágenes 360.

Nota: el CSV complementario debe almacenarse en la misma carpeta que las imágenes.

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.

Guía de Llamadas API

Obtener token

El token se obtiene al autenticarse en Cintoo.
Por favor visite documentación de API para aprender cómo hacerlo.
Encuentre aquí las mejores prácticas para el uso del token.

Obtener ID de cuenta

Por favor use la siguiente llamada API para listar todas las cuentas; luego analice la respuesta para recuperar el ID de cuenta.

Obtener ID de proyecto

Si existe un proyecto, por favor use la siguiente llamada API para listar todos los proyectos y luego analice con esta llamada API para recuperar el ID del proyecto.

Si se va a crear el proyecto, por favor use la siguiente llamada API para crear un nuevo proyecto y luego analice la respuesta para recuperar su ID.

Obtener ID de zona de trabajo

Si hay una zona de trabajo existente, please use la siguiente llamada API para recuperar la lista de zonas de trabajo. De la lista recupere el ID de zona de trabajo necesario.

Si se va a crear la zona de trabajo, por favor use la siguiente llamada API para crear una nueva zona de trabajo y recuperar su ID.

Consejos y limitaciones

Los datos pueden ser importados tanto del almacenamiento local como del almacenamiento en la nube, por lo que se puede utilizar tanto una ruta de archivo local como una URL de la nube.
Para acceder a datos en la nube (AWS, Azure, etc.) el enlace debe incluir una firma y solo se aceptan archivos con formato E57.
Ejemplos de rutas:

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

Tenga en cuenta la capacidad de escaneo e imágenes 360 para la suscripción. Las mismas limitaciones se aplican para la importación a través de Cintoo Connect CLI que para el procedimiento estándar.
Las capacidades de escaneo/imágenes 360 no pueden ser excedidas.
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
```