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.9 | ||
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.
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 |
Tabelas de localização dos campos eSocial
Relação dos campos eSocial do funcionário que serão incluídos na planilha excel e o tipo possível de permissão no mesmo (consulta ou alteração).
| 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 planilha |
| Campo Novo | Indica se esse campo não existe nas demais telas flex do Portal HCM |
| 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 o funcionário poderá alterar o valor do campo na planilha |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
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 as pastasa pasta: sem permissão, consultar e alterar.
- Criar 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.
- Criar três tipos de permissões para as pastasa pasta: sem permissão, consultar e alterar.
- Criar a include (varinc/varXXXXX.i) para conter a pasta com o nome eSocial.
- Essa include será semelhante a var10108.i.
- 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ência | Procedure | Tipo | Objetivo | Parâmetros | Regra | Retorno |
|---|---|---|---|---|---|---|---|
| FPAPIXXX | FPAPI054/pi_seguranca | pi_habilita_eSocial | Novo | Retornar se a aba eSocial será mostrada para o funcionário. |
|
| 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 | ||
| 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
- Implementar no hcm.properties uma propriedade para que seja informado um diretório UNC compartilhado com jboss e appserver.
- Chamar api pi_gera_planilha_excel_eSocial passando como parametro o diretório compartilhado onde a planilha deve ser salva.
- Abrir planilha no brownser do usuário ou como download no navegador. (Ver exemplos em $/HCM/Fontes_Doc/Customizacao/Crefisa/v000/Java-Flex/Fontes/hcm-payroll-crefisa-epc/modules/justificationmonitorview-upc/src/main/flex/com/datasul/hcm/payroll/timelabor/timeattendance/justification/justificationmonitorview / $/HCM/Fontes_Doc/Customizacao/Crefisa/v000/Java-Flex/Fontes/hcm-payroll-crefisa-epc/modules/justificationmonitorview-upc/src/main/flex/com/datasul/hcm/payroll/timelabor/timeattendance/justification/justificationmonitorview /$/HCM/Fontes_Doc/Customizacao/Reutilizaveis/v2.12/MDW/JavaFlex/Fontes/mdw-301/src/main/resources).
- Abrir planilha no brownser do usuário ou como download no navegador. (Ver exemplos em $/HCM/Fontes_Doc/Customizacao/Crefisa/v000/Java-Flex/Fontes/hcm-payroll-crefisa-epc/modules/justificationmonitorview-upc/src/main/flex/com/datasul/hcm/payroll/timelabor/timeattendance/justification/justificationmonitorview / $/HCM/Fontes_Doc/Customizacao/Crefisa/v000/Java-Flex/Fontes/hcm-payroll-crefisa-epc/modules/justificationmonitorview-upc/src/main/flex/com/datasul/hcm/payroll/timelabor/timeattendance/justification/justificationmonitorview /$/HCM/Fontes_Doc/Customizacao/Reutilizaveis/v2.12/MDW/JavaFlex/Fontes/mdw-301/src/main/resources).
Meus Dados - EmployeeDataView - Java/Flex - Botão Upload
- Salvar planilha enviada na pasta compartilhada. Antes de salvar alterar o nome da planilha para o padrão <emp_estab_mat_dataatual-horaatual-minuto-segundo_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.
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! |
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
|---|
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas