4D Doc Center : GET ACTIVITY SNAPSHOT

4D v14.3

GET ACTIVITY SNAPSHOT


GET ACTIVITY SNAPSHOT ( arrActivities \| arrUUID ; arrInicio ; arrDuracao ; arrInfo {; arrSubOp}{; *} )

Parâmetro	Tipo	Descrição
arrActivities \| arrUUID	Object array, Array texto	Descrição completa de operações (object array) ou UUIDs das operações (text array)
arrInicio	Array texto	Horas de início das operações
arrDuracao	Array inteiro longo	Duração das operações em segundos
arrInfo	Array texto	Descrição
arrSubOp	Object array	Sub operações
*	Operador	Se passar = Trazer atividade do servidor

Descrição

O comando GET ACTIVITY SNAPSHOT retorna um array ou vários que descrevem as operações em progresso sobre os dados 4D. Estas operações usualmente mostram uma janela de progresso.

Este comando se usa para trazer uma imagem das x operações que mais consumem tempo e/ou que passam mais frequentemente, tais como escritura de cachê ou execução de fórmulas.

Nota: a informação devolvida pelo comando GET ACTIVITY SNAPSHOT é a mesma mostrada na página "Monitor em tempo real" (RTM) da janela de administração de 4D Server (veja o Manual de 4D Server).

Por padrão, GET ACTIVITY SNAPSHOT processa as operações realizadas a nível local (com 4D autônomo, 4D Server ou 4D em modo remoto). No entanto, com 4D em modo remoto, também pode obter uma instantânea das operações realizadas no servidor: só tem que passar o asterisco (*) como último parâmetro. Neste caso, o servidor de dados se recupera localmente.
O parâmetro * se ignora quando o comando se executa em 4D Server ou 4D autônomo.

O comando GET ACTIVITY SNAPSHOT aceita duas sintaxes:

sintaxe usando somente um array de objetos.
sintaxe utilizando vários arrays.

Primeira sintaxe: GET ACTIVITY SNAPSHOT ( {* ;} arrActivities )

Com esta sintaxe, todas as operações se devolvem em um formulário estruturado no array de objetos 4D (arrActivities). Cada elemento do array é um objeto construído da seguinte maneira:

progressIndicator :{
    ID: string
    StartTime: 12:15:20:0054
    Duration: 501
    Title: String,
    sub-operations: [
        {
            Title: string,
            Start time: string,
            Duration: number (milliseconds)
        },
        {
            Title: string,
            Start time: string,
            Duration: number (milliseconds)
        }
    ]
}

Esta é uma descrição de cada propriedade devolvida:

message (texto): etiqueta da operação
maxValue (número): número de interações definidas para a operação (-1 se a operação não é interativa)
currentValue (número): interação atual
interruptible (número): a operação pode ser interrompida pelo usuário (0=true, 1=false)
remote (número): operação por pares entre cliente e servidor (0=true, 1=false)
uuid (texto): identificador UUID da operação
taskId (número): identificador interno do processo na origem da operação
startTime (texto): a hora de início da operação em formato "aaaa:mm:dd hh:mm:ss:mls"
duration (número): duração da operação em milisegundos
subOperations (array): array de objetos que contém sub operações da operação atual (se existe). A estrutura de cada sub elemento é idêntica a do objeto principal. Se a operação atual não tem sub operações, então subOperations está vazio.

Segunda sintaxe: GET ACTIVITY SNAPSHOT ( {* ;} arrUUID ; arrStart ; arrDuration ; arrInfo {;arrSubOp} )

Com esta sintaxe, todas as operações se devolvem em vários arrays sincronizados (cada operação provoca que um elemento se adiciona a todos os arrays). Os seguintes arrays se devolvem:

arrUUID: contém os identificadores UUID para cada operação (corresponde a propriedade uuid do objeto arrActividades na sintaxe anterior).
arrInicio: contém as horas de início de cada operação (corresponde a propriedade startTime do objeto arrActividades ).
arrDuracao: contém as durações de cada operação em milissegundos (corresponde a propriedade duration do objeto arrActividades ).
arrInfo: contém as etiquetas que descrevem cada operação (corresponde a propriedade message do objeto arrActividades ).
arrSubOp (opcional): cada elemento deste array é um objeto que contém a propriedade "sub Operações". O valor desta propriedade é um array objeto que contém todas as sub-operações da operação atual. Se a operação atual não tem sub operações, o valor da propriedade sub operações é um array vazio (corresponde a propriedade subOperations do objeto arrActivities).

Exemplo

Este método, executado em um processo separado em 4D ou 4D Server, oferece uma instantânea das operações que estão em marcha:

 ARRAY TEXT(arrUUID;0)

 ARRAY TEXT(arrStart;0)

 ARRAY LONGINT(arrDuration;0)

 ARRAY TEXT(arrInfo;0)

 

 Repeat

    GET ACTIVITY SNAPSHOT(arrUUID;arrStart;arrDuration;arrInfo)

    If(Size of array(arrUUID)>0)

       TRACE // chamada do depurador

    End if

 Until(False) // Bucle infinito

Obtém arrays do tipo: