Histórico da Página

(Obrigatório)

Informações Gerais

Especificação
Produto	Logix	Módulo	WMS
Segmento Executor	Supply Chain - Inovação
Projeto1	LOGWMS01	IRM/ EPIC1  EPIC1	Jira server JIRA Produção columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 0c783de1-186e-383b-975c-a1acd7d76cb5 key LOGWMS01-545
Requisito/Story/Issue1		Subtarefa1
Chamado/Ticket2
Jira server JIRA Produção columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 0c783de1-186e-383b-975c-a1acd7d76cb5 key LOGWMS01-829	Subtarefa1	Jira server JIRA Produção columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 0c783de1-186e-383b-975c-a1acd7d76cb5 key LOGWMS01-1877
País	( x			País	(  ) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador (  ) USA  (  ) Colombia   (  ) Outro _____________.
Outros	<Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>.

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

(Obrigatório)

Objetivo

<Nesta etapa informar o objetivo da especificação do requisito, ou seja, o que a funcionalidade deve fazer. Exemplo: Permitir que o usuário defina o percentual mínimo em espécie (dinheiro), a referência mínima para calculo dos débitos do aluno e o período de validade do parâmetro de negociação>.

Image Added

Objetivos

• Criar novos e ajustar controles para convocação ativa:
  • Excluir as colunas endereço origem e destino da tabela de controle das pendências de convocação ativa;
  • Gravar programa originador da criação da pendência de convocação ativa;
  • Gravar programa originador da alteração do usuário executor da pendência de convocação ativa;
  • Gravar programa originador da finalização/exclusão da pendência de convocação ativa bem como um indicador que informe se o registro foi Finalizado (executado) ou foi Excluído por uma operação de desalocação por exemplo.
  • Ajustar busca de atividades principal do programa WMS6743 facilitando a inclusão de novas atividades na convocação ativa.
    
    

Objetos a serem alterados ou criados

(Obrigatório)

Definição da Regra de Negócio

<Regra de negócio é o que define a forma de fazer o negócio, o processo definido e/ou as regras que devem ser contempladas. Devem ser descritas restrições, validações, condições e exceções do processo. Caso necessário, incluir neste capítulo também regras de integridade que devem ser observadas no momento do desenvolvimento>.

<Na tabela abaixo informe quais são as rotinas envolvidas, o tipo de operação, a opção de menu e se necessário uma breve descrição das regras de negócio relacionadas a rotina>.

Rotina	Tipo de Operação	Opção de Menu

Regras de Negócio

[ACAA040 – Parâmetros]

[Alteração]

[Atualizações -> Acadêmico-> Tesouraria]

-

[ACAA050 – Negociação Financeira]

[Envolvida]

[Atualizações -> Acadêmico-> Tesouraria]

-

[ACAA060 – Cadastro de Pedidos]

[Criação]

[Atualizações -> Acadêmico-> Cadastros]

-

 

Exemplo de Aplicação:

• Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
• Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades  como a referência mínima para calcular o débito total do aluno.
• Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
• O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.

 

Tabelas Utilizadas

• SE2 – Cadastro de Contas a Pagar
• FI9 – Controle de Emissão de DARF>.

Opcional

Protótipo de Tela

<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.

Protótipo 01

 Image Removed

Opcional

Fluxo do Processo

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>. 

Opcional

Dicionário de Dados

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

Nome: FINSRF2

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

Consulta: AMB

Definição da Regra de Negócio

1. Criar novos e ajustar controles para convocação ativa.
   1. Objetivo: Excluir as colunas endereço origem e destino das tabelas de controle das pendências de convocação ativa (wms_conv_ativa e wms_conv_ativa_historico);
      • Contextualização:
      1. As colunas de endereço origem e destino foram criadas nos primeiros requisitos referente a convocação ativa onde as atividades de recebimento foram as primeiras analisadas. As atividades de recebimento sempre são realizadas em apenas um endereço, neste caso então, ao ter os campos referentes aos endereços na wms_conv_ativa não se fazia necessário releitura destas informações no programa de convocação ativa (WMS6743). Atualmente já tivemos a experiência de implementar convocação ativa para outros processos além do recebimento, como por exemplo movimentação interna. Nestes processos foi possível identificar que o endereço origem e destino na wms_conv_ativa acaba tendo pouca utilização, gerando apenas esforço e processamento para manter estes campos consistentes uma vez que a cada atualização de pendências de convocação ativa a atualização destes campos se faz necessário. Atualmente a utilização destes campos se restringe apenas para apresentar as informações ao usuário no programa de convocação ativa (WMS6743) e deveria ser utilizado para identificar se o usuário possui permissão nos endereços dos movimentos, porém como geralmente existem 'N' movimentos para 1 registro da convocação ativa, a leitura desta informação acaba sendo feita diretamente nos processos de movimento. 
      • Segue abaixo passos para atingir o objetivo proposto:
      1. Pelos motivos mencionados na contextualização, os campos referente a endereço origem e destino deverão ser removidos da tabela, consequentemente as alterações abaixo serão necessárias:
         

         • Abaixo funções a serem removidas e/ou alteradas:

           Expandir
           title Clique aqui para verificar as indicações para implementações
           Funções a serem removidas: → wmsr139_atualiza_end_origem_destino_conv_ativa; (1) → wms6435a_atualiza_end_origem_destino_conv_ativa; (2) → wms6435b_atualiza_end_origem_destino_conv_ativa; (3) → wms663108a_atualiza_end_origem_destino_conv_ativa; (4) → wms663108b_atualiza_end_origem_destino_conv_ativa; (5) Funções a serem alteradas para remover a chamada das funções removidas mencionadas acima: → wms6177_incluir_processo_moviment; (1) → wms6177_excluir_os_reserva_processo; (1) → wms6180_gera_tabelas_processo_movimentacao; (1) → wmsr139_ajusta_pendencia_conv_ativa_movtos_os_ativ; (1) → wmsr139_ajusta_pendencia_conv_ativa_movtos_os_ativ; (1) → wms6435a_atualiza_conv_ativa; (2) → wms6435b_atualiza_conv_ativa; (3) → wms663108a_atualiza_conv_ativa; (4) → wms663108b_atualiza_conv_ativa; (5) Funções a serem alteradas para que seja retirado a utilização da coluna de endereco_origem e destino. → wms6435a_gera_pendencias_conv_ativa_transf_armz_os; → wms6435b_gera_pendencias_conv_ativa_transf_armz_os; → wms6435c_gera_pendencias_conv_ativa_transf_armz_os; → wms663108a_gera_pendencias_conv_ativa_transf_armz_os; → wms663108b_gera_pendencias_conv_ativa_transf_armz_os; → wms663108c_gera_pendencias_conv_ativa_transf_armz_os; → wmsr139_gera_conv_ativa_historico; → wmsr139_gera_pendencias_conv_ativa_transf_armz_os; → wmsr139_gera_pendencias_conv_ativa_recebto_cesv; → wmsr139_gera_pendencias_conv_ativa_recebto_os_ativ; WMS6743 - Programa da Convocação Ativa → wms6743_busca_atividades_conv_ativa; Alterar a função para que quando a busca for realizada para atividade de recebimento, não seja mais lido/relacionado o campo wms_conv_ativa.endereco_origem e sim o campo wms_ordem_servico.endereco_origem → wms6743_carrega_dados_todas_atividades; Alterar a função para remover o relacionamento com as tabelas 'apelidadas' de end_origem/end_destino e para que quando informado os filtros de endereço origem e destino seja lido ou wms_ordem_servico.endereco_origem/destino para atividades de recebimento, ou wms_processo_moviment.endereco_origem/destino para atividades diferente de recebimento onde exista algum movimento para o endereço origem/destino informado. Devido a necessidade de filtro mais elaborado para estes campos, a implementação deverá se dar verificando se a variável referente ao filtro (l_where_wmsr78) possui endereço origem/destino (wms_conv_ativa.endereco_origem ou wms_conv_ativa.endereco_destino). Possuindo, uma nova cláusula AND provavelmente utilizando EXISTS deverá ser adicionada ao where clause (l_sql_stmt_where) do SQL principal (l_sql_stmt) para tratar a necessidade de busca. O valor do código de barras do endereço informado no filtro também deverá ser obtido através da manipulação da string referente ao where clause do filtro (l_where_wmsr78), sendo que o valor estará logo após o sinal de "=", exemplo " wms_conv_ativa.endereco_origem = 10 ". → wms6743_busca_des_reduz_end_origem / wms6743_busca_des_reduz_end_destino Alterar a função para buscar a descrição reduzida do endereço através da ordem de serviço (wms_ordem_servico) quando recebimento ou através dos movimentos (wms_processo_moviment) quando diferente de recebimento. Caso seja encontrado mais de um endereço continuar exibindo a descrição "VARIOS ENDS. ORIG/DEST." → wms6743_aloca_usuario_atividade_mov_int Remover chamada para a função wmsr139_atualiza_end_origem_destino_conv_ativa. http://tdn.totvs.com.br/pages/viewpage.action?spaceKey=LLOG&title=ER_LOGWMS01-831_ME_15.8.1+-+Ressuprimento→ Esta especificação estava em desenvolvimento durante a criação deste documento, sendo assim, faz-se necessária uma breve verificação por referências a wms_cont_ativa.endereco_origem e wms_contiva_ativa.endereco_destino para serem excluídas.

   2. Objetivo: Gravar programa originador da criação da pendência de convocação ativa;
      • Segue abaixo passos para atingir o objetivo proposto:
      1. Executar conversor de tabela (wms00593) referente as modificações realizadas nas tabelas wms_conv_ativa e wms_conv_ativa_historico conforme descrito no item Modelo de Dados;

      2. Alterar as funções abaixo para que seja gravado o programa que originou a inclusão de novo registro da pendência de convocação ativa (wms_conv_ativa.programa_origem)

         Expandir
         title Clique aqui para verificar as indicações para implementações
         » Utilizar a função log1200_nome_programa() para buscar o nome do programa para ser gravado no campo wms_conv_ativa.programa_origem. Funções a serem alteradas: → wmsr139_gera_pendencias_conv_ativa_recebto_cesv; → wmsr139_gera_pendencias_conv_ativa_recebto_os_ativ; → wmsr139_gera_pendencias_conv_ativa_transf_armz_os; → wms6435a_gera_pendencias_conv_ativa_transf_armz_os; → wms6435b_gera_pendencias_conv_ativa_transf_armz_os; → wms6435c_gera_pendencias_conv_ativa_transf_armz_os; → wms663108a_gera_pendencias_conv_ativa_transf_armz_os; → wms663108b_gera_pendencias_conv_ativa_transf_armz_os; → wms663108c_gera_pendencias_conv_ativa_transf_armz_os. → wmsm274.

   3. Objetivo: Gravar programa originador da alteração do usuário executor da pendência de convocação ativa;
      • Segue abaixo passos para atingir o objetivo proposto:
      1. Executar conversor mencionado no item 1. b) i. para aplicar as alterações das tabelas;

      2. Alterar as funções abaixo para que seja gravado o programa que originou a alteração de registro da pendência de convocação ativa (wms_conv_ativa.programa_alteracao)

         Expandir
         title Clique aqui para verificar as indicações para implementações
         » Utilizar a função log1200_nome_programa() para buscar o nome do programa para ser gravado no campo wms_conv_ativa.programa_alteracao. Funções a serem alteradas: → wmsr139_atualiza_pendencias_conv_ativa_recebto_os_ativ; → wmsr139_atualiza_pendencias_conv_ativa_transf_armz_os.

   4. Objetivo: Gravar programa originador da finalização/exclusão da pendência de convocação ativa bem como um indicador que informe se o registro foi Finalizado (executado) ou foi Excluído por uma operação de desalocação por exemplo.
      • Contextualização:
      1. Atualmente não é possível representar nos registros de histórico da convocação ativa quando um registro foi efetivamente finalizado ou apenas excluído da pendência de convocação ativa. Isso porque essas duas operações geram a exclusão do registro da wms_conv_ativa e inclusão na tabela wms_conv_ativa_historico. Existe o campo dat_hor_fim na tabela wms_conv_ativa_historico para indicar a data e hora da finalização da pendência de convocação ativa, porém finalização é diferente de exclusão, e quando esta exclusão acontece não é possível obter data e hora. 
      • Segue abaixo passos para atingir o objetivo proposto:
      1. Para resolver esta situação foi criado o campo tipo_exclusao conforme o item Modelo de Dados.  No item iii) é possível visualizar as funções que precisam de alteração para que este novo campo seja gravado.
      2. Além da data gração do tipo de exclusão da pendência de convocação ativa, faz-se necessário a gravação do programa originador da exclusão. No item d) iii) é possível visualizar as funções que percism de alteração para que este novo campo seja gravado.

      3. Executar conversor mencionado no item 1. b) i) para aplicar as alterações das tabelas, e alterar as funções abaixo para implementar os itens d) i) e ii)

         Expandir
         title Clique aqui para verificar as indicações para implementações
         » Utilizar a função log1200_nome_programa() para buscar o nome do programa e gravar no campo wms_conv_ativa_historico.programa_exclusao. Funções a serem alteradas: → wmsr139_gera_conv_ativa_historico - Além do programa que gerou a exclusão gravar 'F' no campo tipo_exclusao; → wmsm274_wms_conv_ativa_gera_historico. - Gravar 'E' no campo tipo_exclusao e passar a também gravar a data de finalização.

   5. Objetivo: Ajustar busca de atividades principal do programa WMS6743 facilitando a inclusão de novas atividades na convocação ativa.
      • Contextualização:
      1. Atualmente no início do programa WMS6743 é feito uma busca das pendências de convocação ativa pendentes de convocação. Esta busca considera diversos critérios, conforme abaixo:
         1. Somente atividade que estão em andamento, interrompida ou pendente;
            
         2. Que não possuam atividade pré-requisito pendente de execução;
         3. Realiza a consistência de restrição de endereços e depositante quando pendência de convocação ativa ainda sem usuário executor.
            
      2. Este último item 3) gera uma complexidade grande na consulta SQL pois para cada atividade os endereços são validados de forma diferenciada. Exemplo:
         1. Atividade de recebimento o endereço fica na ordem de serviço;
         2. Atividade de movimentação interna o endereço fica nos processos de movimento;
         3. Atividade de inventário (próximo requisito), o endereço fica nos controle do inventário;
         4. Atividade de reconferência (próximos requisitos), os endereços a serem reconferidos ficam no próprio estoque.
      3. Sendo assim, o objetivo deste item é retirar esta validação desta primeira busca, e incluir no loop de avaliação de cada atividade e assim validar cada atividade individualmente
      • Segue abaixo passos para atingir o objetivo proposto:
      1. Alterar a função wms6743_busca_atividades_conv_ativa e retirar a validação referente aos grupos de endereços para cada atividade;
      2. Criar funções específicas para realizar o tratamento retirado da função wms6743_busca_atividades_conv_ativa. Inicialmente é possível identificar duas possíveis funções, uma para validação de endereço através da ordem de serviço (wms6743_verifica_restricao_endereco_os) e outra para validação de endereço através dos processos de movimento (wms6743_verifica_restricao_endereco_movimentos). Estas novas funções podem ser chamadas no bloco existente para verificação de atividade pronta para ser executada (wms6743_permite_executar_atividade).

Modelo de Dados

• wms_conv_ativa 

• wms_conv_ativa_historico

(Opcional)

Estrutura de Menu

<Informações utilizadas na linha Datasul>.

Procedimentos

Programas

Cadastro de Papéis

<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.

<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.