Integracao Externa AcessoNet

Integração Acesso.
Net
Acesso.Net X sistemas externos
quarta-feira, 18 de julho de 2013 - Página 1 de 12
Introdução
Para integração com sistemas externos, o Acesso.Net possui diversos meios para troca
de informações:
Integração de Cadastro de Pessoas:

 Via importação de arquivo texto com layout configurável (Menu Manutenção,
Importação de Pessoas);
 Direto no banco de dados do sistema, via tabela integracao_externa;
 Através de integração personalizada (alteração específica para o cliente).
Integração de Cadastro de Bloqueios Extras:

 Direto no banco de dados do sistema, via tabela
integracao_bloqueios_extras;
 A view vw_equipamentos foi criada para auxiliar a utilização da integração
de bloqueios extras.
Integração de Cadastro de Horários:

 Direto no banco de dados do sistema, via tabela integracao_horarios;
Integração de Cadastro de Mensagens Específicas:

 Direto no banco de dados do sistema, via tabela integracao_mensagens;
 A view vw_equipamentos foi criada para auxiliar a utilização da integração
de mensagens especificas;
Integração de registros de acesso:

 Via importação de arquivo texto com layout configurável (Menu Relatórios,
Acesso Pessoa, botão Exportar);
 Direto no banco de dados do sistema, via view vw_acessos;
Neste documento, listamos informações referentes à integração direta com o banco de

dados do sistema, através das tabelas integracao_externa,
integração_bloqueios_extras ,integracao_horarios, integracao_mensagens e a view
vw_acessos.
Atenção: Existem outras tabelas no banco de dados do sistema que são utilizadas para
seu funcionamento. Não recomendamos a manipulação de nenhum dos objetos do banco de
Integração Acesso.Net
dados (exceto integracao_externa, integracao_horarios, integração_bloqueios_extras,

integracao_mensagens e vw_acessos), pois diversas regras de negócios devem ser
observadas e somente estes cinco objetos foram especialmente desenvolvidos para integração
sendo assim, protegidos pelas regras do sistema.
Integração com Cadastro de Pessoas

A tabela integracao_externa é indicada para clientes que necessitam transferir dados
de pessoas de algum sistema externo para o Acesso.Net. Nesta tabela, deve-se inserir os
dados das pessoas para integração e a cada 10 segundos o serviço Gerenciador de Tarefas do
Acesso.Net irá fazer a leitura dos dados ainda não importados. A tabela tem a seguinte
estrutura:
CAMPO DESCRIÇÃO
N_FOLHA texto(20) chave prim. Nº da folha da pessoa (usado como chave na integração).
N_IDENTIFICADOR texto(20) Nº identificador da pessoa.
RG texto(14) RG da pessoa.
CPF texto(20) CPF da pessoa.
NOME texto(100) Nome da pessoa.
EMPRESA_CNPJ texto(20) CNPJ da empresa, no formato 99.999.999/9999-99.
HORARIO_NOME texto(50) Nome do horário da pessoa.
NIVEL_NOME texto(50) Nome do nível de acesso da pessoa.
ESTADO byte 0 = Ativo, 1 = Bloqueado, 2 = Livre.
CLASSIFICACAO texto(50) Nome da classificação da pessoa.
VALIDADE_DATA_INI data Data inicial da validade da pessoa.
VALIDADE_HORA_INI texto(5) Hora inicial da validade da pessoa.
VALIDADE_DATA_FIM data Data final da validade da pessoa.
VALIDADE_HORA_FIM texto(5) Hora final da validade da pessoa.
OBS texto(100) Observação para a pessoa.
ESTRUTURA_CODIGO texto(20) Código da estrutura da pessoa.
EMAIL texto(100) E-mail da pessoa.
RG_EXPED data Data de expedição do RG da pessoa.
RG_SSP texto(2) SSP do RG da pessoa.
N_PROVISORIO texto(20) Nº Provisório da pessoa.
PROVISORIO_INICIO data Data inicial da validade do Nº Provisório.
PROVISORIO_FIM data Data final da validade do Nº Provisório.
FILTRO1 texto(50) Nome do campo cadastrado como filtro1 da pessoa.
FOTO texto(255) Caminho onde está localizado o arquivo da foto da pessoa.
EXCLUIR_PESSOA sim/não Informa se é para excluir a pessoa.
N_PIS texto(20) Nº PIS/PASEP da pessoa.
REFEICAO_CONTROLE número Tipo do controle de refeição: 0 = Tabela padrão, 1 = Valor
único, 2 = Personalizada, 3 = Tabela especial.
REFEICAO_VALOR_UNICO Valor da refeição para a pessoa, quando utilizado controle

número por Valor único.
REFEICAO_TABELA texto(50) Nome da tabela de refeição, quando utilizado controle por

Tabela especial.
REFEICAO_CONTA_CORRENTE 0 = Não controla refeição por conta corrente, 1 = controla
(sim/não) refeição por conta corrente.
LEITURA_STATUS sim/não 0 = não importado para o sistema, 1 = já importado.
LEITURA_DATA data/hora Data em que a pessoa foi importada.
LEITURA_RESPOSTA texto(100) Resposta da importação (somente se houve erro).
Observações:
 Os campos em azul são preenchidos automaticamente pelo sistema durante a
importação dos dados.
 O campo n_folha é chave primária, ou seja, não pode haver duplicidades nem
preenchimento nulo neste campo. O campo é utilizado para localização de
pessoas existentes no sistema. Caso o sistema não localize o n_folha da pessoa,
será efetuada uma segunda procura pelo campo RG. Caso o sistema não localize
nenhum dos campos, será efetuado um novo cadastro para essa pessoa.
 Os campos abaixo são autocadastro, ou seja, caso não exista o registro no
sistema, estes serão cadastrados automaticamente:
 empresa_cnpj
 horario_nome
 nivel_nome
 classificacao
 filtro1
 filtro2
 filtro3
 filtro4
OBS: O campo EMPRESA_CNPJ é de autocadastro apenas caso a empresa principal já

esteja cadastrada no sistema.
 Os campos abaixo são obrigatórios, pelo menos a primeira vez que você for
incluir a pessoa:
 n_folha (chave primária)
 nome
 empresa_cnpj
OBS: O campo N_PIS não é obrigatório, mas caso seja incluído algum dado neste campo
ele é validado na importação.
Para que o Acesso.Net processe a linha, o campo leitura_status deve estar como false
(ou zero), isto indicará que o registro ainda não foi importado. Ao ler a linha, o sistema irá
marcar o campo como true (ou um), marcado assim o registro para não ser lido novamente.
Caso você precise alterar dados de uma pessoa, altere o campo para false (ou zero)
novamente.
Ao ler a linha, além de marcar como lida, o sistema informa a data e hora da leitura no
campo leitura_data. Caso não seja possível cadastrar ou excluir a pessoa, a descrição do erro
é informada no campo leitura_resposta.
Integração de Bloqueios Extras

A tabela integracao_bloqueios_extras é indicada para clientes que necessitam transferir
dados de bloqueios extras de algum sistema externo para o Acesso.Net. Nesta tabela, deve-se
inserir os dados dos bloqueios extras para integração e a cada 10 segundos o serviço
Gerenciador de Tarefas do Acesso.Net irá fazer a leitura dos dados ainda não importados.
A tabela tem a seguinte estrutura:
CAMPO DESCRIÇÃO
ID número chave prim. Código de Identificação do bloqueio extra.
PESSOA_N_FOLHA texto(20) chave prim. Número da Folha da pessoa que irá receber o
bloqueio extra.
TIPO byte 0 = Período 1 = Vencimento.

DATA INICIO data Data início do bloqueio extra.
DATA FIM data Data final do bloqueio extra.
HORA INICIO data Hora início do bloqueio extra.
HORA FIM data Hora final do bloqueio extra.
MSG Display texto(100) Mensagem que o equipamento exibirá.
EQUIPAMENTOS texto(255) Equipamentos que farão parte do bloqueio. Para
todos os equipamentos, não preencha o campo.
EXCLUIR_BLOQ sim/não Informa que deve excluir o bloqueio
SENTIDO byte 0 = Ambos; 1 = Somente Entrada;
2 = Somente Saída.
LEITURA_STATUS sim/não 0 = não importado para o sistema, 1 = já
importado.
LEITURA_DATA data/hora Data em que o bloqueio foi importado.
Observações:
 Os campos abaixo são obrigatórios:
 pessoa_n_folha
 tipo
 data_inicio
 hora_inicio
 motivo
 msg_display
Caso o bloqueio extra seja inserido com o valor 0 (período), os campos data_fim e
hora_fim também são obrigatórios.
Os campos hora_inicio e hora_fim devem ser preenchidos no formato hh:mm.
O campo equipamentos deve ser preenchido com os ids dos equipamentos desejados no
formato: 1;2;3 (para os equipamentos de id 1, 2 e 3). Para selecionar todos os equipamentos,
deixe o campo como NULL.
A view vw_equipamentos foi criada para facilitar o acesso à informações sobre os
equipamentos desejados. Utilize-a para descobrir os ids dos equipamentos.
novamente.
campo leitura_data. Caso não seja possível cadastrar ou excluir o horário, a descrição do
erro é informada no campo leitura_resposta.
Integração de Horários
A tabela integracao_horarios é indicada para clientes que necessitam transferir dados
de horários de algum sistema externo para o Acesso.Net. Nesta tabela, deve-se inserir os
dados dos horários para integração e a cada 10 segundos o serviço Gerenciador de Tarefas do
Acesso.Net irá fazer a leitura dos dados ainda não importados.
CAMPO DESCRIÇÃO
NOME texto(50) chave prim. Nome do horário (usado como chave).
INICIO texto(5) chave prim. Hora inicial da faixa de horário (usado como chave).
FIM texto(5) Hora final da faixa de horário.
SEG sim/não Horário usado para Segunda-feira.
TER sim/não Horário usado para Terça-feira.
QUA sim/não Horário usado para Quarta-feira.
QUI sim/não Horário usado para Quinta-feira.
SEX sim/não Horário usado para Sexta-feira.
SAB sim/não Horário usado para Sábado.
DOM sim/não Horário usado para Domingo.
FER sim/não Horário usado para Feriados.
ACESSOS número Quantidade máxima de acessos (diário, semanal ou mensal).
TIPO_ACESSO byte 0 = Diário, 1 = Semanal, 2 = Mensal.
LIBERAR_SENTIDO byte 0 = Ambos, 1 = Entrada, 2 = Saída.
EXCLUIR_HORARIO sim/não Informa se é para excluir o horário.
LEITURA_STATUS sim/não 0 = não importado para o sistema, 1 = já importado.
LEITURA_DATA data/hora Data em que o horário foi importado.
Observações:
 Nesta tabela é usada uma chave composta pelos campos nome e inicio, já que
no nosso sistema, você pode ter varias faixas de horário para um único horário.
 nome (chave primária)
 inicio (chave primária)

 fim
novamente.
Nesta tabela, você pode informar várias faixas para um mesmo horário. Ou seja, para
cadastrar um horário das 08:00 às 12:00 e das 13:30 às 18:00, você deve inserir duas linhas
nesta tabela, ambas com o campo nome igual, porém, uma com o campo inicio = 08:00 e
fim = 12:00, e a outra com o campo inicio = 13:30 e fim = 18:00.
Para cada faixa, você deve informar os dias da semana que ela será liberada através
dos campos seg, ter, qua, qui, sex, sab, dom e fer.
campo leitura_data. Caso não seja possível cadastrar ou excluir o horário, a descrição do
Integração de Mensagens Específicas

A tabela integracao_mensagens é indicada para clientes que necessitam transferir dados de
mensagens específicas de algum sistema externo para o Acesso.Net. Nesta tabela, deve-se
inserir os dados das mensagens específicas para integração e a cada 10 segundos o serviço
Gerenciador de Tarefas do Acesso.Net irá fazer a leitura dos dados ainda não importados.
CAMPO DESCRIÇÃO
ID número chave prim. Código de Identificação da mensagem específica.
PESSOA_N_FOLHA texto(22) chave prim. Número da Folha da pessoa que utilizará a
mensagem específica.
DATA data Data da mensagem específica. Para todos os dias,

não preencha o campo.
MENSAGEM_LINHA1 texto(255) Primeira linha da mensagem específica.
MENSAGEM_LINHA2 texto(255) Segunda linha da mensagem específica.
MENSAGEM_POPUP texto(1024) Mensagem pop up exibida ao usuário do sistema.
EQUIPAMENTOS texto(1024) Equipamentos que utillizarão a mensagem. Para
todos os equipamentos, não preencha o campo.
EXCLUIR_MENSAGEM sim/não Informa se deve excluir a mensagem específica.
LEITURA_STATUS sim/não 0 = não importado para o sistema, 1 = já
importado.
LEITURA_DATA data/hora Data em que a mensagem foi importada.
Observações:
 pessoa_n_folha
 mensagem_linha1 ou mensagem_linha2 (ao menos um deve ser
preenchido).
O campo equipamentos deve ser preenchido com os ids dos equipamentos desejados no
formato: 1;2;3 (para os equipamentos de id 1, 2 e 3). Para selecionar todos os equipamentos,
deixe o campo como NULL.
A view vw_equipamentos foi criada para facilitar o acesso às informações sobre os

equipamentos desejados. Utilize-a para descobrir os ids dos equipamentos.
marcar o campo como true (ou um), marcando assim o registro para não ser lido novamente.
Caso você precise alterar dados de uma mensagem, altere o campo para false (ou zero)
novamente.
campo leitura_data. Caso não seja possível cadastrar ou excluir a mensagem, a descrição do
Integração de Registros de Acesso

A view vw_acessos é indicada para leitura dados dos acessos registrados no sistema.
Cada linha uma tentativa de acesso em um dos equipamentos cadastrados.
Nome do campo na view Descrição

ID Número Identificador do registro de acesso
DATA Data do acesso
HORA Hora do acesso
HORA_SEGUNDOS Hora do acesso em segundos
NEGADO Indica se o acesso foi negado (True/False ou 1/0)
CONFIRMADO Indica se o acesso foi confirmado (True/False ou 1/0)
TIPO_ACESSO Tipo do registro de acesso (R, E ou S)
DESCRICAO Descrição do acesso (caso negado, indica motivo da restrição)
PESSOA_N_IDENTIFICADOR N. Identificador da pessoa que fez o acesso
PESSOA_NOME Nome da pessoa que fez o acesso
PESSOA_N_FOLHA N. Folha da pessoa que fez o acesso
EQUIPAMENTO_CODIGO Código do equipamento que a pessoa que fez o acesso
EQUIPAMENTO_DESCRICAO Descrição do equipamento que a pessoa que fez o acesso
Observações:
 O campo TIPO_ACESSO traz os valores R, E ou S que significam REGISTRO, ENTRADA
ou SAÍDA respectivamente.
 Em caso de equipamentos tipo catraca, o campo CONFIRMADO é utilizado para indicar
se a pessoa girou o braço ao fazer o acesso.
 O campo HORA_SEGUNDOS traz o mesmo valor do campo HORA, porém em segundos
(00:00:00 = 0 ... 23:59:59 = 86399). Sugerimos utilização deste campo para seleção
de período de horas.
Exemplos de seleção:
Selecionar apenas registros feitos nos equipamentos 1 e 2:
select * from vw_acessos where equipamento_codigo in ('1', '2')
Selecionar apenas registros feitos das 11:00 até as 12:00:

select * from vw_acessos where
hora_segundos >= 39600 and hora_segundos <= 43200

Integracao Externa AcessoNet

Enviado por

Dados do documento

Descrição original:

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Integracao Externa AcessoNet

Enviado por

Direitos autorais:

Formatos disponíveis

Integração Acesso.

Integração de Cadastro de Pessoas:

Integração de Cadastro de Bloqueios Extras:

Integração de Cadastro de Horários:

Integração de Cadastro de Mensagens Específicas:

Integração de registros de acesso:

Neste documento, listamos informações referentes à integração direta com o banco de

dados (exceto integracao_externa, integracao_horarios, integração_bloqueios_extras,

Integração com Cadastro de Pessoas

REFEICAO_VALOR_UNICO Valor da refeição para a pessoa, quando utilizado controle

REFEICAO_TABELA texto(50) Nome da tabela de refeição, quando utilizado controle por

OBS: O campo EMPRESA_CNPJ é de autocadastro apenas caso a empresa principal já

Integração de Bloqueios Extras

A tabela tem a seguinte estrutura:

TIPO byte 0 = Período 1 = Vencimento.

A tabela tem a seguinte estrutura:

 inicio (chave primária)

Integração de Mensagens Específicas

A tabela tem a seguinte estrutura:

DATA data Data da mensagem específica. Para todos os dias,

A view vw_equipamentos foi criada para facilitar o acesso às informações sobre os

Integração de Registros de Acesso

Nome do campo na view Descrição

Selecionar apenas registros feitos das 11:00 até as 12:00:

Você também pode gostar