Process activity

4D v20 R7

Process activity


Process activity {( {sessionID}{;}{opções} )} -> Resultado

Parâmetro	Tipo	Descrição
sessionID	Texto	Session ID
opções	Inteiro longo	Retorna opções
Resultado	Objeto	snapshot dos processos executando ou sessões de usuário (apenas em 4D Server)

Descrição

O comando Process activity devolve uma instantanea dos processos ou (4D Server unicamente) sessões de usuário conectados dos processos relacionados que são executados em um momento dado. Este comando devolve todos os processos, incluindo os processos internos que não sejam acessíveis pelo comando Process info.

Por padrão, quando se utiliza sem nenhum parâmetro, Process activity devolve um objeto que contenha as seguintes propriedades:

"processes", uma coleção de todos os processos
"sessions" (só 4D Server), uma coleção de todas as sessões

Em 4D Server, pode filtrar a informação a devolver utilizando os parâmetros opcionaisl sessionID e opcoes:

Se passar um ID de sessão de usuario no parámetro sessionID, o comando só devolve informação relacionada com esta sesão. Por padrão, se for omitido o parámetro opcoes, o objeto devolvido contém uma coleção com todos os processos relacionados com a sessão e uma coelção com um único objeto que descreva a sessão. Se for passado um ID de sessão não válido, um objeto null é devolvido.

Pode selecionar as coleções a devolver passando uma das seguintes constantes do tema "Ambiente 4D" no parâmetro opcoes:

Constante	Tipo	Valor	Comentário
Processes and sessions	Inteiro longo	0	Devolva as listas "process" e "sessions" (valor padrão)
Processes only	Inteiro longo	1	Retorna apenas a lista de processo
Sessions only	Inteiro longo	2	Retorna apenas a lista de sessão do usuário

Nota: quando se executar em 4D em modo remoto ou local, Process activity só devolve a lista de processos em execução (os parâmetros sessionID e opcoes são ignoradas).

Lista de sessões

A propriedade "sessões" contém uma coleção de objetos descrevendo todas as sessões de usuário rodando no servidor.

Cada objeto de sessão contém as propriedades abaixo:

Notas:

Process activity devolve sessões de clientes remotos, sessões de procedimentos armazenados e sessões restantes, mas não sessões Web (limitação).]

Pode obter o objeto do cliente atual ou sessão de procedimento armazanado usando o comando Session.

Lista Processo

A propriedade "processo" contém uma coleção de objetos processos que descrevem todos os processos em execução.

Para obter uma descrição das propriedades dos objetos processo, consulte o comando Process info.

No servidor, o comando Process activity devolve uma propriedade adicional "session":

Propriedade adicional	Tipo	Descrição
session	Objeto	A propriedade .info da sessão na que se está executando o processo. Indefinido se for passado no parámetro Processes only.

Exemplo 1

Se quiser obter a coleção de todas as sessões de usuário:

  //A ser executado no servidor</p> <p>

 C_OBJECT($o)

 C_LONGINT($i)

 

 $o:=Get process activity //Obtém informações de processo e sessão

 For($i;0;($o.processes.length)-1) //Itera sobre a coleção de "processos"

    $processName:=$o.processes[$i].name

    $userName:=String($o.processes[$i].session.userName) // Acesso fácil ao userName

  //usa String porque objeto sessão pode estar indefinido

 End for

Exemplo 2

Se quiser obter todos os processos relacionados à sessão atual:

  // Para executar no servidor

 var $sessionID : Text:=Session.id

 var $o Object</p><p>$o: :=Process activity($sessionID ;Processes only)

Ver também

_o_PROCESS PROPERTIES
Process info
Session storage by ID
WEB Get server info