Histórico da Página
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 | Datasul | Módulo | Portal HCM |
Segmento Executor | Manufatura | ||
Projeto | D_MAN_HCM002 | IRM | PCREQ-540 |
Requisito | PCREQ-6092 | Subtarefa | PDRMAN-4425 |
Release de Entrega Planejada | 12.1.98 | ||
País | ( X ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________. |
Objetivo
Possibilitar a consultar e alteração pelo funcionário de seus dados cadastrais relacionados ao eSocial.
Incluir todos os novos campos do eSocial relacionados aos dados do funcionário no portlet Meus Dados do Portal HCM.
Dica |
---|
A empresa poderá parametrizar no FP0170 - Manutenção Grupo de informações, quais campos do eSocial o funcionário poderá consultar, alterar ou não visualizar. |
Aviso |
---|
Só existirá possibilidade de alterar um campo visualizado na tela Meus Dados, se for um campo do eSocial ou se for um campo que já possuía este tratamento. Não será tratado neste requisito os demais campos. |
Definição da Regra de Negócio
Rotina | Tipo |
Definição da Regra de Negócio
Ao entrar no Portal HCM no portlet Meus Dados existirá uma aba chamada "eSocial". Nesta aba o funcionário terá duas opções:
- Download: Exportar uma planilha excel contendo todos os dados cadastrais do eSocial relativos ao funcionário, como: dados pessoais, endereço, identificação funcional e documentos (ver tabela de localização dos campos eSocial logo abaixo).
- Upload: Importar a planilha excel exportada acima. Os dados alterados serão gravados no HCM.
Abaixo segue o fluxo completo deste processo:
Nota | ||
---|---|---|
| ||
As apis do processo 3 devem ser construidas para que sejam reaproveitadas no Fluig. |
Rotina | Tipo de Operação |
FP0170 - Manuteção Grupo de Informações | Alteração |
Portlet Meus Dados - EmployeeDataView | Alteração |
varinc/varXXXXX.i | Novo |
object/sopy/brw/b02py262.w | Alteração |
FPAPI054.p | Alteração |
FPAPIXXX | Novo |
FPAPI023 | Alteração |
Tabelas de localização dos campos eSocial
Relação dos campos eSocial do funcionário que serão incluídos na planilha excel tela Meus Dados e o tipo possível de permissão no mesmo (sem permissão, consulta ou alteração).
Nota |
---|
Quando o campo for do tipo sem permissão ele aparecerá na tela, porem, congelado e vazio. |
Legenda | |
---|---|
Campo HCM | Nome do campo na tela do HCM |
Campo eSocial | Nome do campo no layout do eSocial |
Campo Flex | Nome do campo equivalente que será usado na planilhana tela flex Meus Dados |
Campo Novo | Indica se esse campo não existe nas demais telas flex do Portal HCMé um novo campo na tela flex Meus Dados |
Programa | Código da tela do HCM que contem o campo |
Tabela | Tabela no banco do HCM onde o valor do campo é armazenado |
Tipo Permissão | Indica se será possível parametrizar o funcionário poderá alterar o valor do campo na planilhacampo para apenas consulta, alteração ou sem permissão de visualização pelo funcionário |
Zoom | Indica se o campo é do tipo combobox |
Pessoal | ||||||||
ID | Campo HCM | Campo eSocial | Campo Flex | Campo Novo? | Programa | Tabela | Tipo Permissão | Zoom? |
---|---|---|---|---|---|---|---|---|
1 | Nome eSocial | nmTrab | Nome eSocial | Sim | FP1440A | compl_pessoa_fisic.nom_pessoa_fisic_sped | alterar | Não |
2 | Sexo | sexo | Sexo | Não | FP1440 | rh_pessoa_fisic.idi_sexo | consultar | Sim |
3 | Cútis | racaCor | Cútis | Sim | FP1440 | rh_pessoa_fisic.idi_cor_cutis | consultar | Sim |
4 | Estado Civil | estCiv | Estado Civil | Não | FP1440 | rh_pessoa_fisic.idi_estado_civil | alterar | Sim |
5 | Grau Instrução | grauInstr | Grau de Instrução | Não | FP1440 | rh_pessoa_fisic.cdn_grau_instruc | alterar | Sim |
6 | Data Nascimento | dtNascto | Data Nascimento | Não | FP1440 | rh_pessoa_fisic.dat_nascimento | consultar | Não |
7 | Município | codMunic | Município Nascimento | Sim | FP1440A | compl_pessoa_fisic.cod_livre_1,2,7 | alterar | Sim |
8 | UF Nascimento | uf | UF Nascimento | Não | FP1440 | rh_pessoa_fisic.cod_unid_federac_nasc | alterar | Sim |
9 | País Nascimento | paisNascto | País Nascimento | Não | FP1440 | rh_pessoa_fisic.cod_pais_nasc | alterar | Sim |
10 | País Nacionalidade | paisNac | País Nacionalidade | Sim | FP1440A | compl_pessoa_fisic.cod_livre_1,9,3 | alterar | Sim |
11 | Nome Mãe | nmMae | Nome da Mãe | Não | FP1440 | rh_pessoa_fisic.nom_mae_pessoa_fisic | alterar | Não |
12 | Nome Pai | nmPai | Nome do Pai | Não | FP1440 | rh_pessoa_fisic.nom_pai_pessoa_fisic | alterar | Não |
Protótipo - Meus Dados - Pessoal
Endereço | ||||||||
---|---|---|---|---|---|---|---|---|
ID | Campo | |||||||
Endereço | ||||||||
ID | Campo HCM | Campo eSocial | Campo Flex | Campo Novo? | Programa | Tabela | Tipo Permissão | Zoom? |
13 | Tipo Logradouro | tpLograd | Tipo | Sim | FP1440A | compl_pessoa_fisic.cod_tip_lograd | alterar | Sim |
14 | Endereço | dscLograd | Endereço | Não | FP1440 | rh_pessoa_fisic.nom_ender_rh | alterar | Não |
15 | No. Res. | nrLograd | Número | Não | FP1440 | rh_pessoa_fisic.cod_livre_1,066,008 | alterar | Não |
16 | Ponto Referência | complemento | Ponto Referência | Não | FP1440 | rh_pessoa_fisic.nom_pto_refer | alterar | Não |
17 | Bairro | bairro | Bairro | Não | FP1440 | rh_pessoa_fisic.nom_bairro_rh | alterar | Não |
18 | CEP | cep | CEP | Não | FP1440 | rh_pessoa_fisic.cod_cep_rh | alterar | Não |
19 | Município | codMunic | Muncípio | Sim | FP1440A | compl_pessoa_fisic.cod_livre_1,085,007 | alterar | Sim |
20 | UF | uf | UF | Não | FP1440 | rh_pessoa_fisic.cod_unid_federac_rh | alterar | Sim |
21 | País Endereço | paisResid | País Endereço | Não | FP1440 | rh_pessoa_fisic.cod_pais_ender | alterar | Sim |
22 | Telefone | fonePrinc | Telefone | Não | FP1440 | rh_pessoa_fisic.num_ddd + rh_pessoa_fisic.num_telefone | alterar | Não |
23 | Telefone Contato | FoneAlternat | Telefone Contato | Não | FP1440 | rh_pessoa_fisic.num_ddd_contat + rh_pessoa_fisic.num_telef_contat | alterar | Não |
24 | emailPrinc | Não | FP1440 | rh_pessoa_fisic.nom_e_mail | alterar | Não | ||
25 | E-mail Contato | emailAlternat | E-mail Contato | Sim | FP1440 | rh_pessoa_fisic.cod_livre_1,26,40 | alterar | Não |
Protótipo - Meus Dados - Endereço
Endereço / Endereço Exterior | ||||||||
ID | Campo HCM | Campo eSocial | Campo Flex | Campo Novo? | Programa | Tabela | Tipo Permissão | Zoom? |
---|---|---|---|---|---|---|---|---|
26 | Cidade Exterior | nmCid | Cidade Exterior | Sim | FP1440A | compl_pessoa_fisic.nom_cidad_exterior | alterar | Não |
27 | Código Endereçamento Postal | codPostal | Código Endereçamento Postal | Sim | FP1440A | ompl_pessoa_fisic.cod_livre_1,072,010 | alterar | Não |
Protótipo - Meus Dados - Endereço - Endereço Exterior
Identificação Funcional / Trabalhador Estrangeiro | |||||||||
ID | Agrupador Flex | Campo HCM | Campo eSocial | Campo Flex | Campo Novo? | Programa | Tabela | Tipo Permissão | Zoom? |
---|---|---|---|---|---|---|---|---|---|
28 | Identificação Funcional / Trabalhador Estrangeiro | Chegada | dtChegada | Data Chegada | Sim | FP1440A | compl_pessoa_fisic.cod_livre_1,92,8 | alterar | Não |
29 | Identificação Funcional / Trabalhador Estrangeiro | Condição | classTrabEstrang | Condição | Sim | FP1440A | compl_pessoa_fisic.idi_cond_trabdor_estrang | alterar | Sim |
30 | Identificação Funcional / Trabalhador Estrangeiro | Casado com brasileiro | casadoBr | Casado com brasileiro | Sim | FP1440A | compl_pessoa_fisic.cod_livre_1,100,1 | alterar | Não |
31 | Identificação Funcional / Trabalhador Estrangeiro | Filhos brasileiros | filhosBr | Filhos brasileiros | Sim | FP1440A | compl_pessoa_fisic.cod_livre_2,1,1 | alterar | Não |
Protótipo - Meus Dados - Identificação Funcional - Trabalhador Estrangeiro
Documentos / Identificação | ||||||||
---|---|---|---|---|---|---|---|---|
ID | Campo HCM | Campo eSocial | Campo Flex | Campo Novo? | Programa | Tabela | Tipo Permissão | Zoom? |
32 | CPF | cpfTrab | CPF | Não | FP1440, FP1500 | funcionario.cod_id_feder | consultar | Não |
33 | Carteira Identidade | nrRg | Carteira Identidade | Não | FP1440 | rh_pessoa_fisic.cod_id_estad_fisic | alterar | Não |
34 | Orgão Emissor | orgaoEmissor | Órgão Emissor | Não | FP1440 | campo compl_pessoa_fisic.num_livre_1 + rh_pessoa_fisic.cod_orgao_emis_id_estad | alterar | Sim |
35 | Emissão Identidade | dtExped | Emissão Identidade | Não | FP1440 | rh_pessoa_fisic.dat_emis_id_estad_fisic | alterar | Não |
Documentos / Identificação / Registro de Identidade Civil | ||||||||
---|---|---|---|---|---|---|---|---|
ID | Campo HCM | Campo eSocial | Campo Flex | Campo Novo? | Programa | Tabela | Tipo Permissão | Zoom? |
36 | RIC | nrRic | Número | Sim | FP1440 | compl_pessoa_fisic.cod_ric | alterar | Não |
37 | Órgão Emissor RIC | orgaoEmissor | Órgão Emissor | Sim | FP1440 | compl_pessoa_fisic.cod_orgao_emis_ric | alterar | Não |
38 | Exped RIC | dtExped | Data Emissão | Sim | FP1440 | compl_pessoa_fisic.dat_expedic_ric | alterar | Não |
Protótipo Meus Dados - Documentos - Identificação
Documentos / Carteira de trabalho | ||||||||
Documentos / Carteira de trabalho | ||||||||
ID | Campo HCM | Campo eSocial | Campo Flex | Campo Novo? | Programa | Tabela | Tipo Permissão | Zoom? |
---|---|---|---|---|---|---|---|---|
39 | Número CTPS | nrCtps | CTPS | Não | FP1500 | funcionario.cod_cart_trab | alterar | Não |
40 | Série | serieCtps | Série | Não | FP1500 | funcionario.cod_ser_cart_trab,4,5 | alterar | Não |
41 | UF | ufCtps | UF | Não | FP1500 | funcionario.cod_unid_federac_cart_trab | alterar | Sim |
Protótipo Meus Dados - Documentos - Carteira de Trabalho
Documentos / Outros | ||||||||
---|---|---|---|---|---|---|---|---|
ID | Campo HCM | Campo eSocial | Campo Flex | Campo Novo? | Programa | Tabela | Tipo Permissão | Zoom? |
42 | PIS | nisTrab | PIS | Não | FP1500 | funcionario.cod_pis | consultar | Não |
43 | Matrícula INSS | nisTrab | Matrícula INSS | Não | Fp1500 | funcionario.cod_func_inss | consultar | Não |
44 | NIS | nisTrab | NIS | Sim | FP1440A | compl_pessoa_fisic.cod_nume_ident_social | consultar | Não |
Documentos / Outros / Estrangeiro | ||||||||
---|---|---|---|---|---|---|---|---|
ID | Campo HCM | Campo eSocial | Campo Flex | Campo Novo? | Programa | Tabela | Tipo Permissão | Zoom? |
45 | Ident Estrang | nrRne | Numero da Identidade | Sim | FP1440 | rh_pessoa_fisic.cod_identde_estrang | alterar | Não |
46 | Emissor RNE | orgaoEmissor | Órgão Emissor RNE | Sim | FP1440A | compl_pessoa_fisic.cod_livre_1,036,020 | alterar | Não |
47 | Emissão RNE | dtExped | Data Emissão RNE | Sim | FP1440A | compl_pessoa_fisic.cod_livre_1,028,008 | alterar | Não |
Documentos / Outros / Órgão de Classe | ||||||||
---|---|---|---|---|---|---|---|---|
ID | Campo HCM | Campo eSocial | Campo Flex | Campo Novo? | Programa | Tabela | Tipo Permissão | Zoom? |
48 | Registro Profissional | nrOc | Número do Registro | Sim | FP3800 | habilid_profis_func.cod_reg_profis_func | alterar | Não |
49 | Ent Classe + UF | orgaoEmissor | Órgão Emissor | Sim | FP1040, FP3800 | habilid_profis.cod_entid_clas_profis + ' ' + string(habilid_profis_func.cod_unid_federac_rh) | alterar | Sim |
50 | Expedição | dtExped | Data Emissão | Sim | FP3800F | habilid_profis_func.dat_livre_1 | alterar | Não |
51 | Validade | dtValid | Data Validade | Sim | FP3800F | habilid_profis_func.dat_livre_2 | alterar | Não |
Documentos / Outros / CNH | ||||||||
ID | Campo HCM | Campo eSocial | Campo Flex | Campo Novo? | Programa | Tabela | Tipo Permissão | Zoom? |
---|---|---|---|---|---|---|---|---|
52 | Cart Habilitação | nrCnh | Registro CNH | Sim | FP1500 | funcionario.num_cart_habilit | alterar | Não |
53 | Expedição | dtExped | Data Emissão CNH | Sim | FP1500F | funcionario.cod_livre_4,115,008 | alterar | Não |
54 | UF | ufCnh | UF CNH | Sim | FP1500 | funcionario.cod_livre_1,10,4 | alterar | Sim |
55 | Vencimento Habilitação | dtValidade | Data Validade CNH | Sim | FP1500 | funcionario.dat_vencto_habilit | alterar | Não |
56 | Data Primeira CNH | dtPriHab | Data Primeira CNH | Sim | FP1500F | sped_participan.dat_primei_cnh | alterar | Não |
57 | Categoria Habilitação | categoriaHab | Categoria CNH | Sim | FP1500 | funcionário.cod_categ_habilit | alterar | Não |
Protótipo - Meus Dados - Documentos - Outros Documentos
FP0170 - Manutenção Grupo de Informações
- Criar um novo grupo de informações chamado: "P01 - Portal Meus Dados". (segur_grp_atrib_dados, grp_atrib_dados).
- Esse grupo terá lógica semelhante ao do grupo FIS.
- Criar três tipos de permissões para a pastaas pastas: sem permissão, consultar e alterar.
As pastas onde na tabela de localização dos campos eSocial o valor do campo "Tipo Permissão" for "consultar", deverá trazer a opção alterar congelada. - Criar arquivo .d de inicialização da tabela segur_grpCriar arquivo .d de inicialização da tabela segur_grp_atrib_dado, onde terá dois grupos default: QSQ e COO. Esses grupos terão o tipo permissão default CONSULTAR a todas as pastas.
- Criar três tipos de permissões para a pastaas pastas: sem permissão, consultar e alterar.
- Criar a include (varinc/varXXXXX.i) para conter a pasta com o nome eSocialconter pastas com os nomes dos campos do eSocial no Portal HCM (Flex).
- Essa include será semelhante a var10108.i.
- A regra para criar os nomes das pastas será: agrupador flex + " / " + "Campo Flex" (consultar tabela de localização dos campos do eSocial).
- Essa include será semelhante a var10108.i.
- Alterar oprograma object/Alterar oprograma object/sopy/brw/b02py262.w para tratar o novo grupo P01.
- Esse grupo terá lógica semelhante ao do grupo FIS.
Protótipo Grupo de Informações - P01 Portal Meus Dados
Meus Dados - Api Progress
Programa | DependênciaProcedure | Tipo | Objetivo | Parâmetros | Regra | Retorno | FPAPIXXX||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
FPAPI054 | /pi_segurancapi_ | habilita_eSocialsegurança | NovoAlteração | Retornar se a aba eSocial será mostrada para o funcionário. |
| Alterar a api para retornar a segurança do grupo de informações P01 |
| tt-erro | FPAPI054 | pi_seguranca | Alteração | Alterar a api para retornar a segurança do grupo de informações P01 |
| tt-erro tt_segur_grp_atrib_dado . Lógica idêntica a do grupo FIS.Importante: Caso um funcionário esteja em dois ou mais grupos de segurança, deve-se considerar a permissão do grupo menos restritivo. Exemplo: Funcionário Pedro possui os grupos QSQ e FUN. O grupo QSQ tem permissão para consultar. Já o grupo FUN tem permissão para alterar. Neste caso a permissão que vale é a de alterar. A sequência de restrição é: Sem permissão -> Consultar -> Alterar. | tt-erro tt_segur_grp_atrib_dado | |||
FPAPIXXX | pi_retorna_zoom_xxxxx | Novo | Criar varias procedures que retornem o valor dos zoom dos campos |
| tt-xxxx tt-erro | |||||||||||||
FPAPIXXX | pi_salva_campos_eSocial | Novo | Possibilitar alteração de todos os campos eSocial |
| A procedure irá verificar quais campos recebidos como parâmetro não estão em branco, então, deve atualiza-los no HCM.
Caso seja encontrado alguma inconsistência nos dados, cria-se tt-erro com a mensagem 4. | tt-erro | ||||||||||||
FPAPIXXX | FPAPIXXX/pi_retorna_zoom_xxxxx FPAPIXXX/pi_retorna_campos_eSocial | pi_gera_planilha_excel_eSocial | Novo | Fazer a criação de uma planilha excel contendo todos os campos do eSocial presentes na tabela de localização, então, salvar a planilha em um diretório recebido como parâmetro |
|
| tt-erro v-file-name | |||||||||||
FPAPIXXX | pi_retorna_campos_eSocial | Novo | Retornar todos os valores atuais de todos os campos do eSocial presentes na tabela de localização |
|
| tt-fields-eSocial ->.field-name ->.field-value | ||||||||||||
FPAPIXXX | FPAPIXXX/pi_salva_campos_eSocial | pi_le_planilha_excel_eSocial | Novo | Retornar todos os valores atuais de todos os campos do eSocial presentes na planilha enviada pelo funcionário através do upload |
|
| tt-erro
|
Meus Dados - EmployeeDataView - Flex
- Criar mais uma aba na tela flex Meus Dados chamada "eSocial".
- Chamar a pi_habilita_eSocial, então, se tt-erro tiver dados, a aba não deve aparecer para o funcionário. No log do jboss deve ser impresso um warning com o conteúdo da tt-erro.
- Dentro da aba eSocial criar dois botões: "download" e "Upload". Esses botões deverão ter uma descrição detalhada referente a seu funcionamento. Sugestão: colocar os botões centralizados na pagina e em cima a descrição.
Meus Dados - EmployeeDataView - Java/Flex - Botão Download
FPAPIXXX | pi_retorna_zoom_xxxxx | Novo | Criar varias procedures que retornem o valor dos zoom dos campos |
| tt-xxxx tt-erro | |
FPAPI023 | pi_altera_meusdados | Novo | Possibilitar alteração de todos os campos eSocial |
| A procedure irá verificar quais campos recebidos como parâmetro não estão em branco, então, deve atualiza-los no HCM. (Verificar a lógica de atualização nas telas progress, para garantir a integridade dos dados). | tt-erro |
Meus Dados - EmployeeDataView - Flex
- Adicionar na tela todos os campos listados na tabela de localização do eSocial.
- Quando o usuário clicar em alterar, deverá chamar a pi_segurança, então irá habilitar apenas os campos que o funcionário tem acesso de alteração, conforme FP0170, grupo P01.
- Para atualizar no HCM os campos alterados no Portal, chamar a pi_altera_meusdados.
- Para os campos combobox, a lista de opções será carregada apenas quando o usuário clicar nos mesmos, neste caso, deve-se chamar a pi_retorna_zoom_xxxx, onde xxxx é o nome do campo.
- Quando o usuário clicar em alterar, deverá chamar a pi_segurança, então irá habilitar apenas os campos que o funcionário tem acesso de alteração, conforme FP0170, grupo P01.
Mensagem
Código | mensagem |
---|---|
1 | "A tabela de <nome_tabela> está vazia. Efetue o cadastro no <código do programa>". |
2 | "<Func: matricula-estabelecimento-empresa> Empregador com eSocial não habilitado |
Meus Dados - EmployeeDataView - Java/Flex - Botão Upload
- Verificar se o funcionário logado possui permissão (FP0170, grupo P01, pasta eSocial) de alteração.
- Se não, gera a mensagem 7.
- Se sim, salva planilha enviada na pasta compartilhada. Antes de salvar alterar o nome da planilha para o padrão <emp_estab_mat_dataatual-horaatual-minutosegundo_M>, exemplo: 1_10_34-20102015-1700-54_M.xls.
- Chamar a api pi_le_planilha_excel_eSocial.
- Caso retorne registros na tt-erro, deve-se exibir o erro 5 concatenado com o erro retornado na tt-erro.
- Se a tt-erro estiver vazia, mostrar a mensagem 6.
- Chamar a api pi_le_planilha_excel_eSocial.
Mensagem
Código | mensagem |
---|---|
1 | "A tabela de <nome_tabela> está vazia. Efetue o cadastro no <código do programa>". |
2 | "<Func: matricula-estabelecimento-empresa> Empregador com eSocial não habilitado. |
3 | "<Func: matricula-estabelecimento-empresa> Funcionário sem permissão no FP0170 (grupo informação P01), para consultar eSocial. |
4 | "<Func: matricula-estabelecimento-empresa> O campo <nome_do_campo> com valor <valor_campo> é inválido. |
5 | Ocorreu um erro ao salvar os dados da planilha <diretório+nome.xls>: <tt-erro> |
6 | Dados eSocial atualizados com sucesso! |
7 | Ocorreu um erro ao salvar os dados da planilha: Funcionário sem permissão para atualizar o eSocial. |
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|
...