VP EXPORT DOCUMENT

Historia

Lanzamiento	Modificaciones
20 R2	Soporte de documentos .sjs

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

Parámetros	Tipo		Descripción
vpAreaName	Text	->	Nombre de objeto formulario área 4D View Pro
filePath	Text	->	Ruta de acceso del documento
paramObj	Object	->	Opciones de exportación

Descripción

El comando VP EXPORT DOCUMENT exporta el objeto de 4D View Pro adjunto al área 4D View Pro vpAreaName a un documento en disco según los parámetros filePath y paramObj.

En vpAreaName, pase el nombre del área 4D View Pro. Si pasa un nombre que no existe, se devuelve un error.

En filePath, pase la ruta de destino y el nombre del documento a exportar. Si no especifica una ruta, el documento se guardará en el mismo nivel que la carpeta Project.

Puede especificar el formato del archivo exportado incluyendo una extensión después del nombre del documento:

• 4D View Pro (".4vp")
• Microsoft Excel (".xlsx")
• PDF (".pdf")
• CSV (".txt", o ".csv")
• Documento SpreadJS (".sjs")

Si no se incluye la extensión, pero se especifica el formato en paramObj, el archivo exportado tendrá la extensión que corresponda al formato, excepto para el formato CSV (en este caso no se añade ninguna extensión).

El parámetro opcional paramObj le permite definir múltiples propiedades para el objeto 4D View Pro exportado y lanzar un método de retrollamada cuando la exportación haya finalizado.

Propiedad	Tipo	Descripción
format	text	(opcional) Cuando está presente, designa el formato del archivo exportado: ".4vp" (por defecto), ".csv", ".xlsx", ".pdf" o ".sjs". Puede utilizar las siguientes constantes :vk 4D View Pro format``vk</li><li> csv format``vk</li><li> MS Excel format``vk</li><li> pdf format``vk</li><li> sjs format 4D añade la extensión adecuada al nombre del archivo si es necesario. Si el formato especificado no corresponde con la extensión en filePath, se añadirá al final de filePath. Si no se especifica un formato y no se da ninguna extensión en filePath, se utiliza el formato de archivo por defecto.
contraseña	text	Sólo Microsoft Excel (opcional) - Contraseña utilizada para proteger el documento MS Excel
formula	4D.Function	Método de retrollamada que se lanzará cuando la exportación haya finalizado. La utilización de un método de retrollamada es necesaria cuando la exportación es asíncrona (que es el caso de los formatos PDF y Excel) si necesita que se ejecute algún código después de la exportación. El método retrollamada debe pasarse con el comando Formula. Ver Pasar un método de retrollamada (fórmula).
valuesOnly	boolean	Especifica que sólo los valores de las fórmulas (si las hay) serán exportados.
includeFormatInfo	boolean	True para incluir información de formato, false en caso contrario (por defecto es True). La información de formato es útil en algunos casos, por ejemplo, para una exportación a SVG. Por otro lado, poner esta propiedad en false permite reducir el tiempo de exportación.
includeBindingSource	boolean	Sólo 4DVP y Microsoft Excel. True (por defecto) para exportar los valores del contexto de datos actual como valores de celda en el documento exportado (los contextos de datos en sí no se exportan). False en caso contrario. El enlace de la celda siempre se exporta. Para la gestión de los contextos de datos y de las fusiones de celdas, ver VP SET DATA CONTEXT y VP SET BINDING PATH.
sheet	number	PDF únicamente (opcional) - Índice de la hoja a exportar (empezando por 0). -2=todas las hojas visibles (por defecto), -1=sólo la hoja actual
pdfOptions	object	Sólo PDF (opcional) - Opciones para la exportación de pdf Propiedad Tipo Descripción creator text nombre de la aplicación que creó el documento original a partir del cual se convirtió. title text título del documento. author text nombre de la persona que ha creado el documento. keywords text palabras clave asociadas al documento. subject text asunto del documento.
csvOptions	object	Sólo CSV (opcional) - Opciones para la exportación csv Propiedad Tipo Descripción range object Objeto rango de celdas rowDelimiter text Delimitador de fila. Default: "\r\n" columnDelimiter text Column delimiter. Por defecto: ","
sjsOptions	object	SJS only (optional) - Options for sjs export Property Type Description includeAutoMergedCells boolean whether to include the automatically merged cells, default is false. includeBindingSource boolean whether to include the binding source, default is true. includeCalcModelCache boolean whether to include the extra data of calculation. Can be faster when open the file with those data, default is false. includeEmptyRegionCells boolean whether to include any empty cells (cells with no data or only style) outside the used data range, default is true. includeFormulas boolean whether to include the formulas, default is true. includeStyles boolean whether to include the style, default is true. includeUnusedNames boolean whether to include the unused custom names, default is true. saveAsView boolean whether to apply the format string to exporting values, default is false.
\<customProperty>	any	Toda propiedad personalizada que estará disponible a través del parámetro $3 en el método de retrollamada.

Notas sobre el formato Excel:

• Al exportar un documento 4D View Pro a un archivo con formato Microsoft Excel, pueden perderse algunos parámetros. Por ejemplo, los métodos y fórmulas 4D no son soportados por Excel. You can verify other settings with this list from SpreadJS.
• La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad formula del paramObj para el código a ejecutar después de la exportación.

Notas sobre el formato PDF:

• Al exportar un documento 4D View Pro en PDF, las fuentes utilizadas en el documento se integran automáticamente en el archivo PDF. Sólo se pueden integrar las fuentes OpenType (archivos .OTF o .TTF) que tengan un tabla Unicode. Si no se encuentra un archivo de fuentes válido para una fuente, se utiliza una fuente por defecto.
• La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad formula del paramObj para el código a ejecutar después de la exportación.

Notas sobre el formato CSV:

• Al exportar un documento 4D View Pro al formato CSV, es posible que se pierdan algunos parámetros, ya que sólo se guardan el texto y los valores.
• Todos los valores se guardan como cadenas entre comillas. Para más información sobre valores separados por delimitadores, ver este artículo en Wikipedia.
• La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad formula del paramObj para el código a ejecutar después de la exportación.

Notas sobre el formato de archivo SpreadJS:

• SpreadJS files are zipped files.
• La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad formula del paramObj para el código a ejecutar después de la exportación.

Once the export operation is finished, VP EXPORT DOCUMENT automatically triggers the execution of the method set in the formula property of the paramObj, if used.

Pasar un método retrollamada (fórmula)

When including the optional paramObj parameter, the command allows you to use the Formula command to call a 4D method which will be executed once the export has completed. El método de retrollamada recibirá los siguientes valores en parámetros locales:

Parámetros		Tipo	Descripción
param1		text	El nombre del objeto de área 4D View Pro
param2		text	Ruta de acceso del objeto 4D View Pro exportado
param3		object	Una referencia al paramObj del comando
param4		object	Un objeto devuelto por el método con un mensaje de estado
	.success	boolean	True si exporta con éxito, de lo contrario False.
	.errorCode	integer	Código de error.
	.errorMessage	text	Mensaje de error.

Ejemplo 1

Quiere exportar el contenido del área "VPArea" a un documento 4D View Pro en el disco:

var $docPath: Text
 
$docPath:="C:\\Bases\\ViewProDocs\\MyExport.4VP"
VP EXPORT DOCUMENT("VPArea";$docPath)
//MyExport.4VP se guarda en su disco

Ejemplo 2

Quiere exportar la hoja actual en PDF:

var $params: Object
$params:=New object
$params.format:=vk pdf format
$params.sheet:=-1
$params.pdfOptions:=New object("title";"Annual Report";"author";Current user)
VP EXPORT DOCUMENT("VPArea";"report.pdf";$params)

Ejemplo 3

Desea exportar un documento 4D View Pro en formato ".xlsx" y llamar a un método que inicie Microsoft Excel con el documento abierto una vez completada la exportación:

 $params:=New object
 $params.formula:=Formula(AfterExport)
 $params.format:=vp MS Excel format //".xlsx"
 $params.valuesOnly:=True
 
 VP EXPORT DOCUMENT("ViewProArea";"c:\\tmp\\convertedfile";$params)

Método AfterExport:

 #DECLARE($areaName : Text ; $filePath : Text ; $params : Object ; $status : Object )
 
 If($status.success=False)
    ALERT($status.errorMessage)
 Else
    LAUNCH EXTERNAL PROCESS("C:\\Program Files\\Microsoft Office\\Office15\\excel "+$filePath)
 End if

Ejemplo 4

Quiere exportar la hoja actual a un archivo .txt con valores separados por "|":

var $params : Object
$params:=New object
$params.range:=VP Cells("ViewProArea";0;0;2;5)
$params.rowDelimiter:="\n"
$params.columnDelimiter:="|"
VP EXPORT DOCUMENT("ViewProArea";"c:\\tmp\\data.txt";New object("format";vk csv format;"csvOptions";$params))

Aquí está el resultado:

Ver también

VP Convert to picture
VP Export to object
VP IMPORT DOCUMENT
VP Print