### Convert and Install Oracle Instant Client on Ubuntu/Debian

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/05-conexoes-scriptcase/08-oracle/03-linux/02-instalacao-manual-lin/03-oracle-odbc

Converts and installs Oracle Instant Client RPM packages to DEB format and then installs them on Ubuntu/Debian systems.

```bash
sudo alien oracle-instantclient12.1-devel-12.1.0.2.0-1.x86_64.rpm
sudo alien oracle-instantclient12.1-basic-12.1.0.2.0-1.x86_64.rpm
sudo dpkg -i oracle-instantclient12.1-basic_12.1.0.2.0-2_amd64.deb
sudo dpkg -i oracle-instantclient12.1-devel_12.1.0.2.0-2_amd64.deb
```

--------------------------------

### Adicionar Caminho do Instant Client às Variáveis de Ambiente

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/05-conexoes-scriptcase/08-oracle/02-windows/02-instalacao-manual-win/02-oracle-8-acima

Configure a variável de ambiente 'Path' para incluir o diretório do Oracle Instant Client, permitindo que o sistema o localize.

```bash
C:\instantclient_19_6
```

--------------------------------

### Scriptcase Local Access Example

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/02-instalacao-scriptcase/03-linux

Use this format to access Scriptcase when installed on your local machine. Ensure the port matches your Apache configuration.

```text
127.0.0.1:8093/scriptcase/
```

```text
localhost:8093/scriptcase/
```

--------------------------------

### Scriptcase Server Access Example

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/02-instalacao-scriptcase/03-linux

Use this format to access Scriptcase when installed on a remote server. Replace the IP address or domain with your server's details.

```text
180.204.163.144:8093/scriptcase/
```

```text
mysc.dominio.net/scriptcase/
```

--------------------------------

### Renomear db2dsdriver.cfg.sample para db2dsdriver.cfg (Instalação Automática)

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/05-conexoes-scriptcase/03-db2/03-linux/03-db2

Instrução para renomear o arquivo de exemplo db2dsdriver.cfg.sample para db2dsdriver.cfg na instalação automática. Este passo é necessário se o arquivo de configuração não existir.

```bash
Na instalação automática, é necessário antes renomear o arquivo **db2dsdriver.cfg.sample** para **db2dsdriver.cfg**
```

--------------------------------

### Redirecionamento Condicional em onApplicationInit

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/06-aplicacoes/10-aplicacao-menu/06-menu-eventos

Utilize este código no evento onApplicationInit para redirecionar o usuário para outra aplicação se uma condição específica não for atendida. Certifique-se de que a variável global 'glo_var_depto' esteja definida.

```php
if ([glo_var_depto] != ‘financeiro’){
    sc_redir(app_x.php);
}
```

--------------------------------

### Configure Query Application to Start with Filter

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/14-macros/02-macros

Forces a query application to initiate by displaying the filter options to the user. This is useful for guiding users to search data first.

```php
sc_apl_conf("minha_consulta", "start", "filter");
```

--------------------------------

### Ajax Processing Configuration Example

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/06-aplicacoes/12-aplicacao-filtro/09-campos/12-select

Illustrates the setup for Ajax processing, where selecting a value in one field (e.g., state) triggers an update in another related field (e.g., city).

```text
Por exemplo: um campo do tipo select com uma **lista de estados** , e outro campo do tipo select com uma **lista de cidades**. Ao selecionar um estado será recarregada a lista de cidades.
```

--------------------------------

### Instalar Informix Client SDK (x64)

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/05-conexoes-scriptcase/05-informix/03-informix-linux

Passos para instalar o Informix Client SDK para arquitetura x64 (64 bits). Inclui extração do tarball e execução do script de instalação.

```bash
sudo tar -xf x64_clientsdk.4.10.FC6DE.LINUX.tar
sudo ./installclientsdk
```

--------------------------------

### Redirecionamento Condicional em onApplicationInit

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/06-aplicacoes/08-aplicacao-controle/12-ctrl-eventos

Utilize este evento para redirecionar o usuário para outra aplicação se uma condição específica for atendida, como a verificação de uma variável global. O código é executado uma única vez quando a aplicação é carregada.

```php
if ([glo_var_depto] != ‘financeiro’){
 sc_redir(app_x.php);
}
```

--------------------------------

### sc_lookup_field Macro Examples

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/14-macros/02-macros

Examples demonstrating the usage of the sc_lookup_field macro for retrieving data from a database.

```APIDOC
## sc_lookup_field Macro

### Description
Retrieves data from a database based on a SQL query.

### Method
`sc_lookup_field(variable_name, sql_query, [connection_name])`

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```php
// Example 1: Accessing multiple rows
sc_lookup_field(meus_dados, "select field_01, field_02, field_03 from tb_name");

// Accessing the first row
{field_01} = {meus_dados[0]['field_01']};
{field_02} = {meus_dados[0]['field_02']};
{field_03} = {meus_dados[0]['field_03']};

// Accessing the second row
{field_01} = {meus_dados[1]['field_01']};
{field_02} = {meus_dados[1]['field_02']};
{field_03} = {meus_dados[1]['field_03']};

// Example 2: With data validation
$comando_sql = "select field_01, field_02, field_03 from tb_name";
sc_lookup_field(meus_dados, $comando_sql);

if ( {meus_dados} === false ) {
    echo "Erro de acesso. Mensagem = " . {meus_dados_erro};
} elseif ( empty({meus_dados}) ) {
    echo "Comando select não retornou dados ";
} else {
    {clienteid} = {meus_dados[0]['field_01']};
    {nomecliente} = {meus_dados[0]['field_02']};
    {limitecred} = {meus_dados[0]['field_03']};
}

// Example 3: Using the connection parameter
$comando_sql = "select field_01, field_02 from tb_name where field_03 = '{field_03} ' and field_02 = [var_global]"
sc_lookup_field(meus_dados, $comando_sql, "conn_name");

// Example 4: Using local and global variables in the macro command
$comando_sql = "select field_01, field_02 from tb_name where field_03 = '{field_03} ' and field_02 = [var_global]"
sc_lookup_field(meus_dados, $comando_sql);
```

### Response
#### Success Response (200)
- **meus_dados** (array) - An array of associative arrays, where each inner array represents a row from the query result.
- **meus_dados_erro** (string) - Contains error message if the query fails.

#### Response Example
```json
{
  "meus_dados": [
    {
      "field_01": "value1",
      "field_02": "value2",
      "field_03": "value3"
    },
    {
      "field_01": "value4",
      "field_02": "value5",
      "field_03": "value6"
    }
  ],
  "meus_dados_erro": null
}
```
```

--------------------------------

### Copiar Arquivos do Instant Client no macOS

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/05-conexoes-scriptcase/08-oracle/04-mac/01-instalacao-automatica-mac/02-oracle-8-acima

Após extrair o Oracle Instant Client, use este comando para copiar os arquivos para o diretório criado. Adapte os nomes dos arquivos e diretórios conforme o seu download.

```bash
cp -avr __MACOSX/ oci_client_macosx_12/ /usr/local/instantclient/12.1.0.2/
```

--------------------------------

### Redirecionamento condicional no onApplicationInit

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/06-aplicacoes/03-aplicacao-consulta/17-eventos

Utilize este exemplo para verificar variáveis globais e redirecionar o usuário antes da execução do SQL da aplicação.

```PHP
if ([glo_var_depto] != ‘financeiro’){ sc_redir(app_x.php); }
```

--------------------------------

### Form Tag GET Method

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/03-conhecendo-scriptcase/emmet

Use this selector to create an HTML form with the GET method.

```HTML
<form action="" method="get">
```

--------------------------------

### LDAP Query Return Example

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/14-macros/02-macros

This is an example of the expected array structure returned by an LDAP query in Scriptcase.

```php
Array (
    [N] => Array
        (
            [uniquemember] => Array
                (
                    [count] => 4
                    [0] => uid=einstein,dc=example,dc=com
                    [1] => uid=galieleo,dc=example,dc=com
                    [2] => uid=tesla,dc=example,dc=com
                    [3] => uid=newton,dc=example,dc=com
                )

            [0] => uniquemember
            [ou] => Array
                (
                    [count] => 1
                    [0] => scientists
                )

            [1] => ou
            [cn] => Array
                (
                    [count] => 1
                    [0] => Scientists
                )

            [2] => cn
            [objectclass] => Array
                (
                    [count] => 2
                    [0] => groupOfUniqueNames
                    [1] => top
                )

            [3] => objectclass
            [count] => 4
            [dn] => ou=scientists,dc=example,dc=com
        )

)

```

--------------------------------

### Instalar Informix Client SDK (x86)

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/05-conexoes-scriptcase/05-informix/03-informix-linux

Passos para instalar o Informix Client SDK para arquitetura x86 (32 bits). Inclui extração do tarball e execução do script de instalação.

```bash
sudo tar -xf x86_clientsdk.3.70.UC8DE.LINUX.tar
sudo ./installclientsdk
```

--------------------------------

### Instalação de pacotes de dependência

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/05-conexoes-scriptcase/08-oracle/03-linux/02-instalacao-manual-lin/01-oracle-pdo

Comandos para instalar as dependências necessárias para o Oracle Instant Client.

```bash
sudo apt-get update
sudo apt-get install libaio1
sudo apt-get install libncurses5
sudo apt-get install alien
sudo apt-get install gcc-multilib g++-multilib
sudo apt-get install libpam0g
sudo apt-get install unixodbc-dev unixodbc
```

```bash
sudo yum update
sudo yum install libaio-devel
sudo yum install libaio
sudo yum install glibc
sudo yum install compat-libstdc++-33
sudo yum install glibc-devel
sudo yum install libstdc++
sudo yum install libstdc++
sudo yum install pam
sudo yum install ncurses-devel
sudo yum install unixODBC
```

--------------------------------

### Install CentOS/RHEL Packages for Oracle

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/05-conexoes-scriptcase/16-amazon-rds/05-oracle/02-linux/01-habilitando-amazon-oracle-85

Installs essential packages on CentOS/RHEL systems required for Oracle database connectivity.

```bash
sudo yum update
```

```bash
sudo yum install libaio-devel
```

```bash
sudo yum install libaio
```

```bash
sudo yum install glibc
```

```bash
sudo yum install compat-libstdc++-33
```

```bash
sudo yum install glibc-devel
```

```bash
sudo yum install libstdc++
```

```bash
sudo yum install pam
```

```bash
sudo yum install ncurses-devel
```

```bash
sudo yum install unixODBC
```

--------------------------------

### Install Oracle Dependencies on CentOS/RHEL

Source: https://www.scriptcase.com.br/docs/pt_br/v9/manual/05-conexoes-scriptcase/08-oracle/03-linux/02-instalacao-manual-lin/03-oracle-odbc

Installs essential packages required for Oracle connectivity on CentOS and RHEL-based systems.

```bash
sudo yum update
sudo yum install libaio-devel
sudo yum install libaio
sudo yum install glibc
sudo yum install compat-libstdc++-33
sudo yum install glibc-devel
sudo yum install libstdc++
sudo yum install libstdc++
sudo yum install pam
sudo yum install ncurses-devel
sudo yum install unixODBC
```