FPAPI083 - Permissões por Área de Negócio.

Documento de API

Produto:	Datasul
Ocorrência:	Documentação de API
Nome Físico	prghur/fpp/fpapi083.p

Objetivo

Atualizar as permissões de acesso por área de negócio conforme as regras cadastradas no Cadastro de Regras por Área de Negócio. Também tem por objetivo retornas as lotações e posições que o usuário possui permissão e restrição acesso.

A Api também recebe o resultado da avaliação realizada e integra com o produto HCM.

Funcionamento

A API/BO

Na forma padrão, realiza-se a chamada através de um comando RUN normal, passando-se as informações necessárias.

A api deverá ser executada persistente. A sintaxe para executar a API/BO em modo persistente é:

run prghur/dsp/dsapi001.p persistent set h-handle .

A variável denominada h-handle irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da API.

Tabelas Temporárias

Tabela Temporária	Descrição	Entrada/Saída
tt-estrut	Contém informações das lotações e permissões de acesso.	Saída

Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
Cdn_empresa	Inteiro	Zz9	Empresa lotação/posição	Sim	2.10
Cdn_estab	Inteiro	Zz9	Estabelecimento lotação/posição	Sim	2.10
Cdn_plano_lotac	Inteiro	>>9	Código do estabelecimento	Sim	2.10
Cod_unid_lotac	Char	X(11)	Código da unidade de lotação	Sim	2.10
Cdn_plano_estrut_reporte	Inteiro	>>9	Código do plano da estrut reporte	Sim	2.10
Cdn_cargo_basic	Inteiro	>>.>>9	Código do Cargo	Sim	2.10
Cdn_niv_cargo	Inteiro	>>9	Código do Nível do cargo	Não	2.10F
Idi_tip_aces	Inteiro	9	Tipo de Acesso (1- permissão 2- restrição)	Não	2.10F
Idi_tip_reg	Inteiro	9	Tipo de Registro (1-lotação 2-estrut reporte)	Não	2.10F

Tabela Temporária	Descrição	Entrada/Saída
tt-erro	Contém código e descrição do erro	Saída

Atributo	Tipo	Formato	Descrição	Obrigatório	Evolução
Code	Inteiro	Zz9	Código do erro	Sim	2.10
Description	Caracter	X(60)	Descrição do erro	Sim	2.10

Métodos

Quando a API/BO for executada em modo persistente, os seguintes métodos estarão disponíveis para execução:

Método Básico

procedure pi_atualiza_usuar_area_negoc:

Requisito	Inexistente.
Sintaxe	run procedure pi_atualiza_usuar_area_negoc in h-handle (input p_cod_usuario, Output table tt-erro).
Descrição	O método atualizará as permissões por área de negócio do gestor para todas as regras relacionadas ao mesmo.
	Parâmetros	Descrição
	p_cod_usuario tt-erro	Código dão usuário (gestor). Erros do processo.
Retorno	Permissões atualizadas na permis_func_area_negoc, Temp-tables tt-estrut e tt-erro populadas.

procedure pi_atualiza_usuar:

Requisito	Inexistente.
Sintaxe	run procedure pi_atualiza_usuar in h-handle (input p_cdn_empresa, input p_cdn_estab, input p_cdn_funcionario, input p_cod_usuario, input p_cod_regra, Output table tt-erro).
Descrição	O método atualizará as permissões por área de negócio do gestor /regra.
	Parâmetros	Descrição
	p_cdn_empresa p_cdn_estab p_cdn_funcionario p_cod_usuario p_cod_regra tt-erro	Código da empresa do gestor. Código do estabelecimento do gestor. Matrícula do funcionário. Código do Usuário. Código da Regra. Erros do processo.
Retorno	Permissões atualizadas na permis_func_area_negoc, tt-erro populadas.

procedure pi_retorna_permis:

Requisito	Inexistente.
Sintaxe	run procedure pi_retorna_permis in h-handle (input p_cdn_empresa, input p_cdn_estab, input p_cdn_funcionario, input p_cod_usuario, input p_cod_regra, output table tt-estrut, Output table tt-erro).
Descrição	O método atualizará as permissões por área de negócio do gestor /regra.
	Parâmetros	Descrição
	p_cdn_empresa p_cdn_estab p_cdn_funcionario p_cod_usuario p_cod_regra tt-estrut tt-erro	Código da empresa do gestor. Código do estabelecimento do gestor. Matrícula do funcionário. Código do Usuário. Código da Regra. Lotações e posições de permissão e restrição de acesso. Erros do processo.
Retorno	Temp-tab tt-estrut e tt-erro populadas.

Método Negócio

Não há método de negócio disponível nesta api.

Árvore de páginas