ER Configuração de Cabeçalhos Portal GCH

Informações Gerais

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

Objetivo

Esse requisito tem por objetivo permitir que os clientes possam customizar o cabeçalho e seus conteúdos que estão disponíveis dentro de várias funcionalidades no portal de gestão do capital humano.

Definição da Regra de Negócio

Relação de fontes envolvidos nesse requisito:

WebService RHMenu

O objetivo da atualização desse serviço é criar um novo método para realizar a chamada do novo ponto de entrada que será criado para permitir a troca das informações contidas de cabeçalhos que são carregados atualmente no portal gestão do capital humano, para isso deveremos realizar as seguintes atividades:

• Criar um novo método denominado UpdHeader, com as seguintes configurações:
  • Definir uma estrutura para o recebimento e envio das informações, como no exemplo abaixo:
  • 
  • Utilizar como parâmetros de entrada (WSReceive): 
    1. TypeReq - tipo da requisição;
    2. Branch - Código da Filial;
    3. HeadUser - Código do usuário;
    4. InputHeader - Objeto de estrutura do header que deverá conter uma lista de: (Título, Conteúdo).
  • Após o recebimento do parâmetro converter o objeto em um array simples de 2 colunas (Título e Conteúdo).
  • Enviar todos parâmetros recebidos para o execBlock do ponto de entrada.
  • Após o processamento o PE deverá devolver o mesmo array enviado com as modificações desejadas.
  • O método deve transformar o array recebido em um objeto simples para retornar como resposta (WSSend):
    1. ListOfOutput - retorna a lista do novo header avaliado pelo ponto de entrada contendo as mesmas informações de: (Título, Conteúdo)
       

Criação do Ponto de Entrada

Para atender essa necessidade de customização de cabeçalhos devemos criar um novo ponto de entrada, denominado "PgchHeader", onde o mesmo será responsável em enviar as informações de cabeçalho do produto padrão e receber o novo cabeçalho desejado pelo cliente para que possa ser renderizado no browser ao usuário logado no Portal GCH.

Dependendo da funcionalidade acessada no portal, o cabeçalho pode possuir informações diferenciadas, como por exemplo no protótipo 01, encontrado na maioria dos itens de solicitação no menu principal.

Esse ponto de entrada possuíra as seguintes características: 

• Serão enviados 4 parâmetros para o ponto de entrada:
  1. (Identificador da Requisição): esse parâmetro é responsável em informar ao PE qual o tipo da funcionalidade do Portal GCH está sendo executada no determinado momento. Os identificadores liberados estão descritos nesse requisito.
  2. (Filial): a informação da filial será disponibilizada apenas quando a funcionalidade do portal estiver processando uma informação referente a um determinado funcionário, por exemplo, ao realizar uma solicitação de férias do próprio usuário logado no portal ou quando o gestor está realizando a alguma inclusão de solicitação. Ou seja, sempre existirá uma filial válida quando uma matrícula estiver envolvida, quando o primeiro parâmetro estiver indicando algum tipo de requisição que não envolva matrícula esse parâmetro será preenchido com os caracteres '@@' para o ponto de entrada.
  3. (Matrícula / Participante): esse parâmetro dependendo do contexto poderá receber a matrícula do funcionário(SRA) ou o código do participante(RD0), por exemplo, durante o contexto relacionado à avaliação de desempenho será enviado o código do participante.
  4. (Conteúdo do Header): esse parâmetro é um array que possuíra 2 posições em cada linha, com as seguintes características:
     1. Na primeira posição do array será enviado o título do item de cabeçalho, exemplo: 'MATRÍCULA';
     2. Na segunda posição do array será enviado o conteúdo do item de cabeçalho, exemplo: '000005';
• Todas as informações que seriam mostradas no cabeçalho para o usuário serão enviadas pelo array do quarto parâmetro.
• O ponto de entrada poderá manipular o header de acordo com suas necessidades, como por exemplo, incluir novas linhas, excluir um cabeçalho padrão, mudar o conteúdo do título e a sua informação.
• Será permitido também inserir uma linha em branco entre os cabeçalhos, com o objetivo de melhorar e organizar a apresentação. Para utilizar essa funcionalidade é necessário adicionar uma linha no array, onde os conteúdos da primeira e segunda ocorrência deverão estar em branco.
• Durante a execução do ponto de entrada todo o environment estará disponível para que seja utilizado durante a customização do cabeçalho, permitindo que a user function tenha acesso as tabelas e funcionalidades do protheus.

No exemplo da user function abaixo, aplicada ao protótipo 01 deverá ser produzido o resultado esperado de acordo com o protótipo 02:

Itens disponíveis para customização do cabeçalho

Os identificadores de requisições listados correspondem a informação enviada no primeiro parâmetro do ponto de entrada utilizado para identificar em qual o item de menu do portal está sendo utilizado no determinado momento do processamento da user function:

Protótipo de Tela

 Protótipo 01

 Protótipo 02