OpenERP Brasil

Primeiros Passos com a OpenERP

Este tutorial tem a finalidade de explicar os primeiro passos para instalar o OpenERP e a instalação de um ambiente padrão de desenvolvimento, assim como uma breve explicação de alguns conceitos sobre a arquitetura. Sugerimos que você use o sistema Operacional Linux de preferência uma distribuição baseada no Debian, pois as ferramentas de desenvolvimento do OpenERP são nativas e algumas já vem pré instaladas, Se você utiliza o sistema operacional windows aconselhamos a instalação do pacote all-in-one que instala o OpenERP e o PostgreSQL já configurado e pronto para executar.

Baixando a versão de desenvolvimento do OpenERP

O comunidade do projeto OpenERP se reuni Launchpad, lá é onde se organiza os códigos, tarefas, controle de bugs, traduções, os times de desenvolvimento e os times regionais que cuidam das localizações, para baixar o OpenERP:

$ bzr branch lp:openerp

Ao baixar a branch do OpenERP será criada uma pasta openerp com 2 arquivos bzr_set.py e readme.txt, para baixar todos os arquivos do projeto basta usar o arquivo bzr_set.py você também pode usar estes argumentos:

• -v VERSION, você pode escolher qual versão você quer instalar:
  • trunk: Atual versão de desenvolvimento
  • 5.0: Versão estável do OpenERP
  • 4.0: Versão anterior
• --checkout=LPLOGIN, especifica um usuário para fazer o checkout da branch

Ao executar o bzr_set.py:

$ bzr_set.py --checkout=USUARIO -v trunk

Será baixado todas a branchs do projeto da versão atual do desenvolvimento se você não esta muito familiarizado com o OpenERP, será melhor baixar a versão estável:

$ bzr_set.py --checkout=USUARIO -v 5.0

As seguintes branchs serão baixadas:

• addons: Conjunto dos principais módulos
• addons-extra: Extenção dos módulos padrões do OpenERP
• addons-community: Módulos publicados pela comunidade em geral
• server: Servidor do OpenERP, ao baixar o script cria um link na pasta bin/addons para a pasta da branch addons.
• client: Cliente do OpenERP padrão escrito em GTK+
• web: Cliente web

Executando o servidor OpenERP

Depois de baixar o código vamos executa-lo, mas antes temos que verificar se o sistema possui todos os requisitos para rodar o OpenERP, verifique se eles estão instalados : Python 2.5 ou 2.6 e os pacotes do Python:

• python-psycopg2
• python-reportlab
• python-pychart
• python-pydot
• python-egenix-mxdatetime
• python-xml
• python-lxml
• python-libxslt1
• python-tz
• python-imaging
• python-vobject

Instalando os pacotes em distribuições baseadas no Debian e Ubuntu:

sudo apt-get install python python-psycopg2 python-reportlab \
     python-egenix-mxdatetime python-xml python-tz python-pychart \
     python-pydot python-lxml python-libxslt1 python-vobject

Com todos os pacotes do python instalados, o outro passo é instalar o servidor de banco de dados, o OpenERP utiliza o PostgreSQL versão 8.3 ou superior, suponhamos que você já tenha o servidor de banco de dados instalado e configurado, é fora de escopo deste tutorial a instalação do PostgreSQL, mas se você tiver duvida em instala-lo você encontrar bons tutoriais na internet disponível para auxilia-lo. Agora vamos ao que interesa, com todo ambiente configurado e pronto, basta executar o servidor OpenERP:

  $ OPENERP_SERVER/bin/openerp-server.py

Executando OPENERP_SERVER/bin/openerp-server.py -h será apresentado todos os argumentos disponível para configurar o servidor como:

• Argumentos relacionados a configuração do banco de dados:
  • -d NOME_BD ou --database=NOME_BD, especifica o nome do banco de dados
  • -r USUARIO_DB ou --db_user=USUARIO_DB, nome do usuário do banco de dados
  • -w SENHA_DB ou --db_password=SENHA_DB, senha do usuário do banco de dados
  • --pg_path=PG_PATH, especifica o PATH dos programas pg
  • --db_host=HOST_DB, especifica o servidor de banco de dados
  • --db_port=PORTA_HOST_DB, informa a porta utilizada pelo servidor de banco de dados
• -s ou --save, salva as configurações no arquivo ~/.openerp_serverrc
• -c ARQUIVO_CONFIG, --config=ARQUIVO_CONFIG, especifica um arquivo de configuração

Aconselhamos na primeira inicialização criar um arquivo de configuração e salvar as opções do usuário e senha do banco de dados como o exemplo abaixo:

  $ OPENERP_SERVER/bin/openerp-server.py -s -r USUARIO_DB -w SENHA_DB

Executando o cliente GTK OpenERP

A instalação do cliente GTK,que é o cliente padrão do OpenERP é bem mais simples do que a instalação do servidor, para executar o cliente esteja certo de que este pacotes estão instalados em seu sistema:

• python-gtk2
• python-glade2
• python-matplotlib
• python-egenix-mxdatetime
• python-xml
• python-tz
• python-hippocanvas

Agora basta executar o cliente:

  $ OPENERP_CLIENT/bin/openerp-client.py

Ao executar o cliente a primeira coisa que você precisa fazer e criar um banco de dados, você fazer isso indo em Arquivo > Banco de dados > Novo banco de dados:

Instalando a Localização Brasileira

Com o OpenERP instalado você pode baixar a localização brasileira l10n_br, atualmente a localização é composta de dois módulos o l10n_br com contém as customizações necessárias para o funcionamento do OpenERP no Brasil e o módulo l10n_br_data contendo uma serie de dados para auxiliar o funcionamento da localização como por exemplo:

• Cadastro das UF e o código do IBGE
• Cadastro de todos os municipios e seus códigos IBGE
• Cadastro de CEP's
• relação de todos os bancos no Brasil
• Tipos de documentos fiscais
• Cadastro de CFOP
• Cadastro de Classificação fiscal - NCM

Para a instalação da localização brasileira é necessário primeiro baixar dois módulos que está listados na dependência da localização: account_fiscal_position_rule e account_product_fiscal_classification estes módulos não estão no addons do OpenERP e para baixa-los basta baixar a branch:

  $ bzr branch lp:~akretion-team/+junk/account_fiscal_position_rule

  $ bzr branch lp:~akretion-team/+junk/account_product_fiscal_classification

Após baixar os modulos você deve criar um link simbolico da pasta do módulo na pasta OPENERP_SERVER/bin/addons:

  $ ln -s account_fiscal_position_rule OPENERP_SERVER/bin/addons/

  $ ln -s account_product_fiscal_classification OPENERP_SERVER/bin/addons/

Agora baixando a localização:

  $ bzr branch lp:openerp.pt-br-localiz

Após baixar a localização você deve criar um link simbolico das duas pastas dentro da openerp.pt-br-localiz

  $ ln -s l10n_br OPENERP_SERVER/bin/addons/

  $ ln -s l10n_br_data OPENERP_SERVER/bin/addons/

Finalizados estes pasos você pode usar o Cliente OpenERP ou o Cliente Web do OpenERP para finalizar a instalação. Vá em Adminsitração > Administração de Módulos > Atualizar Lista de Módulos para atualizar a lista de módulos para visualizar todos os módulos que foi adicionado na pasta addons:

Depois de ter atualizado a lista dos módulos, será encontrado 4 novos módulos:

Agora basta selecionar os módulos que serão instalados no sistemas: account_fiscal_position_rule, account_product_fiscal_classification, l10n_br, l10n_br_data.

Você pode localizar os módulos que deseja instalar filtrando pelo campo nome, como os account_fiscal_position_rule e account_product_fiscal_classification já estão na dependências do l10n_br basta agendar para instalação diretamente os dois módulos da localização que diretamente o OpenERP vai instalar as dependências

Não ocorrendo nenhum problema a instalação será finalizada, e surgirá um assistente para auxiliar em parametrizar algumas configuração ou se você conhece bem os módulos que você instalou, pode fechar e realizar estas parametrizações manualmente depois finalizando a instalação.

Concluida a instalação do OpenERP e da localização brasileira você esta pronto para explorar e conhece-lo melhor, como conhecer os recursos e fincionalidades implementadas e que serão implementadas basta acessar Localização Brasileira.