Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Precisa de ajuda?

Livesearch
spaceKeyPROT
sizelarge
placeholderEstou procurando por ...
typepage
labelssmarterp

Section
Painel
borderColorgrey
borderWidth1

Image Modified












O TOTVS | Web-Agent / SmartClient (Descontinuado) é responsável pela conexão entre a máquina do usuário e o SmartERP Protheus. 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.

Veja como instalar e utilizar o Smartclient:


Aviso

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

Smartclient
Deck of Cards
idSmartclient
Card
idsm01
labelweb-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
idwebagent1
Card
idwa01
labelWindows

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
idwa02
labelLinux

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:
Card
idwa03
labelMac

Resultado de imagem para logo apple 2020 pngImage 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

Deck of Cards
id

Card
idSm02
labelSmartClient | Desktop (Descontinuado)
Deck of Cards
idSmd01
Card
idSmd01
labelInstalaçã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

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


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


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

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

Card
idSmd02
labelUtilização

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

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:







...