Usando preferências de usuário

Pode gerar um arquivo externo com as propriedades personalizadas. Quando esta função estiver ativa, as propriedades definidas contidas no arquivo externo (chamadas "propriedades usuário") são utilizadas ao invés das propriedades armazenadas no arquivo de estrutura do banco de dados (chamadas "propriedades estrutura").

Isto significa que pode salvar a configuração personalizada entre as atualizações de seus aplicativos 4D, o que pode gerenciar diferentes configurações da mesma aplicação 4D implementada em vários sites diferentes. Também faz com que seja possível administrar por programação os arquivos de propriedades utilizando XML.

• Configuração usuário (padrão)
  Estes ajustes de usuário são utilizados ao invés da configuração de estrutura para todo arquivo de dados aberto com a aplicação.

• Configuração usuário para arquivo de dados
  Esta configuração de usuário estão associadas a cada arquivo de dados utilizado com sua aplicação, por exemplo, configurar o ID de porta ou a cache de servidor.
  Com esta opção, pode implementar e atualizar facilmente várias cópias da mesma aplicação com vários arquivos de dados, cada um dos quais contém diferentes configuraçõs. Considere, por exemplo, a seguinte configuração, onde se duplica uma aplicação e cada cópia utiliza uma configuração diferente (ID de portao). Se esta configuração de usuário estiver vinculada ao arquivo de dados, poderá  atualizar a aplicação sem ter que mudar manualmente a ID de porta:
  

Para poder utilizar a funcionalidade de externalização das propriedades usuário, deve selecionar a opção Ativar as preferências de usuário em um arquivo externo, que se encontra em Página Segurança das Propriedades do banco de dados.

Quando se selecionar esta opção, as propriedades do banco de dados se dividem em duas caixas de diálogo: Preferências da estrutura e Preferências de usuário. Pode acessar a estas caixas de diálogo através do menu Desenho/Propriedades do banco> ou o botão Propriedades da barra de ferramentas:

Nota: quando o arquivo de dados se encontra no mesmo nivel que o arquivo de estrutura (configuração normal quando um banco de dados é criado), o comando Configuração usuário para o arquivo de dados... não é mostrada.

Também pode acessar a estas caixas de diálogo utilizando o comando OPEN SETTINGS WINDOW com o selector tipoConf apropriado.

Quando o modo externo estiver ativo, as propriedades do banco de dados são acessíveis via duas caixas de diálogo: "Preferências da estrutura" e "Preferências de usuário".
A caixa de diálogo "Preferências da estrutura"  é idêntica à das propriedades  do banco em modo normal e oferece acesso a todas suas propriedades. A caixa de diálogo "Preferências de usuário" contém uma seleção das propriedades relevantes que podem ser externalizadas:

Conforme ao principio de prioridade das propriedades usuário, se uma opção for modificada nesta caixa de diálogo, seu valor é levado em consideração ao invés do valor armazenado nas propriedades da estrutura.

A tabela abaixo lista as páginas de preferências presentes na caixa  de diálogo  "Preferências de usuário" e descreve suas principais diferenças com respeito as propriedades padrão:

A maioria dos ajustes de usuário também estão disponíveis através de comando SET DATABASE PARAMETER. Os ajustes de usuário são parâmetros com a propriedade  "Se conserva entre duas sessões" em "Sim".

Quando a funcionalidade "Configuração de usuário" estiver ativada, a configuração de usuário editada pelo comando SET DATABASE PARAMETER são salvados automaticamente na configuração de usuário para o arquivo de dados.

Nota: Table sequence number é uma exceção; este valor de configuração sempre é salvada no arquivo de dados.

Ao selecionar a opção Ativar configuração de usuário em arquivo externo nos Parâmetros do banco de dados, os arquivos de configuração de usuário são criados automaticamente. Sua localização depende do tipo de configuração de usuário.

Quando a opção Ativar preferências de usuário em arquivo externo estiver selecionada nas Propriedades do banco, o arquivo de propriedades usuário for criado automaticamente. Sua localização depende do tipo de configuração de usuário.

... onde [PastaBanco] é o nome da pasta que contém o arquivo de estrutura do banco de dados.

Nota: em aplicativos fusionados, o arquivo de configuração do usuário se localiza em:

• Em versões monoposto: [DatabaseFolder]/Database/Preferences/settings.4DSettings
• Em versões cliente-servidor: [DatabaseFolder]/Server Database/Preferences/settings.4DSettings

O arquivo de configuração de usuário para arquivo de dados é criado automaticamente e é colocado em uma pasta [Preferências] no local abaixo:

... onde <DataFolder> é o nome da pasta que contém o arquivo atual de dados (".4dd") do aplicativo.

Nota: quando o arquivo de dados se encontra no mesmo nível que o arquivo de estrutura (normalmente quando um banco de dados é criado), os arquvos de configuração  usuário baseados em dados e na estrutura compartem a mesma localização e arquivo. O comando de menu Configuração usuário para o arquivo de dados... não é proposto.

Configurações de usuário são arquivos XML, podem ser lidos e modificados usando comandos integrados 4D XML ou usando um editor XML. Isto significa que pode gerenciar configurações por programação, especialmente no contexto de aplicativos compilados e fusionados com 4D Volume Desktop. Note que quando modificar este arquivo por programação, as mudanças são consideradas na próxima vez que o banco de dados for aberto.

Configurações de banco de dados podem ser armazenadas em três níveis. Cada configuração definida a um nível sobrepuja uma configuração estabelecida  num nível anterior, se houver:

Lembre que arquivos settings.4DSettings podem conter apenas um subconjunto das configurações relevantes, enquanto o arquivo de estrutura contém todas as configurações personalizadas, incluindo configurações centrais que não podem ser movidas a arquivos externos.