Boletim Técnico: Implementação da rotina Qtd Max Componente
Ocorrência
Nova Rotina
Resumo
Implementada melhoria com a criação da rotina Qtd Max Componente (OFIOA800). Essa rotina permite criar um agrupamento de itens informando a quantidade máxima que poderá ser requisitado. Assim, ao requisitar itens em uma OS, o usuário não poderá requisitar uma quantidade superior à quantidade máxima informada no agrupamento.
ID do Chamado
TDQIU0
Produtos
Microsiga 11
Módulos
- SIGAOFI
Países
- Brasil
Sistema Operacional
todos
Bancos de Dados
- todos
Nome + Fonte
Qtd Max Componente (OFIOA800), Modelos (VEIVA020) e Req Peças (OFIOM020)
Ajustes no Compatibilizador
Sim
Integridade Referencial
Não
Aplicação de Patch
Não
Compatibilizador 1
- UPDOFIH3
Procedimentos para Implementação
Aplicar atualização do(s) programa(s) OFIOA800 e UPDOFIH3.
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.
Antes de executar o compatibilizador UPDOFIH3 é imprescindível:
a) Realizar o backup da base de dados do produto que será executado o compatibilizador (\PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (\PROTHEUS11_DATA\SYSTEM).
b) Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
c) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
d) Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
e) O compatibilizador deve ser executado com a Integridade Referencial desativada*.
|
O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente!
A ativação indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no banco de dados. Portanto, antes de utilizá-la, observe atentamente os procedimentos a seguir:
i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação (APCFG60A). ii. Se não há Integridade Referencial ativa, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário qualquer outro procedimento de ativação ou desativação de integridade, basta finalizar a verificação e aplicar normalmente o compatibilizador, conforme instruções. iii. Se há Integridade Referencial ativa em todas as empresas e filiais, é exibida uma mensagem na janela Verificação de relacionamento entre tabelas. Confirme a mensagem para que a verificação seja concluída, ou; iv. Se há Integridade Referencial ativa em uma ou mais empresas, que não na sua totalidade, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em) integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada e reserve esta anotação para posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework para informações quanto a um arquivo que contém essa informação). v. Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D). vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções. vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da integridade, selecione-a(s) novamente e confirme a ativação.
Contate o Help Desk Framework EM CASO DE DÚVIDAS!
|
1. Em Microsiga Protheus Smart Client, digite U_UPDOFIH3 no campo Programa Inicial.
2. Clique em OK para continuar.
3. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
4. Clique em Sim para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela.
5. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
6. Clique em Gravar para salvar o histórico (log) apresentado.
Clique em OK para encerrar o processamento.
Descrição de Ajustes
1. Criação de Tabelas no Dicionario de dados – SX2:
| Chave | VZZ | VSX |
| Nome | Qtd Máxima do Componente | Agrupamento de Peças Controlad |
| Modo | Exclusivo | Exclusivo |
| Único | VZZ_FILIAL+VZZ_CODAGM+VZZ_GRUITE+VZZ_CODITE |
|
| Pyme | Sim | Sim |
| Módulo | Oficina | Oficina |
2. Alteração de Campos no arquivo SX3 – Campos:
· Tabela VS3 – Itens de Orçamento (Peças):
| Campo | VS3_QTDITE |
| Tipo | Numérico |
| Tamanho | 10 |
| Decimal | 4 |
| Formato | @E 99999.9999 |
| Contexto | Real |
| Propriedade | Alterar |
| Título | Qtd Requisit |
| Descrição | Qtde Requisitada |
| Help | Quantidade da Peça Desejada pelo Cliente |
| Val. Sistema | FS_TOTPEC() .and. VALPMOD020( M->VS3_GRUITE ,M->VS3_CODITE ,M->VS3_QTDITE,"1", "1") |
| Nível | 1 |
| Obrigatório | Sim |
| Usado | Sim |
| Browse | Sim |
| Modulos | SIGAVEI, SIGAOFI e SIGAPEC |
Criação de Campos no arquivo SX3 – Campos:
· Tabela VV2 – Modelos de Veículos:
| Campo | VV2_CODAGM | VV2_DESAGM |
| Tipo | Caracter | Caracter |
| Tamanho | 6 | 25 |
| Decimal | 0 | 0 |
| Formato | @!S6 | @!S25 |
| Contexto | Real | Virtual |
| Propriedade | Alterar | Visualizar |
| Título | Cód.Agrup. | Descrição |
| Descrição | Cód.Agrupamento | Descrição do agrupamento |
| Help | Informe o código do agrupamento. | Informe a descrição do grupo. |
| Lista Opções |
|
|
| Inic. Padrão |
| IF(!INCLUI,POSICIONE("VSX",1,XFILIAL("VSX")+VV2->VV2_CODAGM,"VSX_DESAGM"),"") |
| Inic. Browse |
| Posicione("VSX",1,xFilial("VSX")+VV2->VV2_CODAGM,"VSX_DESAGM") |
| Cons. Padrão | EVSX |
|
| Val. Sistema | VAZIO() .or. FG_Seek("VSX","M->VV2_CODAGM",1,.f.,"VV2_DESAGM","VSX_DESAGM") |
|
| Nível | 1 | 1 |
| Obrigatório | Não | Não |
| Usado | Sim | Sim |
| Browse | Sim | Sim |
| Modulos | Todos | Todos |
· Tabela VSX – Agrupamento de Peças Controlad:
| Campo | VSX_FILIAL | VSX_CODAGM | VSX_DESAGM |
| Tipo | Caracter | Caracter | Caracter |
| Tamanho | 8 | 6 | 25 |
| Decimal | 0 | 0 | 0 |
| Formato | @!S2 | @!S6 | @!S25 |
| Contexto | Real | Real | Real |
| Propriedade | Alterar | Alterar | Alterar |
| Título | Filial | Cod.Agrup. | Des.Agrup. |
| Descrição | Filial | Cod. do Agrupamento | Descr.do Agrupamento |
| Help | Informe código da Filial. | Informe o código do agrupamento. | Informe a descrição do agrupamento. |
| Nível | 1 | 1 | 1 |
| Obrigatório | Não | Sim | Sim |
| Usado | Não | Sim | Sim |
| Browse | Não | Sim | Sim |
| Modulos |
| SIGAVEI, SIGAOFI e SIGAPEC | SIGAVEI, SIGAOFI e SIGAPEC |
· Tabela VZZ – Qtd Maxima do Componente:
| Campo | VZZ_FILIAL | VZZ_CODAGM | VZZ_GRUITE |
| Tipo | Caracter | Caracter | Caracter |
| Tamanho | 8 | 6 | 4 |
| Decimal | 0 | 0 | 0 |
| Formato | @!S2 | @!S6 | @!S4 |
| Contexto | Real | Real | Real |
| Propriedade | Alterar | Alterar | Alterar |
| Título | Filial | Cód.Agrup. | Grupo Item |
| Descrição | Filial | Cód. do Agrupamento | Grupo do Item |
| Help | Informe código da Filial. | Informe o código do agrupamento. | Informe o grupo do item. |
| Cons. Padrão |
|
| SBM |
| Val. Sistema |
|
| VAZIO() .or. FG_Seek("SBM","M->VZZ_GRUITE",1,.f.,"VZZ_DESGRU","BM_DESC") |
| Nível | 1 | 1 | 1 |
| Obrigatório | Não | Sim | Não |
| Usado | Não | Sim | Sim |
| Browse | Não | Sim | Sim |
| Modulos |
| SIGAVEI, SIGAOFI e SIGAPEC | SIGAVEI, SIGAOFI e SIGAPEC |
| Campo | VZZ_DESGRU | VZZ_CODITE | VZZ_DESITE |
| Tipo | Caracter | Caracter | Caracter |
| Tamanho | 30 | 27 | 30 |
| Decimal | 0 | 0 | 0 |
| Formato | @!S30 | @! | @!S30 |
| Form. Variavel |
| RtPict("VZZ_GRUITE") |
|
| Contexto | Virtual | Real | Virtual |
| Propriedade | Visualizar | Alterar | Visualizar |
| Título | Descrição | Código Item | Descrição |
| Descrição | Descrição do Grupo | Código do Item | Descrição do Item |
| Help | Informe a descrição do grupo. | Informe o código do item. | Descrição do Item. |
| Inic. Padrão | IF(!INCLUI,POSICIONE("SBM",1,XFILIAL("SBM")+VZZ->VZZ_GRUITE,"BM_DESC"),"") |
| IF(!INCLUI,POSICIONE("SB1",7,XFILIAL("SB1")+VZZ->VZZ_GRUITE+VZZ->VZZ_CODITE,"B1_DESC"),"") |
| Inic. Browse | Posicione("SBM",1,xFilial("SBM")+VZZ->VZZ_GRUITE,"BM_DESC") |
| Posicione("SB1",7,xFilial("SB1")+VZZ->VZZ_GRUITE+VZZ->VZZ_CODITE,"B1_DESC") |
| Cons. Padrão |
| B03B |
|
| Val. Sistema |
| VAZIO() .or. FG_Seek("SB1","M->VZZ_GRUITE+M->VZZ_CODITE",7,.f.,"VZZ_DESITE","B1_DESC") |
|
| Nível | 1 | 1 | 1 |
| Obrigatório | Não | Sim | Não |
| Usado | Sim | Sim | Sim |
| Browse | Sim | Sim | Sim |
| Modulos | SIGAVEI, SIGAOFI e SIGAPEC | SIGAVEI, SIGAOFI e SIGAPEC | SIGAVEI, SIGAOFI e SIGAPEC |
| Campo | VZZ_QTDITE |
| Tipo | Numérico |
| Tamanho | 8 |
| Decimal | 2 |
| Formato | @E 99999.99 |
| Contexto | Real |
| Propriedade | Alterar |
| Título | Qtd Requisit |
| Descrição | Qtde Requisitada |
| Help | Quantidade controlada por modelo. |
| Nível | 1 |
| Obrigatório | Sim |
| Usado | Sim |
| Browse | Sim |
| Modulos | SIGAVEI, SIGAOFI e SIGAPEC |
O tamanho dos campos que possuem grupo podem variar conforme ambiente em uso.
3. Criação de Consulta Padrão no arquivo SXB – Consulta Padrão:
· Pesquisa B03B:
| Alias | B03B | B03B | B03B |
| Tipo | 1 | 2 | 4 |
| Sequência | 01 | 01 | 01 |
| Coluna | DB | 07 | 01 |
| Descrição | Cadastro de Itens | Grp Item e Cód Item | Grupo do Item |
| Contém | SB1 |
| B1_GRUPO |
| Alias | B03B | B03B | B03B |
| Tipo | 4 | 4 | 5 |
| Sequência | 01 | 01 | 01 |
| Coluna | 02 | 03 |
|
| Descrição | Código do Item | Descrição |
|
| Contém | B1_CODITE | B1_DESC | SB1->B1_CODITE |
| Alias | B03B | B03B |
| Tipo | 7 | 7 |
| Sequência | 01 | 02 |
| Coluna | 01 | 01 |
| Contém | xFilial("SB1")+M->VZZ_GRUITE | xFilial("SB1")+M->VZZ_GRUITE |
4. Criação de Índices no arquivo SIX – Índices:
| Índice | VSX | VSX |
| Ordem | 1 | 2 |
| Chave | VSX_FILIAL+VSX_CODAGM | VSX_FILIAL+VSX_DESAGM |
| Descrição | Código Agrupamento | Descrição Agrupamento |
| Proprietário | S | S |
| Índice | VZZ |
| Ordem | 1 |
| Chave | VZZ_FILIAL+VZZ_CODAGM+VZZ_GRUITE+VZZ_CODITE |
| Descrição | Código Agrupamento + Grupo item + Código Item |
| Proprietário | S |
5. Criação de Parâmetros no arquivo SX6 – Parâmetros:
| Nome da Variável | MV_VERQTCC |
| Tipo | Caracter |
| Descrição | Verifica quantidade requisitada de componentes controlados. Se 1 verifica a OS atual, Se 0 verifica todas as OS's não fechadas do veículo |
| Valor Padrão | 1 |
Procedimentos para Configuração
1. No Configurador (SIGACFG) acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie o(s) parâmetro(s) a seguir:
| Itens/Pastas | Descrição |
| Informações | |
| Nome | MV_VERQTCC |
| Tipo | C |
| Cont. Por. | 1 |
| Descrição | |
| Descrição | Verifica quantidade requisitada de componentes controlados. Se 1 verifica a OS atual, Se 0 verifica todas as OS's não fechadas do veículo. |
2. No Configurador (SIGACFG) acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do Oficina, conforme instruções a seguir:
| Menu | Atualizações |
| Submenu | Cad. Oficina |
| Nome da Rotina | Qtd Max Componente |
| Programa | OFIOA800 |
| Módulo | SIGAOFI |
| Tipo | Função Protheus |
| Tabelas | VSX, VZZ |
Procedimentos para Utilização
No parâmetro MV_VERQTCC , caso informe 1, será considerada a quantidade cadastrada somente para a OS selecionada. Caso informe 0, todas as OSs abertas para estes mesmo veículo serão consideradas na contagem de peças requisitadas.
1. No Oficina (SIGAOFI) acesse Atualizações/ Cad. Oficina/ Qtd Max Componente (OFIOA800).
2. Clique em Incluir.
3. Preencha os campos da rotina atentando-se aos campos Cód Agrup. e Qtd Requisit e confirme.
4. No Oficina (SIGAOFI) acesse Atualizações/ Cad Veiculos/ Modelos (VEIVA020).
5. Selecione um registro e clique em Alterar.
6. Preencha o campo Cód Agrup. com o registro criado anteriormente.
7. Confirme a alteração.
8. No Oficina (SIGAOFI) acesse Atualizações/ Mov Oficina/ Req Peças (OFIOM020).
9. Selecione um registro e clique em Requisitar.
10. Preencha os campos da rotina informando o item cadastrado no agrupamento.
Ao preencher o campo Qtd Requisit com uma quantidade superior a quantidade cadastrada no agrupamento, o sistema apresentará uma mensagem informando que a quantidade requisitada é superior a máxima permitida.
Informações Técnicas
| Tabelas Utilizadas | VS3 – Itens de Orçamento, VV2 – Modelos de Veículos, VSX – Agrupamento de Peças Controlad, VZZ – Qtd Maxima do Componente |
Observações
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas