Protheus :: apconnxcontrol.ocx & PowerShell – Forçando a Desconexão de Usuário

Hoje veremos que usando o componente COM do protheus, podemos, através do Windows PowerShell Obter o estado de conexão dos usuários e forçar a sua desconexão.

Em primeiro lugar faz-se necessária a instalação do componente e, para isso, utilizaremos o programa regsvr32.exe que, normalmente, encontra-se em c:\WINDOWS\system32\regsvr32.exe.

Instalando o compomente:

Pelo console do DOS ou do PowerShell vá para o diretório onde está instalado o client do Protheus, no meu caso em: D:\totvs\p10\ndj\appclient.

Procure o arquivo apconnxcontrol.ocx, se não encontrar existe alguma coisa errada, “que não está certa”, na sua instalação (contate “Juan”).

Utilize agora o programa regsvr32.exe para instalar/registrar o componente. regsvr32.exe sem parâmetros irá mostrar a seguinte saída:

Vamos ao registro.

Feito o registro do componente vamos utiliza-lo. Usarei o PowerGui Script Editor para esse fim (poderá fazê-lo diretamente no console do PowerShell).

#Instanciando um novo objeto com $TObj = New-Object -Com apconnxcontrol.apconnx; #Definindo as variaveis para Conexao $TEnv = "NDJ_01"; $TSrv = "127.0.0.1"; $TPort = 4321; $TUser = "TOTVS"; $TPWD = "SIGA"; #Atribuindo as variaveis para Conexao às Propriedades do objeto $TObj.Environment = $TEnv; $TObj.Password = $TPWD; $TObj.Port = $TPort; $TObj.Server = $TSrv; $TObj.User = $TUser; #Conectando $TObj.Connect();

 

   1: #Instanciando um novo objeto com 

   2: $TObj  = New-Object -Com apconnxcontrol.apconnx;

   3:  

   4: #Definindo as variaveis para Conexao

   5: $TEnv  = "NDJ_01";

   6: $TSrv  = "127.0.0.1";

   7: $TPort = 4321;

   8: $TUser = "TOTVS";

   9: $TPWD  = "SIGA";

  10:  

  11: #Atribuindo as variaveis para Conexao às Propriedades do objeto

  12: $TObj.Environment = $TEnv;

  13: $TObj.Password    = $TPWD;

  14: $TObj.Port        = $TPort;

  15: $TObj.Server      = $TSrv;

  16: $TObj.User        = $TUser; 

  17:  

  18: #Conectando

  19: $TObj.Connect();

Se tudo OK, a última saída do console será: True

Vamos agora ver com o que podemos brincar. Obtendos os Métodos e Propriedades do Objeto COM:

$TObj | Get-Member -MemberType Properties

A saída do console para as propriedades:

PS C:\Documents and Settings\marinaldo.jesus.NALDO-PC\Meus documentos> $TObj | Get-Member -MemberType Properties TypeName: System.__ComObject#{36abe2f0-84fb-490e-9f73-bfdd33cf8162} Name MemberType Definition ---- ---------- ---------- BackColor Property OLE_COLOR BackColor () {get} {set} Caption Property string Caption () {get} {set} CaptionColor Property OLE_COLOR CaptionColor () {get} {set} CaptionSize Property int CaptionSize () {get} {set} Connected Property bool Connected () {get} Cursor Property short Cursor () {get} {set} DateFormat Property string DateFormat () {get} {set} DoubleBuffered Property bool DoubleBuffered () {get} {set} EnableConnections Property bool EnableConnections () {get} {set} Enabled Property bool Enabled () {get} {set} Environment Property string Environment () {get} {set} FontSize Property int FontSize () {get} {set} ForeColor Property OLE_COLOR ForeColor () {get} {set} LastError Property string LastError () {get} Modulo Property string Modulo () {get} {set} Password Property string Password () {get} {set} Port Property int Port () {get} {set} ResultType Property short ResultType () {get} Server Property string Server () {get} {set} ShowCaption Property bool ShowCaption () {get} {set} ShowErrors Property bool ShowErrors () {get} {set} User Property string User () {get} {set} Visible Property bool Visible () {get} {set} VisibleDockClientCount Property int VisibleDockClientCount () {get}

e, agora para os Métodos:

$TObj | Get-Member -MemberType Methods

Name MemberType Definition ---- ---------- ---------- AboutBox Method void AboutBox () AddArrayParam Method bool AddArrayParam (Variant) AddDateParamAsDouble Method bool AddDateParamAsDouble (double) AddDateParamAsString Method bool AddDateParamAsString (string) AddJavaArrayParam Method bool AddJavaArrayParam (string, Variant) AddLogicalParam Method bool AddLogicalParam (bool) AddNullParam Method bool AddNullParam () AddNumericParam Method bool AddNumericParam (double) AddStringParam Method bool AddStringParam (string) BuildNumber Method string BuildNumber () CallProc Method bool CallProc (string) Clear Method void Clear () Connect Method bool Connect () Disconnect Method void Disconnect () DisconnectUser Method bool DisconnectUser (string, string, string, string, bool) DrawTextBiDiModeFlagsReadingOnly Method int DrawTextBiDiModeFlagsReadingOnly () GetUserInfo Method string GetUserInfo (string, string, string, string) GetUsers Method string GetUsers () GetUserScreen Method bool GetUserScreen (string, string, string, string, string) InitiateAction Method void InitiateAction () IsRightToLeft Method bool IsRightToLeft () Paint Method void Paint () PrepareEnv Method bool PrepareEnv (string, string, string, Variant) ResultAsArray Method Variant ResultAsArray () ResultAsDate Method double ResultAsDate () ResultAsDateString Method string ResultAsDateString () ResultAsLogical Method bool ResultAsLogical () ResultAsNumeric Method double ResultAsNumeric () ResultAsString Method string ResultAsString () SendMessage Method bool SendMessage (string, string, string, string, string) StartJob Method bool StartJob (string, string, bool) TextOut Method void TextOut (string) UseRightToLeftReading Method bool UseRightToLeftReading () UseRightToLeftScrollBar Method bool UseRightToLeftScrollBar () UsersCount Method int UsersCount ()

Usando o Método UsersCount() para verificar o número de usuários conectados:

$TObj.UsersCount()

PS C:\Documents and Settings\marinaldo.jesus.NALDO-PC\Meus documentos> $TObj.UsersCount();2

No exemplo, eu, via Protheus Remote e via PowerShell (através do PowerGui Script Editor). Vejamos agora, usando o Método GetUsers() , as informações dos usuários conectados:

$TObj.GetUsers();

PS C:\Documents and Settings\marinaldo.jesus.NALDO-PC\Meus documentos> $TObj.GetUsers();marinaldo.jesus;NALDO-PC;4764; ;2732;1769103725;naldo.jesus

Vamos Obter as informações de conexão para o usuário ‘marinaldo.jesus’ usando GetUserInfo(string, string, string, string) onde a saída da função anterior servirá como entrada para a função atual.

$TObj.GetUserInfo('marinaldo.jesus','NALDO-PC','4764','');

 

PS C:\Documents and Settings\marinaldo.jesus.NALDO-PC\Meus documentos> $TObj.GetUserInfo('marinaldo.jesus','NALDO-PC','4764',''); SIGAMDI;ndj_01;102940;0;Emp :01/01 Logged :TOTVS                     MDI       Obj : MDI Window;Mon Jan 09 0 2:50:01 2012 ;00:11:41

E vamos forçar a desconexão desse usuário com: DisconnectUser(string, string, string, string, bool)

$TObj.DisconnectUser('marinaldo.jesus','NALDO-PC','4764','',$true);

PS C:\Documents and Settings\marinaldo.jesus.NALDO-PC\Meus documentos> $TObj.DisconnectUser('marinaldo.jesus','NALDO-PC','4764','',$true); True

Nesse Primeiro Exemplo, enviamos um Kill informando que é para aguardar pelo termino do Processamento

Já, passando o último parâmetro como $false, solicitamos a desconexão IMEDIATA.

$TObj.DisconnectUser('marinaldo.jesus','NALDO-PC','4764','',$false);

Finalizando a Conexão com o Protheus : Disconnect()

$TObj.Disconnect()

Lembrando que, para remover o registro do componente, basta executar regsvr32.exe com o parâmetro /u

D:\totvs\p10\ndj\appclient>regsvr32.exe /u apconnxcontrol.ocx

[]s
иαldσ dj