4D ODBC Driver Installation on Windows Installation on OS X Configuração da fonte de dados

(1)

4D ODBC Driver

Open Database Connectivity Standard (ODBC) é uma API (Application Programming Interface) estandarte e aberta, que utiliza SQL para acessar a uma ou mais bases de dados desde uma só aplicação. 4D e 4D Server oferecem um servidor SQL nativo que ativa esta funcionalidade.

Para estabelecer uma conexão entre uma aplicação e uma base de dados utilizando ODBC,

deve baixar o driver ODBC de 4D, disponível em versão 32 bits para Mac OS ou Windows e em versão 64 bits para Windows (a versão 64 bits para OS X está disponível a partir de 4D v14 R2). Não requer utilizar livrarias externas: todo está no driver ODBC de 4D.

Pode usar este driver para recuperar os dados de clientes ODBC, como Word, Excel, Crystal Reports®, ou utilizando um script Python, um bridge JDBC-ODBC, ou qualquer outro cliente ODBC.

O driver ODBC de 4D está disponível em nosso site web: http://www.4d.com/downloads/products.html

Installation on Windows Installation on OS X

(2)

Installation on Windows

4D oferece duas versões de driver (uma versão de 32 bits e uma versão de 64 bits) do instalador ODBC Driver para Windows. Pode baixar um (ou ambos) arquivos do site web de 4D:

4D_ODBC_Driver_vXX_(32-bit).exe 4D_ODBC_Driver_vXX_(64-bit).exe

Se escolher o driver em função da versão do cliente ODBC, e não da versão de seu 4D ou 4D Server. Por exemplo, se está utilizando uma versão 32 bits de Excel 2010 com um 4D Server de 64 bits, então você irá necessitar de um driver ODBC de 32 bits. Pode inclusive instalar os dois drivers na mesma máquina.

Lembre que deve desinstalar qualquer versão anterior do Driver ODBC antes de instalar uma nova.

Nota: se instalar a versão de 32 bits em um sistema operativo de 64 bits, deve utilizar o Administrador de fontes de dados ODBC 32 bit em vez da versão de 64 bits pré determinada.

Pode recuperar a versão apropriada do Administrador ODBC nos seguintes lugares: 32 bits: C:\WINDOWS\syswow64\odbcad32.exe

64 bits: C:\WINDOWS\system32\odbcad32.exe

Atenção: o Administrador 32 bits se encontra em "syswow64" e o Administrador 64 bits em "system32". Como isto não é intuitivo, deve ter certeza de não confundir um com o outro.

Para mais informação sobre o Administrador de fontes de dados ODBC, consulte a seguinte nota técnica de Microsoft: http://support.microsoft.com/kb/942976/en-us

Creating a DSN

A DSN (Data Source Name) is a set of registry keys that enables an application, the ODBC client, to link to the native SQL Server of 4D or 4D Server. Applications such as Crystal Reports®, Word and/or Excel can all be OBDC clients, and you can also write your own OBDC client using Python, PHP, C, C++ or any language that enables ODBC use.

After running the ODBC Driver installer, you need to define a DSN in order to connect to the desired database.

To add a DSN, you launch the ODBC Data Source Administrator by selecting Start/Control Panel/Administrative Tools/Data Sources (ODBC).

Click on the "Drivers” tab to check that the 4D ODBC Driver is correctly installed:

To add a DSN using the 4D ODBC Driver: 1. Click on one of the following tabs:

“User DSN” (if you want to make this data source available only to the user currently logged on to this computer. This data source can only be used on the current machine).

OR

“System DSN” (if you want to make this data source available to all users from this computer, including NT services)

(3)

-2. Click the Add button and choose the 4D ODBC Driver from the list of configured drivers:

3. Click Finish.

The 4D ODBC Driver’s own configuration panel appears:

Note: When you select an existing DSN and click on the Configure... button, this same dialog appears pre-filled with all the DSN characteristics.

4. Click OK to save any changes before you close the configuration panel window.

Configurando seu DSN

Os campos destes diálogos devem ser preenchidos com a seguinte informação:

Nome da fonte de dados::

Introduza um nome único para esta fonte de dados. Por padrão: "".

Este campo é obrigatório.

Descrição:

Escreva uma breve descrição desta fonte de dados. Por padrão: "".

Este campo é opcional.

Endereço do servidor:

Exemplos:

"localhost" A aplicação 4D se encontra na equipe local.

"PC-1" A aplicação 4D se encontra na máquina PC-1, publicada na porta 19812 (porta por padrão). "148.1.2.3" A aplicação 4D tem o endereço IP 148.1.2.3.

Por padrão: "localhost". Este campo é obrigatório.

Porta:

Introduza a porta de acesso 4D. Por padrão: "19812".

Caixa de seleção SSL:

Ao selecionar esta opção permite a conexão com 4D Server se a opção "Ativar SSL" foi definido na página SQL/Configuração das Propriedades da base.

Usuário:

Introduza o nome de usuário utilizado para provar a conexão com 4D.. Por padrão: "".

(4)

Senha:

Introduza a senha utilizada (em combinação com o nome de usuário) para provar a conexão com 4D. Por padrão: "".

Botão de prova

Prova a conexão com os parâmetros atuais.

Utiliza "Nome de usuário" e "Senha" para iniciar sessão.

Advanced settings

Clicking on the Advanced >> button gives you access to additional options as shown here:

Timeouts (Seconds) Connection:

Enter the timeout in seconds to be used (0 means no timeout) after you log in for the driver to connect to a socket on the server:port address.

Default: "".

This field is optional.

Login:

Enter the timeout in seconds to be used (0 means no timeout) when the driver sends a request and receives the status from the server.

Default: "".

Query:

Enter the timeout in seconds to be used (0 means no timeout) when waiting for a response after a query to the server. Default: "".

Favorite image formats

Pictures stored in 4D databases are retrieved by ODBC as Blobs. This setting lets you select the formats you prefer. By default, if you do not choose any favorites, 4D selects the best format available with respect to screen display.

When you choose one or more formats, 4D only provides one of those formats (in order of preference). If there are no pictures available in any of your favorite formats, 4D converts the pictures to the first format in the list.

For example, if you have selected GIF and JPEG as your favorite image formats:

4D first checks whether there are any .gif or .jpeg formats available. If neither are available, then it converts the formats to .gif since it is first in the list.

Encoding: sets the text encoding.

(5)

-UTF-8 (Unicode) (recommended)

System (depends on the settings of your OS)

Cache Settings: used to modify how the network handles the cache. Generally, these settings should be left untouched.

Compatibility: settings to enable the ODBC Driver to work properly with OpenQuery and MSAccess. They should only be checked if you encounter problems with these particular applications.

Uninstalling an ODBC Driver

If you intend to completely remove a 4D ODBC Driver, you must first remove all the Data Source Names created for this driver. This can be done from the ODBC Data Source Administrator:

If you only intend to upgrade a 4D ODBC Driver, you do not need to remove the attached DSNs.

To remove a 4D ODBC Driver, simply launch the 4D ODBC Installer and choose the Remove option; the installer will take care of the rest:

(6)

Installation on OS X

The 4D ODBC Driver on Macintosh must be installed manually. Before you begin, to enable ODBC use, make sure you have downloaded the latest iODBC framework from here:

http://www.iodbc.org/dataspace/iodc/wiki/iODBC/Downloads#Mac OS X

You download the ODBC Driver from the 4D web site. The folder contains both the 32-bit and 64-bit versions: 4D ODBC x32.bundle

4D ODBC x64.bundle

You choose your driver based on the version of your ODBC client, and not that of your 4D or 4D Server. For example, if you are using a 64-bit version of Python as your ODBC client, then you'll need a 64-bit ODBC Driver, even if you are using a 32-bit version of 4D Server. You can install both of the drivers on the same machine.

Instalação de um driver ODBC em OS X Desinstalar um Driver ODBC em OS X

(7)

Instalação de um driver ODBC em OS X

Para instalar o Driver ODBC:

1. Copie o 4D ODBC x64.bundle e/ou o 4D ODBC x32.bundle na pasta {Library}/ODBC/

2. Abra o arquivo de texto odbcinst.ini que se encontra na pasta /Library/ODBC/ com um editor de texto e o modifique desta forma:

[ODBC Drivers]

4D ODBC Driver 64-bit = Installed 4D ODBC Driver 32-bit = Installed [4D ODBC Driver 64-bit]

Driver = /Library/ODBC/4D ODBC x64.bundle/Contents/MacOS/4D ODBC x64 Setup = /Library/ODBC/4D ODBC x64.bundle/Contents/MacOS/4D ODBC x64 APILevel = 2

ConnectFunctions = YYN DriverODBCVer = 3.52 FileUsage = 0

SQLLevel = 3

[4D ODBC Driver 32-bit]

Driver = /Library/ODBC/4D ODBC x32.bundle/Contents/MacOS/4D ODBC x32 Setup = /Library/ODBC/4D ODBC x32.bundle/Contents/MacOS/4D ODBC x32 APILevel = 2

ConnectFunctions = YYN DriverODBCVer = 3.52 FileUsage = 0

SQLLevel = 3

Agora pode lanzar el ODBC Manager localizado na pasta "Applications/Utilities/" para criar um Data Source Name (DSN) ou pode utilizar um dos que vem com o framework iODBC.

Nota: a partir de Mac OS X 10.6 Snow Leopard, ODBC Administration Tool já não se oferece como estandarte. No entanto, pode ser baixado aqui:

http://support.apple.com/kb/dl895

Ao fazer clique na guia "Drivers”, pode verificar que o 4D ODBC Driver esteja instalado corretamente:

Esta janela oferece o nome de rota completo de cada driver instalado. Pode fazer o mesmo com o iODBC Administrator:

(8)

Aqui também pode ser visto o número de versão, mas só para as versões de 32 bits.

Nota: a partir da versão 14R2, os números de versão incluem a subversão e a data de modificação no formato: <Versão> <Subversão><Ano><Mês+Dia>

Por exemplo: "14.2.2014.0217", indica a versão 14R2 modificada em 17 de febrero de 2014.

Criar um DSN de 32 bits

Para adicionar um DSN utilizando o Driver ODBC 4D: 1. Faça clique na guia System DSN

Nota: em Mac OS X, lhe recomendamos que utilize um DSN System e não um DSN User.

2. Faça clique no botão Add e selecione o Driver ODBC 4D de 32 bits da lista de drivers configurados:

3. Faça clique em OK.

Aparece o próprio painel de configuração do Driver ODBC 4D:

4. Faça clique em OK para guardar as mudanças antes de fechar a janela do painel de configuração. Nota: é possível encontrar as seguintes anomalias ao criar um DSN através do Administrador Mac OS X ODBC.

Ao criar um novo DSN, pode que não o veja de imediato e pode que tenha que sair e reiniciar o Administrador Mac OS X para que apareça.

Inclusive se agregar uma nova fonte de dados User ODBC, o Driver ODBC criará como um DSN System.

Estas anomalias se devem aos bugs no Administrador Mac OS X ODBC e não tem nada a ver com o Driver ODBC ou instalador 4D.

Configuração de seu DSN

Os campos destas caixas de diálogo devem ser preenchidas com a seguinte informação: 8

(9)

-Data Source Name:

Description:

Introduza uma breve descrição desta fonte de dados. Por padrão: "".

Server Address:

Exemplos:

"localhost" A aplicação 4D se encontra na máquina local.

"PC-1" A aplicação 4D se encontra na máquina PC-1, publicado na porta 19812 (porta por padrão). "148.1.2.3" A aplicação 4D tem o endereço IP 148.1.2.3.

Port:

SSL checkbox:

A ativação desta opção permite a conexão com o servidor 4D se a opção "Ativar SSL" foi definida na página SQL/Configuração das Propriedades da base.

User:

Introduza o nome de usuário que se utiliza para provar a conexão com 4D. Por padrão: "".

Password:

Test button

Utiliza os campos "Nome de usuário" e "Senha" para iniciar sessão.

Configuração avançada

Ao fazer clique no botão Advanced >> obtém acesso a opções adicionais como as que mostramos aqui:

Timeouts (Seconds) Connection:

Introduza o tempo de espera em segundos a utilizar (0 significa que não há tempo de espera) depois de iniciar sessão no driver a conectar a um socket no servidor: endereço de porta.

Por padrão: "".

(10)

Introduza o tempo de espera em segundos a utilizar (0 significa que não há tempo de espera) quando o driver envia uma petição e recebe o estado do servidor.

Por padrão: "".

Query:

Introduza o tempo de espera em segundos a utilizar (0 significa que não há tempo de espera) quando espera por uma resposta depois de uma petição ao servidor.

Por padrão: "".

Formatos de imagem favoritos

As imagens armazenadas nas bases 4D são recuperadas por ODBC como Blobs. Este ajuste lhe permite selecionar os formatos que prefira. Por padrão, se não escolhe um favorito, 4D seleciona o melhor formato disponível com respeito a visualização da tela.

Quando você escolhe um ou mais formatos, 4D só oferece um destes formatos (em ordem de preferência). Se não há imagens disponíveis em qualquer de seus formatos favoritos, 4D converte as imagens ao primeiro formato na lista. Por exemplo, se você selecionou GIF e JPEG como seus formatos de imagens favoritas:

4D primeiro comprova se estão disponíveis os formatos .jpeg ou .gif. Se nenhum está disponível, então converte os formatos a .gif já que está de primeiro na lista.

Encoding: define a codificação do texto. UTF-8 (Unicode) (recomendado)

System (depende da configuração de seu OS)

Cache Settings: é utiliza para modificar a forma em que a rede manipula a memória cachê. Geralmente, estes ajustes devem ser deixados intactos.

Compatibility: ajustes para ativar o Driver ODBC para trabalhar corretamente com OpenQuery e MSAccess. Só devem ser marcados se tiver problemas com estas aplicações particulares.

Criar um DSN de 64 bits

O driver 64 bits não tem interface mas há duas formas de criar um DSN 64 bits: utilizando o driver 32 bits, ou

utilizando o Administrador ODBC.

Utilizando o driver 32 bits

Pode utilizar o driver ODBC 32 bits para criar um DSN 32-bits e depois modificar diretamente este DSN na pasta /Library/ODBC. Abra o arquivo texto /Library/ODBC/odbc.ini com um editor de texto e efetue as seguintes modificações:

1. Na seção [ODBC Data Sources]: mude "4D v15 Rx ODBC Driver 32-bit" por "4D v15 Rx ODBC Driver 64-bit" 2. Na seção [{your data source name}], substitua:

Driver=/Library/ODBC/4D ODBC x32.bundle/Contents/MacOS/4D ODBC x32

por:

Driver=/Library/ODBC/4D ODBC x64.bundle/Contents/MacOS/4D ODBC x64 Utilizando o ODBC Administrator ou iODBC Administrator

1. Clique na aba System DSN.

2. Clique no botão Adicionar e escolha o driver 4D ODBC 64 bits na lista de drivers configurados. O gerador de DSN genérico aparece.

3. Preencha os pares Keyword/Value no seguinte diálogo:

Keyword Value

Driver /Library/ODBC/4D ODBC x64.bundle/Contents/MacOS/4D ODBC x64 Server <IP address of 4D Server>

UID <User's name>

PWD <User's password (can be left blank)>

(11)

-Este es el equivalente para iODBC:

4. Clique em OK

(12)

Desinstalar um Driver ODBC em OS X

Para desinstalar um Driver ODBC 4D, só utilize o Administrador ODBC que se encontra na pasta Application Utilities. Lance o Administrador ODBC e faça clique na guia Drivers:

Para eliminar um Driver ODBC 4D, somente o selecione na lista dos drivers instalados e pressione o botão Remove. Lhe pedirá que confirme esta eliminação:

Logo terá que eliminar os seguintes arquivos manualmente: /Library/4D ODBC x32.bundle

/Library/4D ODBC x64.bundle

(13)

Configuração da fonte de dados

Os campos destas caixas de diálogo tem que estar cheias com a seguinte informação:

Nome da fonte de dados:

Descrição:

Introduza uma breve descrição desta fonte de dados. Por padrão: "".

Servidor: Exemplos:

"localhost" A aplicação 4D está localizada na máquina local.

"PC-1" A aplicação 4D está localizada na equipe PC-1, publicado na porta 1919 (porta por padrão). "148.1.2.3" A aplicação 4D tem o endereço IP 148.1.2.3.

Porta:

Caixa de seleção SSL:

A ativação desta opção permite a conexão com o servidor SQL de 4D se a opção "Ativar SSL" foi definida na página SQL/Configuração das Preferências.

Usuário:

Introduza o nome de usuário que se utiliza para provar a conexão com 4D. Por padrão: "".

Senha:

Conexão:

Introduza o tempo de espera em segundos, que será utilizado (0 significa que não há tempo de espera) depois que o driver se conectar a um soquete do servidor: endereço da porta

Por padrão: "".

Login:

Introduza o tempo de espera em segundos que será utilizado (0 significa que não há tempo de espera) quando o driver envia uma petição e recebe o estado do servidor.

Por padrão: "".

Pesquisa:

Introduza o tempo de espera em segundos que será utilizado (0 significa que não há tempo de espera) quando se espera uma resposta depois de uma consulta ao servidor.

Por padrão: "".

Botão de prova de conexão

Utiliza os campos "Nome de usuário" e "Senha" para iniciar a sessão.

Palavras chaves

Driver

Identifica o ODBC Driver utilizado.

(14)

Para uma definição DSN (OS X): utilize "/Library/ODBC/4D ODBC x32.bundle/Contents/MacOS/4D ODBC x32" ou "/Library/ODBC/4D ODBC x64.bundle/Contents/MacOS/4D ODBC x64" no arquivo obdc.ini ou na configuração para chave/valor DSN genérica.

DSN

Para uma cadeia de conexão: indica um DSN a utilizar.

Neste caso, não é necessário utilizar outras palavras chaves desde que se definiram no DSN. Para uma definição DSN: você atribui um nome diretamente e não necessita uma palavra chave.

Descrição

Para uma cadeia de conexão: esta palavra chave não se utiliza.

Para uma definição DSN: pode introduzir uma descrição curta (opcional). Valor por padrão: ""

Server

Indica o endereço IP ou o nome do servidor 4D ao qual você deseja se conectar. Exemplos: "127.0.0.1", "localhost", "2001:0db8:0000:85a3:0000:0000:ac1f:8001".

Valor por padrão: “localhost”.

Port

Especifica a porta de conexão. Valor por padrão: 19812

Este porta deve ser o mesmo que o que se proporciona na página SQL/Página de configuração das Propriedades da base (na equipe servidor).

UID

Identifica o nome do usuário sob o qual será conectado. Valor por padrão: ""

PWD

Oferece a senha associada com o nome de usuário especificado na chave UID. Valor por padrão: ""

SSL

Ativa uma conexão SSL.

Para uma cadeia de conexão: pode ser "True" ou "False" Para uma definição DSN: aparece como uma caixa de seleção Valor por padrão: "False"

PhysicalConnectionTimeout*

Uma conexão ODBC começa mediante a conexão a rede TCP/IP. Este valor estabelece o tempo de espera para este passo. Valor por padrão: 0

LoginTimeout*

Uma vez que o driver está conectado a rede TCP/IP, a continuação, deve ser reconhecido pelo servidor 4D. Portanto, envia um marco que contém o usuário, a senha e outra informação. Este tempo de espera estabelece o tempo máximo de espera por uma resposta.

Valor por padrão: 0

QueryTimeout*

Uma vez um driver ODBC esteja conectado, também pode executar consultas e manipular dados. Este tempo de espera, expressado em segundos, é aplicado neste caso.

Valor por padrão: 0

* Os Timeouts definem o tempo de espera antes de abortar uma ação. Seus valores se expressam em segundos, com 0 sendo tempo de espera ilimitado.

DefaultPageSize (configuração avançada): Valor expressado em filas.

NetworkCacheSize (configuração avançada): Valor expressado em KB.

FavouriteImageFormats (configuração avançada):

Para uma cadeia de conexão: contém uma lista de formatos imagem aceitos, separados por espaços, escolhidos de entre os seguintes: .tiff, .gif, .jpg, .png, .bmp.

Para uma definição de DSN: aparecem como botões de seleção (como é mostrado a continuação).

(15)

-Valor por padrão: "" (aceita todo formato imagem)

CharsEncoding (configuração avançada):

Para uma cadeia de conexão: pode ser "UTF-8" ou "System". Para uma definição de DSN: mostrado como um botão de rádio Valor por padrão: UTF-8

OpenQuery (configuração avançada):

Para uma cadeia de conexão: utilize "True" ou "False". Se utilizar SQLServerManagementStudio e experimenta dificultades para se conectar a 4D, é preferível executar o seguinte script:

EXEC sp_addlinkedserver @server = '<Your name>', @srvproduct = '<Anything>', @provider = 'MSDASQL',

@provstr = 'OpenQuery=true;dsn=<a 4D-defined DSN>;UID=<your 4D User>;PWD=<Password>'

Para uma definição de DSN: aparece como uma casa de seleção Valor por padrão: False (não selecionado)

MSAccess (configuração avançada):

Para uma cadeia de conexão: utilize "True" ou "False". Se tiver problemas com as datas e horas, pode tentar definir esta opção como "True".

Para uma definição de DSN: aparece como uma casa de verificação Valor por padrão: False (não selecionado)