Este artículo describe las nuevas posibilidades disponibles con el lanzamiento de Cintoo Connect CLI (interfaz de línea de comandos), una versión sin interfaz gráfica pero con amplias capacidades de personalización. Esta herramienta se puede utilizar para automatizar ciertas tareas de importación y exportación, en sustitución de la interfaz clásica de Cintoo Connect, para los usuarios que no están familiarizados con ella.
Una vez configurados el entorno y los parámetros, las tareas repetitivas de importación y exportación resultan sencillas y fluidas. Además, la implementación de procedimientos internos y estándares de datos específicos se vuelve una realidad.
Nota: la versión de Cintoo Connect debe ser superior a 2.13 para que el archivo ejecutable de la CLI se encuentre dentro de la carpeta de instalación. Utilice el siguiente enlace para descargar la última versión de Cintoo Connect.
TABLA DE CONTENIDO
- Permisos
- Ayuda
- Casos de uso
- Lista de comandos de importación
- Lista de comandos de exportación
- Guía de llamadas a la API
- Consejos y limitaciones
Permisos
Para utilizar Cintoo Connect CLI, los roles de los usuarios deben incluir:
- El permiso Importar o eliminar Reality Data para la importación de escaneos
- El permiso Exportar o descargar Reality Data para la exportación de escaneos
Ayuda
Utilice la ayuda para obtener más información sobre el proceso de uso de Cintoo Connect CLI con estos comandos en la línea de comandos.
./cintooconnect-cli.exe --help
./cintooconnect-cli.exe [IMPORT-TYPE] --helpCasos de uso
- Cree un script de Python para importar escaneos por lotes. Ejemplo de script con comentarios.
- Cree un script de Python para exportar escaneos por lotes
- Cree flujos de trabajo específicos de la organización
Con la posibilidad de:
- definir la ruta de importación dentro de un proyecto
- seleccionar una zona de trabajo específica como destino de la exportación
- crear scripts basados en eventos (p. ej., importación automática en Cintoo en cuanto se coloca un escaneo 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_refimport-static --cintoo-uri=$job_uri --file-ref=$file_refComandos para importar datos de escaneo terrestre. Las instrucciones para obtener el token y los ID se encuentran en la sección
import-mobile --cintoo-uri=$job_uri --file-ref $local_file_path --device "$device_name" --position-sampling $position_samplingComandos para importar datos de escaneo móvil sin trayectoria de escaneo.
$device_name puede tomar los siguientes valores:
- 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_samplingComandos para importar datos de escaneo móvil con trayectoria de escaneo.
$device_name puede tomar los siguientes valores:
- 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_floatComando para importar datos de escaneo de dron.
import-360-images --cintoo-uri=$job_uri --tenant=$tenant --accountId=$accout_Id --projectId=$project_Id --workzoneId=$workzone_Id --file-ref=$file_refComando para importar datos de imágenes 360.
Nota: el archivo CSV complementario debe almacenarse en la misma carpeta que las imágenes.
Lista de comandos de exportación
export scans --cintoo-uri=$job_uri --type structured --format E57/RCP--destination-folder PATH --destination-name TEXT
Comando para exportar datos de escaneo estructurados.
Formatos compatibles: 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
Comando para exportar datos de escaneo unificados.
Formatos compatibles: E57,POD, RCS, RCP.
Guía de llamadas a la API
- Obtener el token
Consulte la documentación de la API para saber cómo hacerlo.
Encuentre aquí las prácticas recomendadas para el uso de tokens.
- Obtener el ID de la cuenta
Utilice la siguiente llamada a la API para obtener la lista de todas las cuentas y, a continuación, analice la respuesta para obtener el ID de la cuenta.
- Obtener el ID del proyecto
Si ya existe un proyecto, utilice la siguiente llamada a la API para obtener la lista de todos los proyectos y, a continuación, analice la respuesta con esta llamada a la API para obtener el ID del proyecto.
Si hay que crear el proyecto, utilice la siguiente llamada a la API para crear un nuevo proyecto y, a continuación, analice la respuesta para obtener su ID.
- Obtener el ID de la zona de trabajo
Si ya existe una zona de trabajo, utilice la siguiente llamada a la API para obtener la lista de zonas de trabajo. De esa lista, obtenga el ID de la zona de trabajo que necesite.
Si hay que crear la zona de trabajo, utilice la siguiente llamada a la API para crear una nueva zona de trabajo y obtener su ID.
Consejos y limitaciones
- Los datos se pueden importar tanto desde el almacenamiento local como desde un almacenamiento de blobs 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 la firma y solo se aceptan archivos en 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 escaneos e imágenes 360 de la suscripción. Para la importación mediante Cintoo Connect CLI se aplican las mismas limitaciones que para el procedimiento estándar.
No se pueden superar las capacidades de escaneos/imágenes 360. - Agregue el siguiente parámetro con cualquier número entero superior a 2 (valor predeterminado) para aumentar el número de núcleos y ejecutar la importación/exportación con mayor rapidez (si la capacidad del equipo lo permite).
--nb-threads INTEGER RANGE
- Para especificar la ubicación donde se guardan los registros de cualquier trabajo, agregue el siguiente comando.
--log-path FILE
¿Le fue útil este artículo?
¡Qué bueno!
Gracias por sus comentarios
¡Sentimos mucho no haber sido de ayuda!
Gracias por sus comentarios
Comentarios enviados
Agradecemos su iniciativa, e intentaremos corregir el artículo