O comando LOG FILE TO JSON salva em formato JSON o arquivo de histórico atual ou todo arquivo de histórico especificado.

Quando o histórico (arquivo binário) for salvado em JSON, seu conteúdo pode ser lido e interpretado pelo administrador do banco de dados ou por qualquer usuário com o objetivo de analisar os eventos do banco de dados, por exemplo.

Em rotaPastaDest, passe a rota da pasta na que deseja armazenar o arquivo JSON. Este arquivo se chama JournalExport.json.

De forma pré-determinada, o tamanho máximo do arquivo JSON exportada é de 10 MB. Quando for alcançado este tamanho, o arquivo é fechado e é criado um novo arquivo. Limitar o tamanho de cada arquivo JSON reduz as exigências de memória para a análise dos arquivos. Pode mudar o tamanho máximo para o arquivo exportado definindo um valor (em bytes) no parâmetro tamMax. Passar 0 restaura o tamanho pré-determinado. Passar um valor negativo elimina todo limite de tamanho. 

De forma pré-determinada, se o parâmetro rotaHist, for omitido o comando salva o arquivo de histórico atual. Se desejar exportar um arquivo de histórico específico, passe sua rota no parâmetro rotaHist. O arquivo de histórico deve ser um arquivo com uma extensão ".journal". Se desejar exportar um arquivo de histórico arquivado (extensão ".4bl"), é necessário converter o arquivo anteriormente com o comando RESTORE. Pode passar uma string  vazia ("") para mostrar o diálogo padrão de abrir arquivo, o que permite ao usuário selecionar o arquivo de histórico a salvar. A rota do arquivo de histórico selecionado é devolvido na variável sistema Document.

Nota: quando o comando guardar o arquivo de histórico atual, o banco de dados não está bloqueado. As novas operações podem ser executadas enquanto o arquivo é escrito no disco, estas operações não são incluidas no arquivo salvo.

Quando exportar o arquivo de historial atual, o parâmetro atribCampo lhe permite definir como se descrevem os campos no atributo exportado: por número (pré-determinado), ou por nome. Pode passar uma das seguintes constantes, que se encontra no tema "Backup":

Nota: quando exportar um arquivo de histórico externo, os campos sempre se identificam por seu número.

O arquivo JSON salvo contém todas as operações registradas no histórico, em forma de um array de objetos JSON. Cada objeto contém várias propriedades que descrevem a operação. Exemplo:

Nota: se passou Field attribute with name no parâmetro atribCampo, o objeto "fields" conterá:

A lista atual de propriedades disponíveis depende do tipo de operação  (por exemplo: criar registros, apagar registros, modificar registros, etc.). Aqui estão algumas das propriedades principais:

• operationType: código interno para a operação
• operationName: tipo da operação, por exemplo "criar registro", "modificar registro"
• operationNumber: número interno da operação no arquivo de log
• contextID: ID do contexto da execução
• timeStamp: timestamp da operação no arquivo de log
• dataLen: tamanhos dos dados
• recordNumber: número interno do registro
• tableID: ID interna da tabela
• tableName: nome da tabela
• fields: objeto contendo a lista dos nùmeros de campo (ou nomes de campo) com seus valores. Quaisquer campos com um valor modificado estão logados.
  No caso de valores  Blob ou imagem, diferentes informações são oferecidas baseadas na localização do armazenamento:
  
  • Se o Blob ou imagem for armazenado dentro do arquivo de dados, a propriedade será  "BlobID:"+ um número interno Blob, por exemplo: "BlobID:1"
  • Se o Blob ou imagem for armazenado fora do arquivo de dados, a propriedade será "BlobPath:" + o caminho para os dados, por exemplo: "BlobPath: Table 1/Field 6/Data_EE12D091535F9748BCE62EDE972A4BA2.jpg"
• extraData: dados contextual de usuário, incluindo nome do usuário e  ID, nome de tarefa e ID, nome da máquina host, e versão cliente.
• sequenceNumber: número atual com sequência de auto incremento.
• primaryKey: valor da chave primária.

Para exportar o arquivo atual de journal em JSON:

Para exportar um arquivo de journal arquivado em  JSON:

Ocomando LOG FILE TO JSON modifica o valor das variáveis OK e Document: se o arquivo JSON for guardado corretamente, OK toma o valor 1 e Document contem o nome de rota do arquivo de histórico. Se for passado "" no parâmetro rutaLog e o usuário cancelar o quadro de diálogo de seleção de arquivos, OK toma o valor 0 e o Document contém uma string vazia. Se o usuário selecionar um arquivo não válido, OK toma o valor 0 e o documento contém a rota do arquivo.