JDCM5000
PLANOS DE MANUTENÇÃO
Este programa tem como objetivo cadastrar e/ou importar os Planos de Manutenção de cada modelo de máquina/equipamento, que são disponibilizados pela montadora, para serem utilizados posteriormente na contratação dos acordos de manutenção.
Tabelas utilizadas: JDCAPLMA, JDREPLMA, JDPRPLMA e JDSEPLMA.
Campos
- Modelo Plano: Código do modelo da máquina/equipamento que identifica o plano de manutenção. Será informado no cadastramento ou importado da planilha disponibilizada pela montadora.
- Atualização: Data da última atualização do plano de manutenção. Será calculada automaticamente no cadastramento ou na importação dos planos, utilizando a data corrente, e exibida para consulta. Este campo não poderá ser alterado pelo usuário.
- Total Plano: Valor total do plano de manutenção. Será calculado automaticamente no cadastramento ou na importação dos planos, através do somatório do valor total das revisões que compõem o plano, e exibido para consulta. Este campo não poderá ser alterado pelo usuário.
- Revisões Programadas: Revisões programadas que compõem o plano de manutenção. Campos referentes às revisões:
- Revisão: Número da revisão programada. Será informado no cadastramento ou importado da planilha disponibilizada pela montadora.
- Horas: Quantidade de horas da revisão programada. Será informada no cadastramento ou importada da planilha disponibilizada pela montadora.
- Total Revisão: Valor total da revisão programada. Será calculado automaticamente no cadastramento ou na importação dos planos, através do somatório do valor das peças e do valor dos serviços da revisão, e exibido para consulta. Este campo não poderá ser alterado pelo usuário.
- Peças: Peças que compõem a revisão programada. Campos referentes às Peças:
- Código: Código da peça que compõe a revisão programada. Será informado no cadastramento ou importado da planilha disponibilizada pela montadora.
- Descrição: Descrição da peça na revisão programada. Será selecionada do cadastro de peças no cadastramento ou na importação dos planos, e exibida para consulta. Este campo não poderá ser alterado pelo usuário.
- Quantidade: Quantidade da peça na revisão programada. Será informada no cadastramento ou importada da planilha disponibilizada pela montadora.
- Valor Unitário: Valor unitário da peça na revisão programada. Será selecionado do cadastro de preços das peças no cadastramento ou na importação dos planos, e exibido para consulta. Este campo não poderá ser alterado pelo usuário.
- Desconto: Valor total do desconto da peça na revisão programada. Será informado opcionalmente no cadastramento ou importado da planilha disponibilizada pela montadora.
- Valor Total: Valor total da peça na revisão programada. Será calculado automaticamente no cadastramento ou na importação dos planos, através da fórmula: Valor Total = Quantidade x Valor Unitário – Desconto, e exibido para consulta. Este campo não poderá ser alterado pelo usuário.
- Total Peças: Valor total das peças que compõem a revisão programada. Será calculado automaticamente no cadastramento ou na importação dos planos, através do somatório do valor total de todas as peças que compõem a revisão, e exibido para consulta. Este campo não poderá ser alterado pelo usuário.
- Serviços: Serviços que compõem a revisão programada. Campos referentes aos serviços:
- Código: Código do serviço que compõe a revisão programada. Será informado no cadastramento ou importado da planilha disponibilizada pela montadora.
- Descrição: Descrição do serviço na revisão programada. Será selecionada do cadastro de serviços no cadastramento ou na importação dos planos, e exibida para consulta. Este campo não poderá ser alterado pelo usuário.
- Quantidade: Quantidade do serviço na revisão programada. Será informada no cadastramento ou importada da planilha disponibilizada pela montadora.
- Valor Unitário: Valor unitário do serviço na revisão programada. Será selecionado do cadastro de preços dos serviços no cadastramento ou na importação dos planos, e exibido para consulta. Este campo não poderá ser alterado pelo usuário.
- Desconto: Valor total do desconto do serviço na revisão programada. Será informado opcionalmente no cadastramento ou importado da planilha disponibilizada pela montadora.
- Valor Total: Valor total do serviço na revisão programada. Será calculado automaticamente no cadastramento ou na importação dos planos, através da fórmula: Valor Total = Quantidade x Valor Unitário – Desconto, e exibido para consulta. Este campo não poderá ser alterado pelo usuário.
- Total Serviços: Valor total dos serviços que compõem a revisão programada. Será calculado automaticamente no cadastramento ou na importação dos planos, através do somatório do valor total de todos os serviços que compõem a revisão, e exibido para consulta. Este campo não poderá ser alterado pelo usuário.
A importação da planilha com os planos de manutenção disponibilizados pela montadora será realizada através da opção Importa ou da função F4.
Campos
Nome do Arquivo: Nome do arquivo a ser importado. Deverá ser informado o nome exato do arquivo disponibilizado pela montadora ou acionada a opção de pesquisa para seleção dos arquivos disponíveis no diretório.
Instruções e Observações
- Cada modelo de máquina/equipamento possui um único plano de manutenção, composto por uma ou mais revisões programadas. Cada revisão programada é composta por um conjunto de peças e/ou serviços.
- Os planos poderão ser cadastrados manualmente ou importados da planilha disponibilizada pela montadora.
- Ao ser processada a importação, os planos de manutenção que vierem na planilha e que não estiverem na base de dados deverão ser incluídos.
- Os planos de manutenção que que vierem na planilha e já estiverem na base de dados deverão ser substituídos, mesmo se já tenham sido alterados pelo usuário após sua última importação.
- Os planos de manutenção que estiverem na base de dados e não virem na planilha, deverão ser preservados sem nenhuma alteração.
- Tanto os planos cadastrados manualmente quanto os planos importados, poderão ser alterados ou excluídos pelo usuário.
- As alterações efetuadas nos planos não interferem nos acordos já gerados a partir destes planos, sendo consideradas somente para novos acordos gerados após as alterações.
- A planilha contendo os planos de manutenção será enviada pela montadora aos concessionários, por e-mail, sempre que for necessário proceder a atualização dos planos.
- O usuário deverá parametrizar no COPE0100, para o programa JDCM5000, o diretório de integração ../Intfabrica/ onde a planilha deverá ser recebida da montadora e importada para o sistema.
- Quando a planilha for recebida por e-mail, deverá ser copiada para o diretório de integração com o nome a ser informado no processo de importação.
- A ser acionada a opção Importa ou a função F4 do JDCM5000, será verificada a existência da planilha no diretório, e exibida uma mensagem de confirmação se deseja processar a importação.
- Caso seja confirmado, será lida a planilha e consideradas as abas: Base SIMM Preços (plano de manutenção analítico) e Base Mão de Obra (plano de manutenção sintético). As demais abas serão desconsideradas.
- Na importação da planilha, serão seguidas as seguintes regras:
- Acessar a aba Base SIMM Preços e ler cada linha da planilha.
- Para cada linha lida, considerar a coluna Produto. Esta coluna contém os 4 primeiros dígitos do código do modelo do equipamento. Para cada código diferente que for lido nesta coluna, considerar estes 4 dígitos e ler a tabela CXMODELO (VEIC0100), selecionando todos os modelos que se iniciem com estes 4 dígitos. Cada modelo lido, será considerado um modelo a ser gravado na tabela de Plano de Manutenção (JDCAPLMA). Neste caso, a data de atualização deverá ser gravada com a data corrente e o valor do plano deverá ser gravado inicialmente zerado, para que posteriormente, no final do processo de importação seja totalizado. Caso não seja encontrado nenhum modelo na CXMODELO, o código lido será considerado o código de um novo modelo e deverá ser incluído também na CXMODELO utilizando o campo Grupo Modelo parametrizado no JDCM4000.
- Para cada modelo gravado anteriormente, ler as colunas referentes aos códigos das revisões (colunas K ate W) e gravar na tabela de Revisões Plano Manutenção ( JDREPLMA). Neste caso, o número da revisão será um número sequencial da revisão de cada modelo (1,2,3,4, etc..) e as horas da revisão serão o código que aparece no título das colunas (250, 500, 1000, etc...). Já o valor da revisão deverá ser gravado inicialmente zerado para que posteriormente, no final do processo de importação, seja totalizado. Importante: Nesta tabela, todas as revisões que constam nas colunas deverão ser gravadas, independentemente de estarem ou não marcadas com X para as operações que compõem a revisão.
- Para cada modelo e cada revisão gravados anteriormente, ler as informações das peças que se aplicam a cada modelo e a cada revisão, e gravar estas informações na tabela de Produtos Plano Manutenção (JDPRPLMA). Neste caso, o código do item deverá ser a coluna Item, a quantidade será a coluna QTD, o valor unitário será a coluna LPP, o desconto será zero e o valor total será a coluna Total. Antes da gravação, o código do produto deverá ser consistido com a tabela CMPRODUT e caso não exista deverá ser gravado também nesta tabela. Na gravação de novos produtos na tabela CMPRODUT será utilizado o campo Grupo Peças parametrizado no JDCM4000 e a descrição do produto será igual ao código do produto.
Importante: A peça somente deverá ser gravada para as respectivas revisões do plano de manutenção que estejam marcadas com um X nas colunas de K até W.
- Para cada modelo e cada revisão gravados anteriormente, ler as informações dos serviços que se aplicam a cada modelo e a cada revisão, e gravar estas informações na tabela de Serviços Plano Manutenção (JDSEPLMA). Neste caso, o código do serviço deverá ser a coluna Código, a quantidade (em horas) será a coluna Tempo e o desconto será zero. Para selecionar o valor unitário deverá ser acessada a aba Base Mão de Obra e utilizar a coluna Valor MO referente a cada modelo. Para calcular o valor total, multiplicar a quantidade em horas pelo valor unitário da hora. Neste caso fique atento porque a quantidade é em horas e não em decimal. Antes da gravação, o código do serviço deverá ser consistido com a tabela CSSERVIC e caso não exista deverá ser gravado também nesta tabela. Antes de efetuar a gravação dos novos serviços na tabela CSSERVIC, será exibida em tela a relação dos serviços a serem incluídos, mostrando como default os campos Tipo Serviço, Setor Serviço e Tipo Item Serviço parametrizados no JDCM4000, e permitido que o usuário altere ou confirme estas informações. Somente após o usuário confirmar ou alterar os valores apresentados em tela, os serviços serão incluídos e a importação da planilha será finalizada. Somente os novos serviços que serão incluídos no cadastro de serviços deverão ser listados na tela. Somente os campos Tipo Serviço, Setor Serviço e Tipo Item Serviço poderão ser alterados pelo usuário. Os campos alterados pelo usuário deverão ser consistidos de acordo com suas respectivas tabelas. Na inclusão de um novo serviço, a descrição do serviço será igual ao código do serviço.
Importante: O serviço somente deverá ser gravado para as respectivas revisões do plano de manutenção que estejam marcadas com um X nas colunas de K até W.
- Após as gravações, totalizar o valor de cada revisão, somando o valor das peças e dos serviços que compõem a revisão, e totalizar o valor de cada plano, somando o valor de todas as revisões que compõem o plano.
- No final do processo de importação, exibir uma mensagem de Importação realizada com sucesso, mostrando a quantidade de planos que foram importados e excluir a planilha que foi importada.
- Para processar a importação da planilha, deverão ser efetuadas as seguintes configurações:
- Atualizar a biblioteca LinxMaq Importação Planilha disponibilizada na página, responsável por manipular documentos Microsoft (como por exemplo o Excel). O arquivo poi.jar encontra-se no diretório padrão, previamente definido pelo cliente, no qual deverá ter seu backup realizado antes de sua substituição. Recomendamos, entretanto, que o arquivo poi.jar (versão 3.14), seja inserido dentro da pasta gênero, encontrada através do diretório /usr/local/genero. – vide exemplo a seguir.
- Acessar o caminho /usr/local/genero/gas/app, localizar o arquivo de configuração do banco de dados com a extensão ".xcf", realizar o seu backup e abri-lo para configurá-lo. Por padrão, é possível encontrar as instâncias treino e standart (produção). Para manter a integridade dos dados, somente pessoas com conhecimento em Linux e permissões adequadas de acesso devem alterar estes arquivos. No arquivo ".xcf", será necessário localizar a tag <ENVIRONMENT_VARIABLE Id="CLASSPATH"> na qual deverão ser incluídos os caminhos dos arquivos .jar que foram enviados em anexo.
São eles:
/usr/local/genero/poi.jar
/usr/local/lib/poi-examples-3.14-20160307.jar
/usr/local/lib/poi-excelant-3.14-20160307.jar
/usr/local/lib/poi-ooxml-3.14-20160307.jar
/usr/local/lib/poi-ooxml-schemas-3.14-20160307.jar
/usr/local/lib/poi-scratchpad-3.14-20160307.jar
/usr/local/lib/commons-codec-1.10.jar
/usr/local/lib/commons-logging-1.2.jar
/usr/local/lib/junit-4.12.jar
/usr/local/lib/log4j-1.2.17.jar
/usr/local/lib/jdcm.jar
COMO DEVE FICAR NO ARQUIVO .XCF
EXEMPLO:
<ENVIRONMENT_VARIABLE Id="CLASSPATH">/usr/local/genero/poi.jar:usr/local/genero/fgl/lib/fgl.jar:/usr/local/jre1.6/itext-1.4.8.jar:/usr/local/jre1.6/sisdiaapi.jar:/usr/local/genero/commons-codec-1.10.jar:/usr/local/genero/commons-logging.jar:/usr/local/genero/curvesapi-1.03.jar:/usr/local/genero/jdcm.jar:/usr/local/genero/junit-4.12.jar:/usr/local/genero/log4j-1.2.17.jar:/usr/local/genero/poi-examples-3.14-20160307.jar:/usr/local/genero/poi-excelant-3.14-20160307.jar:/usr/local/genero/poi-ooxml-3.14-20160307.jar:/usr/local/genero/poi-ooxml-schemas-3.14-20160307.jar:/usr/local/genero/poi-scratchpad-3.14-20160307.jar:/usr/local/genero/xmlbeans-2.6.0.jar</ENVIRONMENT_VARIABLE>
- Localizar a tag <ENVIRONMENT_VARIABLE Id="CLASSPATH">/, na qual deverá ser alterada, verificando se o caminho especificado para a poi.jar está correto.
- Em paralelo, os arquivos do tipo .jar devem ser incluídos por padrão na pasta lib e genero, conforme segue o exemplo: /usr/local/lib/nome_do_arquivo.jar.
/usr/local/gênero/nome_do_arquivo.jar
Os arquivos .jar que deverão constar na pasta lib e gênero são:
poi-examples-3.14-20160307.jar; poi-excelant-3.14-20160307.jar
poi-ooxml-3.14-20160307.jar; poi-ooxml-schemas-3.14-20160307.jar
poi-scratchpad-3.14-20160307.jar; commons-codec-1.10.jar
commons-logging-1.2.jar; junit-4.12.jar
log4j-1.2.17.jar; jdcm.jar
PASTA LIB:
PASTA GENERO:
- Por último, deverá ser incluída a seguinte linha no arquivo ".xcf":
<ENVIRONMENT_VARIABLE Id="_JAVA_OPTIONS">-Xmx1g</ENVIRONMENT_VARIABLE>
Obs: Este valor de memória a ser informado no arquivo .xcf deve ser o mesmo valor que é informado no arquivo catalina.sh (/usr/local/tomcat/bin/catalina.sh) na linha CATALINA_OPTS: