Versões comparadas

Chave

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

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

  

Informações Gerais

 

Especificação

Produto

TOTVS Obras e Projetos

Módulo

Timesheet

Segmento Executor

Construção e Projetos

Projeto1

R_C&P_TOP007

IRM1

PCREQ-7444

Requisito1

PCREQ-7444

Subtarefa1

PDR_CP_TOP008-14

Chamado2

 

Release de Entrega Planejada

12.1.8

Réplica

Não

País

(X) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

Pré-Requisitos para melhor entendimento da especificação:

TOTVS HTML Framework - http://tdn.totvs.com/pages/createpage.action?spaceKey=LRM&title=HTML+Framework&linkCreation=true&fromPageId=196053421

Fluig - http://tdn.totvs.com/display/public/fluig/Sobre+o+Fluig

Projetos - http://wikihelp.totvs.com.br:1210/WikiHelp/PRJ/PRJ.Projetos.aspx

Timesheet - http://wikihelp.totvs.com.br/WikiHelp/PRJ/PRJ.Timesheet.aspx

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

Objetivo

 Migração da funcionalidade de Apontamentos de Tarefas de Timesheet para o ambiente Fluig utilizando o TOTVS HTML Framework. 

Definição da Regra de Negócio

TOTVS HTML Framework

 

O TOTVS | HTML Framework foi concebido para tratar apenas a camada de interface das aplicações, confiando que os produtos por trás da interface irão conceder a infraestrutura e a implementação mínima dos serviços para utilização doframework. 

Ela tem como objetivo: 

    • Fornecer uma Infraestrutura de componentes visuais e de serviços (de interface) HTML5; 
    • Disponibilizar um Template de CRUD responsivo com respectivo acelerador no TDS, baseado em Serviços providos pelos produtos; 
    • Estruturar um ambiente de desenvolvimento compatível com o Fluig e que possa ser utilizados por todos os produtos TOTVS.

 

Apontamentos em Tarefas de Timesheet

Após a criação das equipes e a devida alocação dos recursos (membros) realizada, os usuários (pessoas membros de equipe), poderão iniciar os apontamentos nas tarefas. O apontamento poderá ser realizado de três formas distintas, através da Visão de Apontamentos em Tarefas através da Execução da própria tarefa ou pelo processo de apontamentos por período Em ambas as possibilidades, deverão ser considerados alguns parâmetros e regras de consistência do apontamento. Cada apontamento terá uma classificação em relação à sua origem, podendo ser “Avulso” que são originários do cadastro a partir da visão de apontamentos ou do processo de inclusão por período, ou podendo ser “Padrão” que são incluídos através da execução de tarefas, que é considerado a forma mais correta.

Migração para TOTVS HTML Framework

Para a funcionalidade de Apontamentos em Tarefas de Timesheet do TOTVS Obras e Projetos serão desenvolvidas telas Web utilizando o TOTVS HTML Framework.

Uma vez que as telas Web forem desenvolvidas, estas serão inserida na plataforma Fluig para que o usuário possa ter um acesso mais ágil e prático da funcionalidade.

Serão desenvolvidas duas telas da seguinte forma:

    • Tela com a listagem dos apontamentos salvos na base de dados com opções para Adicionar, editar, visualizar e excluir um registro;
    • Tela com os detalhes de um registro;
    • Tela com um formulário para Adicionar ou Editar um registro.

Na tela de listagem de Apontamentos serão mostradas as seguintes informações: 

    • Código do Projeto
    • Descrição do Projeto
    • Código da Etapa 
    • Nome da Etapa
    • Código da Tarefa
    • Nome da Tarefa
    • Membro do apontamento;
    • Data do Apontamento (o valor padrão será a data atual);
    • Hora Inicial do Apontamento;
    • Hora Final do Apontamento;
    • Tempo (Hora Final – Hora Inicial);
    • Quantidade de Horas Apontadas;
    • Desconto em horas do apontamento (considerando o parâmetro);
    • Percentual de Completude;
    • Percentual Concluído da Tarefa;
    • Origem do apontamento (Padrão (execução da tarefa) ou Avulso (inclusão manual));
    • Tipo do apontamento (Produtivo ou Improdutivo);
    • Status do apontamento (Concluído ou Execução);
    • Motivo de Improdutividade (No caso de apontamentos Improdutivos);
    • Descrição da Equipe.

 

 

 

  • Parâmetros de Apontamento:
    • Intervalo de Desconto (Horas): Intervalo padrão para que no momento da inclusão ou alteração de um apontamento possa ser considerado. Este parâmetro somente será considerado se o intervalo do apontamento estiver no período de desconto informado. O parâmetro “Quantidade mínima de horas” informa qual a quantidade mínima de horas do apontamento para que o intervalo seja considerado.
      • Ex.: Intervalo de Desconto: 12:30 – 13:30
        Apontamento: 09:00 – 18:00 => 9 horas
        Desconto: 01:00
        Apontamento Real: 8 horas
                  
    • Quantidade de dias: Será considerado se a opção “Permitir apontamentos retroativos” estiver marcada. A data limite anterior permitida será a data atual menos o valor do parâmetro.
      • Ex.: Data do apontamento (data atual): 29/11/2013
        Quantidade de dias anteriores: 7
        Data limite permitida para o apontamento: 22/11/2013

 

• Deverá ser permitido a inclusão, edição e exclusão de apontamentos;
• Essa tela deve ser exclusiva para lançamentos de apontamentos de usuários alocados em tarefas de timesheet, tanto para responsáveis por equipes que gerenciam os membros quanto para os próprios membros;
• Usuários responsáveis por equipes poderão lançar apontamentos para outros usuários que são membro da equipe;
• Deverá ser criado um novo controle de segurança.

As colunas que deverão ser exibidas na visão do anexo são as seguintes:

• Código do Projeto
• Descrição do Projeto
• Código da Etapa
• Nome da Etapa
• Código da Tarefa
• Nome da Tarefa
• Membro do apontamento;
• Data do Apontamento (o valor padrão será a data atual);
• Hora Inicial do Apontamento;
• Hora Final do Apontamento;
• Tempo (Hora Final – Hora Inicial);
• Quantidade de Horas Apontadas;
• Desconto em horas do apontamento (considerando o parâmetro);
• Percentual de Completude;
• Percentual Concluído da Tarefa;
• Origem do apontamento (Padrão (execução da tarefa) ou Avulso (inclusão manual));
• Tipo do apontamento (Produtivo ou Improdutivo);
• Status do apontamento (Concluído ou Execução);
• Motivo de Improdutividade (No caso de apontamentos Improdutivos);
• Descrição da Equipe.

A tela de edição de apontamentos (Figura 5) deverá considerar as seguintes regras:

• Permitir a inclusão, edição e exclusão de apontamentos;
• O lookup de projetos só deverá listar projetos onde o usuário está alocado ou onde é responsável por equipe;
• O lookup de membros só estará habilitado se o usuário do sistema for um responsável por equipe. Os membros exibidos serão os pertencentes às equipes do usuário responsável;
• O lookup de tarefas só exibirá as tarefas do tipo Timesheet;
• A data do apontamento não poderá ser maior que a data atual;
• As horas inicial e final do apontamento não poderão ser iguais;
• O motivo de improdutividade só estará habilitado se o tipo for “Improdutivo”;
• Apenas os motivos de improdutividade do tipo Mão de Obra serão considerados;
• O parâmetro de Intervalo de Desconto será considerado na inclusão/edição do apontamento caso o parâmetro esteja dentro do intervalo de apontamento e se a “Quantidade mínima de horas” for atendida;
• O parâmetro “Quantidade de dias” será considerado na inclusão/edição do apontamento se o parâmetro “Permitir apontamentos retroativos” estiver marcado;
• No caso de a data do apontamento ser diferente da data de parada de execução da tarefa, uma mensagem de alerta será exibida e dois apontamentos serão inseridos considerando as horas iniciais e finais, como no exemplo:
o Apontamento:
 Início: 01/01/2014 15:00
 Fim: 02/01/2014 06:00
 Dois apontamentos inseridos:
• Apontamento 1: 01/01/2014 15:00 – 23:59
• Apontamento 2: 02/01/2014 00:00 – 06:00
• Ao salvar o apontamento será verificado se o percentual informado é menor que o percentual lançado com a data mais recente. Uma mensagem de confirmação deverá ser apresentada questionando se o usuário deseja continuar o lançamento do apontamento;
• Ao salvar o apontamento deverá ser verificado se o percentual informado é igual ao último percentual lançado com a data mais recente. Uma mensagem de confirmação deverá ser apresentada questionando se o percentual será o mesmo;
• Sempre que um apontamento for salvo, estando todas as consistências validadas, uma apropriação será inserida:
o A apropriação terá a tarefa, o insumo do membro, a pessoa do apontamento, que pode ser um funcionário ou um terceiro, a quantidade de horas apontadas, o preço do insumo associado ao membro, em caso de vigência considerará a data do apontamento;
o Se o apontamento estiver sendo alterado, a apropriação relacionada será excluída e uma nova será inserida;
o Não deverá ser possível alterar informações de apropriações que tem vínculo com apontamentos, pois essa alteração deverá ser feita no próprio apontamento, para impedir inconsistências nas informações;
o Não deverá ser possível excluir apropriações que tem vínculo com apontamentos.
• Os apontamentos só serão incluídos se não existir apontamentos do usuário para o período informado;
• O percentual de completude não pode ser maior que 100%;
• Após salvar o apontamento, o “Percentual Concluído” da tarefa no PERT deverá ser alterado considerando a quantidade de horas alocadas para o recurso, como demonstrado no exemplo:

Ex.:
Tarefa: 001.01.01 – Configurar Ambiente Integração – Total (Horas): 100 horas
JOSÉ DA SILVA: 60 horas alocadas
JOÃO DE SOUZA: 40 horas alocadas

Apontamento JOSÉ DA SILVA: 25% de completude
Apontamento JOÃO DE SOUZA: 30% de completude
Percentual Concluído da Tarefa:

JOSÉ DA SILVA: 25% * 60 = 15 horas
JOÃO DE SOUZA: 30% * 40 = 12 horas

Total: 27 horas concluídas => 27% da Tarefa concluída

 

 

 

 

 

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

     

     

     

     

     

     

     

     

     

    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*/

      

    Índice

    Chave

    01

    <FI9_FILIAL+FI9_IDDARF+FI9_STATUS>

    02

    <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF>

    03

    <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO>

    Campo

    <AAA_PERESP>

    Tipo

    <N>

    Tamanho

    <6>

    Valor Inicial

    <Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>. 

    Mandatório

    Sim (  ) Não (  )

    Descrição

    <Referência Mínima para Cálculo>

    Título

    <Ref.Calc.>

    Picture

    <@E999.99>

    Help de Campo

    <Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação>

     

    (Opcional)

    Grupo de Perguntas

     

    <Informações utilizadas na linha Protheus>.

     

    Nome: FINSRF2

    X1_ORDEM

    01

    X1_PERGUNT

    Emissão De

    X1_TIPO

    D

    X1_TAMANHO

    8

    X1_GSC

    G

    X1_VAR01

    MV_PAR01

    X1_DEF01

    Comum

    X1_CNT01

    '01/01/08'

    X1_HELP

    Data inicial do intervalo de emissões das guias de DARF a serem consideradas na seleção dos dados para o relatório 

     

    (Opcional)

    Consulta Padrão

    <Informações utilizadas na linha Protheus>

     

    Consulta: AMB

    Descrição

    Configurações de Planejamento

    Tipo

    Consulta Padrão

    Tabela

    “AMB”

    Índice

    “Código”

    Campo

    “Código”; ”Descrição”

    Retorno

    AMB->AMB_CODIGO

     

    (Opcional)

    Estrutura de Menu

     

    <Informações utilizadas na linha Datasul>.

     

    Procedimentos

     

    Procedimento

     

     

     

    Descrição

    (Max 40 posições)

    (Max 40 posições)

    (Max 40 posições)

    Módulo

     

     

     

    Programa base

     

     

     

    Nome Menu

    (Max 32 posições)

    (Max 32 posições)

    (Max 32 posições)

    Interface

    GUI/WEB/ChUI/Flex

    GUI/WEB/ChUI/Flex

    GUI/WEB/ChUI/Flex

    Registro padrão

    Sim

    Sim

    Sim

    Visualiza Menu

    Sim/Não

    Sim/Não

    Sim/Não

    Release de Liberação

     

     

     

     

     

     

    Programas

     

    Programa

     

     

     

    Descrição

    (Max 40 posições)

    (Max 40 posições)

    (Max 40 posições)

    Nome Externo

     

     

     

    Nome Menu/Programa

    (Max 32 posições)

    (Max 32 posições)

    (Max 32 posições)

    Nome Verbalizado[1]

    (Max 254 posições)

    (Max 254 posições)

    (Max 254 posições)

    Procedimento

     

     

     

    Template

    (Verificar lista de opções no man01211)

    (Verificar lista de opções no man01211)

    (Verificar lista de opções no man01211)

    Tipo[2]

    Consulta/Manutenção/ Relatório/Tarefas

    Consulta/Manutenção/ Relatório/Tarefas

    Consulta/Manutenção/ Relatório/Tarefas

    Interface

    GUI/WEB/ChUI/Flex

    GUI/WEB/ChUI/Flex

    GUI/WEB/ChUI/Flex

    Categoria[3]

     

     

     

    Executa via RPC

    Sim/Não

    Sim/Não

    Sim/Não

    Registro padrão

    Sim

    Sim

    Sim

    Outro Produto

    Não

    Não

    Não

    Visualiza Menu

    Sim/Não

    Sim/Não

    Sim/Não

    Query on-line

    Sim/Não

    Sim/Não

    Sim/Não

    Log Exec.

    Sim/Não

    Sim/Não

    Sim/Não

    Rotina (EMS)

     

     

     

    Sub-Rotina (EMS)

     

     

     

    Localização dentro da Sub Rotina (EMS)

     

     

     

    Compact[4]

    Sim/Não

    Sim/Não

    Sim/Não

    Home[5]

    Sim/Não

    Sim/Não

    Sim/Não

    Posição do Portlet[6]

    0 – Top Left

    1 – Top Right

    2 – Bottom Left

    3 – Bottom Right

    0 – Top Left

    1 – Top Right

    2 – Bottom Left

    3 – Bottom Right

    0 – Top Left

    1 – Top Right

    2 – Bottom Left

    3 – Bottom Right

    Informar os papeis com os quais o programa deve ser vinculado

     

     

     

     

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

     

    Código Papel

    (máx 3 posições)

    Descrição em Português*

     

    Descrição em Inglês*

     


    [1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.

    [2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante

    [3] Categorias são obrigatórias para os programas FLEX.

    [4] Obrigatório quando o projeto for FLEX

    [5] Obrigatório quando o projeto for FLEX

    [6] Obrigatório quando o projeto for FLEX

     Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.