PJCUS-361 CONTRATO COM CÓDIGO DE BARRAS 1
Sumário 1. OBJETIVO... 3 2. HABILITAR FUNCIONALIDADE... 3 3. INSTALANDO OPENOFFICE 4... 3 4. AMBIENTE WINDOWS... 3 4.1. VARIÁVEL DE AMBIENTE... 3 4.2. ADICIONAR NA INICIALIZAÇÃO DO WINDOWS... 3 4.3. EXECUTAR COMO PROCESSO... 4 4.4. TESTE... 4 5. AMBIENTE LINUX... 5 5.1. EXECUTAR COMO PROCESSO... 5 5.2. TESTE... 5 6. CADASTRO DE PROPRIEDADES DO SISTEMA... 6 7. CONSIDERAÇÕES FINAIS... 7 2
1. OBJETIVO Esta documentação tem como objetivo auxiliar na instalação das ferramentas que fazem parte da funcionalidade de conversão de documentos para PDF. 2. HABILITAR FUNCIONALIDADE Para que a funcionalidade seja habilitada, você deve criar um tipo de requisição marcando a opção Função Código de Barras e selecionar este tipo ao cadastrar uma requisição. Este campo será mostrado somente se criado um item de configuração do cliente com as informações: Nome: HABILITA_CONVERSAO_E_CODIGO_BARRAS Valor: true ou T Para cadastrar esta configuração acesse Painel de Controle Instâncias Aba Itens da Configuração do Cliente. 3. INSTALANDO OPENOFFICE 4 Quando o ambiente do Projuris estiver na plataforma Windows ou Linux, o programa Apache Open Office 4 deve ser instalado. Faça o download através de um dos endereços: Para Windows: http://www.openoffice.org/download/index.html Para Linux: http://www.openoffice.org/download/other.html de acordo com a plataforma/versão do Linux. 4. AMBIENTE WINDOWS Agora com o Apache Open Office 4 instalado, siga os passos para executar como serviço e os testes. 4.1. VARIÁVEL DE AMBIENTE Crie a variável de ambiente OPENOFFICE_PATH com o valor correspondente o caminho do executável soffice.exe (com as aspas duplas). Por exemplo: C:\Program Files (x86)\openoffice 4\program\soffice.exe. 4.2. ADICIONAR NA INICIALIZAÇÃO DO WINDOWS Passo 1: Pressione WinKey (Windows) + R para abrir o Executar ; Passo 2: Digite %AppData%\Microsoft\Windows\Start Menu\Programs\Startup (sem aspas) e pressione Enter; Passo 3: Uma janela do Windows Explorer será aberta. É nessa pasta que você deve copiar o arquivo start-service-openoffice.bat. Pronto! Na próxima vez que você iniciar o Windows, o OpenOffice será aberto automaticamente assim que o sistema for carregado. 3
4.3. EXECUTAR COMO PROCESSO Após instalado, o programa deve ser executado como processo para ser utilizado quando necessário. Para isto, o arquivo start-service-openoffice.bat deve ser executado para subir o processo do Apache Open Office 4. 4.4. TESTE O arquivo teste-codigo-de barras.zip contém os arquivos necessários. Siga os passos abaixo: Passo 1: Descompacte o arquivo teste-codigo-de barras.zip ; Passo 2: Execute o arquivo openoffice-example.jar ou através da linha de comando execute java -jar openoffice-example.jar. Neste momento o arquivo teste.docx será convertido para pdf. Passo 3: Verifique se na mesma pasta foi gerado o arquivo teste.pdf. Se sim, está tudo certo e poderá utilizar a funcionalidade no Projuris. Se não, verifique os pré-requisitos novamente e caso persista, entre em contato com o Suporte. 4
5. AMBIENTE LINUX Agora com o Apache Open Office 4 instalado, siga os passos para executar como serviço e os testes. 5.1. EXECUTAR COMO PROCESSO Após instalado, o programa deve ser executado como processo para ser utilizado quando necessário. O arquivo start-service-openoffice.sh deve ser executado para subir o processo do Apache OpenOffice 4. Antes de executar o arquivo, é necessário criar a variável de ambiente OOFFICE, que deve conter o caminho de instalação do programa + executável, por exemplo: /opt/openoffice4/program/soffice. Para saber onde foi instalado, no terminal execute whereis soffice e será listado o diretório. Para criar a variável de ambiente no Linux edite o arquivo /etc/profile e na última linha coloque export OOFFICE='/usr/bin/soffice'. Faça este mesmo procedimento nos arquivos: ~/.bash_profile, ~/.bash_login e ~/.profile. Deixe o arquivo start-service-openoffice.sh como executável (chmod +x [ARQUIVO]) e execute para subir o processo Apache OpenOffice 4. Caso aconteça algum erro ao executar o arquivo, no terminal rode o comando: $OOFFICE "-accept=socket,host=localhost,port=8100;urp;staroffice.servicemanager" - norestore -nofirststartwizard -nologo -headless & 5.2. TESTE Após instalar e subir o processo do Apache OpenOffice 4, efetue o teste do conversor para checar se está tudo instalado corretamente. O arquivo teste-codigo-de-barras.zip que contém os arquivos necessários. Siga os passos abaixo: 1º Passo: Descompacte o arquivo teste-codigo-de-barras.zip ; 2º Passo: Execute o arquivo openoffice-example.jar ou através da linha de comando execute java -jar openoffice-example.jar. Neste momento o arquivo teste.docx será convertido para pdf. 3º Passo: Verifique se na mesma pasta foi gerado o arquivo teste.pdf. Se sim, está tudo certo e poderá utilizar a funcionalidade no Projuris. Se não, verifique os pré-requisitos novamente e caso persista, entre em contato com o Suporte. 5
6. CADASTRO DE PROPRIEDADES DO SISTEMA Passo 1: Acesse Painel de Controle Instâncias; Passo 2: Selecione projuris. Passo 3: Selecione a aba Itens da configuração do cliente. Verifique se o item já foi cadastrado, clicando em Busca Avançada, colocando no filtro o nome da configuração. Caso não exista, clique no botão Adicionar. 6
Passo 4: Na tela de cadastro, preencha as informações do item de configuração conforme a necessidade. Na sequência, clique em Salvar para gravar o item. Abaixo o exemplo: 7. CONSIDERAÇÕES FINAIS Caso algum termo não tenha ficado claro e não consiga utilizar a funcionalidade corretamente, favor entre em contato com nosso Suporte solicitando uma melhoria na documentação. Somente assim conseguiremos disponibilizar o melhor para você cliente. 7