Loading

Aceder a uma origem de dados utilizando um item de pesquisa e um controlador ODBC

Introdução

Um controlador do ODBC constitui uma interface para uma origem de dados. A origem de dados pode ser uma base de dados (SQL/MS Access) ou um ficheiro (Excel/txt/csv). Os itens de folha-de-trabalho do tipo "Pesquisa" utilizam o controlador e uma consulta para ler as informações da origem de dados e acrescentar essa informação a um pedido.

O ODBC não pode ser utilizado a partir de uma máquina remota. Num sistema distribuído, o utilizador tem de:

  • Criar e configurar o controlador ODBC nos servidores Web do sistema distribuído. O nome do controlador ODBC tem de ser igual em todas as máquinas.

  • A origem de dados tem de ser idêntica nos servidores Web do sistema distribuído.

Determine a versão de bit da aplicação para a qual pretende criar um controlador ODBC. Um sistema operativo Windows de 64 bits tem dois ficheiros odbcad32.exe:

  • %SystemRoot%\system32\odbcad32.exe para aplicações de 64 bits

  • %SystemRoot%\SysWOW64\odbcad32.exe para aplicações de 32 bits, incluindo 32 bits executadas em sistemas operativos de 64 bits.

Criar e configurar um controlador ODBC para uma fonte de dados TXT ou CSV

  1. Crie um ficheiro TXT ou CSV. Os dados no ficheiro têm de estar separados por vírgulas. Por exemplo:

    1,Chai,10 boxes x 20 bags,$18.00,False

    2,Chang,24 - 12 oz bottles,$19.00,False

    3,Aniseed,12 - 550 ml bottles,$10.00,False

    4,Chef Anton's Cajun Seasoning,48 - 6 oz jars,$22.00,False

    5,Chef Anton's Gumbo Mix,36 boxes,$21.35,True

  2. Abra o diálogo de Pesquisa no Windows e escreva "ODBC".

  3. Selecione as "Fontes de dados ODBC (64 bits)".

  4. Clique no separador "DSN do sistema" e clique em "Adicionar…".

    Quando criar um "DSN do sistema", a fonte de dados é local relativamente ao computador, mas pode ser acedida por todos os utilizadores.

  5. Selecione "Microsoft Text Driver (*.txt; *.csv)" e clique em "Concluir".

  6. Escreva um nome para a fonte de dados na opção "Nome da fonte de dados".

  7. Retire a seleção da opção "Utilizar o diretório atual".

  8. Clique em "Selecionar diretório" e navegue até ao diretório que contém o ficheiro TXT ou CSV que pretende utilizar como fonte de dados. Feche o diálogo "Selecionar diretório".

  9. Clique em "Opções>>" e selecione a extensão correta do ficheiro.

  10. Clique em "Definir formato…".

  11. Selecione o ficheiro que pretende utilizar como fonte de dados. Execute esta ação na secção "Tabelas".

  12. Se o seu ficheiro utilizar um delimitador que não seja uma vírgula, tem de configurar a opção "Formato" e "Delimitador".

  13. Clique em "Adivinhar" na secção "Colunas".

    O assistente cria as colunas de acordo com a estrutura de dados no ficheiro TXT ou CSV.

  14. Para cada coluna, assinale o valor da opção "Tipo de dado". Selecione "Char" para colunas com texto, "Inteiro" para colunas com números, etc.

    Opcionalmente, pode dar outro nome aos cabeçalhos das colunas utilizando a opção "Nome". Pode utilizar os nomes das colunas na consulta de um item de folha-de-trabalho do tipo "Pesquisar" no PRISMAdirect. O item de pesquisa utiliza o controlador ODBC e uma consulta para ler informações na fonte de dados.

  15. Clique em OK e OK.

  16. Neste momento o controlador ODBC está configurado. Feche a caixa de diálogo.

  17. Continue com o procedimento "Criar e utilizar um item de consulta no PRISMAdirect". Encontra este procedimento na base deste artigo. Tem de criar um item de consulta para ler informações da fonte de dados utilizando o controlador ODBC e uma consulta.

Criar e configurar um controlador ODBC para uma fonte de dados Excel

  1. Crie um ficheiro Excel. Os dados no ficheiro devem estar disponíveis numa tabela. Pode utilizar os nomes das colunas na consulta de um item de folha-de-trabalho do tipo "Pesquisar" no PRISMAdirect. O item de pesquisa utiliza o controlador ODBC e uma consulta para ler informações na fonte de dados.

    Por exemplo:

  2. Selecione todas as células na tabela - incluindo os cabeçalhos - e defina o formato da célula como "Texto".

  3. Abra o diálogo de Pesquisa no Windows e escreva "ODBC".

  4. Selecione as "Fontes de dados ODBC (64 bits)".

  5. Clique no separador "DSN do sistema" e clique em "Adicionar…".

    Quando criar um "DSN do sistema", a fonte de dados é local relativamente ao computador, mas pode ser acedida por todos os utilizadores.

  6. Selecione "Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)" e clique em "Concluir".

  7. Escreva um nome para a fonte de dados na opção "Nome da fonte de dados".

  8. Se necessário, selecione a versão do Excel.

  9. Clique em "Selecionar pasta de trabalho…" e navegue para o diretório que contém o ficheiro Excel.

  10. Selecione o ficheiro Excel que pretende utilizar como fonte de dados. Execute esta ação na secção "Nome da base de dados".

  11. Clique em OK e OK.

  12. Neste momento o controlador ODBC está configurado. Feche a caixa de diálogo.

  13. Continue com o procedimento "Criar e utilizar um item de consulta no PRISMAdirect". Encontra este procedimento na base deste artigo. Tem de criar um item de consulta para ler informações da fonte de dados utilizando o controlador ODBC e uma consulta.

Controlador ODBC para uma fonte de dados SQL

Verificar a conta de início de sessão de um servidor SQL do cliente

Quando configurar o controlador ODBC, tem de selecionar um tipo de autenticação. O tipo de autenticação depende a localização do servidor SQL:

  • Servidor SQL local => autenticação SQL (recomendada)

  • Servidor SQL remoto no domínio => autenticação Windows (recomendada)

  • Servidor SQL fora do domínio => autenticação SQL (obrigatória)

Para a autenticação selecionada, deve existir uma conta de início de sessão com as credenciais corretas para o servidor SQL. Caso contrário, o controlador ODBC não se consegue ligar ao servidor SQL.

Tem de verificar que existe uma conta de início de sessão válida.

Por exemplo, pode utilizar:

  • Conta “<domain>\<Windows user>” quando for selecionada a autenticação do Windows.

  • Conta “sa” quando estiver selecionada a autenticação SQL para um servidor SQL local.

Criar e configurar um controlador ODBC para uma fonte de dados SQL

  1. Abra o diálogo de Pesquisa no Windows e escreva "ODBC".

  2. Selecione as "Fontes de dados ODBC (64 bits)".

  3. Clique no separador "DSN do sistema" e clique em "Adicionar…".

    Quando criar um "DSN do sistema", a fonte de dados é local relativamente ao computador, mas pode ser acedida por todos os utilizadores.

  4. Selecione "ODBC Driver 11 for SQL Server" e clique em "Concluir".

  5. Escreva um nome para a origem de dados na opção "Nome", selecione o servidor SQL ao qual pretende ligar-se e clique em "Seguinte".

  6. Seleccione o tipo de autenticação. O tipo de autenticação depende a localização do servidor SQL:

    • Servidor SQL local => autenticação SQL (recomendada)

    • Servidor SQL remoto no domínio => autenticação Windows (recomendada)

    • Servidor SQL fora do domínio => autenticação SQL (obrigatória)

    No caso de autenticação integrada com o Windows, deixe a opção "SPN (opcional)" vazia:

    No caso de autenticação do servidor SQL, introduza a "ID de início de sessão" e a "Palavra-passe":

  7. Clique em "Seguinte", clique novamente em "Seguinte" e clique em "Concluir".

  8. Clique em "Testar origem de dados…" para testar a ligação à origem de dados.

  9. Clique em OK quando a ligação estiver bem estabelecida.

  10. Faça clique em OK.

    Neste momento o controlador ODBC está configurado. Feche a caixa de diálogo.

  11. Continue com o procedimento "Criar e utilizar um item de consulta no PRISMAdirect". Encontra este procedimento na base deste artigo. Tem de criar um item de consulta para ler informações da fonte de dados utilizando o controlador ODBC e uma consulta.

Criar e configurar um controlador ODBC para uma fonte de dados do MS Access

  1. Abra o diálogo de Pesquisa no Windows e escreva "ODBC".

  2. Selecione as "Fontes de dados ODBC (64 bits)".

  3. Clique no separador "DSN do sistema" e clique em "Adicionar…".

    Quando criar um "DSN do sistema", a fonte de dados é local relativamente ao computador, mas pode ser acedida por todos os utilizadores.

  4. Selecione "Microsoft Access Driver (*.mdb, *.accdb)" e clique em "Concluir".

  5. Escreva um nome para a fonte de dados na opção "Nome da fonte de dados".

  6. Clique em "Selecionar…" e navegue para o diretório que contém o ficheiro da base de dados.

  7. Selecione no ficheiro da base de dados na secção "Nome da base de dados" e clique em OK.

  8. Clique em OK e OK.

  9. Neste momento o controlador ODBC está configurado. Feche a caixa de diálogo.

  10. Continue com o procedimento "Criar e utilizar um item de consulta no PRISMAdirect". Encontra este procedimento na base deste artigo. Tem de criar um item de consulta para ler informações da fonte de dados utilizando o controlador ODBC e uma consulta.

Criar e utilizar um item de pesquisa no PRISMAdirect

Os itens de folha-de-trabalho do tipo "Pesquisa" utilizam um controlador ODBC e uma consulta para ler informações de uma fonte de dados. Pode adicionar informações a uma encomenda.

  1. Abra a área de trabalho "Editor de produtos e encomendas" do PRISMAdirect.

  2. Selecione os "itens de produtos" e clique em "Adicionar".

  3. Introduza um nome para o novo item e selecione em "Pesquisa" no campo de tipo de item.

  4. Introduza o nome do controlador ODBC. Trata-se do nome exato que definiu no "Nome de origem de dados", ou o "Nome" de uma fonte de dados SQL.

  5. Para uma fonte de dados SQL ou uma fonte de dados do MS Access:

    • Introduza o "Nome de utilizador" e a "Palavra-passe" da conta do utilizador com direitos de acesso à base de dados.

      NOTA

      O "Nome de utilizador" e a "Palavra-passe" do item de pesquisa substituem a "ID de início de sessão" e a "Palavra-passe" do controlador ODBC. Consulte o passo 6 do procedimento "Controlador ODBC de uma fonte de dados SQL". Por exemplo, se deixar os campos "Nome de utilizador" e "Palavra-passe" vazios, a conta do utilizador tenta iniciar sessão com credenciais vazias.

    Para uma fonte de dados TXT ou CSV, ou uma fonte de dados do Excel:

    • Deixe os campos "Nome de utilizador" e "Palavra-passe" vazios.

  6. Crie uma consulta SQL para obter informações de uma origem de dados. Uma consulta válida deve levar em conta a sensibilidade a maiúsculas da base de dados selecionada para obter corretamente os dados.

    No exemplo seguinte, a consulta é: SELECT F3 FROM ODBC_data_source.txt

    Esta consulta devolve todos os valores da coluna "F3" da fonte de dados "ODBC_data_source.txt" em relação ao item de pesquisa "ODBC lookup".

    Pode introduzir o símbolo $ na consulta para apresentar uma lista de itens de perfil. Pode utilizar estes itens de perfil na consulta.

    Exemplos de consultas:

    • Controlador SQL: SELECT Column FROM Database.Table

    • Controlador do Microsoft Access: SELECT Column FROM Table

    • Controlador Microsoft Excel: SELECT Account FROM [Sheet1$] WHERE User LIKE '$LastName$’

    • Controlador Microsoft Txt: SELECT F2 FROM test.txt

  7. Guardar as alterações.

  8. Selecione "Produtos" e adicionar o item de pesquisa a um ou mais produtos.

  9. Publicar as alterações.

Quando criar uma encomenda, pode selecionar um valor da fonte de dados para o item de pesquisa:

NOTA

Os primeiros 999 valores devolvidos pela consulta ficam disponíveis na lista pendente.