Princípios para conversão

• Deve ter uma versão "interpretada" do banco de dados (arquivo xxxx.4DB para a estrutura), arquivo xxxx.4DD para os dados, arquivos .RSR e .4DR para as versões anteriores a 4D v11, ver os documentos "Conversão" das versões anteriores), assim como a senha Desenhador para realizar uma conversão;
• Faça uma cópia de seu banco antes da conversão;

• Realize uma verificação de sintaxe. mesmo se não desejar compilar seu banco de dados, esta verificação pode ajudar a alertar sobre possíveis erros;

• Utilize o Centro de Manutenção e Segurança para verificar e reparar a estrutura e os dados;

•  Comprove se tem algum PICT utilizando o comando GET PICTURE FORMATS e converta os arquivos utilizando o comando CONVERT PICTURE (em 4D, a partir de v14, como padrão os codecs QuickTime não são compatíveis. Por razões de compatibilidade, em uma versão de 32 bits, pode reativá-los em seu banco por meio de um seletor QuickTime para o comando SET DATABASE PARAMETER); A modificação desta opção necessita do reinicio do banco de dados. Entretanto, lembre que a compatibilidade de QuickTime se eliminará permanentemente em futuras versões de 4D.
      Para converter imagens de formato obsoleto: ver Conversion of picture type.

• (Opcional) Possibilidade de implementar chaves primárias se necessitar o registro de dados (a partir da versão 14) (ver Definir ou eliminar uma chave primária no manual Desenho). É recomendado recofigurá-las, mas isso pode ser feito depois da conversão.

• Desde a versão 13.5, é obrigatório que os campos Únicos sejam indexados. Já não se permitirá criar/modificar registros para um campo único não indexado: ao tentar salvar o registro será gerado um erro (-9998 registro único existe, o índice 1088 não é válido ou falta). Para criar índices faltantes ou gerar um arquivo disco que liste os campos não indexados, consulte To create missing indexes.

Os bancos de dados criados com a versão 15 de 4D ou 4D Server (assim como os criados em v11, v12, v13 e v14) são compatíveis com 4D versão 16 (arquivos Estrutura e dados). Pode converter qualquer arquivo de estrutura interpretado. Para isso, só inicie 4D v17 e abra seu arquivo de estrutura em modo interpretado (arquivo xxx.4DB).

Conversão do arquivo de estrutura (.4DB)

Um diálogo lhe informa sobre a conversão do arquivo de estrutura e dependendo da versão de início, da conversão do arquivo de dados:

Seu arquivo de estrutura se converte a 4D v17 e não pode ser aberto em uma versão anterior.

Conversão do arquivo de dados (.4DD)

Este arquivo de dados também são convertidos a versão 17 mas ainda pode ser aberto e utilizado com 4D v15 ou v16.

Não é necessário convereir os dados para os bancos de dados 4D v15 ou 4D v16.

    Diálogo de configuração do arquivo de histórico

Se as chaves primárias não estiverem em seu lugar, 4D lhe pedirá que o faça mostrando o diálogo:



É  aconselhável configurar as chaves primárias (botão "Usar o assistente"), mas este passo pode ser feito mais adiante (botão "Continuar"), para as tabelas que exigem o registro (para uma cópia de segurança). Para mais informação, consulte o capítulo  Gestão de chaves primárias.

    Diálogo Unicode temporal

Se abrir sua aplicação em 4D v17 64 bits e sua aplicação de inicio não está em modo Unicode, 4D lhe oferecerá mudar temporariamente seu banco a Unicode.



Como Unicode melhora a velocidade, este passo deveria ter sido realizado desde várias versões atrás. Se este não for o caso, faça isso rapidamente. Para saber mais, consulte Página Compatibilidade.

Utilize o Centro de manutenção e segurança (CSM) para verificar e reparar a estrutura e os dados.

Como lembrete, na estrutura:

• detecção de métodos órfãos (__Orphan__xxxxx) são indicados por advertências no arquivo de histórico de CSM e podem ser eliminados utilizando o Explorador (depois de comprovar que seu código já não é útil);
• não se permite detecção de nomes de objetos duplicados em formulários: são assinalados como advertências no arquivo de histórico de CSM. Pode realizar uma operação de reparação no banco de dados para modificar estes nomes (neste caso, tenha certeza de revisar a programação dos nomes de objetos).

• Detecção de imagens obsoletas (formato PICT). Ver Verificar a aplicação no capítulo CSM.
  Ver o parágrafo Imagens em formato PICT no manual de funcionalidades Obsoletas ou eliminadas. Estas advertências podem afetar tanto às imagens estáticas como às armazenadas na biblioteca de imagens ou em objetos de formulário.
  
  Nota: para converter estas imagens ver Conversion of picture type.
• Caracteres indesejáveis nos nomes (".", "[", and "]")
  A partir de 4D v16 R4, o uso de pontos (.) ou colchetes ([ ]) não é recomendado nos elementos abaixo:
  
  • nomes de variável
  • nomes de tabela
  • nomes de campo
  • nome de método projeto
  
  Para ajudar aos desenvolvedores a colocar suas aplicações conforme com esta regra, a ação Verificar a aplicação busca automaticamente a presência destes caracteres não desejados nos nomes de variáveis, tabelas, campos e métodos. Se forem detectados estes caracteres, o CSM informa sobre "anomalías" e o arquivo de histórico contém as advertências apropriadas:
  
  
  
  Nste caso, se recomenda mudar o nome destes elementos em sua aplicação.

•  detecção de duplicados em campos únicos:
  
  Se oferece informação adicional: Quando usar o MSC ou um comando como [#cmd id="939"/], os arquivos de histórico gerados agora contém os nomes das tabelas e campos envolvidos, assim como cada valor duplicado.
  Quando se utiliza o CSM ou um comando como VERIFY DATA FILE, os arquivos de históricos gerados agora incluem os nomes das tabelas e campos em questão, assim como cada valor duplicado.
  Nota: ao ingressar dados, o quadro de diálogo de erro "Chave duplicada" agora inclui os nomes das tabelas e campos correspondentes, assim como o valor duplicado e o comando GET LAST ERROR STACK também inclui informação detalhada sobre qualquer duplicado encontrado.
  Quando 4D abrir um arquivo de dados, se for necessário construir (ou reconstruir) um índice, os duplicados são detectados automaticamente em qualquer campo associado que seja declarado único.Neste caso, se mostra um quadro de diálogo de alerta específico antes de abrir o banco de dados, oferecendo ao usuário a informação necessária para identificar e eliminar os duplicados:
  
  

A conversão de um banco a 4Dv16 em v17 não precisa da reconstrução dos índices (exceto de uma versão japonesa de 4D).

Mas se a atualização for feita de uma versão mais antiga (especialmente se for necessário atualizar a biblioteca Unicode - ICU - International Components for Unicode), todos os índices dos campos de tipo texto e de palavras chaves de 4D sãoreconstruidos. Esta operação é realizada de forma automática quando o banco de dados é aberto pela primeira vez (advertência: esta operação pode tomar uma quantidade significativa de tempo).

Nota: com 4D v16, otimizamos significativamente o algoritmo de reindexação global para os datos do banco de dados. Todos seus processos foram revisados e esta operação agora pode ser até duas vezes mais rápida. A reindexação global é exigida, por exemplo, depois de reparar o banco de dados ou quando tiver eliminado o arquivo .4dindx.

É possível abrir um banco de dados em versão  16.Rx com uma versão  4D v16.x e vice versa. Entretanto, código que usar novas propriedades não vai funcionar e deve ser desativado. Mas um banco de dados convertido a v17 não pode mais ser aberto em 4D v16.

Nota: similarmente, um banco de dados v17 Rx também pode ser reaberto com uma versão 4D v17.x