Pular para o conteúdo principal

Postagem em destaque

🚀 Oferecendo Serviços Remotos de Desenvolvedor AdvPL e Mais 🖥️

🚀 Oferecendo Serviços Remotos de Desenvolvedor AdvPL e Mais 🖥️ Olá pessoal, Espero que este post encontre todos vocês bem! É com grande entusiasmo que compartilho que estou expandindo meus serviços como Desenvolvedor AdvPL para novos desafios e colaborações. Com mais de duas décadas de experiência sólida, minha jornada profissional tem sido enriquecedora, com a oportunidade de participar de projetos empolgantes ao longo dos anos. Agora, estou ansioso para trazer minha experiência e habilidades para novas equipes e projetos, trabalhando de forma remota. Minha expertise abrange não apenas AdvPL, mas também outras tecnologias-chave, incluindo JS, SQL, Infraestrutura e Otimização de Processos. Acredito que essa combinação de conhecimentos me permite oferecer soluções abrangentes e eficazes para uma variedade de necessidades de desenvolvimento. Acredito que a tecnologia tem o poder de transformar negócios e impulsionar o sucesso, e estou comprometido em ajudar meus clientes a alcançar seu

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.

image

image

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:

image

Vamos ao registro.

image

image

image

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();

image


image


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


image


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





$TObj | Get-Member -MemberType Properties

image


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














image


image





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()

image





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

image


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();

image





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

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','');

image 






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


image


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);

image






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


image


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


image


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





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

image


image


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





$TObj.Disconnect()










image


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

image


[]s
иαldσ dj

Comentários

  1. Cara, que artigo interessante, parabéns novamente...

    Queria saber como descobre estes componentes... (lets share ?) hehe...

    ResponderExcluir
  2. Ao tentar instanciar o objeto, me ocorria o seguinte erro:

    PS C:\Windows\system32> $TObj = New-Object -Com APConnXControl.APConnX;
    New-Object : Falha na recuperação de factory de classes COM do componente com CLSID {B1C965EB-64A4-4084-83D1-26902EF88DE5} devido ao seguinte erro: 80040154.
    Em linha:1 caractere:20
    + $TObj = New-Object <<<< -Com APConnXControl.APConnX;
    + CategoryInfo : ResourceUnavailable: (:) [New-Object], COMException
    + FullyQualifiedErrorId : NoCOMClassIdentified,Microsoft.PowerShell.Commands.NewObjectCommand

    Descobri que é por que o OCX está em 32bits, e eu estava executando o PowerShell 64bits.

    Se rodar do PowerShell 32 bits funciona normal. Agora vamos ver se a TOTVS libera uma versão 64bits também.

    ResponderExcluir
  3. No Visual Studio 2017 acontece o mesmo problema do Arthur.
    Se rodar no PS x86 funciona muito bem, mas ao tentar consumir este componente no Visual Studio acaba dando problema.

    ResponderExcluir

Postar um comentário

Postagens mais visitadas deste blog

BlackTDN :: RLeg ~ Desvendando a Função ParamBox

Para quem precisar desenvolver uma interface de entrada de dados, coisa rápida, e não quer ter aquele trabalhão danado que todos já sabemos, o Protheus tem uma função que ajuda muito, é uma interface semelhante a função Pergunte, porém com muito mais opção de objeto de entrada de dados, alias até colocar o scrollbox desta interface com todos os objetos em outra MsDialog ou Wizard é simples. Vejam o exemplo abaixo, boa sorte! Rleg. //---------------------------------------------------------- // Função exemplo utilizando a função ParamBox() //---------------------------------------------------------- User Function xParamBox() Local aRet := {} Local aParamBox := {} Local aCombo := {"Janeiro","Fevereiro","Março","Abril","Maio","Junho","Julho","Agosto","Setembro","Outubro","Novembro","Dezembro"} Local i := 0 Private cCadastro := "xParambox" // ---------------

BlackTDN :: Customizando a interface de Login no Protheus e by You

A publicação “ BlackTDN :: By You e sua nova tela de login ”  de nosso amigo OBona deu o que falar e, em função disso, esse que a muito não vos escreve resolveu criar uma versão onde será possível personalizar, “por completo”, a tela de login no Protheus/by You. Considerando que OBona já havia “mapeado, identificado e customizado” as imagens peguei-as emprestadas para o exemplo que se segue: O primeiro passo para a customização “total” da interface de login do Protheus/by You será implementar o “Ponto de Entrada” ChgPrDir (Diretório de impressão) . Usaremos esse PE juntamente como programa U_FindMsObject.prg (apresentado pela primeira vez em: Protheus :: ADVPL : The Container : Presents Pandora's box ). Diferente do exemplo proposto por OBona, que substitui, durante o processo de compilação, as imagens padrões do sistema (excluindo-as) por imagens customizadas (com o mesmo nome) este novo exemplo mantém, no RPO, as imagens padrões adicionando novas imagens customizadas que serã

Protheus :: Chamando Funções do Menu Diretamente e sem a Necessidade de Login

Ferne$ perguntou: "...é possível abrir alguma rotina do sistema sem solicitar login ao usuário, como por exemplo a rotina MATA010..." Sim Ferne$, é possível sim. Abaixo um Exemplo para a Chamada à função MATA010 sem a necessidade de Login no sistema. #INCLUDE "PROTHEUS.CH" #INCLUDE "TBICONN.CH" /*/ Funcao: MATA010Ex Data: 30/04/2011 Autor: Marinaldo de Jesus Descricao: Executar a Funcao MATA010 diretamente sem a necessidade de LOGIN no Protheus Sintaxe: 1 ) U_MATA010Ex ( Chamada diretamente na Tela de Entrada do Sistema ) ; ou 2 ) totvsclient.exe -q -p=u_MATA010Ex -a=01;01 -c=rnp_local -e=rnp -m -l ( Chamada Via Linha de Comando ) /*/ User Function MATA010Ex( cEmpFil ) Local aEmpFil Local bWindowInit := { || __Execute( "MATA010()" , "xxxxxxxxxxxxxxxxxxxx" , "MATA010" , "SIGAFAT" , "SIGAFAT", 1 , .T. ) } Local cEmp Local cFil Local cMod Local cModName := "SIGAFAT" DEFA