Image Modified
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. Lembre-se sempre de estar com o aplicativo atualizado em sua última versão.
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 |
---|
| Card |
---|
| 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 |
| Veja como instalar e utilizar o Smartclient Electron: | ID1 | 01 | Instalação | | Expandir |
---|
title | Instalação do Smartclient Electron Faça 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 |
---|
Expandir |
---|
title | Instalação do Smartclient Electron no Linux |
---|
| A partir da versão 4.4.0, disponibilizamos o SmartClient Electron para o ambiente Linux, basta instalar o RPM ou executar diretamente via bash e proceder com as configurações conforme descrito abaixo (igual ao windows) |
Expandir |
---|
title | Instalação do Smartclient Electron no MacOS |
---|
| A partir da versão 4.4.0, disponibilizamos o SmartClient Electron para o ambiente Mac, basta instalar o DMG em seu ambiente e proceder com as configurações conforme descrito abaixo (igual ao windows) |
Expandir |
---|
title | Instalação do Smartclient Electron em gadgets |
---|
| Para ambientes Android e IOS, não há a necessidade de instalação do SmartClient Electron, pois estes não possui interface de integração com periféricos como coletores de dados e/ou impressoras. Desta forma, poderá acessar o SmartERP diretamente pelo link fornecido no portal TCLOUD. |
|
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á apresentada 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 |
---|
| | Card |
---|
| Após a conclusão da instalação, localize e execute o aplicativo Smartclient. Image Removed A tela para acesso ao ambiente será exibida: Image Removed | 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. Image Removed | 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: Image Removed | 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. 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, acesse o Protheus normalmente. O processo completo está descrito abaixo: Image Removed Aviso |
---|
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 |
---|
| Para instalação no LinuxApó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 WindowsO 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 |
|
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 |
---|
| Card |
---|
| 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 |
---|
| 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 |
|
|
| Caso ao abrir a tela do SmartClient Electron a mesma fique em branco ou apareça uma mensagem de erro em vermelho ("Exceção de programa"), isto pode ser um indicativo de falta de atualização do programa. Recomendamos a sempre estarem na ultima versão disponibilizada e que sempre execute o auto-update do SmartClient Electron.
|
|