Verificando a instalação

Para verificar se o PROBAT está disponível e qual a sua versão, basta utilizar a seguinte instrução:

function sampleIsProbat()

  local jModule

  if ( tlpp.module( 'PROBAT', @jModule ) )
    conout( 'Ferramenta: ' + jModule['module'] )
	conout( 'Instalado?: ' + if( jModule['linked'], 'sim', 'não' ) )
	conout( 'Versão....: ' + jModule['version'] )
  else
	conout( ' >> Ferramenta não instalada <<' )
  endif

return Nil

Saiba mais sobre esse recurso em:

Ambiente: verificando existência dos módulos

Para utilizar o PROBAT, será necessário primeiro obter e instalar a ferramenta em seu ambiente.

Recomendamos fortemente que não seja instalado em seu ambiente de produção, sendo indicado separar um ambiente para testes.

Veja os passos a seguir:

1 - Download

Primeiro será necessário fazer download dos pacotes do produto para aplicar em seu ambiente.
Para isso, utilize a página de DOWNLOAD do tlppCore e busque os pacotes do PROBAT (Test Engine).

https://tdn.totvs.com/display/tec/Downloads

Você precisará de 2 (dois) arquivos, sendo:

• tlpp-probat.th
• probat_{versao_appserver}.ptm

2 - Include

Ao obter o arquivo tlpp-probat.th, copie-o para a mesma pasta de includes que você utilize em seu ambiente.
Caso queira utilizar uma pasta diferentes dos includes do Protheus, não pode esquecer de informar essa nova pasta em seu VsCode.

Todos os seus fontes de testes deverão importar a include do PROBAT, como o exemplo abaixo:

#include "tlpp-probat.th"

3 - Patch

Haverá dois patchs para download, portanto no passo anterior obtenha o patch conforme a versão de seu appserver, ou seja, Lobo-Guará ou Harpia.

• probat_LoboGuara.ptm
  ou
• probat_Harpia.ptm

A aplicação do patch é simples e segue igualmente o processo de todo patch e podem ser realizado de duas maneiras:

• VsCode

Siga as instruções conforme documentação da extensão oficial da TOTVS:

...

• Linha de comando

O appserver possui o recurso de se aplicar patch através de linha de comando, como o exemplo abaixo:

appserver.exe -compile -applypatch -files=D:\totvs\patch\probat_Harpia.ptm -env=advplc -applyoldprogram

...