Tipos de strings de conexão

Introdução

Existem vários tipos de strings de conexão que podem ser usados. Este guia descreve os diferentes tipos de cadeia de conexão.

Arquivos

Os arquivos podem ser carregados em uma tabela definindo um parâmetro de driver da cadeia de conexão como {mvfile}.

driver={mvfile}

Os seguintes tipos de arquivos podem ser carregados:

• Arquivos do Excel .xls e .xlsx
• Arquivos de texto .csv, .tsve .txt

Parâmetros adicionais podem ser especificados para carregar arquivos.

Abaixo está uma visão geral dos parâmetros genéricos que estão disponíveis ou carregando arquivos.

Parâmetro	Description
Nome do arquivo	Isso pode ser um caminho relativo para um arquivo no servidor ou um URL HTTP. Quando o arquivo está no servidor, o arquivo deve ser colocado na guia Dados de desenvolvimento ou Dados do servidor , e o escopo da tabela deve ser definido de acordo. Ao usar um URL HTTP, você pode especificar os parâmetros user e pass para autenticação.
ramal	Por padrão, a extensão do nome do arquivo é usada para determinar o tipo de arquivo, mas isso pode ser substituído.
Usuário	O nome de usuário para o arquivo remoto ao usar uma URL HTTP.
passar	A senha para o arquivo remoto ao usar um URL HTTP.

Arquivos do Excel

Abaixo está uma visão geral dos parâmetros adicionais que podem ser usados para carregar arquivos do Excel.

Parâmetro	Description
Folha	A planilha ou intervalo nomeado a ser importado. Para nomes de folhas, um caractere de cifrão deve ser anexado no final. Se não for especificado, a primeira planilha será carregada.
Primeira coluna	A primeira coluna a partir da qual começar. A configuração padrão é {autodetectar}.
Primeira linha	A primeiro linha para começar. A configuração padrão é {autodetect}.

A tabela abaixo contém strings de conexão de exemplo para carregar arquivos do Excel.

String de conexão	Carrega...
'driver={mvfile}; filename=Data/Dataset.xlsx;'	a primeira folha de um arquivo Excel
'driver={mvfile}; filename=Data/Dataset.xlsx; sheet=MySheet$;'	a planilha chamada 'MySheet'

Arquivos de texto

Abaixo encontra-se uma visão geral dos parâmetros adicionais que podem ser usados para carregar arquivos de texto.

Parâmetro	Description
Tem cabeçalho	Se a primeira linha do arquivo é uma linha de cabeçalho. A configuração padrão é {true}.
delim	O caractere delimitador. A configuração padrão é {tab}.
citar	O caractere usado para citar valores. A configuração padrão é {autodetect}.
escapar	O caractere usado como caracteres de escape A configuração padrão é {none}.
Codificação	A codificação usada no arquivo, por exemplo, UTF8 ou LATIN1. A configuração padrão é {UTF8}.

A tabela abaixo contém um exemplo de strings de conexão para carregar arquivos de texto.

String de conexão	Carrega um arquivo de texto...
driver={mvfile}; filename=Textfile.txt; delim=,; quote=";'	com separadores por vírgulas (,) e aspas (")
'driver={mvfile}; filename=Textfile.txt; delim=|; quote=";'	com separadores pipe (|) e " aspas
"driver={mvfile}; filename=Textfile.txt; delim=9; quote=';"	com separadores de tabulação e ' aspas
'driver={mvfile}; filename=Textfile.txt; delim=59; quote=none;'	com separadores de ponto e vírgula e sem aspas
'driver={mvfile}; filename=Textfile.txt; delim=,; quote="; escape=\;'	com separadores de vírgula (,), " aspas e \ caracteres de escape
'driver={mvfile}; filename=http://www.example.com/files/example.txt;'	de um servidor web
'driver={mvfile}; filename=http://www.example.com/files/example.txt; User=Jane; mv-credential-Pass=example_com_credentials'	de um servidor web com autenticação de acesso básico

ODBC

ODBC é usado para conectar-se a fontes de dados externas, geralmente bancos de dados. Você pode fazer isso usando o sistema operacional, como o gerenciador de fontes de dados ODBC no Microsoft Windows, ou fornecer diretamente a string de conexão no formato correto.

É possível que o driver ODBC precise de uma consulta para executar. A consulta que precisa ser executada no banco de dados pode ser fornecida como uma string no campo Consulta .

Importante: Ao testar uma conexão ODBC certifique-se de que o campo Consulta esteja preenchido com uma consulta válida.

Importante: todos os bancos de dados que têm uma versão de 64 bits podem ser acessados usando uma conexão ODBC. É necessário ter o driver de 64 bits do ODBC instalado no servidor do UiPath Process Mining, e o servidor deve poder acessar esse sistema específico.

Abaixo está uma visão geral dos parâmetros que podem ser usados para conexões ODBC.

Parâmetro	Description
motorista	O driver ODBC a ser usado para esta conexão. Não é necessário ao usar o parâmetro 'dsn' .
dsn	O ODBC DSN a ser usado para essa conexão. Não é necessário ao usar o parâmetro 'driver'. Observação: ao configurar um DSN para usar na string de conexão, certifique-se de que seja um DSN de sistema de 64 bits.
Usuário	Nome de usuário a ser usado para se conectar à origem de dados externa.
passar	A senha a ser usada para se conectar ao recurso de dados externo.
outro	Quaisquer outros parâmetros são passados conforme especificado para o driver ODBC.

A tabela abaixo contém strings de conexão de exemplo para conexões ODBC.

String de conexão	Conecta...
'Driver={SQL Server Native Client 11.0};Server=SERVERNAME;Database=MyDatabase;'	para um banco de dados SQL Server
'Driver={Oracle in OraClient12Home1};Dbq=MyTSN;'	para um banco de dados Oracle
'DSN=MeuDSN; Usuário=MeuUsuário; Pass=MeuPasse;'	usando um DSN configurado com um nome de usuário e senha

Tanto a string de conexão quanto o campo de consulta são expressões. Por exemplo, uma tabela de cadeia de conexão para um banco de dados imaginário pode ser criada.

Veja a ilustração abaixo.

Observação: os dados da tabela só podem ser usados quando a tabela tiver sido carregada. Neste exemplo, a tabela Globals é necessária para usar dados de outras tabelas.

Dicas e truques

Para formatos de cadeia de conexão de outros sistemas, consulte o fabricante desse sistema ou um recurso online como https://www.connectionstrings.com/.

Se o usuário com acesso ao banco de dados for um usuário do Windows, certifique-se de que esse usuário do Windows:

• é uma conta de serviço e não um usuário real.
• tem acesso de leitura/gravação na pasta de instalação do Process Mining .
• é o usuário que executa os scripts (por exemplo, nas tarefas agendadas) para carregamento de dados.
• é usado para executar o pool de aplicativos no IIS.

SAP HANA

Você pode usar uma conexão ODBC para se conectar ao SAP HANA.

Abaixo está um exemplo de string de conexão para SAP HANA.

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

Observação: em vez de conectar-se a um banco de dados SAP, é recomendável usar o tipo de string de conexão SAP para conectar-se ao servidor de aplicativos SAP.

Scripts genéricos

Você pode usar uma cadeia de conexão para executar um script para carregar dados de fontes de dados.

Importante: O manipulador de script que você deseja executar deve ser instalado no servidor UiPath Process Mining .

Os arquivos podem ser carregados em uma tabela definindo o parâmetro do driver da string de conexão como {mvscript} e o parâmetro do script como "generic":

driver={mvscript}; script=generic

Observação: você deve especificar os parâmetros de script no campo Consulta usando a codificação de URL.

Abaixo está uma visão geral dos parâmetros que podem ser especificados no campo Consulta .

Parâmetro	Description	Obrigatório/Opcional
scriptText	O texto do roteiro.	Obrigatório Observação: somente se scriptFile não for usado.
scriptFile	Nome do arquivo do qual carregar o script. Isso pode ser um caminho relativo para um arquivo no servidor. Quando o arquivo está no servidor, o arquivo deve ser colocado na guia Dados de desenvolvimento ou Dados do servidor , e o escopo da tabela deve ser definido de acordo.	Obrigatório Observação: somente se scriptText não for usado.
Dados de Entrada	Um texto separado por ponto e vírgula com cabeçalhos de coluna que contém a entrada para o script. Nota: A função csvtable pode ser usada para gerar dados no formato correto.	Obrigatório
TipoDoScript	O nome do identificador a ser usado conforme especificado na configuração GenericScriptHandlers nas Configurações do servidor. Observação: se scriptFile for especificado, isso será detectado automaticamente com base na extensão do arquivo.	opcional
argumentos	Personalize os argumentos a serem passados para o script. Esta deve ser uma lista codificada em JSON . Existem dois argumentos especiais; '<SCRIPT>'e '<INPUT>'. As ocorrências de '<SCRIPT>' são substituídas pelo caminho para um arquivo de script e as ocorrências de '<INPUT>' são substituídas pelo caminho para o arquivo de entrada. Isso permite que você personalize a chamada para o manipulador de script com argumentos adicionais. O padrão é ["<SCRIPT>", "<INPUT>"].	Opcional
debugPath	Um caminho absoluto para uma pasta. Se este parâmetro for especificado, o UiPath Process Mining produzirá o arquivo de entrada (conforme fornecido ao processo externo) e a saída do processo externo (conforme lido da saída padrão do processo externo) nesta pasta para fins de depuração.	Opcional

Abaixo está um exemplo de uma consulta simples.

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

Abaixo está um exemplo de uma consulta mais avançada.

+'&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 também: Usar fontes de dados de script genérico

SAP

As strings de conexão SAP podem ser usadas para se conectar a um servidor de aplicativos SAP, por exemplo, como SAP R3, SAP ERP, SAP ECC 5.0, SAP ECC 6.0, S/4HANA.

Importante: A biblioteca SAP NWRFC deve ser instalada no servidor UiPath Process Mining para usar uma fonte de dados SAP da string de conexão.

As fontes de dados SAP podem ser carregadas definindo o parâmetro do driver da string de conexão como {SAP}.

driver={SAP}

Abaixo está uma visão geral dos parâmetros que podem ser usados para fontes de dados do SAP.

Parâmetro	Description	Obrigatório/Opcional
Host	O nome de host ou o endereço IP do servidor de aplicativo SAP.	Obrigatório
SystemNumber	O número de dois dígitos entre 00 e 99 que identifica a instância designada.	Obrigatório
FunctionModule	Ao configurar uma extração SAP nativa, o módulo de função SAP Z_XTRACT_IS_TABLE é necessário. Se, por exemplo, o Módulo de Função for renomeado em seu sistema SAP, você poderá especificar o nome correto no parâmetro FunctionModule na string de conexão SAP.FunctionModule parâmetro. Substitui o módulo de função Z_XTRACT_IS_TABLE padrão usado ao consultar esta tabela.	Opcional
Username	O nome de usuário da conta que está sendo usada para fazer login na instância do SAP.	Obrigatório
passar	A senha do usuário acima. Pode ser usado em combinação com o armazenamento de credenciais, use mv-credential-pass neste caso.	Obrigatório
Cliente	O cliente que está sendo usado.	Obrigatório
Idioma	O idioma usado ao fazer login.	Obrigatório

Abaixo está uma visão geral dos parâmetros que podem ser especificados no campo Consulta .

Parâmetro	Description	Obrigatório/Opcional
Tabela	O nome da tabela SAP a partir do qual os dados devem ser carregados. Por exemplo EKPO.	Obrigatório
Campos	Uma matriz de campos que serão recuperados da tabela SAP especificada na propriedade table . Nota: Se a propriedade fields estiver vazia, todos os campos serão recuperados.	Obrigatório
Onde	Uma cláusula where para recuperar um subconjunto de uma tabela.	Opcional
limit	Um número inteiro que especifica um número fixo de registros a serem recuperados da tabela. Observação: se limit for definido como '0', não haverá limite.	Opcional

Nota: Cada campo no SAP tem um comprimento. Por motivos de desempenho, certifique-se de que a soma de todos os comprimentos de campo recuperados para uma tabela não exceda 512.

Abaixo está um exemplo de uma string de conexão SAP.

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

Abaixo estão alguns exemplos de Consultas.

Consulta	Recupera...
'table=' + urlencode("EKPO")	todos os campos de todos os registros da tabela EKPO.
'table=' + urlencode("EKPO") + '&fields=' + urlencode(listtojson(["MANDT", "EBELN"]))	o campo MANDT e EBELN para todos os registros da tabela EKPO .
'table=' + urlencode("EKPO") + '&where=' + urlencode("EBELN = 4500000001")	todos os campos da tabela EKPO onde EBELN é igual a 4500000001.