Histórico da Página

Informações Gerais

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

Objetivo

Desenvolvimento de um componente para permitir o cadastro de dashboards por grupo de segurança (perfil), e possibilitar a configuração do dashboard por usuário.

Conversão para HTML5 dos portlets de pedidos e telas de aprovações de pedidos, disponíveis para o perfil Analista de Pedidos de Venda (Flex). 

Definição da Regra de Negócio 

 1 - Componente Dashboard HTML

Será desenvolvido um componente que permitirá o cadastro de dashboards por grupo de segurança (perfil), e será possível definir quais portlets estarão disponíveis para cada dashboard. 

Os dashboards serão configuráveis por usuário, o usuário poderá escolher o nome, o nome de cabeçalho, quais portlets ele deseja visualizar no dasboard e a posição dos portlets. 

O botão configurar estará disponível em cada dashboard, e abrirá a interface de configuração. Nesta interface o usuário poderá reposicionar para cima ou para baixo os portlets utilizando botões ou o recurso de arrastar e soltar (drag and drop), alterar o tamanho dos portlets para médio ou grande e remove-los.

No cabeçalho da interface de configuração do dashboard estará disponível um botão para cancelar ou gravar a configuração realizada pelo usuário. 

O cabeçalho também terá um botão para adicionar widgets, este botão abrirá uma lista de portlets disponivéis para inclusão no dashboard, com opção de filtro pelo nome do portlet.

Os dashboards e seus portlets serão cadastrados no cadastro de programas do produto datasul (men012aa). Se for desenvolvido algum portlet customizado, este poderá ser adicionado ao dashboard através do cadastro de menus. O cliente também poderá adicionar dashboards customizados através do cadastro de menu do Datasul.

• Dados Técnicos:
  
  Este componente poderá ser reutilizado para criar dashbaords para qualquer modulo disponível no Datasul, por este motivo foi desenvolvido no pacote html-dts-utils-X.X.X-SNAPSHOT.war que se encontra dentro do .EAR do Datasul.
  
  Para acessar os dados progress será criado a fachada (API) "fch/fchutils/fchutils0001.p" e será adicionado na estrutura de arquivos progress do Datasul.
  
  Para gravar as configurações realizadas pelo usuário será utilizado a tabela configur, disponível no foundation, está tabela é utilizada para gravação de preferencias de usuários do Datasul.
  
  Este componente deverá ter um cadastro de menu geral denominado "Dashboard Generico" que o componente utilizará como base para os dashboards cadastrados pelas áreas de negócio (conforme tabela de estrutura de menu definida abaixo).
  
  Cada dasboard deverá ser cadastrado no programa de cadastro de menu (men012aa) e ficará a critério da área de negócio defini-lo como visível ou não. O campo "Nome Externo" no cadastro do dashboard no programa men012aa deverá ser composto pelo seguinte valor: "dts/dts-utils/dashboard" mais o identificador único de cada dashboard, sendo sugerido que seja o código do grupo de segurança (perfil) do dashboard. Por exemplo: "dts/dts-utils/dashboard/rep". 
  
  Ainda no cadastro do dashboard no cadstro de programas (men012aa), o campo "Template" deverá conter a opção "Programa HTML", o campo "Tipo" deve conter a opção "Consulta" e o campo "Interface" deve conter a opção "WEB".
  
  Para ficarem disponíveis nos dasboards os portlets serão cadastrados no cadastro de programas (men012aa), neste cadastro o campo "Nome Externo" obrigatoriamente deve conter o contexto do módulo (dts/[modulo]) a estrutura  de pastas e o nome do arquivo principal do portlet html. Por exemplo: "dts/mpd/html/dashboard/customersummary.jsp". 
  
  Será através da informação do campo "Nome Externo" que o dashboard encontrará o portlet. Outro detalhe obrigatório é  em relação ao arquivo Java Script que define o controller do portlet, este deve conter o mesmo nome do arquivo .html ou .jsp que define a interface html.
  
  No cadastro no programa men012aa para o portlet, o campo "Template" deverá conter a opção "Programa HTML", o campo "Tipo" a opção "Consulta" o campo "Interface" a opção "FLEX", o campo "Categoria" a opção "MONITORY" e não deve ser marcado a opção "Visualiza Menu". 
  
  Se for adicionado mais de um grupo de segurança para um portlet através do programa men012aa (botão Grupo de Segurança), este portlet ficará disponível para os usuários que tiverem permissão de acesso a esses grupos.
  
  Para as funcionalidades de drag and drop será utilizado um plugin externo ao Totvs HTML Framework, este plugin possui licença MIT e esta publicado na web no seguinte endereço:
  http://ngmodules.org/modules/ngDraggable.

 2 - Dashboard do Representante (Portal).

O dashboard do perfil representante no portal de vendas será alterado para utilizar o componente de Dashboard HTML, para isso será cadastrado uma nova opção de menu no cadastro de programas do Datasul  (conforme tabela de estrutura de menu definida abaixo). O cadastro deste dashboard no cadastro de programas (men012aa) deve conter apenas o grupo de segurança "REP".

O menu exclusivo do portal, deverá ter a opção de menu "Dashboard do Representante" alterada para abrir este dashboard.

Para o perfil representante será disponibilizado o portlet Cliente Selecionado, que permitirá a seleção de um cliente e filtrará automaticamente os seguintes portlets: Resumo de Pedidos, Resumo de Agenda, Últimas Notas Fiscais, Resumo de Comissões , Resumo de Títulos  dos Cliente e Últimos Pedidos. O portlet Cliente selecionado está detalhado abaixo no item 8.

A pesquisa rápida por código ou nome abreviado, atualmente disponível no dashboard de representante para o portal, será substituída pelo portlet Cliente Selecionado.

Os portlets disponíveis atualmente para o perfil representante no portal deverão ser adicionados no programa Cadastro de Programas do Datasul (men012aa) para os grupos de segurança "REP".

A configuração de portlets disponível no programa Adiconar Campos por Seleção (FFAdicionaCamposPortal) através da opção "Dashboard do Representante" será removida, e a configuração dos portlets passarão a ser executas no próprio dashboard.

• Dados Técnicos: 

  Os arquivos dos portlets disponíveis atualmente na pasta "html/dashboard" para o dashboard do representante serão movidos para a pasta "html/dashboard/rep".

  A opção do menu "Dashbaord do Representante" que está no menu exclusivo do portal para o perfil representante , deverá ser alterada no método "getMenu" do programa fch/fchdis/fchdis0035api.p de "#/dts/mpd/dashboard" para "#/dts/dts-utils/dashboard/rep".

   

3 - Dashboard do Cliente (Portal).

O dashboard do perfil cliente no portal de vendas será alterado para utilizar o componente de Dashboard HTML, para isso será cadastrado uma nova opção de menu no cadastro de programas do Datasul  (conforme tabela de estrutura de menu definida abaixo). O cadastro deste dashboard no cadastro de programas (men012aa) deve conter apenas o grupo de segurança "CLV".

O menu exclusivo do portal, deverá ter a opção de menu "Dashboard" alterada para abrir este dashboard.

• Dados Técnicos: 
  Os portlets "Resumo de Pedidos" e "Últimos Pedidos" disponíveis atualmente para o dashboard do cliente do portal de vendas, deverá ser cadastrado no programa men012aa para os grupos de segurança "REP" e "CLV", desta forma estes dois portlets estarão disponíveis para os dashboards de Clientes e Representantes no portal.
  
  A opção de menu "Dashoard" que está no menu exclusivo do portal para o perfil cliente, deverá ser alterada no método  "getMenu"  programa fch/fchdis0035api.p de "#/dts/mpd/dashboard" para "#/dts/dts-utils/dashboard/clv".

4 - Dashboard Analista de Pedidos de Venda.

Será criado o dashboard Analista de Pedidos de Venda (HTML) utilizando o componente Dashboard HTML, para isso será cadastrado uma nova opção de menu no cadastro de programas do Datasul  (conforme tabela de estrutura de menu definida abaixo). O cadastro deste dashboard no cadstro de programas (men012aa) deve conter apenas o grupo de segurança "APD".

Para este deashboard estarão disponíveis os seguintes portlets:

• Resumo de Pedidos - definido no item 6.
• Resumo de Clientes - definido no item 7.
• Cliente Selecionado - definido no item 8.
• Resumo de Pedidos do Portal - definido no item 9.
• Resumo de Aprovação de Pedidos (Alçada) - definido no item 11.
  
  

5 - Dashboard Implantador de Pedidos de Venda.

Será criado o dashboard Implantador de Pedidos de Venda (HTML) este dashboard será similar ao do Analista de Pedidos de Venda, porém não terá o portlet "Resumo de Pedidos do Portal".

Para este dashboard será cadastrado uma nova opção de menu no cadastro de programas do Datasul  (conforme tabela de estrutura de menu definida abaixo),  e cadastro deste dashboard no cadastro de programas (men012aa) deve conter apenas o grupo de segurança "IPD".

Para este deashboard estarão disponíveis os seguintes portlets:

• Resumo de Pedidos - definido no item 6.
• Resumo de Clientes - definido no item 7.
• Cliente Selecionado - definido no item 8.
• Resumo de Aprovação de Pedidos (Alçada) - definido no item 11.
  
  

6 - Portlet - Resumo de Pedidos.

O portlet Resumo de Pedidos, disponível atualmente em Flex será convertido para HTML5, utilizando os padrões do Totvs HTML Framework. As funcionalidades do portlet permanecem similares porém não haverá a opção de visualizar planilha. Ao clicar no botão "detalhar" será aberta a interface de carteira de pedidos (especificada em outro documento).

Este portlet deve ser cadastrado no cadastro de programas (men012aa) para os grupos de segurança "APD" e "IPD" (conforme tabela de estrutura de menu definida abaixo).

• Dados Técnicos: 
  Para definição dos serviços REST, que disponibilizarão os dados para a interface, será criada a fachada fch/fchdis/fchdis0046.p que utilizará o método ordersSummaryOrderAdder  da API utilizada na interface Flex para retornar o gráfico de pedidos (fch/fchdis/fchdis0003api.p).
  Os arquivos deste portlet estarão na pasta "html/dashboard/apd" que se encontra dentro da estrutura de pastas do modulo html de pedidos. 
  
  Para tornar os campos "Tipo de Hierarquia" e "Hierarquia" visiveis, será verificado se o modulo de hierarquia de times esta ativo através do método getUserData da API fch/fchdis/fchdis0035api.p, estas informações já estão disponíveis na factory portalUserDataFactory.
  
  

  Se houver um código de cliente na variável  $rootScope.selectedcustomercode, o checkbox "Todos" que define se será exibido apenas os pedidos do cliente selecionado ou de todos os clientes deve ficar habilitado, caso contrario deve ficar desabilitado.

  O botão "detalhar" deste portlet deve abrir a nova interface de carteira de pedidos que será desenvolvida para o perfil de implantador de pedidos interno (IPD e APD).

7 - Portlet - Resumo de Clientes.

O portlet Resumo de Clientes, disponível em Flex, será convertido para HTML5, utilizando os padrões do Totvs HTML Framework. 

Este portlet deve ser cadastrado no cadastro de programas (men012aa) para os grupos de segurança "APD" e "IPD" (conforme tabela de estrutura de menu definida abaixo).

• Dados Técnicos: 
  Para definição dos serviços REST, que disponibilizarão os dados para a interface, será criada a fachada fch/fchdis/fchdis0048.p que utilizará o método returnCustomerSumaryOrderAdder da API utilizada na interface Flex para retornar os dados do gráfico de clientes (fch/fchdis/fchdis0001.p).
  
  O botão "detalhar" deste portlet deve abrir a nova interface de carteira de clientes que será desenvolvida para o perfil de implantador de pedidos interno (APD e IPD).
  
  Os arquivos deste portlet estarão na pasta "html/dashboard/apd" que se encontra dentro da estrutura de pastas do modulo html de pedidos. 
  
  

8 - Portlet - Cliente Selecionado

O portlet Cliente Selecionado, disponível em Flex, será convertido para HTML5, utilizando os padrões do Totvs HTML Framework. 

Este portlet deve ser cadastrado no cadastro de programas (men012aa) para os grupos de segurança "APD", "IPD" e "REP" (conforme tabela de estrutura de menu definida abaixo).

As funcionalidades do portlet serão similares ao já existente em Flex, quando o usuário selecionar um cliente os seguintes portlets serão filtrados automaticamente:

Tabela 01

• Dados Técnicos: 
  Os portlets disponíveis para o portal de vendas listados na tabela 01 serão alterados para escutarem o evento selectedcustomer disparado pelo portlet Cliente Selecionado, e realizar filtro pelo cliente.
  Exemplo:
  

  this.$on("selectedcustomer", function(){ //executar o filtro por cliente}); 

  
  Para definição dos serviços REST, que disponibilizarão os dados para a interface, será utilizada a fachada fch/fchdis/fchdis0048.p que utilizará o método findByPrimaryKey da API utilizada na interface Flex para retornar os dados do cliente selecionado (fch/fchdis/fchdis0001.p).
  
  Ao selecionar um cliente a variável global $rootScope.selectedcustomercode deverá assumir o código do cliente e disparar o evento "selectedcustomer".
  Exemplo:
  

  $rootScope.$broadcast("selectedcustomer");

   

  O botão para pesquisa de cliente que existe atualmente na interface em Flex, será substituído pelo botão de lupa do campo "Busca Rápida", que será do tipo field select2. 
  
  

  O botão detalhar deste portlet deverá abrir a interface  "Detalhe de Cliente", utilizando o endereço "dts/mpd/customer/[código do cliente]".

   

  O botão pedido deve abrir a interface para seleção de modelo, se houver modelo cadastrado para o usuário, caso contrário deve abrir diretamente a interface de implantação de pedidos html (nova interface do PD4000) passando como parâmetro o código do cliente selecionado. O endereço da nova interface do PD4000 será

  "#/dts/mpd/pd4000/model/[código do cliente]", e pode ser verificado no seguinte documento: MANDIS01-83 - Tela de manutenção de Pedido de Venda (PD4000 HTML) .

  Os arquivos deste portlet estarão na pasta "html/dashboard/apd" que se encontra dentro da estrutura de pastas do modulo html de pedidos. 

9 - Portlet - Resumo de Pedidos do Portal

O portlet Resumo de Pedidos do Portal, disponível em Flex, será convertido para HTML5, utilizando os padrões do Totvs HTML Framework. As funcionalidades da interface serão semelhantes, porém não estará disponível a visualização dos dados em grade.

 Este portlet deve ser cadastrado no cadastro de programas (men012aa) somente para o grupo de segurança "APD" (conforme tabela de estrutura de menu definida abaixo).

• Dados Técnicos: 
  Para definição dos serviços REST, que disponibilizarão os dados para a interface, será utilizada a fachada fch/fchdis/fchdis0046.p que utilizará o método getOrderSummary da API utilizada na interface Flex para retornar os dados do gráfico (fch/fchdis/fchdis0030.p).
  
  O botão "detalhar" abrirá a nova interface em html de Gerenciamento dos Pedidos de Venda do Portal, através do endereço "dts/mpd/portalordersmanager".
  
  Os arquivos deste portlet estarão na pasta "html/dashboard/apd" que se encontra dentro da estrutura de pastas do modulo html de pedidos. 

10 - Tela - Gerenciamento dos Pedidos de Venda do Portal

A interface de gerenciamento de pedidos do portal será convertida da tecnologia Flex (Metadados) para HTML5 utilizando os padrões do Totvs HTML Framework. As funcionalidades da interface serão semelhantes, porém haverá melhorias de usabilidade e aplicação de algumas sugestões de melhorias.

• • Dados Técnicos: 
    Para definição dos serviços REST, que disponibilizarão os dados para a interface, será criada a fachada fch/fchdis/fchdis0047.p e a API fch/fchdis/fchdis0047api.p que terá suas funções baseadas nas funções da API fch/fchdis/fchdis0013.p que é utilizada na interface Flex.
    
    

    Método Novo (fchdis0047api.p)	Método base (fchdis0013api.p)	Descrição
    getTaskAvailable	verifyTaskApproval	Retorna as opções de disponíveis para atividades de aprovação do pedidos (combo aprovação). Nesta função deverá ser adicionado as atividades do workflow para aprovação de cancelamento de pedidos.
    searchOrdersManager	getOrderSummary	Retorna a lista de pedidos para a grade de registros.
    searchOrdersManager	piReturnRegistry	Retorna registros de pedidos por paginação.
    searchOrdersManager	simpleFilter	Realiza filtro de pedidos considerando situações selecionadas
    searchOrdersManager	AdvancedFilter	Realiza filtro avançado.
    saveAndSendTask	saveAndSendTask	Realiza ação de transferência, aprovação, reprovação e assumir tarefas, (considera workflow de aprovação de pedidos se configurado). Nesta função deve ser adicionado a funcionalidade para aprovação de cancelamento de pedidos do portal.
    portalOrdersSanitize	deleteOrder	Realiza saneamento de pedidos do portal. (mpd_FFPortalEliminaPedidoVenda.xml)
    deleteSelectedOrders	novo	Remove os pedidos selecionados na grade de registros

     

    As funcionalidades do métodos getOrderSummary, piReturnRegistry, simpleFilter e  AdvancedFilter da API fch/fchdis/fchdis0013api serão unificadas no método na API fch/fchdis/fchdis0047api.p.

    Exemplo de assinatura do método searchOrdersManager:   

    PROCEDURE PROCEDURE searchOrdersManager:
    DEFINE INPUT PARAMETER p-start AS INTEGER NO-UNDO. /*Índice do primeiro registro requisitado*/
    DEFINE INPUT PARAMETER p-max AS INTEGER NO-UNDO. /*Quantidade máxima de registros por requisição*/
    DEFINE INPUT PARAMETER p-prop AS CHARACTER EXTENT NO-UNDO. /*Lista de nomes de campos para filtros*/
    DEFINE INPUT PARAMETER p-values AS CHARACTER EXTENT NO-UNDO. /*Lista de valores de campos para filtros*/
    DEFINE INPUT PARAMETER p-order AS CHARACTER NO-UNDO.
    DEFINE INPUT PARAMETER p-asc AS CHARACTER NO-UNDO.
    DEFINE INPUT PARAMETER p-fullobj AS LOGICAL NO-UNDO.
    DEFINE OUTPUT PARAMETER paramcount AS INTEGER NO-UNDO.
    DEFINE OUTPUT PARAMETER TABLE FOR ttOrdersManager. /*Registros de pedidos*/
    DEFINE OUTPUT PARAMETER TABLE FOR RowErrors. /*Registros de erros de negócio*/

     

    
    Para exibir o detalhe de um pedido será utilizada a mesma interface desenvolvida para o portal. O botão "Detalhe do Pedido" desta tela deve abrir a interface disponível através do endereço "dts/mpd/orderdetail/[nr pedido]". 

     

    Obs: A interface "Detalhe de Pedido" será atualizada para suportar o perfil de implantador interno (APD/IPD) em outra especificação.

     

    
    

     

    Para exibir o histórico do pedido será utilizada a mesma interface desenvolvido para o portal. O botão "Histórico do Pedido" desta tela deve abrir  a interface disponível através do endereço "dts/mpd/orderhistory/[nr pedido]".

     

11 - Portlet - Resumo de Aprovação de Pedidos (Alçada)

12 - Tela - Aprovação de Pedidos de Venda (Alçada - mpd.FFLibPedVda)

13 - Tela - Configurações de Alçada de Desconto (Cadastro de Alçada + Configurações de Workflow)

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

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

• prog_dtsul
• prog_dtsul_segur
• configur
• usuar_mestre

available

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

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

Nome: FINSRF2

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

Consulta: AMB

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