Precisa de ajuda?

Livesearch

spaceKey	PROT
size	large
placeholder	Estou procurando por ...
type	page
labels	smarterp

Section

Painel

borderColor	grey
borderWidth	1

Image Added

Image Removed

panel

Após a conclusão da instalação, localize e execute o aplicativo Smartclient.

Image Removed

A tela para acesso ao ambiente será exibida:

Programa Inicial:
Refere-se ao módulo inicial do Protheus que quer acessar. As opções possíveis estão os módulos: SIGAATF, SIGACOM, SIGAFAT, SIGAFIS, SIGAADV e SIGAMDI para acesso a todos os módulos e SIGACFG para o configurador do Protheus.

Comunicação no cliente:
Nome que identifica a forma como o Smartclient se comunicará com o servidor Protheus. Deve ser configurado através do botão com a engrenagem.

Ambiente no servidor:
Refere-se aos ambientes existentes no Protheus ao qual irá realizar o login, como por exemplo: Produção, Homologação e Desenvolvimento.

Clique no botão Configuração:

Image Removed

A tela seguinte mostra as opções para configurar o idioma da interface, o programa inicial que virá preenchido na tela de login para acessar o ambiente, a comunicação no cliente e o ambiente no servidor.

Interface:
Indica o idioma para a execução do ambiente. Recomendamos utilizar Português.

Programa Inicial:
Refere-se ao módulo inicial do Protheus que será acessado. Neste ponto, é apresentado sempre como padrão ao usuário.
As opções possíveis estão os módulos: SIGAATF, SIGACOM, SIGAFAT, SIGAFIS, SIGAADV e SIGAMDI para acesso a todos os módulos e SIGACFG para o configurador do Protheus.

Comunicação no cliente:
Refere-se à configuração de servidores disponíveis para o usuário.

Para configurar os servidores, vá para a sessão de TCP.

Pode-se criar uma nova configuração de servidor ou alterar a opção existente. Neste último caso, clique duas vezes sobre uma comunicação já existente.

Image Removed

Será apresentada a seguinte tela:

Nome:
Identifique qual servidor vai se conectar. recomendamos utilizar os nomes: Produção, Desenvolvimento e Homologação.

Tipo:

Refere-se ao tipo de comunicação que será feita com o servidor do SmartERP, as opções são: TCP ou HTTP.

Ao se selecionar uma conexão TCP/IP deverá informar o IP e porta nas opções Endereço e Porta.

O TOTVS | Web-Agent / SmartClient (Descontinuado) é responsável pela conexão entre a máquina do usuário e o SmartERP Protheus. Ele combina o poder da ferramenta de interface Web com a tecnologia para desktop, retirando assim, a limitação do navegador (browser) no acesso ao sistema de arquivos da estação do usuário. Com Com esta ferramenta, teremos todos os ambientes centralizados em um único aplicativo, isto é possível por meio das configurações dos ambientes.
Com ele é possível ter acesso aos drivers de impressoras, leitores de dados e outros periféricos, além de acesso à outros softwares de integração como o pacote Office.Veja como instalar e utilizar o Smartclient Electron:

Aviso
À partir do release 12.1.2410 (Outubro/2024) o SmartClient Desktop será descontinuado e deverá ser instalado o TOTVS | Web-Agent
Deck of Cards
id ID1Smartclient
Faça o download do arquivo compactado do Smartclient Electron.
Image Removed
Execute o Setup.exe e escolha o diretório de destino para a instalação.
Image Removed
Clique em Instalar e aguarde o processo de instalação.
Image Removed
Após a conclusão da instalação aparecerá a seguinte mensagem:
Image Removed
Card
id 01sm01
label Instalação
Expandir
title Instalação do Smartclient Electron no Windows
Expandir
title Instalação do Smartclient Electron no Linux
Coming soon...
Expandir
title Instalação do Smartclient Electron no MacOS
Nesta primeira versão, não há o aplicativo nativo para execução em MacOS. Recomenda-se a utilização do Wine ou semelhante para execução do aplicativo Windows.
Card
id 04
label Executando o Auto-Update
O SmartClient Electron possui a funcionalidade de se auto atualizar. Para isto, no momento da abertura do aplicativo será apresentado uma mensagem no rodapé da tela indicando que há uma atualização.
Ao clicar no balão contendo a mensagem de atualização, será exibido uma nova tela com o processo de instalação.
O processo de atualização está descrito abaixo:
Image Removed

Card

id	02
label	Configuração

Card

id	02
label	Configuração

Image Removed

Aviso
Para acesso ao SmartERP a conexão deve ser por HTTP informando apenas a url (Endpoint), na opção endereço.

Endereço:
Nessa opção deve ser preenchido o endereço fornecido pela TOTVS, para acesso ao ambiente.

Este endereço é fornecido no e-mail de boas vindas e também poderá ser coletado através do Portal T-CLOUD.

Para mais informações sobre o Portal T-CLOUD, clique aqui.

Ao término da configuração, clique na opção OK e inicie o ambiente. Com isso, o SmartClient já está apto para acessar o ambiente do Protheus.

Ao fazer o acesso será realizada configuração do Smartclient:

Image Removed

Aguarde e, após a conclusão e acesse o Protheus normalmente.

O processo completo está descrito abaixo:

Image Removed

Tire as suas dúvidas acessando às FAQs do produto.

Image Removed

...

web-Agent

Acessando a Tela de Parâmetros do WebApp, agora será exibida a tela para download dos instaladores:

Importante

🚨O Popup para instalação do WebAgent deixará de ser exibido assim que a primeira conexão entre ele e o Navegador for bem sucedida, para que não induza o usuário a instalar mais de uma vez a ferramenta.

🚨O checkbox "Não mostrar novamente" deve ser usado caso o usuário não precise instalar o WebAgent e também não queira que esta opção continue sendo exibida.

Image Added

O instalador vai sugerir o Sistema Operacional, caso utilize o Windows 64 bits, mas possua o Microsoft Office 32 bits, poderá instalar o WebAgent 32 bits para garantir essa integração, mais detalhes aqui.

Image Added

Processo de instalação

Deck of Cards

id	webagent1

Card

id	wa01
label	Windows

Para instalação no Windows

Após o download do instalador, basta iniciar sua instalação, que irá seguir sem intervenção do usuário.

Image Added

O programa ficará disponível no menu, como neste exemplo utilizando o Windows 11.

Image Added

O WebApp irá iniciar o WebAgent sempre que necessário a partir deste momento, mais detalhes consulte a seção Habilitar WebAgent na Tela de Parâmetros.

Apenas para testes, você pode iniciar a aplicação, será exibido o ícone na bandeja, como no exemplo abaixo.

Image Added

Card

id	wa02
label	Linux

Para instalação no Linux

Após baixar o arquivo para o seu respectivo Linux, sendo o arquivo .deb para Ubuntu e .rpm para o Red Hat.

Para Ubuntu Image Added

No diretório onde o arquivo .deb foi copiado

sudo apt install ./web-agent<versao>.deb

Caso tenha problema durante a instalação, o comando abaixo define o arquivo como um instalador, execute e na sequencia repita o comando acima

sudo chmod +x ./web-agent<versao>.deb

Para Red hat 8.x Image Added

Pré requisito: Necessário instalar a biblioteca libappindicator

sudo dnf install libappindicator-gtk3

No diretório onde o arquivo .rpm foi copiado

sudo dnf install ./web-agent<versao>.rpm

Caso tenha problema durante a instalação, o comando abaixo define o arquivo como um instalador, execute e na sequencia repita o comando acima

sudo chmod +x ./web-agent<versao>.rpm

Registro do Certificado (SSL) para uso do WebAgent

Para utilizar o Websocket Secure (wss) é necessário registrar o TOTVS Certificate em seu sistema operacional.

Image Added Para usuários Windows

O registro é automático para Windows 10/11, 32 ou 64 bits, e será efetivado na primeira execução do WebAgent.

🚨 Importante:
Na primeira execução do WebAgent, caso seja apresentada a tela de confirmação para o registro do certificado, selecione a opção Sim.

Image AddedPara usuários Linux

Image Added Ubuntu

Após a instalação do WebAgent
Localize o arquivo totvs_certificate_CA.crt na pasta /opt/web-agent
Acesse seu navegador e efetue o registro:
- Para o Google Chrome
  - Na barra de navegação digite: chrome://settings/certificates
  - Acesse: Authorities (autoridades)
  - Na sequência: Import (importar)
  - Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent
  - Selecione todos os Trusts, e por fim, o botão OK
    Image Added
- Para o Microsoft Edge
  - Na barra de navegação digite: edge://settings/privacy/manageCertificates
  - Acesse: Authorities (autoridades)
  - Na sequência: Import (importar)
  - Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent
  - Selecione todos os Trusts e Okay
    Image Added
- Para o Firefox
  - Na barra de navegação digite: about:preferences#privacy
  - Acesse: View Certificates… (verificar certificados)
  - Acesse: Authorities (autoridades)
  - Na sequência: Import (importar)
  - Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent
  - Selecione todos os Trusts e OK
    Image Added

Image Added Red Hat 8.x

- Para Google Chrome e o Firefox o registro do certificado segue os mesmos passos do Ubuntu.
- Para o Microsoft Edge:
  - O Edge utiliza o certificado do Sistema Operacional, utilize os comandos abaixo para resgistrar:
    - Copie o certificado da pasta do web-agent para a pasta de certificados
      - sudo cp /opt/web-agent/totvs_certificate_CA.crt /etc/pki/ca-trust/source/anchors/
    - Registre o certificado
      - sudo update-ca-trust
    - Verifique se o certificado foi instalado
      - trust list | grep TO
        label: TOTVS certificate CA
  - Acesse os links abaixo para mais informações:
    - https://docs.fedoraproject.org/en-US/quick-docs/using-shared-system-certificates/
    - https://www.redhat.com/sysadmin/ca-certificates-cli

Card

id	wa03
label	Mac

Image Added Para usuários macOS

Para mais detalhes acesse a documentação oficial da Apple aqui:

Após a instalação do WebAgent
Localize o arquivo totvs_certificate_CA.crt na pasta /Applications/web-agent.app/Contents/MacOS
No app Acesso às Chaves (keychain access) Image Added, selecione as chaves de início de sessão ou de Sistema.
Arraste o arquivo do certificado para o app Acesso às Chaves.
Configure a confiança do certificado clicando com o botão direito sobre o mesmo e escolhendo a opção Get Info. Na interface aberta expanda a opção Trust e coloque Always Trust para todas as opções disponíveis, conforme as imagens abaixo. Se for solicitado que você forneça um usuário, utilize um usuário com acesso de administrador.

Image AddedImage AddedImage Added

🚨 Repita o mesmo processo de registro do Certificado acima para o arquivo totvs_certificate.crt também na pasta /Applications/web-agent.app/Contents/MacOS

Importante
Atente-se à utilização dos certificados disponibilizados na pasta de instalação do WebAgent, não utilize os certificados da pasta de instalação do AppServer

Habilitar WebAgent na Tela de Parâmetros

Para habilitar o uso do WebAgent pelo WebApp, na Tela de Parâmetros, selecione o botão de configuração.

Image Added

Escolha a porta de inicialização do WebAgent (por padrão é a 21021).

Image Added

Na sequencia feche essa janela clicando no X na parte superior da janela de configuração.

Image Added

Assim que confirmar os dados na Tela de Parâmetros, será exibida a mensagem abaixo, solicitando autorização para abertura do WebAgent, basta clicar no botão Abrir.

Image Added

Após dez tentativas de conexão malsucedidas ou caso a solicitação de autorização seja ignorada, será exibida a seguinte mensagem: Falha ao conectar com o WebAgent!

Image Added

Para maiores informações, acesse: 2. WebApp - WebAgent

Card

id	Sm02
label	SmartClient \| Desktop (Descontinuado)

Deck of Cards

id	Smd01

Card

id	Smd01
label	Instalação

Faça o download do arquivo compactado do Smartclient | Desktop. pelo endereço: https://arte.engpro.totvs.com.br/public/tec/smartclient_harpia/auto-update

Image Added

Escolha a versão para o seu sistema operacional e clique em download

Image Added

Após realizar o download da versão do seu sistema operacional, realize o download do arquivo smartclient.ini, conforme abaixo:

Image Added

Descompacte o arquivo em um pasta (de sua preferencia) e copie o arquivo smartclient.ini para dentro desta pasta

Image Added

Após copiado o arquivo smartclient.ini para dentro da pasta, basta alterar o cxxxxx para o código da sua topologia.

Card

id	Smd02
label	Utilização

Após a conclusão da instalação, localize e execute o aplicativo Smartclient e de dois cliques sobre o aplicativo.

Image Added

Informações

Caso não tenha ajustado o smartclient.ini para o seu ambiente, será exibido uma tela que não é possivel realizar a conexão:

Image Added

...

HTML

<script>
	function linksToBlank(){
		var links = document.getElementsByTagName("a");
        var l = 0;
        for (var i = 0, l = links.length; i < l; i++) {
           links[i].target = "_blank";
        }
    }
	window.onload = linksToBlank;
</script>

...

Árvore de páginas

Versões comparadas

Versão antiga 31

Nova versão Atual

Chave

Precisa de ajuda?

Image Added

Image Removed

À partir do release 12.1.2410 (Outubro/2024) o SmartClient Desktop será descontinuado e deverá ser instalado o TOTVS | Web-Agent

Processo de instalação

Para instalação no Windows

Para instalação no Linux

Para Ubuntu Image Added

Para Red hat 8.x Image Added

Registro do Certificado (SSL) para uso do WebAgent

Image Added Para usuários Windows

Image AddedPara usuários Linux

Image Added Ubuntu

Image Added Red Hat 8.x

Image Added Para usuários macOS

Habilitar WebAgent na Tela de Parâmetros

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 31

Nova versão Atual

Chave

Precisa de ajuda?

Image Added

Image Removed

À partir do release 12.1.2410 (Outubro/2024) o SmartClient Desktop será descontinuado e deverá ser instalado o TOTVS | Web-Agent

Processo de instalação

Para instalação no Windows

Para instalação no Linux

Para Ubuntu Image Added

Para Red hat 8.x Image Added

Registro do Certificado (SSL) para uso do WebAgent

Image Added Para usuários Windows

Image AddedPara usuários Linux

Image Added Ubuntu

Image Added Red Hat 8.x

Image Added Para usuários macOS

Habilitar WebAgent na Tela de Parâmetros