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 determinadas tareas de importación y exportación, sustituyendo 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, es posible implementar procedimientos internos y estándares de datos específicos.
Nota: la versión de Cintoo Connect debe ser posterior a la 2.13 para que la carpeta de instalación contenga el archivo ejecutable de la CLI. Utilice el siguiente enlace para descargar la versión más reciente de Cintoo Connect.
TABLA DE CONTENIDOS
- 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 Help 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 posibilidades como:
- enrutar la ruta de importación dentro de un proyecto
- dirigirse a una zona de trabajo específica para la exportación
- crear scripts controlados por eventos (por ejemplo, importación automática en Cintoo cuando 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 y M6
- Serie GeoSLAM Zeb
- Viametris Backpack Mobile Scanner
- Emesent Hovermap
- E57/LAS/LAZ genérico
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 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 estructurado.
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 unificado.
Formatos compatibles: E57,POD, RCS, RCP.
Guía de llamadas a la API
- Obtener el token
Visite la documentación de la API para saber cómo hacerlo.
Consulte aquí las prácticas recomendadas para el uso del token.
- Obtener el ID de la cuenta
Utilice la siguiente llamada a la API para enumerar todas las cuentas y, a continuación, analice el resultado 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 enumerar todos los proyectos y, a continuación, analice el resultado con esta llamada a la API para obtener el ID del proyecto.
Si se va a crear el proyecto, utilice la siguiente llamada a la API para crear un nuevo proyecto y, a continuación, analice el resultado 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 la lista, obtenga el ID de la zona de trabajo que necesite.
Si se va a 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 el 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 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 escaneos y de imágenes 360 de la suscripción. Se aplican las mismas limitaciones a la importación mediante Cintoo Connect CLI que al procedimiento estándar.
No se pueden superar las capacidades de escaneos ni de 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 o la exportación más rápido (si la capacidad del PC lo permite).
--nb-threads INTEGER RANGE
- Para especificar un lugar donde se guarden 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