Usuário X Unidade Beneficiamento
Características do Requisito
Linha de Produto: | Protheus | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmento: | Agroindústria | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Módulo: | SIGAAGR | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Rotina: |
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
País(es): | Todos | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Tabelas utilizadas: | NKF-DX0-DX9-DXD-DXI-DXJ-DXL-DXM-DXN-DXP-DXR-DXS-DXT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Versões/Release: | 11.8 |
Descrição
Melhoria realizada para todas as rotinas descritas acima, através do chamado TSPLRQ.
Essa melhoria tem por objetivo tratar cada usuário com uma unidade de beneficiamento. Foi desenvolvido para as rotinas uma função que faz a validação do usuário, caso não possua o cadastro de usuário X unidade de beneficiamento não deixa incluir, alterar ou excluir os dados de qualquer rotina citada. Somente com cadastro o usuário irá poder fazer as ações.
Importante
Antes de executar o compatibilizador U_AGRUPD é 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:
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), digite informe o U_AGRUPD no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
- 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 ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- 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.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
Descreva se há algum procedimento necessário após a aplicação do compatibilizador.
Procedimento para Implantação
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.
- Aplique o patch do chamado e execute uma vez a rotina U_AGRUPD.
- Para executar o compatibilizador, abrir o SmartCliente e informar em Programa Inicial o nome do compatibilizador.
- Selecionar as empresas que irá receber as atualizações.
- Marcar os Updates das tabelas relacionadas: UPDNKF - UPDDX0 - UPDDX9 - UPDDXD - UPDDXI - UPDDXJ - UPDDXL - UPDDXM - UPDDXN - UPDDXP - UPDDXR - UPDDXS - UPDDXT.
Atualizações do Compatibilizador
1 - Criação de tabela no arquivo SX2– Tabelas:
Chave | Nome | Modo | PYME |
NKF (X2_CHAVE) | Usuário X Unidade de Beneficiamento (X2_NOME) | E (X2_MODO) | N (X2_PYME) |
2 - Criação de Campos no arquivo SX3 – Campos:
- Tabela NKF - Usuário X Unidade de Beneficiamento:
Campo | NKF_FILIAL |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Filial |
Descrição | Código da Filial |
Nível | 1 |
Usado | Não |
Obrigatório | Sim |
Browse | Não |
Opções | |
When |
|
Relação |
|
Val. Sistema |
|
Help | Código da filial. |
Campo | NKF_CODUSU |
Tipo | C |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Usuário |
Descrição | Código do Usuário |
Nível | 1 |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Opções | |
When |
|
Relação |
|
Val. Sistema | Naovazio() .AND. UsrExist(M->NKF_CODUSU,.T.) |
Pesquisa | USR |
Help | Informar o código do usuário. |
Campo | NKF_NOMUSU |
Tipo | C |
Tamanho | 40 |
Decimal | 0 |
Formato | @! |
Título | Nome Usuário |
Descrição | Nome do Usuário |
Nível | 1 |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Opções | |
When |
|
Relação | IIF(!INCLUI,UsrRetName(M->NKF_CODUSU),"") |
Val. Sistema | Naovazio() |
Contexto | V |
Visual | V |
Inicializa Browse | UsrRetName(NKF->NKF_CODUSU) |
Help | Informar o nome do usuário. |
Campo | NKF_CODUNB |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Un.Benef. |
Descrição | Unidade de Beneficiamento |
Nível | 1 |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Opções | |
When |
|
Relação |
|
Val. Sistema | Naovazio() .AND. ExistChav("NKF",M->NKF_CODUSU+M->NKF_CODUNB) .AND. ExistCpo("DX3") |
Pesquisa | DX3 |
Help | Informar o código da unidade de beneficiamento. |
Campo | NKF_NOMUNB |
Tipo | C |
Tamanho | 30 |
Decimal | 0 |
Formato | @! |
Título | N.Un.Benef. |
Descrição | Nome Unidade de Beneficia |
Nível | 1 |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Opções | |
When |
|
Relação | IIF(!INCLUI,Posicione("DX3",1,xFilial("NKF")+M->NKF_CODUNB,"DX3_NOME")," ") |
Val. Sistema | Naovazio() |
Contexto | V |
Visual | V |
Inicializa Browse | Posicione("DX3",1,xFilial("NKF")+NKF->NKF_CODUNB,"DX3_NOME") |
Help | Informar o nome da unidade de beneficiamento. |
- Tabela DX0 - Itens do Romaneio de Saída
Campo | DX0_CODUNB |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | UN.Benef |
Descrição | Unidade de Beneficiamento |
Nível | 1 |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Opções | |
When |
|
Relação |
|
Val. Sistema |
|
Help | Informar o código da unidade de beneficiamento. |
- Tabela DX9 - Pesagens Avulsas
Campo | DX9_CODUNB |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | UN.Benef |
Descrição | Unidade de Beneficiamento |
Nível | 1 |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Opções | |
When |
|
Relação |
|
Val. Sistema |
|
Help | Informar o código da unidade de beneficiamento. |
- Tabela DXD - Cadastro de Blocos
Campo | DXD_CODUNB |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | UN.Benef |
Descrição | Unidade de Beneficiamento |
Nível | 1 |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Opções | |
When |
|
Relação |
|
Val. Sistema |
|
Help | Informar o código da unidade de beneficiamento. |
- Tabela DXI - Fardos de Algodão
Campo | DXI_CODUNB |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | UN.Benef |
Descrição | Unidade de Beneficiamento |
Nível | 1 |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Opções | |
When |
|
Relação |
|
Val. Sistema |
|
Help | Informar o código da unidade de beneficiamento. |
- Tabela DXJ - Romaneio de Classificação
Campo | DXJ_CODUNB |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | UN.Benef |
Descrição | Unidade de Beneficiamento |
Nível | 1 |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Opções | |
When |
|
Relação |
|
Val. Sistema |
|
Help | Informar o código da unidade de beneficiamento. |
- Tabela DXL - Cadastro de Fardões
Campo | DXL_CODUNB |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | UN.Benef |
Descrição | Unidade de Beneficiamento |
Nível | 1 |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Opções | |
When |
|
Relação |
|
Val. Sistema |
|
Help | Informar o código da unidade de beneficiamento. |
- Tabela DXM - Romaneio de Entrada
Campo | DXM_CODUNB |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | UN.Benef |
Descrição | Unidade de Beneficiamento |
Nível | 1 |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Opções | |
When |
|
Relação |
|
Val. Sistema |
|
Help | Informar o código da unidade de beneficiamento. |
- Tabela DXN - Instrução de Embarque
Campo | DXN_CODUNB |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | UN.Benef |
Descrição | Unidade de Beneficiamento |
Nível | 1 |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Opções | |
When |
|
Relação |
|
Val. Sistema |
|
Help | Informar o código da unidade de beneficiamento. |
- Tabela DXP - Cadastro de Reservas
Campo | DXP_CODUNB |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | UN.Benef |
Descrição | Unidade de Beneficiamento |
Nível | 1 |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Opções | |
When |
|
Relação |
|
Val. Sistema |
|
Help | Informar o código da unidade de beneficiamento. |
- Tabela DXR - Programação de Embarque
Campo | DXR_CODUNB |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | UN.Benef |
Descrição | Unidade de Beneficiamento |
Nível | 1 |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Opções | |
When |
|
Relação |
|
Val. Sistema |
|
Help | Informar o código da unidade de beneficiamento. |
- Tabela DXS - Romaneio de Saída
Campo | DXS_CODUNB |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | UN.Benef |
Descrição | Unidade de Beneficiamento |
Nível | 1 |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Opções | |
When |
|
Relação |
|
Val. Sistema |
|
Help | Informar o código da unidade de beneficiamento. |
- Tabela DXT - Romaneio de Saída
Campo | DXT_CODUNB |
Tipo | C |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | UN.Benef |
Descrição | Unidade de Beneficiamento |
Nível | 1 |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Opções | |
When |
|
Relação |
|
Val. Sistema |
|
Help | Informar o código da unidade de beneficiamento. |
Importante:
O tamanho dos campos que possuem grupo pode variar conforme o ambiente em uso.
5. Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:
- Pesquisa B05PLS:
Alias | (XB_ALIAS) |
Tipo | (XB_TIPO) |
Sequência | (XB_SEQ) |
Coluna | (XB_COLUNA) |
Descrição | (XB_DESCRI) |
Contém | (XB_CONTEM) |
Procedimento para Configuração
(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).
CONFIGURAÇÃO DE PARÂMETROS
- No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
(É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)
Itens/Pastas | Descrição |
Nome: |
|
Tipo: | Informe o Tipo do parâmetro |
Cont. Por.: | Informe o Conteúdo padrão |
Descrição: |
|
CONFIGURAÇÃO DE MENUS
2. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:
Menu | Informe o Menu em que estará localizada a rotina |
Submenu | Informe o Submenu em que estará localizada a rotina |
Nome da Rotina | Informe o Título da rotina |
Programa | Informe o Fonte da rotina |
Módulo | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” |
Tipo | Informe a Função |
Procedimento para Utilização
- Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
- Localização da rotina no menu;
- Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
- Caso seja necessário ter algum cadastro feito previamente, faça uma observação.
Exemplo:
1. No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).
O sistema apresenta a janela de produtos cadastrados.
2. Posicione o cursor em um produto e clique em Alterar.
3. Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.
4. Dê duplo clique no campo TP Prestador (BCW_TIPPRE).
O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.
5. Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:
Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.
6. Confira os dados e confirme.
Vídeo
- Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.
** Canal do youtube e software de vídeoem definição.
Título do Vídeo: | Disponibilizado pelo Marketing. |
Introdução: | Disponibilizado pelo Marketing. |
Passo a Passo: | Capturar diretamente do sistema. |
Finalização: | Disponibilizado pelo Marketing. |
Ponto de Entrada
Descrição: | Informe o Menu em que estará localizada a rotina | ||||||||||||||||
Localização: | Informe o Submenu em que estará localizada a rotina | ||||||||||||||||
Eventos: | Informe o Título da rotina | ||||||||||||||||
Programa Fonte: | Informe o Fonte da rotina | ||||||||||||||||
Função: | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” | ||||||||||||||||
Retorno: |
|
Exemplo:
#Include 'Protheus.ch'
User Function CN120ALT()
Local aCab:= PARAMIXB[1]
Local cTipo:= PARAMIXB[2]
If cTipo == '1'
aCab[4][2]:= 'NF' //Validações do usuário
EndIf
Return aCab