Process activity
Process activity () : Object
Process activity ( options ) : Object
Process activity ( sessionID ) : Object
Process activity ( sessionID ; options ) : Object
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| sessionID | Text | → | ID da sessão |
| options | Integer | → | Opções de retorno |
| Resultado | Object | ← | Snapshot de sessões de usuários em execução e/ou (apenas 4D Servidor) |
História
| Release | Mudanças |
|---|---|
| 20 R7 | Suporte do parâmetro sessionID |
Descrição
O comando Process activity retorna um snapshot dos processos em execução e/ou (4D Server apenas) sessões usuário conectadas em um dado momento. Este comando retorna todos os processos, incluindo processos internos que não são alcançáveis pelo comando Informações do processo.
Por padrão quando usado sem quaisquer parâmetros, a atividade de processo retorna um objeto que contém as seguintes propriedades:
- "processos", uma coleção de todos os processos
- "sessões" (apenas 4D Servidor), uma coleção de todas as sessões
No 4D Server, você pode filtrar informações para serem retornadas usando os parâmetros opcionais sessionID e options:
- Se você passar um ID de sessão de usuário no parâmetro sessionID, o comando retorna somente informações relacionadas a esta sessão. Por padrão se o parâmetro options for omitido, o objeto retornado contém uma coleção com todos os processos relacionados à sessão e uma coleção com um único objeto descrevendo a sessão. Se você passar um ID de sessão inválido, um objeto null será retornado.
- Você pode selecionar a(s) coleção(ões) a retornar passando uma das seguintes constantes no parâmetro options:
| Parâmetros | Valor | Comentário |
|---|---|---|
| Processes and sessions | 0 | Retorna as listas "processos" e "sessões" (valor padrão) |
| Processes only | 1 | Retorna apenas a lista de "processos" |
| Somente sessões | 2 | Retorna apenas a lista de "sessões" |
Quando executado em 4D em modo remoto ou local, Processar atividade sempre retorna a lista de processos em execução (sessionID e parâmetros de opções são ignorados).
Sessões
A propriedade "sessões" contém uma coleção de objetos descrevendo todas as sessões em execução no servidor. Para obter uma descrição das propriedades do objeto de sessão, consulte o comando Session info.
- Você pode obter o objeto de uma sessão usando o comando Session.
- 'Process ativity' retorna sessões de cliente remoto, sessão de procedimento armazenado e sessões repouso, mas não sessões Web (limitação).
Processos
A propriedade "processes" contém uma coleção de objetos de processo descrevendo todos os processos em execução. Para obter uma descrição das propriedades do objeto de processo, consulte o comando Process info.
No servidor, o comando Process activity retorna uma propriedade adicional de "session":
| Propriedade adicional | Tipo | Descrição | |
|---|---|---|---|
| session | Object | A propriedade .info da sessão onde o processo está sendo executado. Indefinido se o parâmetro Processes only for passado. |
Exemplo 1
Se quiser obter a coleção de todas as sessões de usuários:
//Para ser executado no servidor
var $o : Object
var $i : Integer
var $processName;$userName : Text
$o:=Process activity //obter informação de processo e sessão
For($i;0;($o.processes.length)-1) //Iterar sobre a coleção "processes"
$processName:=$o.processes[$i].name
$userName:=String($o.processes[$i].session.userName) // Acesso fácil a userName
//use String porque o objeto de sessão pode ser indefinido
End for
Exemplo 2
Se quiser obter todos os processos relacionados à sessão atual:
//a ser executado no servidor
var $sessionID : Text:=Session.id
var $o : Object
$o:=Process activity($sessionID ;Processes only)