Roteiro de Homologação — MPSWCOMP

Programa: MPSWCOMP.PRW
Versão: 1.1
Data: 14/04/2026

Pré-requisitos

Tabelas ZAA e ZAB criadas
MPSWCOMP.PRW e AFTERLOGIN.PRW compilados e aplicados ao RPO do ambiente de homologação
Application Server reiniciado após compilação
Ao menos 3 máquinas distintas disponíveis para os testes (ou 3 sessões SmartClient com hostnames diferentes)
Usuário de teste criado (diferente de 000000 / ADMINISTRADOR)
U_ZACADMIN configurado no menu do perfil de suporte
Acesso ao banco de dados para consulta das tabelas ZAA e ZAB

Convenções

Símbolo	Significado
✅	Resultado esperado — aprovado
❌	Resultado divergente — reprovado
📋	Ação do testador
🔍	Verificação no banco de dados

Cenário 1 — Usuário Administrador (bypass)

Objetivo: Confirmar que o usuário administrador não é impactado pelo controle.


Pré-condição	Nenhum registro na ZAA para o usuário `000000`
Usuário	`000000` (ou `ADMINISTRADOR`)
Máquina	Qualquer

Passos:

📋 Efetuar login no Protheus com o usuário administrador
📋 Observar se alguma mensagem de controle de acesso é exibida

Resultado esperado:

✅ Nenhuma mensagem exibida
✅ Acesso liberado normalmente sem qualquer interação
✅ Nenhum registro gravado na ZAB

Cenário 2 — Primeiro Acesso

Objetivo: Validar o fluxo de cadastro da máquina principal no primeiro login do usuário.

CT-02 — Primeiro acesso: usuário confirma máquina principal


Pré-condição	Nenhum registro na ZAA para o usuário de teste
Usuário	Usuário de teste
Máquina	Máquina A

Passos:

📋 Efetuar login com o usuário de teste na Máquina A
📋 Verificar se a mensagem de primeiro acesso é exibida com os dados corretos (hostname e SO)
📋 Clicar em Sim para registrar como máquina principal

Resultado esperado:

✅ Dialog FWAlertYesNo exibido com título "Primeiro Acesso - Registro de Maquina"
✅ Mensagem contém o hostname correto da Máquina A
✅ Após confirmação: MsgInfo de sucesso exibida
✅ Acesso ao sistema liberado normalmente

Verificação no banco:

SELECT ZAA_USER, ZAA_HOST, ZAA_SO, ZAA_TIPO, ZAA_ATIVO
FROM ZAAG01
WHERE ZAA_USER = '<usuario_teste>'

✅ 1 registro com ZAA_TIPO = 'P' e ZAA_ATIVO = 'S'

SELECT ZAB_STATUS, ZAB_MSG
FROM ZABG01
WHERE ZAB_USER = '<usuario_teste>'
ORDER BY ZAB_DATA DESC, ZAB_HORA DESC

✅ 1 registro com ZAB_STATUS = 'C' e mensagem "Maquina principal registrada no primeiro acesso"

CT-03 — Primeiro acesso: usuário recusa cadastro


Pré-condição	Nenhum registro na ZAA para o usuário de teste
Usuário	Usuário de teste (diferente do CT-02 ou ZAA limpa)
Máquina	Qualquer

Passos:

📋 Efetuar login com o usuário de teste
📋 Dialog de primeiro acesso exibido
📋 Clicar em Não

Resultado esperado:

✅ MsgStop exibido com mensagem de acesso bloqueado
✅ Sessão encerrada (__Quit) após fechar a mensagem
✅ Nenhum registro na ZAA

Verificação no banco:

✅ ZAB_STATUS = 'B' com mensagem "Primeiro acesso: usuario recusou registrar maquina - sessao bloqueada"

Cenário 3 — Reacesso pela Máquina Principal

Objetivo: Confirmar que o acesso pela máquina já registrada é liberado automaticamente.


Pré-condição	CT-02 executado com sucesso (Máquina A cadastrada como Principal)
Usuário	Usuário de teste
Máquina	Máquina A

Passos:

📋 Efetuar logout
📋 Efetuar login novamente com o mesmo usuário na Máquina A

Resultado esperado:

✅ Nenhuma mensagem de controle exibida
✅ Acesso liberado imediatamente

Verificação no banco:

✅ Novo registro na ZAB com ZAB_STATUS = 'L' e mensagem "Acesso liberado - maquina registrada e ativa"

Cenário 4 — Cadastro de Máquina Secundária

Objetivo: Validar o fluxo de registro de uma segunda máquina autorizada.


Pré-condição	CT-02 executado (Máquina A = Principal cadastrada)
Usuário	Usuário de teste
Máquina	Máquina B (diferente da A)

Passos:

📋 Efetuar login com o usuário de teste na Máquina B
📋 FWAlertWarning é exibido informando a situação
📋 Dialog "Registrar como MAQUINA SECUNDARIA?" é exibido — clicar Sim

Resultado esperado:

✅ FWAlertWarning exibido com hostname e SO corretos da Máquina B
✅ Dialog de Principal não é exibido (usuário já tem Principal cadastrada)
✅ Dialog de Secundária exibido com hostname da Máquina B
✅ Após confirmação: MsgInfo de sucesso exibida
✅ Acesso liberado

Verificação no banco:

SELECT ZAA_HOST, ZAA_TIPO, ZAA_ATIVO
FROM ZAAG01
WHERE ZAA_USER = '<usuario_teste>'

✅ 2 registros: Máquina A (ZAA_TIPO = 'P') e Máquina B (ZAA_TIPO = 'S')
✅ ZAB com ZAB_STATUS = 'C' para a Máquina B

CT-06 — Reacesso pela máquina secundária já cadastrada


Pré-condição	CT-05 executado (Máquina B = Secundária cadastrada)
Usuário	Usuário de teste
Máquina	Máquina B

Passos:

📋 Efetuar logout e login novamente na Máquina B

Resultado esperado:

✅ Nenhuma mensagem exibida
✅ Acesso liberado automaticamente
✅ ZAB com ZAB_STATUS = 'L'

Cenário 5 — Bloqueio por Limite de Máquinas Atingido

Objetivo: Confirmar que o acesso é bloqueado quando o usuário já possui Principal e Secundária cadastradas e tenta acessar de uma terceira máquina.

CT-07 — Tentativa de acesso em terceira máquina


Pré-condição	CT-02 e CT-05 executados (Máquinas A e B cadastradas)
Usuário	Usuário de teste
Máquina	Máquina C (terceira máquina, não cadastrada)

Passos:

📋 Efetuar login com o usuário de teste na Máquina C

Resultado esperado:

✅ Nenhum dialog de cadastro exibido
✅ MsgStop de bloqueio exibido imediatamente
✅ Sessão encerrada após fechar a mensagem

Verificação no banco:

✅ ZAB com ZAB_STATUS = 'B' e mensagem "Acesso bloqueado - limite de maquinas atingido (Principal e Secundaria ja cadastradas)"
✅ Nenhum novo registro na ZAA

Cenário 6 — Bloqueio por Recusa de Cadastro em Nova Máquina

Objetivo: Confirmar que recusar todas as opções de cadastro bloqueia o acesso.

CT-08 — Nova máquina: usuário recusa todas as opções


Pré-condição	Usuário com apenas Máquina A (Principal) cadastrada, sem Secundária
Usuário	Usuário de teste
Máquina	Máquina B (não cadastrada)

Passos:

📋 Efetuar login na Máquina B
📋 FWAlertWarning exibido — fechar
📋 Dialog "Registrar como MAQUINA SECUNDARIA?" — clicar Não

Resultado esperado:

✅ MsgStop de bloqueio exibido
✅ Sessão encerrada
✅ Nenhum registro criado na ZAA

Verificação no banco:

✅ ZAB com ZAB_STATUS = 'B' e mensagem "Acesso bloqueado - maquina nao registrada (possivel compartilhamento de senha)"

Cenário 7 — Integridade dos Dados de Auditoria

Objetivo: Verificar que todos os eventos estão sendo registrados corretamente na ZAB.

CT-09 — Consulta geral de auditoria após todos os cenários

Passos:

🔍 Executar a consulta abaixo após todos os cenários anteriores

SELECT
    ZAB_USER,
    ZAB_HOST,
    ZAB_SO,
    ZAB_TIPO,
    ZAB_DATA,
    ZAB_HORA,
    ZAB_STATUS,
    ZAB_MSG
FROM ZABG01
WHERE ZAB_USER = '<usuario_teste>'
ORDER BY ZAB_DATA, ZAB_HORA

Resultado esperado:

Status	Quantidade mínima	Origem
`C`	2	CT-02 (Principal) + CT-05 (Secundária)
`L`	2	CT-04 (Máquina A) + CT-06 (Máquina B)
`B`	3	CT-03 + CT-07 + CT-08

✅ Todos os registros possuem ZAB_HOST preenchido
✅ Todos os registros possuem ZAB_DATA e ZAB_HORA corretos
✅ Campo ZAB_MSG descritivo em todos os registros

Cenário 8 — Rotina Administrativa ZACADMIN

Objetivo: Validar o controle de acesso à rotina administrativa, o cadastro manual de máquinas pelo suporte e a consulta read-only do log de auditoria.

CT-10 — Acesso à ZACADMIN por usuário sem permissão


Pré-condição	Usuário de teste não pertence ao grupo `SUPORTE`
Usuário	Usuário de teste comum

Passos:

📋 Executar a função U_ZACADMIN pelo menu ou por Miscelanea > Executar Função

Resultado esperado:

✅ FWAlertWarning exibido com mensagem "Acesso restrito ao time de Suporte Protheus"
✅ Nenhuma tela de menu ou formulário é aberta
✅ Nenhum registro gravado nas tabelas ZAA ou ZAB

CT-11 — Acesso à ZACADMIN por usuário do grupo SUPORTE


Pré-condição	Usuário pertence ao grupo `SUPORTE`
Usuário	Usuário de suporte

Passos:

📋 Executar a função U_ZACADMIN

Resultado esperado:

✅ Dialog Aviso exibido com título "Administracao - Suporte Protheus", subtítulo "Rotina restrita ao time de Suporte Protheus" e os três botões: "Cadastrar Maquina para Usuario", "Consultar Log de Auditoria" e "Sair"
✅ Nenhuma mensagem de bloqueio exibida

CT-12 — Cadastro manual de máquina pelo suporte


Pré-condição	CT-11 executado (menu exibido)
Usuário	Usuário de suporte

Passos:

📋 Selecionar "Cadastrar Maquina para Usuario"
📋 Verificar se a tela padrão AxCadastro da tabela ZAA é exibida com título "Cadastro de Maquinas - Suporte Protheus"
📋 Clicar em Incluir, preencher: Usuário = <usuario_alvo>, Hostname = PC-SUPORTE-MANUAL, SO = Windows 10, Tipo = P
📋 Confirmar a inclusão

Resultado esperado:

✅ Tela AxCadastro exibida com browse da ZAA e botões padrão (Incluir, Alterar, Excluir, Pesquisar)
✅ Formulário de inclusão exibe os campos conforme definidos no dicionário SX3
✅ Após confirmação o registro aparece no browse

Verificação no banco:

SELECT ZAA_USER, ZAA_HOST, ZAA_SO, ZAA_TIPO, ZAA_ATIVO
FROM ZAAG01
WHERE ZAA_USER = '<usuario_alvo>'
  AND ZAA_HOST = 'PC-SUPORTE-MANUAL'

✅ 1 registro com ZAA_TIPO = 'P' e ZAA_ATIVO = 'S'

CT-13 — Validação de campos obrigatórios no cadastro (SX3)


Pré-condição	CT-11 executado
Usuário	Usuário de suporte

Passos:

📋 Selecionar "Cadastrar Maquina para Usuario"
📋 Clicar em Incluir e tentar confirmar com o campo ZAA_USER em branco

Resultado esperado:

✅ Validação padrão do Protheus (SX3) impede confirmação com campos obrigatórios vazios
✅ Nenhum registro gravado na ZAA

CT-14 — Consulta read-only do log de auditoria


Pré-condição	CT-11 executado; ZAB com registros dos cenários anteriores
Usuário	Usuário de suporte

Passos:

📋 Selecionar "Consultar Log de Auditoria"
📋 Verificar se os registros da ZAB são exibidos no browse
📋 Tentar inserir, alterar ou excluir um registro

Resultado esperado:

✅ Browse da ZAB aberto com os registros de auditoria visíveis
✅ Nenhum botão de inclusão, alteração ou exclusão disponível na interface
✅ Dados exibidos correspondem aos eventos registrados nos cenários anteriores

Resumo dos Casos de Teste

ID	Descrição	Resultado
CT-01	Login administrador sem validação	⬜
CT-02	Primeiro acesso — confirma máquina principal	⬜
CT-03	Primeiro acesso — recusa cadastro	⬜
CT-04	Reacesso pela máquina principal	⬜
CT-05	Nova máquina — cadastro como secundária	⬜
CT-06	Reacesso pela máquina secundária	⬜
CT-07	Terceira máquina — limite atingido, bloqueia	⬜
CT-08	Nova máquina — recusa todas as opções	⬜
CT-09	Consulta geral de auditoria na ZAB	⬜
CT-10	ZACADMIN — acesso negado a usuário sem permissão	⬜
CT-11	ZACADMIN — menu exibido para usuário do grupo SUPORTE	⬜
CT-12	ZACADMIN — cadastro manual de máquina com auditoria	⬜
CT-13	ZACADMIN — validação de campos obrigatórios	⬜
CT-14	ZACADMIN — consulta read-only do log de auditoria	⬜

Legenda: ⬜ Não executado | ✅ Aprovado | ❌ Reprovado

Registro de Execução

Campo	Valor
Testador
Data de execução
Ambiente
Versão do RPO
Resultado geral	⬜ Aprovado / ⬜ Reprovado
Observações

Pré-requisitos​

Convenções​

Cenário 1 — Usuário Administrador (bypass)​

CT-01 — Login com usuário administrador​

Cenário 2 — Primeiro Acesso​

CT-02 — Primeiro acesso: usuário confirma máquina principal​

CT-03 — Primeiro acesso: usuário recusa cadastro​

Cenário 3 — Reacesso pela Máquina Principal​

CT-04 — Login pela máquina principal já cadastrada​

Cenário 4 — Cadastro de Máquina Secundária​

CT-05 — Login em nova máquina: cadastro como Secundária​

CT-06 — Reacesso pela máquina secundária já cadastrada​

Cenário 5 — Bloqueio por Limite de Máquinas Atingido​

CT-07 — Tentativa de acesso em terceira máquina​

Cenário 6 — Bloqueio por Recusa de Cadastro em Nova Máquina​

CT-08 — Nova máquina: usuário recusa todas as opções​

Cenário 7 — Integridade dos Dados de Auditoria​

CT-09 — Consulta geral de auditoria após todos os cenários​

Cenário 8 — Rotina Administrativa ZACADMIN​

CT-10 — Acesso à ZACADMIN por usuário sem permissão​

CT-11 — Acesso à ZACADMIN por usuário do grupo SUPORTE​

CT-12 — Cadastro manual de máquina pelo suporte​

CT-13 — Validação de campos obrigatórios no cadastro (SX3)​

CT-14 — Consulta read-only do log de auditoria​

Resumo dos Casos de Teste​

Registro de Execução​

Pré-requisitos

Convenções

Cenário 1 — Usuário Administrador (bypass)

CT-01 — Login com usuário administrador

Cenário 2 — Primeiro Acesso

CT-02 — Primeiro acesso: usuário confirma máquina principal

CT-03 — Primeiro acesso: usuário recusa cadastro

Cenário 3 — Reacesso pela Máquina Principal

CT-04 — Login pela máquina principal já cadastrada

Cenário 4 — Cadastro de Máquina Secundária

CT-05 — Login em nova máquina: cadastro como Secundária

CT-06 — Reacesso pela máquina secundária já cadastrada

Cenário 5 — Bloqueio por Limite de Máquinas Atingido

CT-07 — Tentativa de acesso em terceira máquina

Cenário 6 — Bloqueio por Recusa de Cadastro em Nova Máquina

CT-08 — Nova máquina: usuário recusa todas as opções

Cenário 7 — Integridade dos Dados de Auditoria

CT-09 — Consulta geral de auditoria após todos os cenários

Cenário 8 — Rotina Administrativa ZACADMIN

CT-10 — Acesso à ZACADMIN por usuário sem permissão

CT-11 — Acesso à ZACADMIN por usuário do grupo SUPORTE

CT-12 — Cadastro manual de máquina pelo suporte

CT-13 — Validação de campos obrigatórios no cadastro (SX3)

CT-14 — Consulta read-only do log de auditoria

Resumo dos Casos de Teste

Registro de Execução