VP IMPORT DOCUMENT

4D v18

VP IMPORT DOCUMENT


VP IMPORT DOCUMENT ( vpAreaName ; rotaArquivo {; paramObj} )

Parâmetro	Tipo	Descrição
vpAreaName	Texto	nome de objeto da área de formulário 4D View Pro
rotaArquivo	Texto	Nome da rota do documento
paramObj	Objeto	Opções de importação

Descrição

O comando VP IMPORT DOCUMENT importa e exibe o documento 4D View Pro ou Microsoft Excel designado por rotaArquivo e o mostra na área 4D View Pro vpAreaName. O documento importado substitui todos os datos inseridos na área.

Passe em vpAreaName o nome da área no formulàrio 4D. Se passar um nome não válido, se devolve um erro.

Em rotaArquivo, passe a rota de destino e o nome do documento importar. Só os documentos 4D View Pro (extensão ".4vp") e Microsoft Excel (extensão ".xlsx") são suportados pelo comando. Deve passar uma rota completa, a menos que o documento se encontre no mesmo nível que o arquivo de estrutura do banco de dados, em cujo caso pode passar seu nome.

Nota: Quando importar um arquivo de formato Microsoft Excel em um documento 4D View Pro, algumas configurações podem ser perdidas. Pode verificar suas configurações com esta lista de GrapeCity.

Um erro é devolvido se o parâmetro rotaArquivo, não é válido ou se o arquivo falta ou está mal formado.

O parâmetro opcional paramObj permite que defina propriedades para o documento importado:

Propriedade	Tipo	Descrição
formula	object	Um nome de chamada de método a ser lançado quando a exportação estiver completa. O método deve ser usado com o comando Formula Veja Passar um método de chamada.
password	text	A senha usada para proteger um documento Microsoft Excel (opcional)

Exemplo 1

Se quiser importar um documento 4D View Pro armazenado no disco, ao abrir o formulário:

 C_TEXT($docPath)

 If(Form event code=On VP Ready) //4D View Pro área carregada e pronta

    $docPath:="C:\\Bases\\ViewProDocs\\MyExport.4VP"

    VP IMPORT DOCUMENT("VPArea";$docPath)

 End if

Exemplo 2

Se quiser importar um documento Microsoft Excel protegido por senha em uma área 4D View Pro:

 $o.password:="excel123"

 

 VP IMPORT DOCUMENT("ViewProArea";"c:\\tmp\\excelfilefile.xlsx";$o)