Saltar para o conteúdo principal
Versão: Próximo

VP IMPORT DOCUMENT

História
ReleaseMudanças
20 R2Suporte de documentos .sjs

VP IMPORT DOCUMENT ( vpAreaName : Text ; filePath : Text { ; paramObj : Object} )

ParâmetroTipoDescrição
vpAreaNameText->Nome de objeto formulário área 4D View Pro
filePathText->Caminho do documento
paramObjObject->Opções de importação

Descrição

The VP IMPORT DOCUMENT command imports and displays the document designated by filePath in the 4D View Pro area vpAreaName. O documento importado substitui qualquer dado já inserido na área

Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

Em filePath, passe o caminho de destino e o nome do documento a ser importado. São suportados os seguintes formatos:

  • Os documentos 4D View Pro (extensão ".4vp")
  • Microsoft Excel (extensão ".xlsx")
  • documentos textos (extensão ".txt", ".csv", o documento deve ser em utf-8)
  • SpreadJS documents (extension ".sjs")

If the document extension is not a recognized extension, such as .4vp or .xlsx, the document is considered a text document. Deve passar uma rota completa, a não ser que o documento esteja localizado no mesmo nível que a pasta Project, em cujo caso pode passar apenas seu nome.

An error is returned if the filePath parameter is invalid, or if the file is missing or malformed.

The optional paramObj parameter allows you to define properties for the imported document:

ParâmetroTipoDescrição
formula4D. FunctionUm método de retorno de chamada a ser iniciado quando a importação for concluída. Você deve usar uma fórmula retornada pelo comando Formula. Veja Passando um método de callback (fórmula).
senhatextSomente Microsoft Excel (opcional) - Senha usada para proteger o documento do MS Excel.
csvOptionsobjectopções para importação csv
rangeobjectO intervalo de células que contém a primeira célula onde os dados serão escritos. Se o intervalo especificado não é um intervalo de células, só a primeira célula do intervalo é usada.
rowDelimitertextDelimitador de linha. Se não estiver presente, o delimitador é automaticamente determinado por 4D.
columnDelimitertextDelimitador de coluna. O padrão: ","
sjsOptionsobjectopções para importação de sjs
calcOnDemandbooleanSe as fórmulas devem ser calculadas somente quando forem exigidas; padrão=falso.
dynamicReferencesbooleanSe deve calcular funções com referências dinâmicas; o padrão é true.
fullRecalcbooleanPara decidir se calcula depois do carregamento do dado json, falso por padrão
includeFormulasbooleanSe deve incluir as fórmulas ao carregar; o padrão é true.
includeStylesbooleanSe os estilos devem ser incluídos no carregamento; o padrão é true.
includeUnusedStylesbooleanSe deve incluir os estilos de nome não utilizados ao converter o xml do Excel em json; o padrão é true.
openModeinteger
  • 0 (normal): normal open mode, without lazy and incremental. When opening file, UI and UI event could be refreshed and responsive at specific time points.
  • 1 (lazy): lazy open mode. Quando abrir o documento, só a folha ativa será carregada diretamente. Other sheets will be loaded only when they are be used.
  • 2 (incremental): incremental open mode. When opening file, UI and UI event could be refreshed and responsive directly.
  • Notas
    • Importar arquivos em formatos .xslx, .csv, e .sjs é assíncrona. With these formats, you must use the formula attribute if you want to start an action at the end of the document processing.
    • Quando importar um arquivo formatado em Excel em um documento 4D View Pro, algumas configurações podem ser perdidas. You can verify your settings with this list from SpreadJS.
    • For more information on the CSV format and delimiter-separated values in general, see this article on Wikipedia

    Exemplo 1

    Se quiser importar um documento 4D View Pro armazenado no disco quando o formulário for aberto:

    C_TEXT($docPath)
    If(Form event code=On VP Ready) //A zona 4D View Pro está carregada e pronta
    $docPath:="C:\\Bases\\ViewProDocs\\MyExport.4VP"
    VP IMPORT DOCUMENT("VPArea";$docPath)
    End if

    Exemplo 2

    Você deseja importar um documento do Microsoft Excel protegido por senha para uma área do 4D View Pro:

    	//Código de importação
    var $o : Object
    $o:=New object
    $o.password:="excel123"
    $o.formula:=Formula(myImport)

    VP IMPORT DOCUMENT("ViewProArea";"c:\\tmp\\excelfilefile.xlsx";$o)
    	//myImport callback method
    #DECLARE($area : Text; $filePath : Text; $param : Object; $status : Object)

    If ($status.success)
    ALERT("Import successfully completed")
    Else
    ALERT("Error: "+$status.errorMessage)
    End if

    Exemplo 3

    You want to import a .txt file that uses a comma (",") as delimiter:

    example-import-csv

    $params:=New object
    $params.range:=VP Cells("ViewProArea";0;0;2;5)
    VP IMPORT DOCUMENT("ViewProArea";"c:\\import\\my-file.txt";New object("csvOptions";$params))

    Aqui está o resultado: example-import-csv

    Veja também

    VP EXPORT DOCUMENT
    VP NEW DOCUMENT