VP EXPORT TO BLOB
VP EXPORT TO BLOB ( vpAreaName : Text ; paramObj : Object )
| Parâmetro | Tipo | Descrição | ||
|---|---|---|---|---|
| vpAreaName | Text | -> | Nome de objeto formulário área 4D View Pro | |
| paramObj | Object | -> | Opções de exportação |
Descrição
O comando VP EXPORT TO BLOB exporta o documento vpAreaName 4D View Pro em um 4D.Blob de acordo com as opções paramObj. O blob exportado está disponível por meio da chamada de retorno de exportação. A exportação e importação de áreas do 4D View Pro como blobs é rápida e eficiente em termos de memória.
Em paramObj, você pode passar várias propriedades:
| Propriedade | Tipo | Descrição |
|---|---|---|
| formula | 4D. Function | (obrigatório) Método de retorno de chamada a ser lançado quando a exportação estiver concluída. Veja Passando um método de callback (fórmula). |
| includeAutoMergedCells | Parâmetros | Se deve incluir as células mescladas automaticamente ao salvar; padrão=falso. |
| includeBindingSource | Parâmetros | Se deve incluir a fonte de vinculação ao salvar, padrão = true. |
| includeCalcModelCache | Parâmetros | Se deve incluir os dados extras de cálculo. Pode afetar a velocidade de abertura do arquivo; padrão=false. |
| includeEmptyRegionCells | Parâmetros | Se devem ser incluídas células vazias (células sem dados ou apenas com estilo) fora do intervalo de dados usado, default=true |
| includeFormulas | Parâmetros | Se a fórmula deve ser incluída ao salvar, padrão = true. |
| includeStyles | Parâmetros | Se deve incluir o estilo ao salvar, padrão=true. |
| includeUnusedNames | Parâmetros | Se deve incluir o nome personalizado não utilizado ao salvar, padrão=true. |
| saveAsView | Parâmetros | Se a string de formato deve ser aplicada ao valor de exportação ao ser salva, padrão = falso. |
Os seguintes parâmetros podem ser usados no método de retorno de chamada:
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| param1 | text | O nome do objeto 4D View Pro | |
| param2 | 4D. Blob | O blob exportado | |
| param3 | object | Uma referência ao parâmetro paramObj do comando | |
| param4 | object | Um objeto devolvido pelo método com uma mensagem de estado | |
| .success | boolean | True se a exportação for bem sucedida, False caso contrário. | |
| .errorCode | integer | Código de erro. | |
| .errorMessage | text | Mensagem de erro. |
Exemplo
O comando VP EXPORT TO BLOB é assíncrono. Você deve criar um método de retorno de chamada (denominado VPBlobCallback em nosso exemplo) para usar os resultados da exportação.
//Exportar o documento VP
VP EXPORT TO BLOB("ViewProArea"; {formula: Formula(VPBlobCallback)})
//Método VPBlobCallback
#DECLARE($area : Text; $data : 4D.Blob; $parameters : Object; $status : Object)
var $myEntity : cs.myTableEntity
If ($status.success)
// Save the document in a table
$myEntity:=ds.myTable.new()
$myEntity.blob:=$data
$myEntity.save()
End if