Pular para o conteúdo principal

CD_USUARIOEMAIL — Usuário Responsável por E-mails

Tela de configuração: REC001 — Parâmetros da Recapadora Localização: Aba &Opção 2 → campo "Código Usuário E-mail" Tabela: PARAMRECAP.CD_USUARIOEMAIL Tipo: VARCHAR(5) Valor padrão: (vazio — sem usuário definido)

Descrição​

Define qual usuário do sistema será utilizado como remetente/associado para o envio de e-mails automáticos da recapadora. O campo armazena o código do usuário (CD_USUARIO) e exibe o nome do usuário no campo somente-leitura ao lado.

Está diretamente relacionado ao parâmetro STEMAILSERVICE (configurado na mesma aba, acima deste campo), que habilita ou desabilita o serviço de e-mail.

Telas impactadas​

TelaDescrição
REC001Parâmetros da Recapadora — configuração do campo

Campos envolvidos​

CampoTabelaTipoRelação
CD_USUARIOEMAILPARAMRECAPVARCHAR(5)FK → USUARIO.CD_USUARIO (ON UPDATE CASCADE)
NM_USUARIOEMAIL(via JOIN)VARCHAR(60)Campo de exibição (nome do usuário, somente leitura)
CD_CONTAEMAILUSUARIO—Validado indiretamente: o usuário deve possuir conta de e-mail associada
STEMAILSERVICEPARAMRECAPCHAR(1)Parâmetro complementar na mesma aba — habilita o serviço de e-mail

Opções disponíveis​

O campo aceita qualquer código de usuário válido cadastrado na tabela USUARIO (tela ADM001). Aceita também valor vazio (desabilita a associação de e-mail).

Preenchido — Usuário Válido com Conta de E-mail​

O que fazDetalhe
Associa um usuário como responsável pelo envio de e-mailsO código digitado é validado contra a tabela USUARIO; o nome do usuário é exibido no campo NM_USUARIOEMAIL ao lado
ExigeUsuário existente em USUARIO.CD_USUARIO e campo CD_CONTAEMAIL preenchido no cadastro do usuário

Simulação passo a passo​

  1. Acesse REC001 — Parâmetros da Recapadora.
  2. Navegue até a aba &Opção 2.
  3. No campo Código Usuário E-mail (DBEdit45), digite o código de um usuário válido (ex: 00001).
  4. Saia do campo (pressione <Tab> ou clique em outro componente).
  5. Observe que o campo Nome Usuário E-mail ao lado é preenchido automaticamente com o nome do usuário.
  6. Clique em Salvar (<F5> ou botão Salvar).

Resultado esperado: O valor é gravado em PARAMRECAP.CD_USUARIOEMAIL e o sistema utiliza esse usuário para envio de e-mails automáticos da recapadora.

Exceção / Importante: Se o usuário existir mas não possuir uma Conta de E-mail associada (campo CD_CONTAEMAIL vazio no cadastro do usuário), o sistema exibirá o erro: "O Usuário não possui uma Conta de E-mail associada! Verifique [ADM001]".

Preenchido — Usuário Válido SEM Conta de E-mail​

O que fazDetalhe
Bloqueia a gravaçãoO sistema impede que um usuário sem conta de e-mail seja selecionado
ExigeUsuário com CD_CONTAEMAIL preenchido no cadastro de USUARIO

Simulação passo a passo​

  1. Acesse REC001 — Parâmetros da Recapadora.
  2. Navegue até a aba &Opção 2.
  3. No campo Código Usuário E-mail, digite o código de um usuário cadastrado que não possui conta de e-mail vinculada.
  4. Saia do campo.

Resultado esperado: O sistema exibe a mensagem de erro: "O Usuário não possui uma Conta de E-mail associada! Verifique [ADM001]". O campo permanece com o valor anterior (ou vazio).

Preenchido — Usuário Inexistente​

O que fazDetalhe
Bloqueia a gravaçãoO código informado não existe na tabela USUARIO

Simulação passo a passo​

  1. Acesse REC001 — Parâmetros da Recapadora.
  2. Navegue até a aba &Opção 2.
  3. No campo Código Usuário E-mail, digite um código que não existe na tabela de usuários (ex: 99999).
  4. Saia do campo.

Resultado esperado: O sistema exibe a mensagem de erro: "O Usuário não está Cadastrado! Verifique [ADM001]". O campo permanece com o valor anterior.

Vazio — Sem Usuário Associado​

O que fazDetalhe
Desabilita a associação de e-mailLimpa o nome do usuário exibido no campo complementar
EditávelO campo pode ser deixado em branco sem erro

Simulação passo a passo​

  1. Acesse REC001 — Parâmetros da Recapadora.
  2. Navegue até a aba &Opção 2.
  3. Se houver um código preenchido no campo Código Usuário E-mail, selecione todo o conteúdo e apague.
  4. Saia do campo.

Resultado esperado: O campo Nome Usuário E-mail ao lado é limpo automaticamente. Ao salvar, o valor NULL ou vazio é gravado em PARAMRECAP.CD_USUARIOEMAIL. E-mails automáticos da recapadora não terão um remetente/associado definido.

Busca por <F9>​

O que fazDetalhe
Abre lista de usuáriosPermite buscar e selecionar um usuário por pesquisa, sem necessidade de digitar o código manualmente
EditávelDisponível sempre que o campo estiver em modo de edição

Simulação passo a passo​

  1. Acesse REC001 — Parâmetros da Recapadora.
  2. Navegue até a aba &Opção 2.
  3. Posicione o cursor no campo Código Usuário E-mail.
  4. Pressione <F9>.
  5. Na janela de busca que abrir, pesquise e selecione o usuário desejado.
  6. Confirme a seleção.

Resultado esperado: O código do usuário selecionado é preenchido automaticamente no campo. Ao sair do campo, a validação de conta de e-mail é executada normalmente (ver cenário "Usuário Válido com Conta de E-mail" ou "Usuário Válido SEM Conta de E-mail").

Regra Geral de Validação​

  1. O campo aceita código vazio (sem usuário associado).
  2. Se preenchido, obrigatoriamente o código deve existir na tabela USUARIO.
  3. O usuário selecionado deve possuir uma conta de e-mail vinculada (USUARIO.CD_CONTAEMAIL preenchido).
  4. A validação ocorre no evento OnValidate do campo, ou seja, ao sair do componente ou ao tentar salvar.

Tabela Comparativa Resumida​

CenárioCódigo Existe?Possui E-mail?Resultado
Usuário válido com e-mail✓✓Nome preenchido, valor gravado
Usuário válido sem e-mail✓✗Erro: "não possui Conta de E-mail"
Usuário inexistente✗—Erro: "não está Cadastrado"
Campo vazio——Nome limpo, grava vazio/null
Busca <F9>✓VerificadoPreenche código + valida normalmente

Procedures impactadas​

Rotinas Delphi com referência direta ao campo​

RotinaArquivoLinhaDescrição
TdmREC001.qryCadastroCD_USUARIOEMAILValidatesource/REC001/UdmREC001.pas1499Valida o código informado contra USUARIO, verifica CD_CONTAEMAIL e preenche NM_USUARIOEMAIL
TframeREC001.edtCD_USUARIOEMAILKeyDownsource/REC001/UframeREC001.pas1490Trata <F9> para abrir busca de usuários

Referências SQL diretas ao campo​

Não foi encontrada referência direta ao campo CD_USUARIOEMAIL em procedures ou scripts SQL em Scripts/. O campo é utilizado exclusivamente no dataset qryCadastro da tela REC001, via SELECT/INSERT/UPDATE gerados pelo componente de persistência Delphi.

Candidatas por uso da tabela PARAMRECAP​

As seguintes procedures utilizam a tabela PARAMRECAP mas não citam o campo CD_USUARIOEMAIL diretamente. Impacto funcional direto sobre este campo não foi identificado:

ProcedureArquivo
ATUALIZA_PEDIDONOTAScripts/ATUALIZA_PEDIDONOTA.sql
ATUALIZA_PREVISAOORDEMPRODScripts/ATUALIZA_PREVISAOORDEMPROD.sql
ATUALIZA_STFATURAAUTOScripts/ATUALIZA_STFATURAAUTO.sql
GERA_NOTAPEDIDOScripts/GERA_NOTAPEDIDO.sql
GERA_ORDEMPRODUCAORECAPScripts/GERA_ORDEMPRODUCAORECAP.sql
FECHA_ORDEMPRODUCAORECAPScripts/FECHA_ORDEMPRODUCAORECAP.sql
(entre outras 15+ procedures)