TEOREMA Licenças APP – MANUAL DE Operação e SUPORTE Ferramenta DELPHI

---
title: Teorema Licenças APP – Operação e Suporte (Ferramenta Delphi)
slug: teorema-licencas-app-operacao
sistema: 
  - "Sistemas Teorema -> 00001"
categoria: user_manual
tipo: how-to
autor: Marcelo Schemmer
setor: Qualidade
modulo: SISTEMAS TEOREMA
publico: "Equipe técnica Teorema e operadores responsáveis pela gestão de licenças de aplicativos"
keywords:
  - licenças
  - registros
  - dispositivos
  - revogar
  - Orion Horse
  - Aliant
  - Delphi
revisao: Paulo Bley
aprovado_em: Maio de 2025
chamado: ""
versao_doc: "01"
versao_pipeline: 2.5.2
ultima_revisao: "2026-06-11"
---

## Visão Geral

O Painel de Licenciamento de Aplicativos Teorema (Ferramenta Delphi) permite visualizar, consultar e revogar licenças dos dispositivos vinculados aos sistemas da empresa. A funcionalidade está disponível a partir da versão v.140.00 do sistema e atende dois cenários: servidor particular do cliente e servidor compartilhado (ambiente Aliant multiempresas).

Com o painel é possível:

- Acessar e navegar entre as categorias de dispositivos (Android, iOS, Windows, Linux);
- Consultar o consumo de licenças contratadas por sistema;
- Buscar registros por nome, ID, empresa, sistema ou usuário;
- Visualizar detalhes de cada registro (apelido, usuário, data de registro, plataforma, data de expiração);
- Confirmar as informações de um dispositivo antes de revogar o acesso;
- Revogar uma licença, liberando-a para uso em outro dispositivo.

## Modo de Utilização

Para utilizar o Painel de Licenciamento, acesse o menu lateral e clique em **Registros e Licenças**. Na tela principal são exibidos todos os dispositivos registrados por sistema operacional, o consumo de licenças por aplicativo e os dados vinculados a cada registro. Sempre que um novo dispositivo realizar o primeiro login, ele é listado automaticamente no painel, sem necessidade de atualização manual.

Para revogar uma licença, clique no botão **Revogar** ao lado do dispositivo correspondente. O sistema exibirá uma janela de confirmação com os detalhes do registro, permitindo verificar se é o aparelho correto antes de confirmar. Após a confirmação, o dispositivo perde acesso ao aplicativo e a licença fica disponível para outro uso.

## Servidor Teorema Orion Horse e Controle de Licenciamento

### Visão Geral do Controle de Licenciamento

A partir da versão v.140.00, o sistema incorporou um painel de controle de licenças nos aplicativos desenvolvidos em Delphi, facilitando o gerenciamento de permissões por base de dados. A ferramenta é utilizada tanto para testes internos da Teorema Sistemas quanto para os ambientes dos clientes, em servidores próprios ou compartilhados.

![Tela inicial do Servidor Teorema Orion Horse com menu lateral exibindo Dashboard, Configurações, Registros e Licenças, Atualizações, Banco de Dados e Logs do Sistema](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-06.png)

A tela de **Configurações** do Servidor Orion Horse reúne a seção **Configuração de Servidor** — com os campos Documento, Apelido e Path Anexos — e a seção **Tokens e Integrações**, que contém o campo **Registro de Servidor**.

> ⚠️ **Atenção:** o campo **Registro de Servidor** contém o token de autenticação do servidor. Não compartilhe esse valor nem capturas de tela que o exibam.

### Ambiente de Testes Interno (Base Dialeto)

Para testes de aplicativos, utiliza-se preferencialmente a Base DIALETO, já configurada para esse fim. A Base DIALETO possui:

- Aplicativos já registrados;
- Licenças válidas para testes;
- Configuração ajustada para desempenho em ambiente de homologação.

A escolha dessa base centraliza os aplicativos, reduz variáveis externas e agiliza o processo de validação interna.

### Modos de Controle de Licenciamento

A funcionalidade contempla dois cenários distintos:

**A. Servidor Particular (Cliente)**

- O servidor pertence ao cliente;
- Está vinculado à base de dados exclusiva da empresa;
- A configuração de licenciamento ocorre diretamente no ambiente do cliente;
- Controle individualizado por base.

**B. Servidor Compartilhado (Multiempresas)**

- Utilizado por múltiplas empresas em um mesmo ambiente de hospedagem;
- Compartilha estrutura de servidor;
- A gestão de licenças deve ser feita com atenção à base utilizada por cada cliente.

### Exemplo Prático – Ambiente com Servidor Particular

Para os exemplos deste documento, é utilizado um servidor configurado como ambiente particular do cliente, simulado internamente com ORION HORSE, representando a estrutura típica de uma base produtiva. O servidor está configurado conforme os padrões exigidos pela nova versão, a base contém os aplicativos com licenciamento ativo e todas as validações ocorrem com base nesse cenário.

### Conclusão do Bloco de Testes

Sempre que for necessário testar um aplicativo, a recomendação é utilizar a Base DIALETO, pois ela já contém as configurações ideais e evita interferências externas. O painel de licenças traz mais controle, segurança e flexibilidade tanto para os testes quanto para o ambiente do cliente.

Caso surjam dúvidas ou ajustes durante os testes, documente os pontos observados e reporte à equipe responsável pelo desenvolvimento.

## Acessar o Painel de Registros e Licenças

No menu lateral esquerdo, clique em **Registros e Licenças**.

![Tela Dispositivos registrados com menu lateral destacando o item Registros e Licenças; cards de totais para Dispositivos Android, iOS, Windows e Linux; painel Consumo de Licenças exibindo Teorema Service (App) com Qtd. Contratada 10 e Qtd. Registrada 1; seção Registros com barra de busca e filtros Todos, Android, iOS, Windows, Linux, Inativo](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-08.png)

Após acessar a seção, o painel exibe:

- Categorias de dispositivos registrados: Android, iOS, Windows e Linux;
- Gráfico de comparação entre os tipos de dispositivos utilizados;
- Consumo de licenças, com indicação da quantidade contratada e quantidade já registrada.

> **Nota:** O painel só exibirá consumo após o registro do primeiro dispositivo.

## Visualizar a Listagem de Dispositivos

![Tela Dispositivos registrados com gráfico de barras mostrando 1 Android e 0 nos demais sistemas; seção Registros listando ID 252, dispositivo Android Moto G73 5G, cliente DIALETO INFORMATICA LTDA, sistema Teorema Service (App), usuário Michel Pinheiro, status Ativo e botão Revogar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-09.png)

Abaixo do gráfico está a listagem detalhada dos dispositivos registrados para a base da empresa. Cada linha da tabela inclui:

- Nome ou apelido do dispositivo;
- Tipo de sistema (Android, iOS, etc.);
- Cliente relacionado;
- Status de uso;
- ID do dispositivo;
- Ações disponíveis (botão Revogar).

> **Dica:** No primeiro login, oriente o usuário a preencher corretamente os campos solicitados (nome, apelido e finalidade do dispositivo), como por exemplo "Celular da Produção" ou "Dispositivo Compras". Isso facilita a identificação e localização futura no painel.

### Boas Práticas no Cadastro de Registros e Licenças

- Mantenha os nomes dos dispositivos padronizados e claros;
- Oriente os usuários a cadastrar o dispositivo de forma adequada no primeiro acesso;
- Realize limpezas periódicas nos registros inativos, quando necessário;
- O painel pode ser usado também como ferramenta de auditoria de acessos por dispositivo.

## Consultar Detalhes do Dispositivo Registrado

Ao clicar em qualquer linha da listagem de dispositivos, o sistema abre automaticamente a janela **Detalhes do Registro**.

![Tela Dispositivos registrados com janela Detalhes do Registro aberta; campos: Registro Nº 252, Cliente DIALETO INFORMATICA LTDA, Sistema 00078 – Teorema Service (App), Apelido Michel MT8 teste, Usuário Michel Pinheiro, Data Registro 2025-05-13T09:52:50.000Z, Plataforma ANDROID; campo Data Expiração em destaque vazio; botão Confirmar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-10.png)

Nessa janela são exibidos:

- Número do Registro;
- Nome do Cliente;
- Sistema vinculado (ex.: Teorema Service App);
- Apelido do dispositivo;
- Nome do usuário que realizou o registro;
- Data e hora do registro;
- Plataforma (Android, iOS etc.);
- Data de Expiração — quando este campo está em branco, indica que não se trata de uma licença demo. Se fosse uma licença de demonstração, o sistema exibiria automaticamente a data limite de uso vinculada ao dispositivo.

## Acompanhar o Registro Atualizado de Dispositivos

Após registrar um novo dispositivo, o painel **Registros e Licenças** é atualizado automaticamente, sem necessidade de recarregar a página ou executar ações manuais.

![Tela Dispositivos registrados com card Dispositivos Android exibindo contador 2 destacado; painel Consumo de Licenças mostrando Teorema Service (App) com Qtd. Contratada 10 e Qtd. Registrada 2, ambos destacados](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-11.png)

No painel lateral direito, em **Consumo de Licenças**, é exibida a quantidade contratada e a quantidade registrada por sistema. Caso seja realizado um registro em outro aplicativo (ex.: Inventário), o sistema indicará o consumo separado por licença.

## Confirmar Novo Registro de Dispositivo

Na tela de Registros e Licenças é possível visualizar todos os dispositivos vinculados à base atual.

![Tela Dispositivos registrados com listagem de dois registros: ID 252 Android Moto G73 5G, cliente DIALETO INFORMATICA LTDA, sistema Teorema Service (App), usuário Michel Pinheiro, status Ativo, marcado como Item 1; ID 253 Android Samsung note 20, cliente DIALETO INFORMATICA LTDA, sistema Teorema Service (App), usuário Marcelo Schemmer, status Ativo, marcado como Item 2](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-12.png)

Ambos os dispositivos estão ativos, vinculados ao sistema Teorema Service (App) e pertencem ao mesmo cliente: Dialeto Informática LTDA. A listagem é atualizada automaticamente sempre que um novo dispositivo é registrado.

## Visualizar Detalhes Antes de Revogar uma Licença

Para evitar revogações equivocadas, consulte os detalhes completos do dispositivo antes de executar qualquer ação.

1. Clique sobre qualquer linha da listagem de dispositivos.
2. O sistema abrirá automaticamente a janela **Detalhes do Registro**.

![Tela Dispositivos registrados com janela Detalhes do Registro aberta para o ID 253; campos: Registro Nº 253, Cliente DIALETO INFORMATICA LTDA, Sistema 00078 – Teorema Service (App), Apelido Financeiro, Usuário Marcelo Schemmer, Data Registro 2025-05-13T15:36:14.000Z, Plataforma ANDROID, Data Expiração vazio; botão Confirmar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-13.png)

Essa consulta é essencial antes de clicar em **Revogar**, pois garante que o usuário visualize claramente a qual dispositivo a licença está vinculada.

## Revogar uma Licença

Quando for necessário revogar o acesso de um dispositivo registrado:

1. Clique no botão **Revogar** ao lado do dispositivo (Item 1).
2. O sistema exibirá a janela **Confirmar Exclusão** (Item 2) com a mensagem: *"Tem certeza que deseja excluir essa licença?"* e o aviso *"Esta ação não pode ser desfeita."*

![Janela Confirmar Exclusão sobreposta à tela Dispositivos registrados com mensagem de confirmação para excluir a licença do Android Samsung note 20; botões Cancelar e Excluir; Item 2 destacado no botão Excluir](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-14.png)

> ⚠️ **Atenção:** A revogação é definitiva e não pode ser desfeita.

**O que acontece ao revogar uma licença:**

- O dispositivo é imediatamente bloqueado, impedindo novos logins com aquela licença;
- A quantidade de licenças registradas é atualizada, liberando a vaga para uso em outro dispositivo;
- O gráfico e o contador de dispositivos são atualizados automaticamente no painel;
- Os dados são sincronizados com o sistema da Teorema em tempo real.

**Boas práticas:**

- Se o objetivo for restringir completamente o acesso de um ex-funcionário, além de revogar a licença no aplicativo, remova também o acesso do usuário dentro do sistema ERP. Isso garante que o colaborador não consiga mais acessar nem via aplicativo, nem via sistema web ou TP.

> **Nota:** O sistema utiliza dois modelos de licenciamento: o modelo antigo (baseado em servidor legado) e o novo modelo (atual), que já impede automaticamente o login após a revogação da licença.

### Confirmar a Exclusão

Clique em **Excluir** para concluir a revogação.

![Tela Dispositivos registrados com janela de sucesso exibindo ícone de verificação e mensagem Licença foi removida com sucesso; botão OK em destaque](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-15.png)

## Visualizar o Painel Atualizado Após Revogação

Após a revogação, o painel é atualizado automaticamente, refletindo a nova situação de consumo e dispositivos ativos.

![Tela Dispositivos registrados com card Dispositivos Android exibindo contador 1 destacado como Item 1; painel Consumo de Licenças com Teorema Service (App) exibindo Qtd. Contratada 10 e Qtd. Registrada 1, destacado como Item 2](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-16.png)

Essa visualização permite:

- Confirmar instantaneamente que a revogação foi processada com sucesso;
- Acompanhar o controle de uso de licenças em tempo real;
- Liberar espaço para registro de novos dispositivos, sem necessidade de ações adicionais.

## Gerenciar Licenças no Ambiente Aliant (Servidor Compartilhado)

Quando a base de dados do cliente está hospedada no ambiente compartilhado da Aliant, o controle de licenças é realizado por meio do painel central da Aliant, onde o servidor Orion Horse está configurado para atender múltiplas bases.

![Tela inicial do Servidor Orion Horse no ambiente Aliant com menu lateral exibindo Dashboard, Configurações, Servidores, Registros e Licenças, Atualizações, Criar Versão, Banco de Dados e Logs do Sistema](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-17.png)

Nesse cenário, o painel funciona da mesma forma que no servidor particular, mas com visibilidade total das licenças utilizadas por todos os clientes hospedados na Aliant. Ao acessar **Registros e Licenças**, são exibidos:

- A quantidade de dispositivos registrados por sistema (Android, iOS, Windows, Linux);
- O consumo individual de licenças por aplicativo (Teorema Service, Inventário, Autorizador, Uptime etc.);
- A situação detalhada de cada licença ativa, por cliente.

![Tela Dispositivos registrados no ambiente Aliant com cards mostrando 11 Dispositivos Android e 6 Dispositivos Windows; painel Consumo de Licenças listando Teorema Autorizador (App) Qtd. Contratada 100 Qtd. Registrada 1, Integrador Automação de Concreto Qtd. Contratada 10 Qtd. Registrada 1, Teorema Service (App) Qtd. Contratada 109 Qtd. Registrada 9, Teorema Uptime (App) Qtd. Contratada 99 Qtd. Registrada 3, Teorema Inventário (App) Qtd. Contratada 500 Qtd. Registrada 2; seção Registros com barra de busca e filtros](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-18.png)

> **Nota:** A equipe da Teorema, ao operar no ambiente Aliant, deve sempre utilizar esse painel unificado para garantir que o controle de dispositivos e licenças esteja em conformidade com os limites contratados de cada cliente.

Essa configuração é ideal para clientes em nuvem ou com infraestrutura terceirizada, pois centraliza o controle e facilita o gerenciamento por parte da equipe técnica.

![Tela Dispositivos registrados no ambiente Aliant com listagem de registros exibindo colunas ID, Dispositivo, Cliente, Sistema, Usuário, Status e Ação; barra de busca com campo Buscar dispositivos por Nome, ID, Número, Empresa destacada como Item 1](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-19.png)

## Filtrar e Pesquisar Dispositivos no Painel Aliant

### Filtrar por Sistema Operacional

![Tela Dispositivos registrados com campo de busca preenchido com Android e botões de filtro Todos, Android, iOS, Windows, Linux, Inativo destacados com numeração de 1 a 5 na paginação inferior; listagem exibindo dispositivos Android da empresa PRIMA CAMPOS LTDA vinculados a sistemas Teorema Service (App)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-20.png)

- Use os botões de filtro abaixo da barra de pesquisa para listar dispositivos por sistema operacional. Exemplo: ao clicar em **Android**, o painel exibe apenas os dispositivos registrados com esse sistema.
- Para navegar entre páginas quando há muitos dispositivos cadastrados, utilize as numerações de paginação (1 a 5) na área inferior da tela.

### Pesquisar por Cliente ou Identificador Específico

![Tela Dispositivos registrados com campo de busca preenchido com RIO BONITO; listagem retornando ID 115, dispositivo SM-X200, cliente RIO BONITO EMBALAGENS LTDA, sistema Teorema Uptime (App), usuário Alessandro, status Ativo](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-21.png)

Utilize a barra de busca para digitar qualquer informação: nome da empresa, nome do usuário, ID do dispositivo, modelo, sistema ou apelido. O sistema filtra automaticamente os resultados em tempo real. Exemplo: ao pesquisar "RIO BONITO", o sistema retorna os dispositivos vinculados a esse cliente.

Para visualizar todos os registros novamente, limpe o campo de busca.

## Localizar um Dispositivo e Revogar a Licença

Ao pesquisar por nome de usuário (ex.: "ALESSANDRO") e clicar sobre o resultado, o sistema abre a janela com os detalhes completos do registro.

![Tela Dispositivos registrados com campo de busca preenchido com ALESSANDRO; janela Detalhes do Registro aberta exibindo Registro Nº 115, Cliente RIO BONITO EMBALAGENS LTDA, Sistema 00081 – Teorema Uptime (App), Apelido Manutencao, Usuário Alessandro, Data Registro 16/12/2024 11:26:00, Plataforma SM-X200, Data Expiração vazio; botão Confirmar em destaque](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-22.png)

Após confirmar que se trata do dispositivo desejado, clique em **Revogar** para liberar a licença. Essa ação bloqueia o uso do aplicativo naquele aparelho e devolve uma licença para ser usada por outro dispositivo.

## Confirmar a Exclusão da Licença no Ambiente Aliant

Para concluir a exclusão de uma licença, clique em **Excluir** na janela de confirmação.

![Janela Confirmar Exclusão com mensagem Tem certeza que deseja excluir essa licença? SM-X200 e aviso Esta ação não pode ser desfeita; botão Excluir em destaque](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/teorema-licencas-app-operacao/teorema-licencas-app-operacao-23.png)

Essa ação confirma a remoção definitiva do registro, liberando automaticamente o uso de mais uma licença associada ao sistema. Após a exclusão, o dispositivo correspondente não poderá mais acessar o aplicativo vinculado até que uma nova licença seja registrada. A atualização no painel ocorre em tempo real.

## Informações do documento

> Autor: Marcelo Schemmer
> Setor: Qualidade
> Módulo: SISTEMAS TEOREMA
> Chamado:
> Versão do Sistema:
> Versão do documento: 01
> Revisão: Paulo Bley
> Aprovado em: Maio de 2025

---

> 📎 **Arquivos originais:** [TEOREMA LICENÇAS APP – MANUAL DE OPERAÇÃO E SUPORTE FERRAMENTA DELPHI.docx](https://drive.google.com/uc?export=download&id=18O1bIkkZKKotRbE4jrrppxOPol3gnLLj) · [TEOREMA LICENÇAS APP – MANUAL DE OPERAÇÃO E SUPORTE FERRAMENTA DELPHI.pdf](https://drive.google.com/uc?export=download&id=1MRvwZFD39N_BRm7Rf5WSYvuPjRFQ-JvZ)