Introdução... 9 Drivers suportados... 9 Principais funcionalidades... 9 Limitações... 9 Instalação Executando o Template Utilitário em versões

Transcrição

1 Introdução... 9 Drivers suportados... 9 Principais funcionalidades... 9 Limitações... 9 Instalação Executando o Template Utilitário em versões inferiores à Notas sobre o Template Utility Recomendações específicas para os novos usuários Antes de começar O Início Algumas recomendações para os novos usuários do SQL Roteiro de Exemplos do File Manager Começando Adicionando o FM3 à sua aplicação Adicionando a Extensão Global Adicionando os Defines do Projeto Usuários do Clarion Adicionando a janela SQL_Connect Configurando a procedure RuntimeFilemanager O que deve ser feito no Dicionário de dados? Regras essenciais a serem seguidas pelos usuários do FM Usando AutoUP Quem deve usar o AutoUP Como funciona Implementação Adicionando o AutoUP a uma aplicação.exe simples Adicionando AutoUP a uma aplicação Multi Dll Adicionando AutoUP à uma aplicação Legacy.Exe Adicionando AutoUp à uma aplicação Legacy Multi Dll Adicionando AutoUP à uma aplicação que utiliza o IP Driver Considerações adicioais sobre o IP Driver Terceiro Caso Problemas relatados Auto UP e o Dynamic File Driver (DFD) Esclarecimentos adicionais Adicionando o AutoUP à uma aplicação nova Adicionando o AutoUP à uma aplicação já existente Adicionando AutoUP a uma aplicação de Conversão de Drivers TPS / SQL Adicionando AutoUP a uma aplicação DET ou DEF Como fazer alterações básicas nas estruturas dos arquivos? Como Adicionar / Alterar o número da versão do arquivo? Como alterar o nome de um arquivo? Como alterar o nome de um campo? Como alterar o prefixo de um arquivo? Como preparar (prime) campos novos? Campos numéricos Campos String Campos Auto-numeráveis

2 Preparando (prime) campos de arquivos que já contenham dados Como adicionar senhas a arquivos ou como alterar a senha de um arquivo? Aprendendo sobre as Opções de Usuário do Dicionário de Dados Detalhando as opções de usuário do Dicionário de Dados Version OldName (Nivel de arquivo) OldName (a nível de Campo) SetIfNew UnRealField (SQL) RealField (SQL) AutoNumber (SQL) TableSpace (SQL) ZeroNull (SQL) OldPrefix IgnoreDriver FM3IGNORE DctMasterFields (SQL) DctMasterKeys (SQL) DctMasterRelations (SQL) DctMasterField (SQL) DctMasterKey (SQL) ForceSQLDataType (SQL) Overrides Ignorando arquivos DAT pré existentes Ignorando um arquivo em particular Decrementando a versão do arquivo O arquivo UPG.TPS Quando devo distribuir o arquivo UPG? Distribuindo uma app nova para novos clientes Você já possui uma aplicação com arquivos DAT do Clarion Aplicações que usam arquivos TPS ou Btrieve Aplicações existentes que usam TPS ou Btrieve com alterações estruturais Forçando o posicionamento do arquivo UPG.TPS Detalhes adicionais a respeito do arquivo UPG. Cuidados a serem levados em conta Suporte a múltiplos Data sets Arquivos não SQL Arquivos SQL Suporte à grandes Aplicações e grandes Dicionários Adicionando o template de código VLDS:FM3 Init Como manipular um Erro 47 preexistente SQL para usuários do File Manager Criando o procedimento de conexão Criando uma aplicação separada para atualização da aplicação SQL Tratamento de Erros Erros de Compilação Assertion failed on line: 303 in file abfile.clw. Message: You are calling CLOSE(thefile) instead of FileManager.close(). Shall I GPF?

3 Compile Error: Link Error: Too many segdef in file Error(6): cif$fileclose The handle is invalid Link Error: Duplicate symbol: SQLxxxxxxxxxx, file FM2.OBJ (Repeated for a number of functions) FM3 warning: <FieldName> has a non-unique external name. Invalid in <FileName> of driver: <FileDriver> FM3 warning: <FieldName> of type <FieldType> is invalid in <FileName> of driver: <FileDriver> Error Occurred: [Microsoft][ODBC SQL Server Driver][SQL Server]Zeile 1: Failed Syntax in the File Link Error: DS_FILEOPEN is unresolved in file c:\clarion5\xxxxxxxxx.obj (Repeated for a number of functions) Erros genéricos do FM Unable to identify driver - use ds_adddriver driver to register drivers Unable to Upgrade - Not "Using" File <file prefix> Possible file change without changing File Version number. File involved : <filename> Unable to Open UPG file : cause <error> Unable to upgrade file which doesn't have a prefix : <filename> Unable to upgrade file - no file name available Unable to upgrade file - Error creating destination file <error> Unable to upgrade file - Error opening destination file <error> Unable to upgrade file - Error reading source file <error> Error Writing destination file <error> Warning - Driver not located - GPF likely WARNING: Possible downgrade File Corrupt. Restart program to invoke AutoFIX. Name : <FileName> Errorcode received on open: <error> Unable to Open MDI window FM3: Unable to upgrade. Access to the existing file has been denied Erros específicos do SQL FM3 cannot detect any connection properties for this file: <FileName> WARNING: FM3 detects this application contains older file structures than the current backend version. Please upgrade your Program. FM3 suggests implementing AutoNET for automatic program file upgrades across networks! Ending Program! Error locating the Database name for this file: <FileName> Owner string searched: <FileOwner> File Manager 3 does not currently support this Database through ODBC: <DataBase> Alternatively, please check that you entered the database backend correctly on the ConnectToSQLBackend Extension Template. Ending Program! FM3 could not find the specified database (<DataBaseName>) in the backend! Unable to open / create FM3 required system table: <gsqlfilename> Unable to open FM3 System table: <gsqlfilename> Error posted: <Error> Unable to interpret SQL structure: [columns] Error: <FileError> Unable to interpret SQL structure: [keys] Error: <FileError> Unable to interpret SQL structure: [indexes] Error: <FileError> Unable to interpret SQL structure: [constraints] Error: <FileError>

4 Could not create Oracle TableSpace! <FileError> Press Ignore to create the table in the default tablespace WARNING: This table already contains an IDENTITY FIELD : <TableName> Ensure there is a maximum of 1 per file FM3 has detected a SREAL datatype in your Clarion Dictionary. Oracle does NOT support this datatype. Please update your dictionary definition to datatype REAL. FM3 cannot manage this file! FM3 has detected an INVALID datatype in your Clarion Dictionary. FM3 does not support this datatype: <DataType> Please update your dicitonary definition. FM3 cannot manage this file! Could not configure SQL Server for DATA ACCESS! FM3 cannot manage this file! Error: <error> FM3 File error on final open:<filename> : <driver> <error> Please ensure you have the FireBird Client DLL installed on your workstation: gds32.dll. 52 Untrappable runtime error - program crashes at startup (during FM2/3 launching) AutoBuild Descrição das funções de Gerenciamento de Arquivos Adicionando o Auto Build à sua aplicação Adicionando o AutoBuild à uma aplicação Multi Dll Distribuição AutoFix Adicionando o AutoFix à sua aplicação Esclarecimentos importantes a respeito do TPSFix AutoNET Implementação Sincronizando mais que um diretório Notas Distribuição Problemas e Soluções Check List Debugando o FM Acionando as opções do Debug Dicas sobre o Debug View Criando uma Aplicação de Exemplo Algumas regras para as aplicações de exemplo Arquivos que devem acompanhar o pedido de suporte Distribuindo uma aplicação com o FM3 habilitado Suporte à idiomas (internacionalização) Convertendo aplicações FM2 para o FM SQL Uma nova visão Principais características dos Bancos de dados Princípios fundamentais do desenvolvimento Clarion com SQL Questões a serem respondidas antes de começar! Usar o Dicionário de Dados ou usar somente o Backend? De quem é a responsabilidade pela manutenção do Banco de dados? Estruturas existentes de TPS ou SQL Modelagem dos dados Todas as tabelas devem ter uma chave primária Regras para nomear Chaves primárias, Chaves únicas e Chaves estrangeiras

5 Regras sobre as palavras reservadas Definindo chaves estrangeiras como Integer Dicas e macetes O atributo Owner e sua definição O Banco de dados SQL Configurando o MSSQL como linked server Configurando o DATA ACCESS do MSSQL Server para True Tipos de dados SQL Data e Hora (Date / Time ) Usando um Group com Over sobre uma String(8) Usando dados do tipo DATE e do tipo TIME Usando um tipo de dado LONG Usando um tipo de dado String ou Cstring Campos Memo Campos Reais Arrays (Dims) Índices dinâmicos e estáticos Tipos de dados do Oracle Tipos de dado String muito grandes Identificador único do MSSQL Binary Strings (PostgreSQL) Gerenciando campos Gerenciando chaves Considerações especiais sobre o MSSQL Server Considerações especiais sobre o PostgreSQL O template ConnectToSQLBackend Tópicos e configurações avançadas Migrando para SQL Antes de começar Regras básicas Strings de Conexão Nomenclatura das tabelas SQL Conexões ODBC e os DSNs Como criar e configurar uma conexão ODBC Como acessar bases de dados através de strings de conexão Criando uma string de conexão para o MSSQL Criando uma string de conexão para o MSSQL Criando uma string de conexão para o Oracle Criando uma string de conexão para o MySQL Criando uma string de conexão para o Sybase Criando uma string de conexão para o PostgreSQL Criando uma string de conexão para o Firebird Oracle TableSpaces Acessando múltiplas bases de dados ao mesmo tempo com um mesmo programa O SQL, o FM3 e o Clarion informações importantes SQL Backend Case-Sensitivity Convertendo zeros e brancos dos arquivos TPS para NULL em sua base de dados SQL Configurando ZeroNull nas opções de usuário do Dicionário de Dados MSSQL Informações adicionais

6 Uma Stored Procedure muito útil Importando Arquivos MDF e LDF Exportando Arquivos MDF e LDF Firebird Informações adicionais Baixando o Firebird (download) Usuário SYSDBA e Senha Criando um banco de dados Firebird GDS32.DLL Limitação do tamanho das chaves Ordenamento de chaves Limitação de chaves compostas PostgreSQL Informações adicionais O que é preciso para rodar o PostgreSQL Configurando o PostgreSQL Guia para solução de problemas Continuo recebendo a mensagem de erro Quando devo apagar o arquivo UPG.TPS? É viável diminuir a versão da tabela? O Auto Net não parece estar funcionando Suporte a múltiplos Dicionários com um mesmo arquivo UPG Um erro do AutoNET diz que AutoNET.exe and File Manager are out of Sync? A aplicação demora para carregar depois que o FM3 foi habilitado O CScan está solicitando uma senha Problemas com o alias do arquivo ao atualizar Estou recebendo um erro: "File has no Prefix", ou "The data file is Invalid".. 92 Um campo decimal com máscara 13,3 foi alterado para máscara 13,4 e agora o número aparece sendo dividido por GPF na saída do programa GPF ao acessar um arquivo Erro: Assertion failed on line: 303 in file abfile.clw. Message: You are calling CLOSE(thefile) instead of FileManager.close(). Shall I GPF? Erro: Possible file change without changing File Version number. File involved : <filename> após alterar a estrutura de uma tabela Estou usando o Clarion 6(.1), com o template MDI Synch e o FM3 e o meu programa trava durante uma atualização do Fm O FM3 atualiza com sucesso os meus arquivos, mas eu não consigo vê-los na janela de atualização Posso atualizar todos os arquivos ao iniciar um Upgrade? Existe alguma variável que eu possa setar em uma trigger para impedir que a trigger inicie um upgrade do FM3? O procedimento de conexão ao banco de dados está travando Mesmo com o user.event na procedure de conexão, ela continua travando. 94 Está ocorrendo um erro de sintaxe do tipo syntax error near the Keyword...94 Na conversão de tabelas TPS para SQL, não ocorrem mensagens de erro, mas os dados não são convertidos O FM3 oferece suporte à manutenção dos relacionamentos entre tabelas no backend? Por que não posso usar o FM3 sob um driver ODBC genérico? Alto consumo de recursos da CPU com o Clarion Explosão no processo de Upgrade após a conexão

7 A janela de conexão reaparece assim que eu escolho uma opção de menu no meu aplicativo Por que não posso usar a opção /TurboSQL com meus aplicativos SQL que usam o FM3.? Não consigo conectar ao banco de dados MSSQL pelo seu nome, mas consigo com o endereço IP Um erro do tipo Unknown Procedure Label ocorre na linha que faz a chamada para a procedure RunTimeFileManager Outros problemas Usando o Cscan Formatação Segurança Localizar (e Substituir) Distribuição Usando o UPG View Imprimindo o layout de um arquivo Analisando o arquivo Usando o BDE Bulk Dictionary Editor Visão geral Funções Um início rápido Executando o BDE Recomendações importantes Cuidados Conclusão Bibliografia