Precisa de criar um documento View Pro 4D usando código, sem qualquer interface de utilizador? É possível! Como os documentos 4D View Pro são objectos, é muito fácil criar documentos fora do ecrã. Pode criar um novo documento numa variável do tipo de objecto e manipulá-lo através das suas propriedades. Quando o seu documento estiver pronto, pode registá-lo na sua base de dados, num ficheiro, ou exibi-lo directamente numa área 4D View Pro.
Criar um documento View Pro 4D é bastante simples.
Primeiro, crie um objecto com a seguinte estrutura:
$doc:=New object)
$doc .version:=1 // version [mandatory]
$doc .dateCreation:=Timestamp // creation date
$doc .dateModified:=Timestamp // modification date
$doc .spreadJS:=New object // spreadJS [mandatory]
$doc .meta:=New object("comentário"; "4D - Como faço" // optional metadata
Este objecto contém:
- Informação interna para 4D: versão do documento
- Informação do programador: metadados, datas de criação e modificação
- Estrutura e dados do documento: dados a serem passados na propriedade spreadJS.
Assim que a sua estrutura estiver pronta, complete a propriedade spreadJS. É um objecto que contém, entre outras coisas, informação de folha de cálculo, dados, estilos de células, fórmulas, etc.
exemplo inicial
No exemplo abaixo escrevemos “Olá 4D View Pro!” na primeira célula do seu documento:
// Create the document
$doc:=New object("version";1; "dateCreation";Timestamp; "dateModified";Timestamp)
$doc .spreadJS:=New object("versão"; "11.0.0"; "folhas";New object)
//
// Creation of the first sheet
$sheet :=New object("name"; "Sheet1"; "rowCount";100; "columnCount";20)
$doc .spreadJS.sheets[$sheet.name]:=$sheet
//
// Fill first sheet cells
$sheet .data:=Novo objecto ("dataTable";Novo objecto)
$sheet .data.dataTable["0""]:=New object // primeira fila
$sheet .data.dataTable["0"]["0"]:=New object("valor"; "Olá 4D View Pro!") // conjunto A1
$sheet .data.dataTable["0"]["1"]:=New object("valor";42) // conjunto B1
//
VP IMPORT FROM OBJECT ("ViewProArea";$doc)
Exemplo avançado
Na base de dados de exemplo, é possível ver como criar rápida e facilmente um documento simples fora do ecrã.
Criação fora do ecrã de um documento 4D View Pro
Para o ajudar na criação de documentos mais complicados, pode consultar o esquema JSON dos documentos SpreadJS.