sc_connection_new("Nome_da_Conexão", $arr_conn)

Quando usada, a macro cria uma nova conexão com as informações inseridas em seus parâmetros. Esta conexão fica disponível em toda a sessão atual do Scriptcase, deixando de existir somente quando a sessão for fechada.

A nova conexão só estará disponível na próxima aplicação.

1º Parâmetro: Nome da conexão à ser criada.

Obs: Se existir uma conexão criada dentro do Scriptcase com o mesmo nome, essa macro não terá nenhum efeito. Conexões criadas dentro do Scriptcase prevalecem. Caso deseje editar uma conexão já existente, veja a documentação da macro sc_connection_edit.

2º Parâmetro: Array de itens contendo as informações da conexão. Confira abaixo os indices do array:

 

Indice
Descrição Exemplo
['drive'] Driver do banco de dados utilizado na conexão (ver tabela abaixo) $arr_conn['drive'] = "oci8"
['server'] Servidor do banco de dados $arr_conn['server'] = "127.0.0.1"
['user'] Usuário do banco de dados $arr_conn['user'] = "root"
['password'] Senha do banco de dados $arr_conn['password'] = "secretpass123"
['database'] Base de dados utilizada pela conexão $arr_conn['database'] = "sc_samples"
['persistent'] Define se a conexão será persistente ou não $arr_conn['persistent'] = "Y" / "N"
['encoding'] Configura o encoding da conexão $arr_conn['encoding'] = "utf8"

Obs: É obrigatório que todos os itens estejam preenchidos, com exceção dos itens ['persistent'] e ['encoding'].

 

Veja abaixo a lista de drivers das conexões:

 

Driver
Descrição
access MS Access
ado_access MS Access ADO
odbc ODBC Genérico
db2 DB2
db2_odbc DB2 ODBC Nativo
odbc_db2 DB2 ODBC Genérico
odbc_db2v6 DB2 ODBC Genérico 6 ou Abaixo
pdo_db2_odbc DB2 PDO ODBC
pdo_ibm DB2 PDO
firebird Firebird
pdo_firebird Firebird PDO
borland_ibase Interbase 6.5 ou Acima
ibase Interbase
pdo_informix Informix PDO
informix Informix
informix72 Informix 7.2 ou Abaixo
ado_mssql MSSQL Server ADO
pdo_sqlsrv MSSQL Server NATIVE SRV PDO
mssqlnative MSSQL Server NATIVE SRV
odbc_mssql MSSQL Server ODBC
mssql MSSQL Server
pdo_dblib DBLIB
pdo_mysql MySQL PDO
mysqlt Mysql (Transactional)
mysql MySQL (Non-Transactional)
pdo_oracle Oracle PDO
oci805 Oracle 8.0.5 ou Acima
odbc_oracle Oracle ODBC
oci8 Oracle 8
oci8po Oracle 8 Portable
oracle Oracle 7 ou menor
postgres7 PostgreSQL 7 ou Acima
pdo_pgsql PostgreSQL PDO
postgres64 PostgreSQL 6.4 ou acima
postgres PostgreSQL 6.3 ou abaixo
pdosqlite SQLite PDO
sqlite SQLite
sybase Sybase
pdo_sybase_dblib Sybase PDO DBLIB
pdo_sybase_odbc Sybase PDO ODBC

 

Exemplo de uso da macro:

$arr_conn = array();

$arr_conn['drive'] = "mysqlt";
$arr_conn['server'] = "127.0.0.1";
$arr_conn['user'] = "root";
$arr_conn['password'] = "pass123";
$arr_conn['database'] = "sc_samples";
$arr_conn['persistent'] = "Y";
$arr_conn['encoding'] = "utf8";

sc_connection_new("new_conn_mysql", $arr_conn);