Tipos de cadena de conexión

Introducción

Hay varios tipos de cadenas de conexión que se pueden utilizar. Esta guía describe los diferentes tipos de cadenas de conexión.

Archivos

Los archivos se pueden cargar en una tabla estableciendo un parámetro de controlador de la cadena de conexión en {mvfile}.

driver={mvfile}

Se pueden cargar los siguientes tipos de archivos:

• Archivos de Excel .xls y .xlsx
• Archivos de texto .csv, .tsvy .txt

Se pueden especificar parámetros adicionales para cargar archivos.

A continuación se muestra una descripción general de los parámetros genéricos que están disponibles o que cargan archivos.

Parámetro	Descripción
Nombre de archivo	Esta puede ser una ruta relativa a un archivo en el servidor o una URL HTTP. Cuando el archivo está en el servidor, el archivo debe colocarse en la pestaña Datos de desarrollo o Datos del servidor , y el ámbito de la tabla debe establecerse en consecuencia. Cuando usas una URL HTTP, puedes especificar los parámetros user y pass para la autenticación.
ext	De forma predeterminada, la extensión del nombre del archivo se utiliza para determinar el tipo de archivo, pero esto se puede anular.
Usuario	El nombre de usuario para el archivo remoto al utilizar una URL HTTP.
aprobar	La contraseña para el archivo remoto cuando se usa una URL HTTP.

Archivos de Excel

A continuación se muestra una descripción general de los parámetros adicionales que se pueden utilizar para cargar archivos de Excel.

Parámetro	Descripción
Hoja	La hoja o rango con nombre que se va a importar. Para los nombres de hojas, se debe añadir un carácter de signo de dólar al final. Si no se especifica, se cargará la primera hoja.
Primera columna	La primera columna desde la que comenzar. La configuración predeterminada es {autodetect}.
Primera fila	La primera línea por la que empezar. La configuración predeterminada es {autodetect}.

La tabla siguiente contiene cadenas de conexión de ejemplo para cargar archivos de Excel.

Cadena de conexión	Cargas ...
'driver={mvfile}; filename=Data/Dataset.xlsx;'	la primera hoja de un archivo de Excel
'driver={mvfile}; filename=Data/Dataset.xlsx; sheet=MySheet$;'	la hoja llamada 'MySheet'

Archivos de texto

A continuación, se resumen los parámetros adicionales que pueden usarse para cargar Archivos de texto.

Parámetro	Descripción
Contiene encabezado	Si la primera fila del archivo es una fila de encabezado. La configuración predeterminada es {true}.
delimitar	El carácter delimitador. La configuración predeterminada es {tab}.
cita	El carácter utilizado para entrecomillar valores. La configuración predeterminada es {autodetect}.
escapar	El carácter utilizado para evitar caracteres. La configuración predeterminada es {none}.
Codificación	La codificación utilizada en el archivo, p. Ej., UTF8 o LATIN1. La configuración predeterminada es {UTF8}.

La siguiente tabla contiene cadenas de conexión de ejemplo para cargar archivos de texto.

Cadena de conexión	Carga un archivo de texto ...
driver={mvfile}; filename=Textfile.txt; delim=,; quote=";'	con comas (,) separadores y comillas "
'driver={mvfile}; filename=Textfile.txt; delim=|; quote=";'	con separadores de barra vertical (|) y comillas
"driver={mvfile}; filename=Textfile.txt; delim=9; quote=';"	con separadores de pestañas y comillas
'driver={mvfile}; filename=Textfile.txt; delim=59; quote=none;'	con separadores de punto y coma y sin comillas
'driver={mvfile}; filename=Textfile.txt; delim=,; quote="; escape=\;'	con comas (,), comillas y caracteres de escape
'driver={mvfile}; filename=http://www.example.com/files/example.txt;'	desde un servidor web
'driver={mvfile}; filename=http://www.example.com/files/example.txt; User=Jane; mv-credential-Pass=example_com_credentials'	desde un servidor web con autenticación de acceso básica

ODBC

ODBC se utiliza para conectarse a fuentes de datos externas, normalmente bases de datos. Puedes hacerlo usando el sistema operativo, como el administrador de orígenes de datos ODBC en Microsoft Windows, o proporcionar directamente la cadena de conexión en el formato correcto.

Es posible que el controlador ODBC necesite una consulta para ejecutarse. La consulta que debe ejecutarse en la base de datos se puede proporcionar como una cadena en el campo Consulta .

Importante: al probar una conexión ODBC, asegúrate de que el campo Consulta contiene una consulta válida.

Importante: Se puede acceder a todas las bases de datos que tienen una versión de 64 bit con una conexión ODBC. El controlador ODBC de 64 bits necesario debe estar instalado en el servidor Process Mining de UiPath, y el servidor debe poder acceder a ese sistema específico.

A continuación se muestra una descripción general de los parámetros que se pueden utilizar para las conexiones ODBC.

Parámetro	Descripción
controlador	El controlador ODBC que se utilizará para esta conexión. No es necesario cuando se utiliza el parámetro 'dsn' .
dsn	El DSN de la ODBC se utilizará para esta conexión. No se necesitará al usar el parámetro 'driver'. Nota: al configurar un DSN para utilizar en la cadena de conexión, asegúrate de que es un DSN de sistema de 64 bits.
Usuario	Nombre de usuario que se utilizará para conectarse a la fuente de datos externa.
aprobar	Contraseña que se utilizará para conectarse a la fuente de datos externa.
Otro	Cualquier otro parámetro se pasa como se especifica al controlador ODBC.

La tabla siguiente contiene cadenas de conexión de ejemplo para conexiones ODBC.

Cadena de conexión	Conecta ...
'Driver={SQL Server Native Client 11.0};Server=SERVERNAME;Database=MyDatabase;'	a una base de datos de SQL Server
'Driver={Oracle in OraClient12Home1};Dbq=MyTSN;'	a una base de datos de Oracle
«DSN = MyDSN; Usuario = MyUser; Pase = MyPass; '	utilizar un DSN configurado con un nombre de usuario y una contraseña

Tanto la cadena de conexión como el campo de consulta son expresiones. Por ejemplo, se podría crear una tabla de cadenas de conexión a una base de datos imaginaria.

Consulta la siguiente ilustración.

Nota: Los datos de la tabla solo se pueden utilizar cuando la tabla se ha cargado. En este ejemplo, se necesita la tabla Globals para usar datos de otras tablas.

Consejos y trucos

Para conocer los formatos de las cadenas de conexión de otros sistemas, consulta al proveedor de ese sistema o a un recurso en línea como https://www.connectionstrings.com/.

Si el usuario con acceso a la base de datos es un usuario de Windows, asegúrese de que este usuario de Windows:

• es una cuenta de servicio y no un usuario real.
• tiene acceso de lectura / escritura en la carpeta de instalación de Process Mining .
• es el usuario que ejecuta los scripts (por ejemplo, en las tareas programadas) para la carga de datos.
• se utiliza para ejecutar el grupo de aplicaciones en IIS.

SAP HANA

Puede usar una conexión ODBC para conectarse a SAP HANA.

A continuación se muestra una cadena de conexión de ejemplo para SAP HANA.

'Driver={HDBODBC};User=MyUser;Pass=MyPass;ServerNode=MyServer:30015;DatabaseName=TDB1'

Nota: en lugar de conectarse a una base de datos SAP, se recomienda utilizar el tipo de cadena de conexión SAP para conectarse al servidor de aplicaciones SAP.

Scripts genéricos

Puede usar una cadena de conexión para ejecutar un script y cargar datos de fuentes de datos.

Importante: El controlador de scripts que desea ejecutar debe estar instalado en el servidor de UiPath Process Mining .

Los archivos se pueden cargar en una tabla estableciendo el parámetro del controlador de la cadena de conexión en {mvscript} y el parámetro de script en "genérico":

driver={mvscript}; script=generic

Nota: debes especificar los parámetros del script en el campo Consulta utilizando la codificación de URL.

A continuación se muestra una descripción general de los parámetros que se pueden especificar en el campo Consulta .

Parámetro	Descripción	Obligatorio / Opcional
scriptText	El texto del script.	Obligatorio Nota: solo si no se utiliza scriptFile .
scriptFile	Nombre de archivo desde el que cargar el script. Esta puede ser una ruta relativa a un archivo en el servidor. Cuando el archivo está en el servidor, el archivo debe colocarse en la pestaña Datos de desarrollo o Datos del servidor , y el ámbito de la tabla debe establecerse en consecuencia.	Obligatorio Nota: solo si no se utiliza scriptText .
Datos de entrada	Un texto separado por punto y coma con encabezados de columna que contiene la entrada del script. Nota: La función csvtable se puede utilizar para generar datos en el formato correcto.	Obligatorio
TipoDeScript	El nombre del identificador a usar como se especifica en la configuración GenericScriptHandlers en la Configuración del servidor. Nota: si se especifica scriptFile , se detectará automáticamente según la extensión del archivo.	Opcional
argumentos	Personalizar los argumentos para pasar al script. Debe ser una lista codificada en JSON . Hay dos argumentos especiales; '<SCRIPT>'y '<INPUT>'. Las apariciones de '<SCRIPT>' se reemplazan con la ruta a un archivo de script, y las apariciones de '<INPUT>' se reemplazan con la ruta al archivo de entrada. Esto te permite personalizar la llamada al controlador de scripts con argumentos adicionales. El valor predeterminado es ["<SCRIPT>", "<INPUT>"].	Opcional
debugPath	Una ruta absoluta a una carpeta. Si se especifica este parámetro, UiPath Process Mining generará el archivo de entrada (como se le da al proceso externo) y la salida del proceso externo (como se lee desde la salida estándar del proceso externo) en esta carpeta para fines de depuración.	Opcional

A continuación se muestra un ejemplo de una consulta sencilla.

+'&scriptFile=' + urlencode("script.py")
+'&inputData='  + urlencode("a;b;c"+#10+"1;2;3"+#10+"4;5;6")

A continuación se muestra un ejemplo de una consulta más avanzada.

+'&scriptText=' + urlencode(/* your script as text */)
+'&scriptType=' + urlencode("HandlerName")
+'&inputData='  + urlencode(csvtable(
    "Case_ID", jsontolist(InputData_Case_ID)
    "Amount" , jsontolist(InputData_Amount)
))
+'&args='       + urlencode(listtojson(["<SCRIPT>", "--filename", "<INPUT>"]))

Consulte también: Usar fuentes de datos de script genéricos

SAP

Las cadenas de conexión de SAP se pueden utilizar para conectarse a un servidor de aplicaciones SAP, por ejemplo, como SAP R3, SAP ERP, SAP ECC 5.0, SAP ECC 6.0, S / 4HANA.

Importante: La biblioteca SAP NWRFC debe estar instalada en el servidor de UiPath Process Mining para usar un origen de datos SAP de la cadena de conexión.

Los orígenes de datos SAP se pueden cargar estableciendo el parámetro del controlador de la cadena de conexión en {SAP}.

driver={SAP}

A continuación se muestra un resumen de los parámetros que se pueden utilizar para las fuentes de datos de SAP.

Parámetro	Descripción	Obligatorio / Opcional
Host	El nombre del host o la dirección IP del servidor de aplicaciones SAP.	Obligatorio
NúmeroDelSistema	El número de dos dígitos entre 00 y 99 que identifica la instancia designada.	Obligatorio
MóduloDeFunción	Al configurar una extracción de SAP nativa, se requiere el módulo de funciones SAP Z_XTRACT_IS_TABLE . Si, por ejemplo, se cambia el nombre del Módulo de funciones en tu sistema SAP, puedes especificar el nombre correcto en el parámetro FunctionModule de la cadena de conexión SAP.FunctionModule Parámetro Anula el módulo de función Z_XTRACT_IS_TABLE predeterminado que se utiliza al consultar esta tabla.	Opcional
Nombre de usuario	El nombre de usuario de la cuenta que se está utilizando para iniciar sesión en la instancia de SAP.	Obligatorio
aprobar	La contraseña del usuario anterior. Se puede utilizar en combinación con el almacén de credenciales, utiliza mv-credential-pass en este caso.	Obligatorio
Cliente	El cliente que se está utilizando.	Obligatorio
Idioma	El idioma que se usa al iniciar sesión.	Obligatorio

A continuación se muestra una descripción general de los parámetros que se pueden especificar en el campo Consulta .

Parámetro	Descripción	Obligatorio / Opcional
Tabla	El nombre de la tabla de SAP desde la que se deben cargar los datos. Por ejemplo EKPO.	Obligatorio
Campos	Una matriz de campos que se recuperarán de la tabla SAP especificada en la propiedad table . Nota: si la propiedad fields está vacía, se recuperarán todos los campos.	Obligatorio
Dónde	Una cláusula where para recuperar un subconjunto de una tabla.	Opcional
limit	Un número entero que especifica un número fijo de registros que se recuperarán de la tabla. Nota: si limit se establece en "0", no habrá límite.	Opcional

Nota: Cada campo en SAP tiene una longitud. Por razones de rendimiento, asegúrese de que la suma de todas las longitudes de los campos recuperados de una tabla no supere los 512.

A continuación se muestra un ejemplo de una cadena de conexión SAP.

'Driver={SAP};Host=10.10.10.10;SystemNumber=00;Username=MyUser;pass=secretPassword;client=100;Language=EN'

A continuación se muestran algunos ejemplos de consultas.

Consulta	Recupera ...
'table=' + urlencode("EKPO")	todos los campos de todos los registros de la tabla EKPO.
'table=' + urlencode("EKPO") + '&fields=' + urlencode(listtojson(["MANDT", "EBELN"]))	el campo MANDT y EBELN para todos los registros de la tabla EKPO .
'table=' + urlencode("EKPO") + '&where=' + urlencode("EBELN = 4500000001")	todos los campos de la tabla EKPO donde EBELN es igual a 4500000001.