vtiger CRM 5.0.

4 Configurao Banco de Dados UTF-8

(Para MySQL)

Copyright 2003-2008 vtiger.com.Todos os direitos reservados. vtiger uma marca registrada de vtiger.com. Todas as outras marcas so de propriedade de seus respectivos donos.

Sumrio
1. 2. Introduo................................................................................................................................................ 3 Suporte UTF-8 para MySQL ................................................................................................................... 3 2.1. 2.2. 2.3. 2.4. 3. 4. 5. Nvel Servidor ................................................................................................................................. 3 Nvel Base de Dados ...................................................................................................................... 3 Nvel de Tabela ............................................................................................................................... 4 Nvel Coluna.................................................................................................................................... 4

Instalao do vtiger ................................................................................................................................ 5 Confirmao de Configuraes do vtiger ............................................................................................ 6 Referncias.............................................................................................................................................. 7

Copyright 2003-2008 vtiger.com.Todos os direitos reservados. vtiger uma marca registrada de vtiger.com. Todas as outras marcas so de propriedade de seus respectivos donos.

1. Introduo
O vtiger 5.0.4 permite-lhe agora trabalhar com o UTF-8. Temos dispensado o maior esforo para fornecerlhes este suporte em todo o produto. Para funcionar adequadamente o banco de dados utilizado pelo vtiger precisar estar configurado para utilizar caracteres codificados em UTF-8. Este documento tem o objetivo de descrever alguns detalhes que recolhemos durante o desenvolvimento.

2. Suporte UTF-8 para MySQL

O banco de dados MySQL disponibiliza muitas formas de habilitar o UTF-8.

2.1.

Nvel Servidor

O suporte a UTF-8 pode ser configurado para todo o servidor de banco de dados MySQL. Contudo, isto pode representar um alto custo, caso a base de dados de outra aplicao no necessite de suporte a UTF8. Para executar este procedimento voc precisa configurar o arquivo de configurao do servidor MySQL (my.ini or my.cnf) da seguinte forma: [mysql] default-character-set=utf8 [mysqld] collation_server=utf8_unicode_ci character_set_server=utf8 default-character-set=utf8 init_connect='SET collation_connection = utf8_general_ci' init_connect='SET NAMES utf8'

NOTA: Voc deve reiniciar o servidor MySQL aps a realizao das mudanas. Para conferir se as mudanas foram aplicadas, abra o a linha de comando do MySQL e digite SHOW VARIABLES; e verifique os valores exibidos. 2.2. Nvel Base de Dados

Voc pode disponibilizar o suporte a UTF-8 para uma determinada base de dados MySQL. Este procedimento tem a funo de atribuir o valor padro quando a tabela criada sem especificar a configurao do caractere. CREATE DATABASE <nomebd> DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci Se voc j possui um banco de dados com outra configurao de caractere e tipo de collate: ALTER DATABASE <nomebd> DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci NOTA: Todas as tabelas criadas depois deste procedimento tero suporte a utf8.
Copyright 2003-2008 vtiger.com.Todos os direitos reservados. vtiger uma marca registrada de vtiger.com. Todas as outras marcas so de propriedade de seus respectivos donos.

2.3.

Nvel de Tabela

Voc pode habilitar o suporte a UTF-8 para cada tabela individual. 2.4. Nvel Coluna

Voc pode habilitar o suporte a UTF-8 para um tipo de texto especfico de uma coluna, este procedimento cancelar todas as outras configuraes.

Copyright 2003-2008 vtiger.com.Todos os direitos reservados. vtiger uma marca registrada de vtiger.com. Todas as outras marcas so de propriedade de seus respectivos donos.

3. Instalao do vtiger
Se voc est criando uma base de dados durante o processo de instalao, certifique-se que a caixa de seleo Enable UTF-8 est ativada.

Se voc estiver criando uma base de dados antes da instalao, crie esta base de dados com o nvel de suporte UTF-8 conforme discutido na seo anterior.

Copyright 2003-2008 vtiger.com.Todos os direitos reservados. vtiger uma marca registrada de vtiger.com. Todas as outras marcas so de propriedade de seus respectivos donos.

4. Confirmao de Configuraes do vtiger

O suporte do banco de dados UTF-8 verificado durante a etapa confirmao de configuraes da instalao. Esta verificao baseada no caractere configurado na base de dados e nos valores de collation. Se for detectado que a base de dados tem suporte a UTF-8 ento, exibido Enabled como mostrado abaixo:

Se voc estiver utilizando uma base de dados sem suporte a UTF-8 isto ser destacado.

Voc poder continuar com a instalao, mas o suporte a UTF-8 no estar totalmente disponvel.

Copyright 2003-2008 vtiger.com.Todos os direitos reservados. vtiger uma marca registrada de vtiger.com. Todas as outras marcas so de propriedade de seus respectivos donos.

5. Referncias
http://dev.mysql.com/doc/refman/5.0/en/charset-connection.html

Nota do tradutor: Traduzido para o Portugus por: Valmir Carlos Trindade | 04.02.2008 TTCA Consultoria Empresarial 80060-100 - Curitiba Paran - Brasil http://www.ttcasolucoes.com.br valmir@ttcasolucoes.com.br

Copyright 2003-2008 vtiger.com.Todos os direitos reservados. vtiger uma marca registrada de vtiger.com. Todas as outras marcas so de propriedade de seus respectivos donos.