You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 108
Current »
Tipos de Amostras Avulsas
Características do Requisito
Linha de Produto: | Microsiga Protheus |
Segmento: | Agroindústria |
Módulo: | SIGAAGR |
Rotina: | Rotina | Nome Técnico | OGA181 | Tipos de Amostras Avulsas |
Rotina(s) envolvida(s) | Nome Técnico | OGA180 | Cadastro de Amostra Avulsa | AjustaNKI | Tipos de Amostras Avulsas | AjustaNJF | Cadastro de Amostras | UPDOG | Compatibilizador Originação | UPD0G00001 | Compatibilizador Originação |
|
Parâmetro(s): | |
País(es): | Todos |
Tabelas Utilizadas: | NKI, NJF |
Versões/Release: | 11.80.16 |
Descrição
Foi desenvolvida uma rotina para os Tipos de Amostras Avulsas, a fim de que ocorra um melhor controle das amostras.
Importante
Antes de executar o compatibilizador UPDARM/UPDOG é imprescindível:
- Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão 11).
- Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
- Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
- 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.
- O compatibilizador deve ser executado com a Integridade Referencial desativada*.
Atenção 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: - No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação (APCFG60A).
- 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.
- 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;
- 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).
- Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
- Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.
- 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! |
---|
- Em Microsiga Protheus TOTVS Smart Client (se versão 10) ou ByYou Smart Client (se versão 11), informe UPDARM no campo Programa Inicial.
- Clique em OK para continuar.
- Após a confirmação, é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
- Após a confirmação, é exibida uma tela para a seleção das tabelas que serão executadas, selecione as tabelas NKI e NJF.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - 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.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
- Em Microsiga Protheus TOTVS Smart Client (se versão 10) ou ByYou Smart Client (se versão 11), digite UPDOG no campo Programa Inicial.
- Clique em OK para continuar.
- Ao confirmar, é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- Após a confirmação, é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
. - Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
- É apresentada uma mensagem explicativa na tela.
- 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.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
Atualizações do Compatibilizador
- Criação de Campos no arquivo SX3 – Campos:
- Tabela NKI - Tipos de Amostras Avulsas:
Campo | NKI_FILIAL |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Título | Filial |
Descrição | Filial |
Usado | Nao |
Obrigatório | Não |
Browse | Não |
Campo | NKI_TIPAMO |
Tipo | Caracter |
Tamanho | 3 |
Decimal | 0 |
Formato | @! |
Título | Tip. Amost. |
Descrição | Tipo de Amostra |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Relação | 1 |
Val. Sistema | ExistChav('NKI',M->NKI_TIPAMO) |
Campo | NKI_DESCRI |
Tipo | Caracter |
Tamanho | 25 |
Decimal | 0 |
Formato | @! |
Título | Descrição |
Descrição | Descrição do Tipo da Amostra |
Nível | 1 |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Campo | NKI_TIPREL |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Tip Rel. |
Descrição | Tipo da Relação |
Nível | 1 |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Val. Sistema | Pertence('123') |
Opções | 1=Não Possui;2=Lib.CTR;3=Contrato |
- Tabela NJF - Cadastros de Amostra:
Campo | NJF_TIPAMO |
Tipo | Caracter |
Tamanho | 3 |
Decimal | 0 |
Formato | @! |
Título | Tip. Amost. |
Descrição | Tipo da Amostra |
F3 | NKI |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Val. Sistema | NaoVazio().AND.ExistChav('NKI',M->NJF_TIPAMO) |
Campo | NJF_ITMAUT |
Tipo | Caracter |
Tamanho | 3 |
Decimal | 0 |
Formato | @! |
Título | Item Aut. |
Descrição | Item de Autorização |
F3 | NJP |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Val. Sistema | ExistCpo('NJP') |
Campo | NJF_STATUS |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Título | Status |
Descrição | Status da Amostra |
Relação | 0 |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Val. Sistema | Pertence('012345') |
Opções | 0=Amostra;1=Classificada;2=Vinculada;3=Liberada;4=Reprovada;5=Cancelada |
Campo | NJF_QTDAUT |
Tipo | Numerico |
Tamanho | 12 |
Decimal | 2 |
Formato | @E 999,999,999.99 |
Título | Qt. Autoriz. |
Descrição | Quantidade da Autorizada |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Val. Sistema | POSITIVO() |
Campo | NJF_TIPAUT |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Tip. Auto. |
Descrição | Tipo de Autorização |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Val. Sistema | Pertence('ES') |
Opções | E=Entrada;S=Saida |
Importante:
O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.
2. Criação de Índices no arquivo SIX – Índices:
Índice | NKI |
Ordem | 1 |
Chave | NKI_FILIAL+NKI_TIPAMO |
Descrição | Grupo+Tipo Amostra |
Proprietário | S |
Índice | NJF |
Ordem | 4 |
Chave | NKI_FILIAL+NKI_TIPAMO |
Descrição | Grupo+Tipo Amostra |
Proprietário | S |
Índice | NJF |
Ordem | 5 |
Chave | NJF_FILIAL+NJF_CODCTR+NJF_ITMAUT |
Descrição | Grupo+Tipo Amostra+Item Autorização |
Proprietário | S |
Ponto de Entrada
Localização: | No meio da Transação de Liberação do OGA180 |
Programa Fonte: | OGA180 |
Função: | Permitir manipular os dados do que será gerado. |
Retorno: | Nome | Tipo | Descrição | Obrigatório | OG180LIB | Array | Contendo o Cabeçalho e itens da liberação | NÃO |
|
Exemplo:
#Include 'Protheus.ch'
#include "fwmvcdef.ch"
User Function OG180LIB()
Local lRetorno := .T.
If !NJF->NJF_CODAMO == '99'
ALERT( "TESTE " )
lRetorno := .F.
ENDIF
Return (lRetorno)
Localização: | No meio da Transação de Rejeitar do OGA180 |
Programa Fonte: | OGA180 |
Função: | Permitir manipular os dados do que será Rejeitado |
Retorno: | Nome | Tipo | Descrição | Obrigatório | OG180REJ | Array | Contendo o Cabeçalho e itens da rejeição | NÃO |
|
Exemplo:
#Include 'Protheus.ch'
#include "fwmvcdef.ch"
User Function OG180REJ()
Local lRetorno := .T.
If !NJF->NJF_CODAMO == '99'
ALERT( "TESTE " )
lRetorno := .F.
ENDIF
Return (lRetorno)
Localização: | No meio da Transação de Cancelar do OGA180 |
Programa Fonte: | OGA180 |
Função: | Permitir manipular os dados do que será Cancelado |
Retorno: | Nome | Tipo | Descrição | Obrigatório | OG180CAN | Array | Contendo o Cabeçalho e itens do Cancelamento | NÃO |
|
Exemplo:
#Include 'Protheus.ch'
#include "fwmvcdef.ch"
User Function OG180CAN()
Local lRetorno := .T.
If !NJF->NJF_CODAMO == '99'
ALERT( "TESTE " )
lRetorno := .F.
ENDIF
Return (lRetorno)
Procedimento para Utilização
- No Gestão Agroindústria (SIGAAGR), acesse Atualizações/ Originação/ Cadastros Básicos/ Tipos de Amostras Avulsas (OGA181);
O sistema apresenta a janela de tipo de amostras já cadastradas. - Na opção Incluir, clique e cadastre um tipo de amostra avulsa;
Não é possível incluir dois registros idênticos.