Relatórios em telas do Gestão do Ponto

Permite adicionar relatórios a serem exibidos em telas do colaborador e do gestor. Para isso, é necessário realizar algumas configurações:

1. Criar um arquivo com a extensão ".link" no pacote "src" do projeto de customização do cliente.
2. Exemplo:

   meuArquivoDeLinks.link

1. Criar um arquivo com a extensão "workset.repository" no pacote "src" do projeto de customização do cliente.
   Exemplo:

   workset.repository

Neste arquivo serão definidos os links (os arquivos ".link" definidos anteriormente, com as configurações dos relatórios) que o sistema irá utilizar.

Exemplo:

workset.repository

Conteúdo do arquivo:

{

links: ["meuArquivoDeLinks"]

}

Configuração de um arquivo .link

Em arquivos ".link" é necessário configurar:

• Em que tela ele será exibido;
• Nome;
• Produto;
• Módulo;
• Relatório;
• Parâmetros e se a tela inicial de parâmetros será exibida.

Exemplo:

Configuração dentro do arquivo ".link":

{

links: [{

// Relatório Apuração para o colaborador

name: "relatorioColaborador",

type: "REPORT",

title: "Relatório de Apuração",

tags: ["colaborador"],

productName: "ronda",

moduleName: "HR",

resource: "HRAP001.APU",

skipParamsScreen: false,

visibleToGroups: ["grupoGestores", "grupoDiretores", "grupoRH"],

params: [{

name: "dado_EAbrEmp",

value: "${EAbrEmp}"

}, {

name: "dado_UsaPosto",

value: "S"

}, {

name: "dado_QtdVariavel",

value: "158"

}, {

name: "dado_EAbrTcl",

value: "${tipCol}"

}, {

name: "dado_EAbrCol",

value: "${tipCol}"

}]

}, {

// Relatório Apuração para o gestor

name: " relatorioGestor",

type: "REPORT",

title: "Relatório de Apuração",

tags: ["gestor"],

productName: "ronda",

moduleName: "HR",

resource: "HRAP002.APU",

skipParamsScreen: false,

visibleToGroups: ["grupoGestores", "grupoDiretores", "grupoRH"],

params: [{

name: "dado_EDatInr",

value: "${datIni}"

}, {

name: "dado_EDatFir",

value: "${datFim}"

}, {

name: "dado_NomePadrao",

value: "João da Silva"

}]

}]

}

Parâmetros para definição de relatório

Parâmetros utilizados para definir um relatório:

Name
Define o identificador único do relatório, que não pode se repetir dentro do arquivo de links.

Type
Define o tipo de link que a ser utilizado, para relatórios deve ser utilizado "REPORT".

Title
Define o título que a ser apresentado na tela como opção para o usuário.

Tags
Define os assuntos de cada relatório, no Gestão do Ponto existem três tags reservadas, são elas:

• "gestor": define quais relatórios irão aparecer para o gestor;
• "colaborador": define quais relatórios irão aparecer para o colaborador;
• "visibleToGroups": define que a lista de relatórios será filtrada através dos grupos de usuários informados. Assim, caso o usuário não pertencer a nenhum grupo configurado, o relatório não é exibido a ele. Entretanto, caso não encontre esta propriedade ou seu valor for vazio, o relatório é visualizado para qualquer usuário.

ProductName
Nome do produto aonde o relatório utilizado se encontra, por exemplo: ronda.

ModuleName
Nome do módulo aonde o relatório utilizado se encontra, por exemplo: HR.

Resource
O nome do relatório a ser utilizado, por exemplo: HRAP002.APU

SkipParamsScreen
Define se a tela de parâmetros iniciais será apresentada.

Params
Lista de parâmetros que o relatório irá receber. Deve ser informado as seguintes propriedades:

• Name: nome do parâmetro que está no relatório, sempre iniciando com "dado_".
  Exemplo:

  dado_EDatIni

• Value: valor que será passado como parâmetro para o "name" informado. Este valor pode ser fixo ou variável. Caso seja utilizado uma variável do sistema como valor do parâmetro, ela deve seguir a seguinte nomenclatura "${nome_variavel}".
  Exemplos:

  João da Silva, 2, ${datIni}

Por padrão o Gestão do ponto disponibiliza as seguintes variáveis para os valores dos parâmetros:

• Gestor: Início e fim do período de apuração selecionado (datIni e datFim).
• Colaborador: Empresa do colaborador, Tipo do colaborador, Cadastro do colaborador, Início e fim do período de apuração selecionado (numEmp, tipCol, numCad, datIni e datFim).