Ejecutar DataUploader

Sigue estos pasos para cargar datos utilizando DataUploader.

1. Descarga DataUploader.
2. Cree una carpeta y copie los archivos de entrada que desea cargar utilizando DataUploader en esta carpeta.
3. Abre un Windows Powershell.
4. Dirígete a la ubicación donde descargaste DataUploader.
5. Ejecuta uno de los siguientes comandos:
   Importante:

   Escriba cada valor de parámetro entre comillas.

process-mining-data-uploader.exe "<csv dir>" "<sas url>" "<end-of-upload api>"

process-mining-data-uploader.exe -c "<myfolder>" -s "<my-sas-uri>" -e "<my-end-of-upload-api>"

process-mining-data-uploader.exe --config-file "path\to\config\file"

Se muestra una barra de progreso para cada carga de archivos.

Cadena de comando de ejemplo

./process-mining-data-uploader.exe "data" "https://asdf.blob.core.windows.net/a28d10b0-6822-4xxy-a197-02zz39824ad4?sv=2020-06-12&si=sap-a58d10b0-6822-4ffc-a197-02ed649824ad4&sr=c&sig=WELk3bW8zpY5rL71lJ8pPPhlOq0odLNoQleY%2BL3nPqek%3D" "https://asdf.uipath.com/org/tenant/processmining_/api/v4.0/apps/a28d10b0-6822-4ffc-a197-02ed39824ad4/ingest/authenticated?AppSecretToken=A5B221CD00E77F02677G36H572IJKLM61N2440320O44666PQ4RS3T0U81410VW" "44"

Extracción incremental

Sigue estos pasos para ejecutar DataUploader con sincronización incremental.

1. Abre un Windows Powershell y navega a la ubicación donde descargaste el DataUploader.
2. Asegúrate de que todos los archivos de entrada siguen el formato de nombre requerido. Consulta Nomenclatura de archivos para sincronización incremental.
3. Ejecuta DataUploader con el parámetro --tables . El siguiente código muestra un comando de ejemplo.

   process-mining-data-uploader.exe -c "<csv dir>" -s "<sas url>" -e "<end-of-upload api>" --tables '[{"prefix": "pfx01", "name": "Table01", "load-type": "incremental"}, {"prefix": "pfx02", "name": "Table02", "load-type": "full"}]'
   

   Importante:

   Escriba cada valor de parámetro entre comillas.

Nota:

Después de cada ejecución, DataUploader guarda el estado de sincronización en un archivo en la misma carpeta que el ejecutable.

Nota:

Los archivos cuyo prefijo no coincida con ninguna entrada en el parámetro --tables se ignoran. Cuando no se proporciona --tables , se cargan todos los archivos de la carpeta.

Nomenclatura de archivos para sincronización incremental

Todos los archivos destinados a la ingestión incremental deben seguir este formato de nombres:

<table-prefix>_<any text>_<yyyymmdd>T<HHMMSS>.<extension>

Ejemplo:

pfx01_filename-part-not-read-by-data-uploader_20240221T142100.csv

Parte	Descripción
<table-prefix>	Debe coincidir con un prefijo definido en el parámetro --tables . No debe contener guiones bajos.
<any text>	Cualquier texto descriptivo. No utilizado por DataUploader.
<yyyymmdd>T<HHMMSS>	Marca de tiempo de la extracción de datos del origen. T separa la fecha y la hora.
<extension>	Cualquier extensión de archivo.

Solución de problemas

Tamaño máximo de archivo

El tamaño máximo de archivo (por archivo) es de 5 TB.

NúmeroDeReintentos

Si la carga falla, por ejemplo, debido a una conexión inestable, DataUploader volverá a intentar la carga hasta 4 veces. Si la carga de datos no se ha realizado correctamente después de 5 veces, se crea un informe.

ADVERTENCIA:

Bajo ciertas configuraciones de red, DataUploader no puede alcanzar la API de fin de carga debido a un certificado autofirmado, y obtendrás el error UNABLE_TO_GET_ISSUER_CERT_LOCALLY. Esto se puede resolver dirigiendo DataUploader al certificado de la autoridad de certificación (AC) de tu organización. Sigue estos pasos.

1. Crea una variable de entorno llamada NODE_EXTRA_CA_CERTS.
2. Establece el valor de la nueva variable de entorno en la ruta del archivo de tu certificado de CA.

En caso de que algunos de los archivos hayan fallado en la carga, puedes reiniciar DataUploader utilizando el mismo comando y con los mismos archivos.

Llamar al final de la API de carga

¿Qué sucede si mis archivos se cargan, pero no se llama al punto final de carga?

Ocasionalmente, puede ocurrir que la API de fin de carga no se llame correctamente, incluso después de cargar todos los archivos. Si no ves el siguiente registro después de cargar los archivos desde el cargador de datos, significa que la API de fin de carga no se ha llamado correctamente:

End-of-upload API reached successfully, data transformation started.

En este caso, puedes copiar y ejecutar el siguiente código en una sesión de PowerShell para llamar a la API de Fin de carga.

$endOfUploadUri = "*******"
$delimiter = 9 # you can change this to the ascii of the character of your choice
$fullUri = "$endOfUploadUri&dataLoadOptionsJson=%7B%22UseSampleData%22%3Afalse%2C%22FileFormatOptions%22%3A%7B%22FieldDelimiter%22%3A%22$delimiter%22%7D%7D"
$response = Invoke-WebRequest -Uri $fullUri -Method POST
Write-Output $response.StatusCode

Certificados

ADVERTENCIA:

Bajo ciertas configuraciones de red, DataUploader no puede llegar a la API de fin de carga debido a un certificado autofirmado, y obtendrás un error como UNABLE_TO_GET_ISSUER_CERT_LOCALLY. Puedes solucionarlo proporcionando DataUploader con la cadena de certificados válida.

Sigue estos pasos para proporcionar DataUploader con la cadena de certificados válida.

1. Ve al Portal de Process Mining y desde la pestaña Aplicaciones de proceso , abre la aplicación de proceso.

2. Navega a la barra de direcciones en el navegador web y selecciona el icono Ver información del sitio a la izquierda en la barra de direcciones.

   

3. Selecciona La conexión es segura y luego selecciona El certificado es válido para mostrar el certificado.

   

4. Ve a la pestaña Detalles y expande la Jerarquía de certificados.

5. Selecciona la entrada cloud.uipath.com y selecciona Exportar....

   

6. Selecciona una ubicación para guardar el archivo de certificado en tu ordenador y asegúrate de guardarlo como ASCII de tipo Base64 codificado, cadena de certificados (*.pem;*crt).

   El archivo cloud.uipath.crt aparecerá en la ubicación seleccionada.

7. Crea una variable de entorno NODE_EXTRA_CA_CERTS y establece el valor de esta variable en la ruta completa del archivo del certificado seleccionado en el paso 6 (incluida la ruta de la carpeta, el nombre del archivo y la extensión del archivo)

   1. Abre las Propiedades del sistema de Windows.
   2. Go to the Advanced tab.
   3. Selecciona Variables de entorno.
   4. Selecciona Nuevo para añadir una nueva variable del sistema.

8. Inicia una nueva sesión de PowerShell para asegurarte de que DataUploader reconozca la variable de entorno.