CD_USUACESSO - Usuário de Acesso Padrão
Tela de configuração: ADM010 — Parâmetros do Sistema Localização: Aba Acesso Padrão → campo Usuário Tabela:
PARMSISTEMA.CD_USUACESSOTipo:VARCHAR(5)Valor padrão: vazio (nenhum usuário definido)
Descrição
Define o usuário padrão utilizado pelo sistema para operações de acesso automático. O campo trabalha em conjunto com CD_EMPRACESSO (Empresa de Acesso Padrão), formando um par usuário + empresa que deve obrigatoriamente existir na tabela USUARIOEMPRESA.
Campos envolvidos
| Campo | Tabela | Tipo | Descrição |
|---|---|---|---|
CD_USUACESSO | PARMSISTEMA | VARCHAR(5) | Código do usuário de acesso padrão |
CD_EMPRACESSO | PARMSISTEMA | INTEGER | Código da empresa de acesso padrão (configurado no mesmo formulário) |
NM_USUARIO | USUARIO | — | Nome do usuário (exibido ao lado do campo, somente leitura) |
Comportamento
Preenchimento do Usuário
| O que faz | Detalhe |
|---|---|
| Validação ao digitar | Verifica se o usuário existe em USUARIO e se está vinculado à empresa informada em CD_EMPRACESSO via USUARIOEMPRESA |
| Exige empresa preenchida | Se CD_EMPRACESSO estiver vazio, ao informar o usuário o sistema exibe erro: "É Obrigatório informar a Empresa para a Validação do Usuário!" |
Busca por <F9> | O campo possui hint "Lista de Usuários <F9>" e abre lookup de usuários |
| Limpeza em cascata | Se a empresa (CD_EMPRACESSO) for apagada, o campo CD_USUACESSO também é limpo automaticamente |
Simulação passo a passo
- Acesse a tela ADM010 — Parâmetros do Sistema.
- Clique na aba Acesso Padrão.
- No campo Empresa, digite o código da empresa desejada (ex.:
1) e pressione<Tab>— o nome da empresa será exibido ao lado. - No campo Usuário, digite o código do usuário (ex.:
ADMIN) ou pressione<F9>para abrir a lista de usuários. - Selecione o usuário desejado e pressione
<Tab>— o nome do usuário será exibido ao lado. - Clique em Salvar para confirmar.
Resultado esperado: O par usuário + empresa fica armazenado como acesso padrão no sistema. O nome do usuário aparece ao lado do campo em somente leitura.
Exceção / Importante:
- Se o campo Empresa estiver vazio, não será possível preencher o campo Usuário — o sistema exigirá que a empresa seja informada primeiro.
- Se o usuário não existir no cadastro, será exibida a mensagem: "O Usuário não está Cadastrado [ADM001]!".
- Se o usuário existir mas não estiver vinculado à empresa informada, será exibida a mensagem: "Esta Empresa não está Liberada para este Usuário [ADM001]!".
- Se a empresa for apagada, o campo usuário também será limpo automaticamente.
Campo vazio (nenhum usuário definido)
| O que faz | Detalhe |
|---|---|
| Permite valor nulo | Sim — o campo pode ficar vazio |
| Sem validação | Quando vazio, nenhuma verificação é executada |
Simulação passo a passo
- Acesse a tela ADM010 — Parâmetros do Sistema, aba Acesso Padrão.
- Deixe o campo Usuário em branco.
- Clique em Salvar.
Resultado esperado: O campo CD_USUACESSO é gravado como vazio na tabela PARMSISTEMA.
Procedures impactadas
Rotinas Delphi com referência direta ao campo
| Rotina | Arquivo | Descrição |
|---|---|---|
tabPARMSISTEMACD_USUACESSOValidate | source/ADM010/UdmADM010.pas | Valida existência do usuário e vínculo com a empresa |
tabPARMSISTEMACD_EMPRACESSOValidate | source/ADM010/UdmADM010.pas | Ao apagar a empresa, limpa CD_USUACESSO em cascata |
Referências SQL diretas ao campo
Não foram encontradas referências diretas ao campo CD_USUACESSO em scripts SQL da pasta Scripts/. O campo aparece apenas em comandos genéricos de INSERT/UPDATE no data module (UdmADM010.dfm).
Candidatas por uso da tabela
As procedures abaixo utilizam a tabela PARMSISTEMA, mas não referenciam diretamente o campo CD_USUACESSO — o impacto funcional é indireto ou inexistente:
| Procedure/View | Arquivo |
|---|---|
ARRUMA_MASCARACONTA | Scripts/ARRUMA_MASCARACONTA.sql |
ATUALIZA_CONTACONTABIL | Scripts/ATUALIZA_CONTACONTABIL.sql |
CALCULA_TEMPOPERMANENCIA | Scripts/CALCULA_TEMPOPERMANENCIA.sql |
CONTABILIZA_CUPOMFISCAL | Scripts/CONTABILIZA_CUPOMFISCAL.sql |
ENDERECOPESSOA_BI0 | Scripts/ENDERECOPESSOA_BI0.sql |
GERA_CONTACLIFOR | Scripts/GERA_CONTACLIFOR.sql |
GERA_DARF | Scripts/GERA_DARF.sql |
GERA_PLANOFILIAL | Scripts/GERA_PLANOFILIAL.sql |
GERA_SPEDBLOCOL | Scripts/GERA_SPEDBLOCOL.sql |
GERA_SPEDCONTABIL | Scripts/GERA_SPEDCONTABIL.sql |
GERA_SPEDCONTABIL_0000 | Scripts/GERA_SPEDCONTABIL_0000.sql |
GERA_SPEDECF | Scripts/GERA_SPEDECF.sql |
GERA_SPEDECFBLOCOJ | Scripts/GERA_SPEDECFBLOCOJ.sql |
GERA_SPEDECFBLOCOK155 | Scripts/GERA_SPEDECFBLOCOK155.sql |
GERA_SPEDECFBLOCOK355 | Scripts/GERA_SPEDECFBLOCOK355.sql |
GERA_SPEDECFBLOCOL210 | Scripts/GERA_SPEDECFBLOCOL210.sql |
GERA_SPEDECFBLOCOY | Scripts/GERA_SPEDECFBLOCOY.sql |
GRAVA_REGISTROSPED0500 | Scripts/GRAVA_REGISTROSPED0500.sql |
IMPORTA_ARQUIVOMAGNETICO | Scripts/IMPORTA_ARQUIVOMAGNETICO.sql |
INCLUI_IMPOSTONOTACTB | Scripts/INCLUI_IMPOSTONOTACTB.sql |
Restrição de integridade
O campo CD_USUACESSO participa da constraint foreign key RPARMSISTEMA_USUARIOEMPRESA, junto com CD_EMPRACESSO, referenciando USUARIOEMPRESA(CD_USUARIO, CD_EMPRESA):
ALTER TABLE PARMSISTEMA
ADD CONSTRAINT RPARMSISTEMA_USUARIOEMPRESA
FOREIGN KEY (CD_USUACESSO, CD_EMPRACESSO)
REFERENCES USUARIOEMPRESA (CD_USUARIO, CD_EMPRESA);
Isso significa que o par usuário + empresa informado deve obrigatoriamente existir previamente na tabela USUARIOEMPRESA.