Árvore de páginas

Documento de API

Produto:

Datasul

Ocorrência:

 

Documentação de API

Dados do Documento

Nome

API Fachada Controle de Acesso

Descrição

 

Nome Físico

fchcrm/fchcrm1045api.p

Include com Parâmetros

fchcrm/fchcrm1045.i

Release Inicial

12.1.8

Versão de Integração

N/A

Data Liberação

N/A

Banco

Mdtcrm

Tabela

crm_acess_portal

Aplicativo

Portal CRM

 

Evolução

Versão

12.1.8

Programa

fchcrm/fchcrm1045api.p

 

 

Objetivo

 

Realizar a manutenção de controle de acesso.

 

 

Tabelas Temporárias

 

Nos atributos das tabelas temporárias de entrada e saída:

 

ttFilter

Atributo

Tipo

Formato

Descrição

Obrigatório

c_table  

character

 

Tabela

Sim

c_property            

character

 

Propriedade

Sim

c_value         

character

 

Valor    

Sim

ttRestricaoAcesso

Atributo

Tipo

Formato

Descrição

Obrigatório

num_id  

integer

 

Cod. identificador

Sim

nom_acess

character

 

Nome acesso

Sim

idi_tip_acess

integer

 

Tipo acesso

Sim

ttRegraAcesso

Atributo

Tipo

Formato

Descrição

Obrigatório

num_id  

integer

 

Cod. identificador

Sim

num_id_acess_portal

integer

 

Numero Id acesso

Sim

idi_tip_acess

integer

 

Tipo acesso

Sim

num_id_acess_compon

integer

 

Numero Id componente

Sim

nom_compon

character

 

Nome componente

Sim

num_id_acess_form_portal

Integer

 

Numero Id formulário

Sim

nom_form

Character

 

Nome formulário

Sim

log_livre_1

Logical

 

Logico livre 1

Sim

log_visivel

Logical

 

Visível

Sim

log_editavel

Logical

 

Editável

Sim

log_op_editavel

logical

 

Formulário editável

Sim

ttUsuario

Atributo

Tipo

Formato

Descrição

Obrigatório

num_id  

integer

 

Cod. identificador

Sim

num_id_acess_portal

integer

 

Numero Id acesso

Sim

num_id_grp_usuar

integer

 

Numero Id grupo usuário

Sim

nom_grp_usuar

character

 

Nome grupo usuário

Sim

num_id_usuar

integer

 

Numero Id usuário

Sim

nom_usuar

character

 

Nome usuário

Sim

cod_usuario

character

 

Codigo usuário

Sim

log_usuar

logical

 

Usuário

Sim

ttFormulario

Atributo

Tipo

Formato

Descrição

Obrigatório

num_id  

integer

 

Cod. identificador

Sim

nom_form

character

 

Nome formulário

Sim

cod_form

character

 

Codigo formulário

Sim

log_padr

logical

 

Padrão

Sim

log_livre_1

logical

 

Logico livre 1

Sim

ttRestricaoFormulario

Atributo

Tipo

Formato

Descrição

Obrigatório

num_id  

integer

 

Cod. identificador

Sim

num_id_acess_portal

integer

 

Numero Id acesso

Sim

idi_tip_acess

integer

 

Tipo acesso

Sim

num_id_acess_compon

integer

 

Numero Id componente

Sim

nom_compon

character

 

Nome componente

Sim

num_id_acess_form_portal

Integer

 

Numero Id formulário

Sim

nom_form

Character

 

Nome formulário

Sim

log_livre_1

Logical

 

Logico livre 1

Sim

log_visivel

Logical

 

Visível

Sim

log_editavel

Logical

 

Editável

Sim

log_op_editavel

logical

 

Formulário editável

Sim

ttRestricaoUsuario

Atributo

Tipo

Formato

Descrição

Obrigatório

num_id  

integer

 

Cod. identificador

Sim

num_id_acess_portal

integer

 

Numero Id acesso

Sim

num_id_grp_usuar

integer

 

Numero Id grupo usuário

Sim

nom_grp_usuar

character

 

Nome grupo usuário

Sim

num_id_usuar

integer

 

Numero Id usuário

Sim

nom_usuar

character

 

Nome usuário

Sim

cod_usuario

character

 

Codigo usuário

Sim

log_usuar

logical

 

Usuário

Sim

ttRestricaoFormularioUsuario

Atributo

Tipo

Formato

Descrição

Obrigatório

cod_compon  

character

 

Codigo componente

Sim

log_visivel

logical

 

Visivel

Sim

idi_tip_acess

integer

 

Tipo acesso

Sim

log_editavel

logical

 

Editavel

Sim

 

Metodo Básico

 

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

findAccessRestriction

Requisito

N/A

Sintaxe

findAccessRestriction (INPUT  i_start, INPUT i_end, INPUT c_properties, INPUT c_values, INPUT c_orderBy, INPUT c_asc, INPUT l_count, INPUT i_type, OUTPUT i_count, OUTPUT DATASET DSCRMRestricaoAcesso, OUTPUT TABLE RowErrors)

Descrição

Retorna os registros (query) conforme parâmetros informados.

Parâmetros

Descrição

i_start

Valor inicial da faixa de registros

i_end

Valor final da faixa de registros

c_properties

Propriedades

c_values

Valores

c_orderBy

Campo para ordenação

c_asc

Ascendente ou Decrescente

l_count

Contador

i_type

Tipo

i_count

Quantidade de registros selecionados

DATASET DSCRMRestricaoAcesso

Dataset com os registros selecionados

TABLE RowErros

Tabela de erros

Retorno

A API/BO irá retornar os registros selecionados e a quantidade. Caso ocorra erros, retorna a tabela de erros encontrados para o programa.

persistAccessRestriction

 

Requisito

N/A

 

Sintaxe

persistAccessRestriction (INPUT i_id, INPUT TABLE ttRestricaoAcessoVO, DATASET DSCRMRestricaoAcesso, OUTPUT TABLE RowErrors)

 

Descrição

Cria ou atualiza restrição de acesso.

 

Parâmetros

Descrição

 

i_id

Codigo Identificador Sequencial

 

TABLE ttRestricaoAcessoVO

Tabela restrição de acesso

 

DATASET DSCRMRestricaoAcesso

Dataset com os registros selecionados

 

TABLE RowErrors

Tabela de erros

 

Retorno

A API/BO irá criar ou atualizar a restrição de acesso solicitada. Caso ocorra erros, retorna a tabela de erros encontrados para o programa.

 

deleteAccessRestriction

 

Requisito

N/A

 

Sintaxe

deleteAccessRestriction (INPUT i_id, OUTPUT l_ok, OUTPUT TABLE RowErrors)

 

Descrição

Exclui a restrição de acesso.

 

Parâmetros

Descrição

 

i_id

Código Identificador Sequencial

 

l_ok

Indentificador sucesso

 

TABLE RowErrors

Tabela de erros

 

Retorno

A API/BO irá excluir a restrição de acesso. Caso ocorra erros, retorna a tabela de erros encontrados para o programa.

 

 

 

Metodo Negócio

 

getAccessRestriction

 

Requisito

N/A

 

Sintaxe

getAccessRestriction (INPUT i_id, OUTPUT DATASET DSCRMRestricaoAcesso, OUTPUT TABLE RowErrors)

 

Descrição

Retorna o detalhe da restrição de acesso solicitada.

 

Parâmetros

Descrição

 

i_id

Codigo Identificador Sequencial

 

DATASET DSCRMRestricaoAcesso

Dataset com os registros selecionados

 

TABLE RowErrors

Tabela de erros

 

Retorno

A API/BO irá retornar o detalhe da restrição de acesso solicitada. Caso ocorra erros, retorna a tabela de erros encontrados para o programa.

 

getAllForms

 

Requisito

N/A

 

Sintaxe

getAllForms (INPUT l_general, OUTPUT TABLE ttFormulario, OUTPUT TABLE RowErrors)

 

Descrição

Retorna todos os formulários.

 

Parâmetros

Descrição

 

l_general

Geral

 

TABLE ttFormulario

Tabela Formulário

 

TABLE RowErrors

Tabela de erros

 

Retorno

A API/BO irá retornar todos os formulários cadastrados. Caso ocorra erros, retorna a tabela de erros encontrados para o programa.

 

persistRestrictionForm

 

Requisito

N/A

 

Sintaxe

persistRestrictionForm (INPUT i_restriction, INPUT-OUTPUT TABLE ttRestricaoFormularioVO, OUTPUT TABLE RowErrors)

 

Descrição

Cria nova restrição de acesso ao formulário.

 

Parâmetros

Descrição

 

i_restriction

Codigo Identificador Sequencial

 

TABLE ttRestricaoFormularioVO

Tabela restrição formulário

 

TABLE RowErrors

Tabela de erros

 

Retorno

A API/BO irá retornar a restrição de acesso formulário cadastrada na base. Caso ocorra erros, retorna a tabela de erros encontrados para o programa.

 

deleteRestrictionForm

 

Requisito

N/A

 

Sintaxe

deleteRestrictionForm (INPUT i_id, OUTPUT l_ok, OUTPUT TABLE RowErrors)

 

Descrição

Exclui a restrição de acesso formulário.

 

Parâmetros

Descrição

 

i_id

Código Identificador Sequencial

 

l_ok

Indentificador sucesso

 

TABLE RowErrors

Tabela de erros

 

Retorno

A API/BO irá excluir a restrição de acesso formulário. Caso ocorra erros, retorna a tabela de erros encontrados para o programa.

 

getAllFormComponents

 

Requisito

N/A

 

Sintaxe

getAllFormComponents (INPUT i_restriction, INPUT i_form, OUTPUT TABLE ttRegraAcesso, OUTPUT TABLE RowErrors)

 

Descrição

Retorna todos os componentes cadastrados para o formulário.

 

Parâmetros

Descrição

 

i_restriction

Codigo Identificador Sequencial Restrição

 

i_form

Codigo Identificador Sequencial Formulário

 

TABLE ttRegraAcesso

Tabela regras acesso

 

TABLE RowErrors

Tabela de erros

 

Retorno

A API/BO irá retornar todos os componentes cadastrados para o formulário. Caso ocorra erros, retorna a tabela de erros encontrados para o programa.

 

setFormComponentRestriction

 

Requisito

N/A

 

Sintaxe

setFormComponentRestriction (INPUT-OUTPUT TABLE ttRegraAcesso, OUTPUT TABLE RowErrors)

 

Descrição

Cria nova restrição de acesso ao componente do formulario.

 

Parâmetros

Descrição

 

TABLE ttRegraAcesso

Tabela regras acesso

 

TABLE RowErrors

Tabela de erros

 

Retorno

A API/BO irá retornar a restrição de acesso ao componente do formulário cadastrada na base. Caso ocorra erros, retorna a tabela de erros encontrados para o programa.

 

persistRestrictionUserGroup

 

Requisito

N/A

 

Sintaxe

persistRestrictionUserGroup (INPUT i_restriction, INPUT-OUTPUT TABLE ttRestricaoUsuarioVO, OUTPUT TABLE RowErrors)

 

Descrição

Cria nova restrição de acesso ao grupo de usuário.

 

Parâmetros

Descrição

 

i_restriction

Codigo Identificador Sequencial

 

TABLE ttRestricaoUsuarioVO

Tabela restrição usuário

 

TABLE RowErrors

Tabela de erros

 

Retorno

A API/BO irá retornar a restrição de acesso ao grupo de usuário cadastrada na base. Caso ocorra erros, retorna a tabela de erros encontrados para o programa.

 

deleteRestrictionUserGroup

 

Requisito

N/A

 

Sintaxe

deleteRestrictionUserGroup (INPUT i_id, OUTPUT l_ok, OUTPUT TABLE RowErrors)

 

Descrição

Exclui o grupo de usuário da restrição de acesso.

 

Parâmetros

Descrição

 

i_id

Código Identificador Sequencial

 

l_ok

Indentificador sucesso

 

TABLE RowErrors

Tabela de erros

 

Retorno

A API/BO irá excluir o grupo de usuário da restrição de acesso. Caso ocorra erros, retorna a tabela de erros encontrados para o programa.

 

getUserRestrictions

 

Requisito

N/A

 

Sintaxe

getUserRestrictions (INPUT c_form, INPUT c_user, OUTPUT TABLE ttRestricaoFormularioUsuario, OUTPUT TABLE RowErrors)

 

Descrição

Retorna todas as restrições do usuário.

 

Parâmetros

Descrição

 

c_form

Codigo Identificador Sequencial Formulário

 

c_user

Codigo Identificador Sequencial Usuário

 

TABLE ttRestricaoFormularioUsuario

Tabela restrição formulário usuário

 

TABLE RowErrors

Tabela de erros

 

Retorno

A API/BO irá retornar todas as restrições cadastradas para o usuário. Caso ocorra erros, retorna a tabela de erros encontrados para o programa.