Wiki Borgis - Contribuições do usuário [pt-br]

Sierre

2026-08-12T23:45:04Z

Vinicius Borges:

== Padrões que venho aplicando ==
* [[Usuários e Grupos de Usuários]]
* [[Permissões de Pasta (Grupo)]]
* [[Rede Radmin]]
* [[Compartilhamento de Pasta e Mapeamento de Unidade]]
* [[Instalação de Impressoras Locais]]
* [[RemoteApp e Sistema em Modo Desktop]]

== Considerações Finais ==

Este material foi elaborado com o objetivo de registrar os principais padrões e procedimentos que costumo seguir durante a configuração dos ambientes dos clientes.

Peço desculpas por não ter conseguido detalhar cada etapa de forma mais aprofundada. A intenção foi apresentar principalmente os '''padrões, caminhos e decisões de configuração''' que utilizo no dia a dia, servindo como uma referência para a equipe.

Espero que este material seja útil e que, mesmo sem entrar em todos os detalhes de cada procedimento, consiga ajudar na padronização das configurações, facilitar o suporte e tornar mais claro o motivo de algumas das escolhas adotadas.

'''Obrigado pela leitura e bom trabalho!'''

Sierre

2026-08-12T23:44:41Z

Vinicius Borges:

== Padrões que venho aplicando ==
* [[Usuários e Grupos de Usuários]]
* [[Permissões de Pasta (Grupo)]]
* [[Rede Radmin]]
* [[Compartilhamento de Pasta e Mapeamento de Unidade]]
* [[Instalação de Impressoras Locais]]
* [[RemoteApp e Sistema em Modo Desktop]]

= Considerações Finais =

Este material foi elaborado com o objetivo de registrar os principais padrões e procedimentos que costumo seguir durante a configuração dos ambientes dos clientes.

Peço desculpas por não ter conseguido detalhar cada etapa de forma mais aprofundada. A intenção foi apresentar principalmente os '''padrões, caminhos e decisões de configuração''' que utilizo no dia a dia, servindo como uma referência para a equipe.

Espero que este material seja útil e que, mesmo sem entrar em todos os detalhes de cada procedimento, consiga ajudar na padronização das configurações, facilitar o suporte e tornar mais claro o motivo de algumas das escolhas adotadas.

'''Obrigado pela leitura e bom trabalho!'''

RemoteApp e Sistema em Modo Desktop

2026-08-12T23:18:37Z

Vinicius Borges: Criou página com '== RemoteApp para Clientes sem Acesso via Navegador == Para clientes que não utilizarão o sistema via navegador, podemos disponibilizar o sistema através de '''RemoteApp'''. O funcionamento é semelhante ao TSplus RemoteApp: o sistema permanece instalado no servidor em nuvem, porém, para o usuário, somente a aplicação é apresentada. Dessa forma, a experiência se aproxima de um sistema instalado localmente, sem disponibilizar o Desktop completo do servidor. ==...'

== RemoteApp para Clientes sem Acesso via Navegador ==

Para clientes que não utilizarão o sistema via navegador, podemos disponibilizar o sistema através de '''RemoteApp'''.

O funcionamento é semelhante ao TSplus RemoteApp: o sistema permanece instalado no servidor em nuvem, porém, para o usuário, somente a aplicação é apresentada. Dessa forma, a experiência se aproxima de um sistema instalado localmente, sem disponibilizar o Desktop completo do servidor.

=== Instalação do RemoteApp Tool ===

O '''RemoteApp Tool''' é utilizado para configurar e disponibilizar as aplicações através do RemoteApp.

O projeto está disponível no GitHub:

https://github.com/kimmknight/remoteapptool

Acesse o projeto e baixe o instalador '''.MSI''' disponível na seção '''Releases'''.

=== Cadastro da Aplicação ===

Após instalar o RemoteApp Tool no servidor:

# Abra o '''RemoteApp Tool'''.
# Clique no botão '''+''' para adicionar uma nova aplicação.
# Localize o executável do sistema que será disponibilizado.
# A aplicação será adicionada à lista de aplicações.

Após adicionar a aplicação, podemos utilizar as opções disponíveis sobre ela para configurar:

* '''Nome''' — nome que será apresentado ao usuário;
* '''Caminho''' — caminho do executável;
* '''Ícone''' — ícone utilizado pela aplicação.

Normalmente, essas são as principais configurações necessárias para disponibilizar o sistema.

Após realizar as configurações, salve a aplicação.

=== Criar a Conexão do Cliente ===

Com a aplicação selecionada, utilizamos a opção:

<syntaxhighlight lang="text">
Create Client Connection
</syntaxhighlight>

Nessa etapa serão configuradas as informações da conexão que será disponibilizada para o cliente.

O campo '''Server''' IP da máquina na '''Radmin VPN'''.

No campo '''Alternative Server''', IP da máquina na '''Radmin VPN'''.

Exemplo:

<syntaxhighlight lang="text">
Alternative Server: IP_RADMIN_DO_SERVIDOR
</syntaxhighlight>

=== Por que utilizar o IP da Radmin? ===

A conexão do RemoteApp utiliza RDP para estabelecer a comunicação com o servidor.

Ao utilizar o endereço da Radmin VPN, a comunicação ocorre através da rede privada criada entre o cliente e o servidor, não sendo necessário expor diretamente uma porta RDP do servidor à Internet.

Isso reduz a superfície de exposição do serviço RDP.

'''Importante:''' não recomendamos simplesmente liberar uma porta RDP diretamente na Internet. Caso seja necessário utilizar uma porta pública, devem ser avaliados mecanismos adicionais de proteção, como VPN, firewall, restrição de origem e outras medidas de segurança.

=== Geração do Arquivo RDP ===

Após configurar o servidor e a aplicação, basta gerar o arquivo:

<syntaxhighlight lang="text">
.rdp
</syntaxhighlight>

Esse arquivo será disponibilizado para o cliente e deverá ser colocado na máquina que utilizará o sistema.

Ao executar o arquivo pela primeira vez, o Windows solicitará as credenciais do usuário criado no servidor.

Informe:

<syntaxhighlight lang="text">
Usuário: NOME_DO_USUARIO
Senha: SENHA_DO_USUARIO
</syntaxhighlight>

Podemos optar por salvar as credenciais no Windows para que, nas próximas execuções, o usuário não precise informar novamente o login e a senha.

Dessa forma, para o usuário, basta executar o arquivo `.rdp` para abrir diretamente o sistema.

=== Resultado para o Usuário ===

Para o usuário final, o funcionamento será semelhante a uma aplicação instalada localmente:

<syntaxhighlight lang="text">
Área de Trabalho do Windows
│
└── Ícone do Sistema
│
▼
Arquivo .RDP
│
▼
RemoteApp
│
▼
Sistema em Nuvem
</syntaxhighlight>

O servidor continua executando o sistema e mantendo os dados na nuvem, enquanto o usuário visualiza somente a aplicação disponibilizada.

=== RDP Options ===

O RemoteApp Tool possui também a opção '''RDP Options''', que permite configurar diversos parâmetros relacionados ao comportamento da conexão RDP.

Entre outras opções, é possível controlar recursos que serão redirecionados ou compartilhados entre o computador local e o servidor, como:

* Impressoras;
* Unidades de disco;
* Área de transferência;
* Recursos locais;
* Áudio;
* Outros dispositivos e recursos do RDP.

Essas opções devem ser alteradas somente quando houver necessidade específica do ambiente.

Para a configuração padrão dos clientes, recomenda-se manter as opções padrão e alterar somente os recursos necessários para o funcionamento do sistema.

Instalação de Impressoras Locais

2026-08-12T23:07:42Z

Vinicius Borges: Criou página com '== Impressoras de Cupom, Matriciais e Etiquetas == Impressoras de '''cupom, matriciais e etiquetas''' podem apresentar problemas quando utilizadas através do redirecionamento do RemoteApp ou pela '''Universal Printer''' do servidor, principalmente alterações de escala, posicionamento e formatação. Para esses casos, utilizamos uma instalação da impressora de forma '''local no servidor''', utilizando o compartilhamento da impressora através da rede Radmin VPN. =...'

== Impressoras de Cupom, Matriciais e Etiquetas ==

Impressoras de '''cupom, matriciais e etiquetas''' podem apresentar problemas quando utilizadas através do redirecionamento do RemoteApp ou pela '''Universal Printer''' do servidor, principalmente alterações de escala, posicionamento e formatação.

Para esses casos, utilizamos uma instalação da impressora de forma '''local no servidor''', utilizando o compartilhamento da impressora através da rede Radmin VPN.

=== Pré-requisito: Compartilhamento Protegido por Senha ===

Antes de configurar a impressora, é necessário garantir que o compartilhamento de impressoras e arquivos da máquina local esteja '''protegido por senha'''.

Esse ponto é fundamental para o funcionamento deste modelo de configuração.

Na máquina onde a impressora está instalada, criamos um usuário específico para o compartilhamento, utilizando um nome que identifique sua finalidade, por exemplo:

<syntaxhighlight lang="text">
IMP
</syntaxhighlight>

ou:

<syntaxhighlight lang="text">
IMPRESSORA
</syntaxhighlight>

Utilizamos uma senha padrão definida para esse tipo de acesso.

O usuário e a senha serão utilizados posteriormente pelo servidor para autenticar o acesso à impressora compartilhada.

=== Compartilhamento da Impressora ===

A impressora é instalada normalmente na máquina local do cliente e, posteriormente, compartilhada na rede.

Utilizamos um nome que facilite sua identificação, por exemplo:

<syntaxhighlight lang="text">
ELGIN_L42_PRO
</syntaxhighlight>

A máquina do cliente e o servidor devem estar conectados através da '''Radmin VPN'''.

O caminho do compartilhamento ficará, por exemplo:

<syntaxhighlight lang="text">
\\MAQUINA_LOCAL_DO_CLIENTE\ELGIN_L42_PRO
</syntaxhighlight>

=== Instalação no Servidor ===

Embora seja possível instalar a impressora diretamente pelo compartilhamento do Windows, esse método pode apresentar problemas posteriormente, principalmente relacionados a drivers.

Por isso, no servidor, instalamos o '''driver específico do modelo da impressora''' como se fosse uma instalação local.

Após a instalação do driver, criamos uma porta do tipo:

<syntaxhighlight lang="text">
Local Port
</syntaxhighlight>

Como caminho da porta, utilizamos o caminho do compartilhamento:

<syntaxhighlight lang="text">
\\MAQUINA_LOCAL_DO_CLIENTE\ELGIN_L42_PRO
</syntaxhighlight>

Dessa forma, a impressora fica instalada no servidor utilizando o driver correto do fabricante, mas envia os trabalhos de impressão para a impressora compartilhada na máquina local do cliente.

=== Permissões da Impressora ===

Assim como fazemos com as pastas, as permissões da impressora também devem ser configuradas.

O acesso à impressora deve ser permitido somente para:

* '''Administradores'''
* '''Frame'''
* '''Grupo do cliente'''

Dessa forma, a impressora fica instalada no servidor, mas somente os usuários autorizados conseguem visualizar e utilizar a impressora.

=== Credenciais de Acesso ===

Para que os usuários da nuvem consigam acessar a impressora compartilhada, é necessário cadastrar as credenciais da máquina local.

No usuário que utilizará a impressora, acesse:

'''Painel de Controle → Gerenciador de Credenciais → Credenciais do Windows'''

Adicione uma nova credencial utilizando o nome ou endereço da máquina onde a impressora está instalada.

Preferencialmente, utilize o '''nome da máquina''' em vez do endereço IP:

<syntaxhighlight lang="text">
MAQUINA_LOCAL_DO_CLIENTE
</syntaxhighlight>

Isso evita problemas caso o endereço IP da máquina seja alterado.

Informe o usuário criado anteriormente:

<syntaxhighlight lang="text">
Usuário: IMP
Senha: SENHA_PADRAO
</syntaxhighlight>

Essas credenciais devem ser cadastradas para todos os usuários da nuvem que pertençam ao grupo autorizado e que precisarão utilizar aquela impressora.

=== Resumo da Estrutura ===

A comunicação ficará estruturada da seguinte forma:

<syntaxhighlight lang="text">
Servidor em Nuvem
│
│ Radmin VPN
│
▼
Máquina do Cliente
│
└── Impressora compartilhada
│
└── ELGIN_L42_PRO
</syntaxhighlight>

No servidor:

<syntaxhighlight lang="text">
Driver da impressora
│
▼
Local Port
│
▼
\\MAQUINA_LOCAL_DO_CLIENTE\ELGIN_L42_PRO
│
▼
Impressora física
</syntaxhighlight>

'''Importante:''' o compartilhamento da máquina local deve estar configurado para exigir autenticação por usuário e senha. Sem essa configuração, esse modelo de instalação poderá não funcionar corretamente ou poderá permitir acesso indevido ao recurso compartilhado.

Sierre

2026-08-12T22:58:56Z

Vinicius Borges:

Compartilhamento de Pasta e Mapeamento de Unidade

2026-08-12T22:58:10Z

Vinicius Borges: Criou página com '== Compartilhamento de Pastas == Assim como definimos as permissões de acesso para as pastas locais e do servidor, aplicamos permissões específicas nas pastas compartilhadas, permitindo acesso somente ao '''Suporte''' e ao '''grupo do cliente'''. Normalmente, utilizamos uma pasta para transferência de arquivos entre o ambiente local e o servidor em nuvem. Essa pasta pode ser utilizada para: * Arquivos XML; * Fotos e imagens; * Cargas para balança; * Outros arquiv...'

== Compartilhamento de Pastas ==

Assim como definimos as permissões de acesso para as pastas locais e do servidor, aplicamos permissões específicas nas pastas compartilhadas, permitindo acesso somente ao '''Suporte''' e ao '''grupo do cliente'''.

Normalmente, utilizamos uma pasta para transferência de arquivos entre o ambiente local e o servidor em nuvem. Essa pasta pode ser utilizada para:

* Arquivos XML;
* Fotos e imagens;
* Cargas para balança;
* Outros arquivos que precisem ser transferidos entre o ambiente local e a nuvem.

=== Padrão de Compartilhamento ===

O compartilhamento pode receber um nome específico para determinada finalidade:

<syntaxhighlight lang="text">
BALANCA_GD_MERCANTIL$
</syntaxhighlight>

Ou podemos utilizar uma pasta geral para transferência de arquivos:

<syntaxhighlight lang="text">
ARQUIVOS_11111111111111$
</syntaxhighlight>

O caractere '''$''' no final do nome transforma o compartilhamento em um '''compartilhamento oculto'''. Dessa forma, ele não aparece normalmente na listagem de compartilhamentos de rede do Windows.

'''Observação:''' o compartilhamento oculto não é um mecanismo de segurança. Caso o usuário conheça o caminho do compartilhamento ou consiga visualizar a lista de compartilhamentos por outros meios, ele ainda poderá tentar acessá-lo. A segurança deve ser garantida pelas permissões configuradas na pasta.

=== Mapeamento da Unidade de Rede ===

Após criar o compartilhamento e configurar as permissões, podemos mapear a pasta como uma unidade de rede no Windows.

No computador do cliente:

# Abra o '''Explorador de Arquivos'''.
# Clique com o botão direito em '''Este Computador'''.
# Selecione '''Mapear unidade de rede'''.
# Escolha a letra que será utilizada para a unidade, por exemplo:
<syntaxhighlight lang="text">
Z:
</syntaxhighlight>
# No campo '''Pasta''', informe o caminho do compartilhamento:
<syntaxhighlight lang="text">
\\SERVIDOR\ARQUIVOS_11111111111111$
</syntaxhighlight>
# Marque '''Reconectar-se durante a entrada'''.
# Se necessário, marque '''Conectar usando credenciais diferentes'''.
# Clique em '''Concluir'''.
# Informe o usuário e a senha autorizados para acessar o compartilhamento.

Após o procedimento, a pasta ficará disponível no Windows como uma unidade de rede, por exemplo:

<syntaxhighlight lang="text">
Z:\
</syntaxhighlight>

O cliente poderá utilizar essa unidade para transferir arquivos entre o ambiente local e o servidor.

Rede Radmin

2026-08-12T22:53:25Z

Vinicius Borges: Criou página com '== Rede Radmin VPN == A rede Radmin VPN será criada utilizando o '''nome do cliente''' como padrão: <syntaxhighlight lang="text"> NOME_DO_CLIENTE </syntaxhighlight> A senha utilizada seguirá o mesmo padrão definido para os acessos do ambiente. A rede Radmin será utilizada para a comunicação entre os equipamentos do cliente e o servidor, incluindo: * Compartilhamento de pastas e arquivos; * Geração e transferência de cargas de balança; * Acesso ao servidor...'

== Rede Radmin VPN ==

A rede Radmin VPN será criada utilizando o '''nome do cliente''' como padrão:

<syntaxhighlight lang="text">
NOME_DO_CLIENTE
</syntaxhighlight>

A senha utilizada seguirá o mesmo padrão definido para os acessos do ambiente.

A rede Radmin será utilizada para a comunicação entre os equipamentos do cliente e o servidor, incluindo:

* Compartilhamento de pastas e arquivos;
* Geração e transferência de cargas de balança;
* Acesso ao servidor via '''RemoteApp'''.
* Instalação de impressoras Locais (Cupom, Matricial, Etiqueta)

'''Importante:''' para ambientes que utilizam RemoteApp, a comunicação deverá ser realizada através da rede Radmin VPN ou outra VPN

Permissões de Pasta (Grupo)

2026-08-12T22:46:12Z

Vinicius Borges: Criou página com '== Padrão de Instalação do Sistema == No padrão de instalação do sistema, costumamos utilizar uma estrutura de pastas organizada por cliente: <syntaxhighlight lang="text"> C:\SISTEMA\CLIENTE </syntaxhighlight> Ou, preferencialmente, utilizando o CNPJ do cliente: <syntaxhighlight lang="text"> C:\SISTEMA\CNPJ_DO_CLIENTE </syntaxhighlight> A utilização do CNPJ facilita a organização e a identificação dos ambientes, principalmente quando existem vários clie...'

== Padrão de Instalação do Sistema ==

No padrão de instalação do sistema, costumamos utilizar uma estrutura de pastas organizada por cliente:

<syntaxhighlight lang="text">
C:\SISTEMA\CLIENTE
</syntaxhighlight>

Ou, preferencialmente, utilizando o CNPJ do cliente:

<syntaxhighlight lang="text">
C:\SISTEMA\CNPJ_DO_CLIENTE
</syntaxhighlight>

A utilização do CNPJ facilita a organização e a identificação dos ambientes, principalmente quando existem vários clientes no mesmo servidor.

== Permissões da Pasta Base ==

Como estamos trabalhando em um ambiente compartilhado, o '''Cliente X''' não deve ter acesso ou sequer conseguir visualizar a existência do '''Cliente Y'''.

Para isso, primeiro configuramos as permissões da pasta base:

<syntaxhighlight lang="text">
C:\SISTEMA
</syntaxhighlight>

Acessamos:

'''Propriedades → Segurança → Avançado'''

Desabilitamos a '''herança''' e removemos as permissões existentes.

Em seguida, adicionamos somente as permissões necessárias para:

* '''Administradores'''
* '''Administradores do sistema'''
* '''Frame''' — usuário utilizado pela equipe de suporte.

O usuário '''Frame''' é mantido como uma espécie de acesso de recuperação. Caso, por algum motivo, as permissões da pasta sejam alteradas ou o acesso seja perdido, o usuário do suporte ainda terá acesso suficiente para restaurar as permissões originais.

Com essa configuração, os usuários dos clientes não possuem permissão para acessar a pasta base:

<syntaxhighlight lang="text">
C:\SISTEMA
</syntaxhighlight>

Dessa forma, o '''Cliente X''' não consegue acessar ou navegar até as pastas dos demais clientes.

Por exemplo:

<syntaxhighlight lang="text">
C:\SISTEMA
├── 11111111111111
├── 22222222222222
└── 33333333333333
</syntaxhighlight>

O usuário do cliente '''11111111111111''' terá acesso somente à sua própria pasta e não conseguirá visualizar ou acessar as pastas dos demais clientes.

== Permissões da Pasta do Cliente ==

Depois de configurar a pasta base, aplicamos as permissões individualmente na pasta de cada cliente.

Por exemplo:

<syntaxhighlight lang="text">
C:\SISTEMA\11111111111111
</syntaxhighlight>

Acessamos:

'''Propriedades → Segurança → Avançado'''

Nesse nível, '''não é necessário desabilitar a herança'''. Aplicamos as permissões aos grupos específicos daquele cliente.

O cliente deverá possuir seus respectivos grupos de acesso, por exemplo:

<syntaxhighlight lang="text">
NOME_DO_CLIENTE
NOME_DO_CLIENTE_RDP
</syntaxhighlight>

O grupo utilizado dependerá da forma de acesso do cliente:

* '''NOME_DO_CLIENTE''' — acesso via navegador.
* '''NOME_DO_CLIENTE_RDP''' — acesso via RemoteApp/Desktop.

Dessa forma, cada cliente possui acesso somente à sua própria pasta.

== Restrição de Exclusão e Alteração de Permissões ==

Embora o cliente tenha acesso completo aos arquivos necessários para a execução do sistema, algumas permissões devem ser removidas para evitar alterações administrativas indevidas.

Para os grupos dos clientes, removemos permissões relacionadas a:

* Alterar permissões;
* Apropriar-se da pasta ou dos arquivos;
* Excluir arquivos;
* Excluir subpastas e arquivos, quando aplicável.

O objetivo é permitir que o cliente possa:

* Criar arquivos;
* Alterar arquivos;
* Executar o sistema;
* Criar e modificar arquivos necessários ao funcionamento do sistema.

Porém, o usuário não deverá possuir permissão para excluir arquivos ou alterar as permissões da pasta.

Dessa forma, conseguimos limitar o cliente ao seu próprio ambiente, mantendo o controle administrativo das pastas com a equipe de suporte.

== PDV Offline ==

No caso do '''PDV Offline''', é importante manter exatamente o mesmo caminho de instalação utilizado no servidor.

Por exemplo, se o sistema no servidor estiver instalado em:

<syntaxhighlight lang="text">
C:\SISTEMA\11111111111111
</syntaxhighlight>

O PDV Offline também deverá utilizar:

<syntaxhighlight lang="text">
C:\SISTEMA\11111111111111
</syntaxhighlight>

Essa padronização é necessária para que o PDV Offline consiga localizar corretamente os '''schemas''' e demais arquivos utilizados pelo sistema.

'''Atenção:''' não altere o caminho do cliente no PDV Offline sem verificar as dependências do sistema, pois os caminhos podem ser utilizados para localizar schemas e outros arquivos necessários à execução.

Usuários e Grupos de Usuários

2026-08-12T22:36:35Z

Vinicius Borges: Criou página com '== Criação de Usuários e Grupos == Com '''Windows + R''', buscamos por: <syntaxhighlight lang="text"> netplwiz </syntaxhighlight> Acessamos '''Avançado''' e, novamente, '''Avançado'''. Em seguida, criamos um grupo com o seguinte padrão: <syntaxhighlight lang="text"> NOME_DA_EMPRESA </syntaxhighlight> Depois, criamos os usuários, geralmente seguindo o padrão: <syntaxhighlight lang="text"> Nome.Empresa </syntaxhighlight> Utilizamos uma senha padrão para tod...'

== Criação de Usuários e Grupos ==

Com '''Windows + R''', buscamos por:

<syntaxhighlight lang="text">
netplwiz
</syntaxhighlight>

Acessamos '''Avançado''' e, novamente, '''Avançado'''. Em seguida, criamos um grupo com o seguinte padrão:

<syntaxhighlight lang="text">
NOME_DA_EMPRESA
</syntaxhighlight>

Depois, criamos os usuários, geralmente seguindo o padrão:

<syntaxhighlight lang="text">
Nome.Empresa
</syntaxhighlight>

Utilizamos uma senha padrão para todos os usuários.

<ref>Seja RDP ou acesso via navegador, é interessante utilizar uma única senha para todos os usuários. Dessa forma, tarefas como instalação de impressoras e manutenção são facilitadas para a equipe de suporte.</ref>

Após criar o grupo e os usuários, basta enviar uma mensagem no grupo de suporte solicitando a liberação no seguinte padrão:

<syntaxhighlight lang="text">
Preciso da liberação do:

Sistema: C:\CAMINHO_DO_CLIENTE
Grupo: NOME_DO_GRUPO
Servidor: Servidor (Ex: https://one.yourcloud.com.br/)
</syntaxhighlight>

== Grupo para RemoteApp / RDP ==

Quando utilizamos o '''RemoteApp''', é interessante criar um grupo separado seguindo o padrão:

<syntaxhighlight lang="text">
NOME_DO_CLIENTE_RDP
</syntaxhighlight>

Dessa forma, temos grupos distintos para cada tipo de acesso:

* '''NOME_DO_CLIENTE''' — acesso via navegador.
* '''NOME_DO_CLIENTE_RDP''' — acesso via RemoteApp / Desktop.

Essa separação é importante porque, caso o mesmo grupo utilizado para o acesso via navegador seja utilizado também no RemoteApp, podemos ter duas aplicações sendo abertas simultaneamente e ficando sobrepostas na sessão do usuário.

Manter grupos separados facilita o controle das permissões e evita conflitos entre o acesso via navegador e o acesso via RemoteApp/Desktop.

Sierre

2026-08-12T22:27:28Z

Vinicius Borges: Criou página com '== Padrões que venho aplicando == * Usuários e Grupos de Usuários * Permissões de Pasta (Grupo) * Rede Radmin * Compartilhamento de Pasta e Mapeamento de Unidade * RemoteApp e Sistema em Modo Desktop'

Página principal

2026-08-12T22:18:51Z

Vinicius Borges:

Bem-vindo à '''Wiki Borgis'''!

Esta é a nossa central de conhecimento, onde você encontrará documentação detalhada sobre diversos tópicos essenciais. Aqui, você pode acessar guias, tutoriais e soluções.

📌 '''O que você encontra aqui?'''

* Guia de Instalação – ''Passo a passo para configurar e utilizar corretamente nossas ferramentas.''
* Resolução de Problemas – ''Soluções para erros comuns e dicas para otimizar seu uso.''
* Downloads Úteis – ''Links para ferramentas e arquivos complementares.''
* Tutoriais e Exemplos – ''Exemplos práticos para facilitar o aprendizado.''

🔎 '''Como usar a Wiki?'''

* 📖 Utilize a barra de pesquisa para encontrar informações rapidamente.
* 💬 Para dúvidas, consulte a seção de ajuda ou entre em contato com a equipe.

== Tópicos ==
'''[[rlsBorgis]] - Nossa ferramenta de relatórios personalizados'''

'''[[Instalador]] - Instalador padrão CodigoUP'''

'''[[Gdoor(Pentaho)]] - Script de conversão de Dados GDOOR -> CODIGOUP ( Documentação !!!)'''

'''[[Sierre]] - Padrões de nuvem aplicados por mim'''

Gdoor(Pentaho)

2026-05-22T21:30:19Z

Vinicius Borges:

= Conversão GDOOR → Código UP =

== 1. Sobre o Projeto 🚩 ==
Projeto independente de conversão de dados entre os sistemas GDOOR e Código UP. O serviço consiste na migração, adequação e compatibilização estrutural das bases de dados do GDOOR para utilização no padrão operacional do Código UP.

---

== 2. Modelo de Conversão ==
A conversão é realizada diretamente por mim, de forma técnica e personalizada para cada base recebida.

O serviço contempla:

* Conversão estrutural da base de dados
* Adequação de registros ao padrão Código UP
* Compatibilização de IDs, vínculos e relacionamentos
* Ajustes técnicos necessários durante o processo de migração

O serviço NÃO contempla:

* Instalação do sistema Código UP
* Instalação de servidores
* Configuração de rede
* Treinamento de usuários
* Configuração de impressoras, SAT, NFC-e ou periféricos
* Suporte operacional pós-implantação
* Manutenção de hardware ou infraestrutura

A base enviada deve obrigatoriamente estar em versão compatível do Firebird, sendo a versão mínima suportada atualmente a '''5.0'''.

O cliente é responsável por:

* Backup integral da base antes do envio
* Integridade física dos arquivos
* Validação final das informações convertidas
* Infraestrutura onde a base será utilizada

Não há responsabilidade sobre:

* Corrupção pré-existente na base
* Falhas de hardware
* Problemas de armazenamento
* Perda de dados ocasionada por terceiros
* Danos causados após a entrega da conversão

Bases muito grandes, múltiplos bancos ou projetos com alto volume de registros devem ser agendados previamente devido ao tempo de processamento e validação necessários.

---

== 3. Escopo Atual de Compatibilidade ==

{| class="wikitable"
! Módulo !! Compatibilidade !! Status
|-
| Produtos || Cadastro principal, tributação, NCM, estoque, custos, GLP e informações fiscais || 🟢 Total
|-
| Histórico de Custos (Aba Produtos) || Fornecedor, nota de entrada e histórico de custo por produto || 🟢 Total
|-
| Subgrupos de Produtos || Conversão de subgrupos e classificações internas || 🟢 Total
|-
| Food / Sabores / Adicionais / Retiradas e Grupos de Complemento || Conversão de sabores e estruturas relacionadas || 🟢 Total
|-
| Clientes || Conversão completa de clientes || 🟢 Total
|-
| Fornecedores (Prefixo 2) || Conversão completa de fornecedores || 🟢 Total
|-
| Vendedores (Prefixo 4) || Conversão completa de vendedores || 🟢 Total
|-
| Transportadoras (Prefixo 3) || Conversão completa de transportadoras || 🟢 Total
|-
| Contas a Receber || Conversão financeira || 🟢 Total
|-
| Contas a Pagar || Conversão financeira || 🟢 Total
|-
| DAV || Conversão de DAVs ativos para consignados || 🟡 Parcial
|-
| Pedido de Venda Gerencial || Conversão com prefixação de ID (2) para compatibilidade operacional || 🟡 Parcial (Sem Financeiro)
|-
| NFC-e || Conversão de vendas NFC-e || 🟢 Total
|-
| SAT || Conversão de vendas SAT || 🟢 Total
|-
| Nota Manual || Conversão de vendas manuais || 🟢 Total
|-
| Ordem de Serviço || Conversão de O.S || 🟡 Parcial (Sem Financeiro)
|-
| Fiscal || Documentos Fiscais SaidaxEntrada || 🔴 Não convertido
|}

---

== 4. Observações Técnicas ==

* Estruturas não listadas nesta documentação devem ser consideradas como não suportadas atualmente.
* Alguns módulos podem possuir limitações decorrentes de diferenças estruturais entre versões do GDOOR e do Código UP.
* Conversões parciais dependem da disponibilidade estrutural das informações na base de origem.
* Bases com inconsistências estruturais podem exigir tratamento técnico adicional antes da migração.
* Algumas estruturas internas do GDOOR podem variar entre revendas, versões e personalizações.

---

== 5. Contato ==
Para mais informações técnicas, análises de compatibilidade, agendamentos ou parcerias:

📧 ''contato@borgis.com.br''
📱 ''(16) 99391-7443''

Gdoor(Pentaho)

2026-05-22T21:24:16Z

Vinicius Borges:

= Conversão GDOOR → Código UP =

== 1. Sobre o Projeto 🚩 ==
Projeto independente de conversão de dados entre os sistemas GDOOR e Código UP. O serviço consiste na migração, adequação e compatibilização estrutural das bases de dados do GDOOR para utilização no padrão operacional do Código UP.

---

== 2. Modelo de Conversão ==
A conversão é realizada diretamente por mim, de forma técnica e personalizada para cada base recebida.

O serviço contempla:

* Conversão estrutural da base de dados
* Adequação de registros ao padrão Código UP
* Compatibilização de IDs, vínculos e relacionamentos
* Ajustes técnicos necessários durante o processo de migração

O serviço NÃO contempla:

* Instalação do sistema Código UP
* Instalação de servidores
* Configuração de rede
* Treinamento de usuários
* Configuração de impressoras, SAT, NFC-e ou periféricos
* Suporte operacional pós-implantação
* Manutenção de hardware ou infraestrutura

A base enviada deve obrigatoriamente estar em versão compatível do Firebird, sendo a versão mínima suportada atualmente a '''5.0'''.

O cliente é responsável por:

* Backup integral da base antes do envio
* Integridade física dos arquivos
* Validação final das informações convertidas
* Infraestrutura onde a base será utilizada

Não há responsabilidade sobre:

* Corrupção pré-existente na base
* Falhas de hardware
* Problemas de armazenamento
* Perda de dados ocasionada por terceiros
* Danos causados após a entrega da conversão

Bases muito grandes, múltiplos bancos ou projetos com alto volume de registros devem ser agendados previamente devido ao tempo de processamento e validação necessários.

---

== 3. Escopo Atual de Compatibilidade ==

{| class="wikitable"

| ! Módulo !! Compatibilidade !! Status | | | | |
| ------------------------------------- | - | ------------------------------------------------------------------------------- | - | ----------------- |
| Produtos | | Cadastro principal, tributação, NCM, estoque, custos, GLP e informações fiscais | | 🟢 Total |
| - | | | | |
| Histórico de Custos | | Fornecedor, nota de entrada e histórico de custo por produto | | 🟢 Total |
| - | | | | |
| Subgrupos de Produtos | | Conversão de subgrupos e classificações internas | | 🟢 Total |
| - | | | | |
| Food / Sabores | | Conversão de sabores e estruturas relacionadas | | 🟡 Parcial |
| - | | | | |
| Adicionais e Retiradas | | Conversão de adicionais, observações e retiradas | | 🟡 Parcial |
| - | | | | |
| Grupo de Complementos | | Conversão estrutural dos grupos compatíveis | | 🟡 Parcial |
| - | | | | |
| Clientes | | Conversão completa de clientes | | 🟢 Total |
| - | | | | |
| Fornecedores | | Conversão completa de fornecedores | | 🟢 Total |
| - | | | | |
| Vendedores | | Conversão completa de vendedores | | 🟢 Total |
| - | | | | |
| Transportadoras | | Conversão completa de transportadoras | | 🟢 Total |
| - | | | | |
| Contas a Receber | | Conversão financeira | | 🟢 Total |
| - | | | | |
| Contas a Pagar | | Conversão financeira | | 🟢 Total |
| - | | | | |
| DAV | | Conversão de DAVs ativos para consignados | | 🟡 Parcial |
| - | | | | |
| Pedido de Venda Gerencial | | Conversão com prefixação de ID para compatibilidade operacional | | 🟢 Total |
| - | | | | |
| NFC-e | | Conversão de vendas NFC-e | | 🟢 Total |
| - | | | | |
| SAT | | Conversão de vendas SAT | | 🟢 Total |
| - | | | | |
| Nota Manual | | Conversão de vendas manuais | | 🟢 Total |
| - | | | | |
| Histórico de Pagamentos | | PIX, Cartão, Dinheiro e múltiplas formas de pagamento | | 🟢 Total |
| - | | | | |
| Ordem de Serviço | | Conversão de O.S | | 🟢 Total |
| - | | | | |
| Produção | | Estruturas produtivas | | 🔴 Não convertido |
| - | | | | |
| SPED | | Estruturas fiscais avançadas | | 🔴 Não convertido |
| - | | | | |
| Integrações Externas | | APIs, marketplaces e integrações terceiras | | 🔴 Não convertido |
| } | | | | |

---

== 4. Observações Técnicas ==

* Estruturas não listadas nesta documentação devem ser consideradas como não suportadas atualmente.
* Alguns módulos podem possuir limitações decorrentes de diferenças estruturais entre versões do GDOOR e do Código UP.
* Conversões parciais dependem da disponibilidade estrutural das informações na base de origem.
* Bases com inconsistências estruturais podem exigir tratamento técnico adicional antes da migração.
* Algumas estruturas internas do GDOOR podem variar entre revendas, versões e personalizações.

---

== 5. Contato ==
Para mais informações técnicas, análises de compatibilidade, agendamentos ou parcerias:

📧 ''[contato@borgis.com.br](mailto:contato@borgis.com.br)''
📱 ''(16) 99391-7443''

Instalador

2026-04-22T18:08:54Z

Vinicius Borges: /* Observações */

Um instalador padrão tem como objetivo facilitar a implantação do sistema, eliminando a necessidade de configurações manuais, apontamentos ou execução de parametrizações básicas.

Com ele, você conta com um processo padronizado, simples e eficiente, garantindo uma instalação rápida e sem complicações.

A seguir, estão a documentação e os detalhes do instalador.

== Requisitos ==

* Inno Setup
Criador de instaladores baseado em scripts.
Download: https://jrsoftware.org/isdl.php/Inno-Setup-Downloads

* Inno Script Studio
Interface gráfica para edição de scripts do Inno Setup. É com ele que você poderá alterar e atualizar o instalador.
Download: https://www.kymoto.org/products/inno-script-studio/downloads

== Arquivos de Personalização ==

* '''login.png (450x450)'''
Imagem exibida na tela de login do sistema. Pode ser um usuário padrão (como o homem azul do Up) ou a logo da sua empresa.

* '''logopequena.png'''
Exibida no dashboard do sistema.

* '''logo.png (1412x1050)'''
Imagem principal da marca da revenda. Preferencialmente com fundo transparente. Aparece quando o dashboard está fechado.

* '''carregando.png (1200x535)'''
Exibida antes da tela de login. Recomenda-se usar uma mensagem como “Estamos carregando, aguarde”. Também é possível utilizar um GIF animado.

* '''pdv.png (735x466)'''
Imagem exibida no modo balcão do PDV e quando o produto não possui foto. Excelente ponto para inserir a marca da revenda.

* '''pdv.ico'''
Ícone utilizado na área de trabalho para o PDV.

* '''icone.ico'''
Ícone utilizado na área de trabalho para o ERP.

* '''normal.bmp'''
Imagem exibida na lateral do instalador durante o processo de instalação.

* '''small.bmp / favicon.ico'''
Ícones do instalador exibidos durante a instalação.

* '''sem_foto.png'''
Utilizada no PDV moderno quando o produto não possui imagem.

* '''fundopdv.png (945x591)'''
Fundo das telas PDV e PDV Super. Recomenda-se utilizar uma faixa superior com a marca da revenda ou um fundo neutro.

* '''auxiliares.ico'''
Ícone da pasta “Auxiliares”, criada pelo instalador (caso utilizada).

* '''licenca.rtf'''
Arquivo de licença de uso do software. Deve ser personalizado com os dados da empresa.

* '''infoafter.rtf'''
Mensagem exibida ao final da instalação.

== Estrutura do Instalador ==

* '''bin'''
Pasta de saída do instalador compilado (executável final).

* '''dlls'''
Armazena as DLLs que serão distribuídas para as pastas do sistema.

* '''executaveis'''
Contém as aplicações utilizadas pelo sistema CódigoUP.
Quando houver uma nova versão, basta substituir o arquivo nesta pasta.

* '''firebird'''
Armazena o banco de dados padrão e o banco do PDV offline.
O instalador utiliza sempre o Firebird 5.0.
Para alterar o banco padrão, substitua o arquivo '''DADOS.FDB'''.
No caso do PDV OFF, utilize '''PDV OFF\DADOS.FDB'''.

* '''fix_erp_dlls'''
Contém DLLs e scripts utilizados para correção de registros no Windows.

* '''ini'''
Arquivos INI utilizados pelo sistema.
São auto configuráveis de acordo com a instalação.

* '''outros'''
Armazena instaladores auxiliares como Aquipede, WhatsUP e UpSystem reduzido.
Para esse cenário, utilize o padrão '''padraov2.iss'''.
(Quanto mais arquivos e instaladores, maior será o executável final.)

* '''pastas'''
Contém estruturas utilizadas pelo sistema, como:

* Schemas de notas fiscais
* IBPT
* Migrador Excel
* Conformidade Fácil
* Boletos

* '''recursos'''
Contém arquivos de personalização e scripts (.bat) para configurações do Windows.

* '''utilitarios'''
Tudo dentro desta pasta será instalado e poderá ter atalho na área de trabalho (ex: AnyDesk, RustDesk, WinRAR).
Para adicionar ou remover um utilitário, basta incluir ou excluir o arquivo desta pasta.

'''Observação:'''
O Master Remote (acesso remoto) deve estar na pasta '''executaveis'''.
Se o arquivo '''MasterControl.exe''' estiver presente, ele será instalado automaticamente junto com o sistema.
Caso não esteja, essa instalação será ignorada.

== Padrões de Instalador ==

O projeto possui dois padrões de instalador:

* '''padrao.iss'''
Instalador padrão com todas as funcionalidades básicas.

* '''padraov2.iss'''
Versão mais completa, que permite:

* Escolher o tipo de instalação (Completa ou Reduzida)
* Instalar o Aquipede
* Instalar o WhatsUP

Observação: o instalador V2 gera um executável final maior, pois inclui outros instaladores internamente.

== Configuração do Arquivo .ISS ==

Ao abrir o arquivo '''.iss''', são poucas as configurações que precisam ser ajustadas:

* '''MyAppName'''
Nome do sistema exibido no instalador e no painel de controle do Windows.
Exemplo: "ERP Rosa dos Ventos".

* '''MyAppVersion'''
Controle interno de versão do instalador.
Pode seguir um padrão próprio ou acompanhar a versão do sistema.

* '''MyAppPublisher'''
Nome da sua empresa.
Será exibido no Windows e também utilizado dentro do sistema (ex: rodapé do login e relatórios).

* '''MyAppURL'''
Site da empresa (opcional).

* '''ProjectBaseDir'''
Caminho onde está o projeto do instalador na sua máquina.

* '''DefaultDirName'''
Caminho onde o sistema será instalado.
Exemplo: C:\UpSystem ou C:\ERP_Rosa_DV

'''Importante:'''
Caso altere esse caminho, certifique-se de que o banco de dados e todas as estações utilizem o mesmo padrão.

== Funcionamento do Instalador ==

Após aceitar os termos de uso, será necessário escolher o tipo de instalação:

* '''Servidor'''
Utiliza conexões locais (localhost, 127.0.0.1).

* '''Estação'''
Utiliza o nome ou IP do servidor (ex: DESKTOP891-23M, 192.168.x.xxx).

* '''PDV OFF'''
Opera com banco local e segue o padrão do servidor.

== Componentes da Instalação ==

Durante a instalação, é possível selecionar:

* Firebird 5.0 (x86 e x64)
* Executáveis adicionais (UpIfood, Busca Preço, etc.)

Esses itens são instalados quando selecionadas as opções:

* Firebird
* Pasta completa

A opção '''pasta reduzida''' é voltada para estações e contém apenas arquivos essenciais.

== Tarefas Adicionais ==

Durante a instalação, você poderá selecionar:

* Criação de atalhos na área de trabalho
* Uso do '''iniciar.exe''' (atualização automática do sistema)
* Bloqueio de múltiplas instâncias do sistema

Também estão disponíveis:

* Inicialização do backup ao final da instalação
* Criação da pasta de utilitários
* Instalação do serviço Força de Vendas (quando aplicável)

== Processo de Instalação ==

Durante a instalação:

* O Firebird é instalado automaticamente, sem intervenção do usuário
* Portas do firewall são liberadas (3050, 2018, 8082, 7079, 1080)
* Permissões da pasta são configuradas (Todos, Usuários, Administradores e SYSTEM)
* DLLs são registradas automaticamente

Caso já exista um Firebird instalado, o sistema apenas exibirá um aviso e continuará normalmente.

Ao final, será exibida a mensagem de sucesso e a opção de abrir o sistema.

Instalador

2026-04-18T14:22:23Z

Vinicius Borges: Criou página com 'Um instalador padrão tem como objetivo facilitar a implantação do sistema, eliminando a necessidade de configurações manuais, apontamentos ou execução de parametrizações básicas. Com ele, você conta com um processo padronizado, simples e eficiente, garantindo uma instalação rápida e sem complicações. A seguir, estão a documentação e os detalhes do instalador. == Requisitos == * Inno Setup Criador de instaladores baseado em scripts. Download: ht...'

2025-08-15T19:34:44Z

Vinicius Borges:

= Documentação do Projeto de Conversão GDOOR + Código UP via Pentaho =

== 1. Aviso Importante 🚩 ==
'''Atenção:''' Este projeto não possui vínculo com a Gdoor ou com a Código UP.
Ele foi desenvolvido de forma independente, utilizando conhecimentos próprios em SQL e exploração do banco de dados, além de validação feita com outras revendas que tiveram acesso antecipado aos scripts de conversão.
'''Não há garantia de funcionamento a 100%''' e o projeto é fornecido ''"como está"'', podendo apresentar falhas.

Afinal, atrás de todo software existe um ser humano — e neste caso, sou eu.

----

== 2. Objetivo do Projeto ==
Este script e fluxo no Pentaho foram criados para facilitar a conversão de dados entre o '''GDOOR''' e o '''Código UP''', garantindo maior automação e padronização no processo.

----

== 3. Requisitos Mínimos ==

=== Banco de Dados ===
* '''Firebird GDOOR''': Versão mínima '''5.0''' (alguns comandos SQL utilizam recursos exclusivos desta versão para melhor performance).
* '''Versão do GDOOR''': 3.0.0.620
* '''Versão do Código UP''': Firebird 5.0 (pode funcionar em versões anteriores, mas é recomendado utilizar sempre a última versão do painel e do Firebird disponível).

=== Pentaho ===
* '''Pentaho Data Integration (PDI)''': Versão mínima '''9.4 (2022)'''
* '''Java''': Versão 8
* '''Driver JDBC do Firebird''': Compatível com Java 8

----

== 4. Instalação e Preparação ==
# Instalar o Java 8
# Instalar o Pentaho 9.4 ou superior
# Adicionar o driver JDBC do Firebird compatível ao diretório <code>lib</code> do Pentaho.
# Validar conexão com o banco antes de iniciar qualquer conversão.

----

== 5. Observações ==
* Realize '''backup completo''' dos bancos de dados antes de iniciar o processo.
* Teste o script em um ambiente de homologação antes de aplicar no ambiente de produção.
* Caso surjam erros, revise se todos os requisitos estão atendidos.
* Se de todo modo não conseguir rodar a conversão, ou simplesmente não quiser ter esse trabalho, entre em contato comigo para a realização desse serviço, '''''sujeito à cobrança de valores por base de dados convertida.'''''

{| class="wikitable"
! Conversões Suportadas
|-
| '''Produtos''' (Completo, estoque, tributo e informações de GLP)
|-
| '''Pessoas'''
|-
| '''Financeiro'''
|-
| '''DAV → Consignado'''
|-
| '''Vendas → Pedido de Venda'''
|}

2025-03-29T02:40:52Z

Vinicius Borges:

Bem-vindo à Wiki Borgis!
Esta é a nossa central de conhecimento, onde você encontrará documentação detalhada sobre diversos tópicos essenciais. Aqui, você pode acessar guias, tutoriais e soluções.

📌 '''O que você encontra aqui?'''
🔹 Guia de Instalação – Passo a passo para configurar e utilizar corretamente nossas ferramentas.
🔹 Resolução de Problemas – Soluções para erros comuns e dicas para otimizar seu uso.
🔹 Downloads Úteis – Links para ferramentas e arquivos complementares.
🔹 Tutoriais e Exemplos – Exemplos práticos para facilitar o aprendizado.

🔎 '''Como usar a Wiki?'''
📖 Utilize a barra de pesquisa para encontrar informações rapidamente.
💬 Para dúvidas, consulte a seção de ajuda ou entre em contato com a equipe.

== Tópicos ==
[[rlsBorgis]] - Nossa ferramenta de relatórios personalizados