Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Melhorias - Tabela de Tarifas de Reparo (Depot)

Características do Requisito

Linha de Produto:

SARA

Segmento:

Logística

Módulo:

Faturamento

Rotina:

ufrmTarifaDepot.pas (frmTarifaDepot, Faturamento) - Tela de Tabela de Tarifas de Reparo (Depot)
ufrmTarifaDepotItem.pas (frmTarifaDepotItem, Faturamento) - Tela de Itens de Tarifa (Depot)

ufrmImportaTarifaArmadorDepot.pas (frmImportaTarifaArmadorDepot, Faturamento) - Tela de Importar Tarifas do Armador (Depot)
ufrmClonarTarifaArmadorDepot.pas (frmClonarTarifaArmadorDepot, Faturamento) - Tela de Clonar Tarifa do Armador (Depot)

proc_diu_tarifa_depot - Procedure de Insert, Update e Delete da tab_tarifa_depot
proc_diu_tarifa_depot_item - Procedure de Insert, Update e Delete da tab_tarifa_depot_item

proc_clonar_tarifa_depot - Procedure para clonar uma tabela de tarifas do armador

Cadastros Iniciais:

Cadastros DEPOT no módulo Operacional, menu Depot:

  • Tipos de Reparo
  • Tipos de Material
  • Tipos de Avaria
  • Componentes do Container
  • Serviços
Requisito (ISSUE): PCREQ-6828

País(es):

Brasil

Banco(s) de Dados:

SQL Server

Tabelas Utilizadas:

tab_tarifa_depot – Tabela de tarifas do depot;
tab_tarifa_depot_item – Tabela de itens de tarifa depot;
tab_moedas - Tabela de moedas;
tab_tipo_moeda - Tabela de tipos de moeda (1 - Fiscal, 2 - Comercial)
tab_clientes - Tabela de clientes do SARA
tab_servico_depot - Tabela de Serviços do SARA

Sistema(s) Operacional(is):

Windows

Descrição

Escreva aqui a descrição da nova implementação ou melhoria.

 

Importante

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador informe o nome do compatibilizador é 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:

  1. No   Configurador (SIGACFG), veja se a empresa utiliza Integridade   Referencial, selecionando a opção Integridade/Verificação   (APCFG60A).
  2. 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.
  3.  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;
  4.  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).
  5. Nestes   casos descritos nos itens “iii” ou   “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
  6.  Quando desativada a Integridade Referencial,   execute o compatibilizador, conforme instruções.
  7. 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 TOTVS Smart Client (se versão 10), digite o nome do compatibilizador 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 ___/___/____.
  2. Clique em OK para continuar.
  3. 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().
  4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
    1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
    2. 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.
    3. Clique em Gravar para salvar o histórico (log) apresentado.
    4. Clique em OK para encerrar o processamento.

 

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.

  1. Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
  2. No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:

Nome da Variável:

Informe o Nome da Variável

Tipo:

Informe o Tipo

Descrição:

Informe a Descrição

Valor Padrão:

Informe o Valor Padrão

 

 

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

  1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

Pergunte

(X1_PERGUNT)

Nome

 

Grupo

(X1_GRUPO)

Ordem

(X1_ORDEM)

Tipo

(X1_TIPO)

Tamanho

(X1_TAMANHO)

 

2.    Criação ou Alteração de tabela no arquivo SX2– Tabelas:

Chave

Nome

Modo

PYME

B04

(X2_CHAVE)

Dente/Região

(X2_NOME)

C

(X2_MODO)

N

(X2_PYME)

 

3.  Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

Chave

Ex.: AR

Descrição

Ex.: Tabela de IR de Aplicações Financeiras

 

4.  Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

  • Tabela BGD - Prod x Cob x Proc x Co-Part:

 

Campo

(X3_CAMPO)

Tipo

(X3_TIPO)

Tamanho

(X3_TAMANHO)

Decimal

(X3_DECIMAL)

Formato

(X3_PICTURE)

Título

(X3_TITULO)

Descrição

(X3_DESCRIC)

Nível

(X3_NÍVEL)

Usado

(X3_USADO) Informe Sim ou Não

Obrigatório

(X3_OBRIGAT) Informe Sim ou Não

Browse

(X3_BROWSE) Informe Sim ou Não

Opções

(X3_CBOX)

When

(X3_WHEN)

Relação

(X3_RELACAO)

Val. Sistema

(X3_VALID)

Help

Descreva o conteúdo informado para Help de Campo no ATUSX

 

Importante:

O tamanho dos campos que possuem grupo pode variar conforme 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)

 

6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

Índice

AA1

Ordem

6

Chave

AA1_FILIAL+AA1_CODVEN

Descrição

Cod. Vendedor

Proprietário

S

 

7.  Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

Nome da Variável

(X6_VAR)

Tipo

(X6_TIPO)

Descrição

(X6_DESCRIC + X6_DESC1 + X6_DESC2)

Valor Padrão

(X6_CONTEUD)

 

8.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

  • Tabela BD5 – Contas Médicas:

Campo

Informe o conteúdo do (X7_CAMPO)

Sequência

Informe o conteúdo do (X7_SEQUENC)

Campo Domínio

Informe o conteúdo do (X7_CDOMIN)

Tipo

Informe o conteúdo do (X7_TIPO)

Regra

Informe o conteúdo do (X7_REGRA)

Posiciona?

Informe o conteúdo do (X7_SEEK)

Chave

Informe o conteúdo do (X7_CHAVE)

Condição

Informe o conteúdo do (X7_CONDIC)

Proprietário

Informe o conteúdo do (X7_PROPRI)

 

 

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

 

  1. 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.

 

 

Procedimento para Utilização

Tela de Tabela de Tarifas de Reparo (Depot)

  1. Acesse o módulo Faturamento, menu Depot, submenu Tabela de Tarifas de Reparo.
    O sistema deve apresentar a tela de cadastro de tabela de tarifas de reparo.
  2. Valide se o campo Valor H/H está presente na tela;
  3. Valide se a coluna Valor H/H está no grid entre as colunas Tipo de cotação e Cadastro;
  4. Valide se o botão Clonar Tarifa está presente na tela;
  5. Insira uma nova tabela de tarifa informando o valor h/h da tabela;
  6. Acione o botão Gravar.
    O sistema deve efetivar o registro no banco de dados e recarregar as informações em tela;
  7. Edite uma tabela de tarifa modificando o valor h/h da tabela;
  8. Acione o botão Gravar.
    O sistema deve efetivar o registro no banco de dados e recarregar as informações em tela;

Resultados Esperados

  1. Taborder dos campos deve respeitar a ordem estabelecida na especificação;
  2. O título da tela e botões e Abas devem conter o primeiro caracter de cada palavra em Caixa Alta (Exemplo: Faces do Container);
  3. Os labels dos campos/campos grid devem conter somente o primeiro caracter da primeira palavra em Caixa Alta. Exemplo: Tipo de avaria;
  4. Os campos e labels dos campos devem estar devidamente alinhados;
  5. A opção de Clonar Tarifa e os campos de Valor H/H presentes na tela;
  6. O campo Valor H/H deve ser registrado no banco de dados e deve retornar o valor para exibição na tela;
  7. Não deve permitir registrar Valor H/H em branco, mas permite 0 (zero);

 

Tela de Itens de Tarifa (Depot)

  1. Acesse o módulo Faturamento, menu Depot, submenu Tabela de Tarifas de Reparo.
    O sistema deve apresentar a tela de cadastro de tabela de tarifas de reparo.
  2. Selecione uma tarifa ou crie uma nova e acione o botão Outras Ações -> Itens da Tarifa.
    O sistema deve apresentar a tela de cadastro de Itens da Tarifa (Depot).
  3. Valide se a tela está de acordo com o protótipo;
  4. Valide se os campo do agrupador Tarifa são carregados corretamente;
  5. Insira um novo Item de tarifa sem informar o Serviço do SARA.
    O sistema deve gravar o registro sem reclamar de campo não preenchido. Importante: Os demais campos da tela são de preenchimento obrigatório, mas aceitam valor 0 nos campo numéricos;
  6. Valide se o campo Dt. Atualização é atualizado automáticamente;
  7. Insira um novo Item de tarifa informando o campo Serviço do SARA.
    O sistema deve gravar o registro mantendo o relacionamento;
  8. Insira um novo Item de tarifa deixando os campos Dimensão inicial, Dimensão adicional, Área, H/H inicial, H/H adicional, Material inicial, Material adicional e Valor de um serviço com o valor 0 (zero).
    O sistema deve assumir no campo Tipo de cálculo o valor 3 - Livre e deve gravar o registro no banco de dados corretamente;
  9. Insira um novo Item de tarifa deixando os campos H/H adicional e Material adicional com o valor 0 (zero), preencha os demais campos exceto o campo Valor de um serviço.
    O sistema deve assumir no campo Tipo de cálculo o valor 1 - Calculado sem adicional, preencher automaticamente o valor de cálculo no campo Valor de um serviço e deve gravar o registro no banco de dados corretamente;
  10. Insira um novo Item de tarifa deixando um dos campos H/H adicional ou Material adicional com o valor 0 (zero), preencha os demais campos exceto o campo Valor de um serviço.
    O sistema deve assumir no campo Tipo de cálculo o valor 2 - Calculado com adicional, preencher automaticamente o valor de cálculo no campo Valor de um serviço e deve gravar o registro no banco de dados corretamente;
  11. Faça o mesmo do item anterior, mas agora informando os dois campos de adicional.
    O sistema deve ter o mesmo comportamento do item anterior;
  12. Insira um novo item de tarifa agora, mas informando apenas o Valor de um serviço;
    O sistema deve assumir no campo Tipo de cálculo o valor 0 - Fixo valor informado e deve gravar o registro no banco de dados corretamente.
  13. Valide se ao mudar a seleção no campo Tipo de cálculo para 0 - Fixo valor informado o campo Valor de um serviço é habilitado;
  14. Valide se ao mudar a seleção no campo Tipo de cálculo para 1 - Calculado sem adicional o campo Valor de um serviço é desabilitado e preenchido o cálculo automaticamente;
  15. Valide se ao mudar a seleção no campo Tipo de cálculo para 2 - Calculado com adicional o campo Valor de um serviço é desabilitado e preenchido o cálculo automaticamente;
  16. Valide se ao mudar a seleção no campo Tipo de cálculo para 3 - Livre o campo Valor de um serviço é habilitado;
  17. Selecione no grid um Item de tarifa cadastrado.
  18. Edite o registro e grave novamente.
    O sistema deve ter o mesmo comportamento da inserção e mudar os dados no banco de dados.

Resultados Esperados

  1. Taborder dos campos deve respeitar a ordem estabelecida na especificação;
  2. O título da tela e botões e Abas devem conter o primeiro caracter de cada palavra em Caixa Alta (Exemplo: Faces do Container);
  3. Os labels dos campos/campos grid devem conter somente o primeiro caracter da primeira palavra em Caixa Alta. Exemplo: Tipo de avaria;
  4. Os campos e labels dos campos devem estar devidamente alinhados;
  5. Um item de tarifa cadastrado com sucesso;

 

Tela de Importar Tarifas do Armador (Depot)

  1. Acesse o módulo Faturamento, menu Depot, submenu Tabela de Tarifas de Reparo.
    O sistema deve apresentar a tela de cadastro de tabela de tarifas de reparo.
  2. Selecione uma tarifa ou crie uma nova e acione o botão Outras Ações -> Itens da Tarifa.
    O sistema deve apresentar a tela de cadastro de Itens da Tarifa (Depot).
  3. Acione botão Outras Ações -> Importar Tarifas.
    O sistema deve exibir a tela de importação de tarifas do armador.
  4. Valide se a tela está de acordo conforme protótipo;
  5. Valide se o agrupador Tarifa é carregado corretamente.
  6. Acione o botão Abrir Arquivo Excel.
    O sistema deve abrir tela permitindo selecionar um arquivo Excel no modelo de importação de tarifas.
  7. Ao selecionar o arquivo, valide se o campo Arquivo é preenchido com o caminho do arquivo Excel e se o grid é carregado com os itens do arquivo Excel.
    Enquanto o sistema carrega o arquivo um label com a mensagem "Aguarde enquanto o sistema carrega os dados..." deve aparecer ao lado do botão Executar Importação;
  8. Acione o botão Executar Importação.
    O sistema deve exibir o label "Aguarde enquanto o sistema importa os dados..." e deve gravar os registros no banco de dados. Em cada linha do grid que for gravado com sucesso no banco de dados deve aparecer uma marcação indicando Sucesso. Em caso de falha na gravação de uma linha no grid deverá aparecer uma marcação de falha no grid.
  9. Se no grid possuir itens com marcação de falha após a importação, o botão Exportar Itens não Importados deve gerar uma nova planilha Excel somente com estes itens no mesmo padrão do modelo.
  10. Feche a tela.
    O sistema deve voltar para a tela anterior e carregar os dados importados automaticamente.

Resultados Esperados

  1. Taborder dos campos deve respeitar a ordem estabelecida na especificação;
  2. O título da tela e botões e Abas devem conter o primeiro caracter de cada palavra em Caixa Alta (Exemplo: Faces do Container);
  3. Os labels dos campos/campos grid devem conter somente o primeiro caracter da primeira palavra em Caixa Alta. Exemplo: Tipo de avaria;
  4. Os campos e labels dos campos devem estar devidamente alinhados;
  5. As regras de cálculo da tela conforme o Tipo de cálculo aplicado automaticamente durante a importação;
  6. Uma importação de tabela de tarifas de reparos importada com sucesso;

 

Tela de Clonar Tarifa do Armador (Depot)

  1. Acesse o módulo Faturamento, menu Depot, submenu Tabela de Tarifas de Reparo.
    O sistema deve apresentar a tela de cadastro de tabela de tarifas de reparo.
  2. Crie uma nova tabela de tarifa e acione o botão Outras Ações -> Clonar Tarifa.
    O sistema deve apresentar a tela para clonar uma tarifa do armador;
  3. Valide se a tela está de acordo com o protótipo;
  4. Valide se o agrupador Tarifa é carregado corretamente.
  5. No agrupador Clonar de pesquise uma tarifa anterior.
    O sistema deve carregar os dados da tabela de tarifa e no grid carregar os itens da tarifa.
  6. Acione o botão Clonar tarifa.
    O sistema deve exibir ao lado do botão uma mensagem com a seguinte frase "Aguarde enquanto o sistema clona os dados da tarifa..." enquanto efetua a clonagem de tarifa. Ao termino o sistema deve exibir a mensagem "Tarifa clonada com sucesso!" com o botão OK de confirmação.
  7. Acione o botão OK.
    O sistema deve fechar a tela e voltar para a tela anterior.

Resultados Esperados

  1. Taborder dos campos deve respeitar a ordem estabelecida na especificação;
  2. O título da tela e botões e Abas devem conter o primeiro caracter de cada palavra em Caixa Alta (Exemplo: Faces do Container);
  3. Os labels dos campos/campos grid devem conter somente o primeiro caracter da primeira palavra em Caixa Alta. Exemplo: Tipo de avaria;
  4. Os campos e labels dos campos devem estar devidamente alinhados;
  5. Só deve permitir clonar de tarifas para o mesmo armador, com a mesma moeda e que esteja vencida ou cancelada;
  6. Uma clonagem realizada com sucesso;

 

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:

Nome

Tipo

Descrição

Obrigatório

 

 

 

 

 

 

 

 

 

 

 

 

 

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