WP EXPORT VARIABLE
WP EXPORT VARIABLE ( wpDoc ; destination ; format {; option} )
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| wpDoc | Object | → | Variable 4D Write Pro |
| destination | Text, Blob | → | Variable para recibir los contenidos exportados |
| format | Integer | → | Formato de salida variable |
| option | Object, Integer | → | Opciones de exportación |
Descripción
The WP EXPORT VARIABLE command exports the wpDoc 4D Write Pro object to the 4D destination variable in the specified format.
En wpDoc, pase el objeto 4D Write Pro que desea exportar.
En destination, pase la variable que quiere llenar con el objeto exportado de 4D Write Pro. El tipo de esta variable depende del formato de exportación especificado en el parámetro format:
- Si pasa el formato .4wp nativo o el formato .docx, la variable será de tipo Blob,
- Si pasa un formato HTML o SVG, la variable será de tipo Text.
En el parámetro format, pase una constante del tema 4D Write Pro Constants para definir el formato de exportación que desea utilizar. Cada formato está relacionado con un uso específico. Se soportan los siguientes formatos:
| Constante | Tipo | Valor | Comentario |
|---|---|---|---|
| wk 4wp | Integer | 4 | El documento 4D Write Pro se guarda en un formato de archivo nativo (HTML comprimido e imágenes guardadas en una carpeta separada). Se incluyen las etiquetas específicas 4D y no se calculan las expresiones 4D. Este formato es especialmente adecuado para guardar y archivar documentos 4D Write Pro en disco sin pérdida alguna. |
| wk docx | Integer | 7 | Extensión .docx. El documento 4D Write Pro se guarda en formato Microsoft Word. Compatibilidad certificada con Microsoft Word 2010 y versiones posteriores. Las partes del documento exportadas son: Cuerpo / encabezados / pies de página / seccionesPágina / configuración de impresión (márgenes, color de fondo / imagen, bordes, relleno, tamaño de papel / orientación)Imágenes - en línea, ancladas, y patrón de imagen de fondo (definido con wk background image)Variables y expresiones compatibles (número de página, número de páginas, fecha, hora, metadatos). Las variables y expresiones no compatibles serán evaluadas y congeladas antes de export.Links - BookkmarksURLsNote que algunos ajustes de 4D Write Pro pueden no estar disponibles o comportarse de forma diferente en Microsoft Word. |
| wk mime html | Integer | 1 | El documento 4D Write Pro se guarda como HTML MIME estándar con documentos HTML e imágenes anidadas como partes MIME (codificadas en base64). Se calculan las expresiones y se eliminan las etiquetas específicas de 4D y los enlaces de métodos. Sólo se exportan los cuadros de texto anclados a la vista incrustada (como divs). Este formato es especialmente adecuado para enviar correos electrónicos HTML con el comando. |
| wk pdf | Integer | 5 | Extensión .pdf. El documento 4D Write Pro se guarda en formato PDF, según el modo vista Página. Los siguientes metadatos se exportan en un documento PDF: Título Autor Asunto Creador del contenido Notas: Las expresiones se congelan automáticamente al exportar el documento Los enlaces a métodos NO se exportan |
| wk svg | Integer | 8 | La página del documento 4D Write Pro se guarda en formato SVG, según el modo vista Página. Nota: al exportar a SVG, sólo puede exportar una página cada vez. Utilice el wk page index para especificar qué página exportar. |
| wk web page html 4D | Integer | 3 | El documento 4D Write Pro se guarda como HTML e incluye etiquetas específicas 4D; cada expresión se inserta como un espacio inseparable. Como este formato no tiene pérdidas, es apropiado para almacenar propósitos en un campo de texto. |
Notas:
- "Etiquetas específicas 4D" significa XHTML 4D con un espacio de nombres 4D y estilos CSS 4D.
- Para más información sobre el formato de documento 4D Write Pro, consulte el formato del documento .4wp.
- Para ver una lista de las diferencias o incompatibilidades conocidas al utilizar el formato .docx, consulte Importación y exportación en formato .docx.
- Cuando se exporta al formato SVG con este comando, las imágenes se integran en formato base64.
- Para obtener más información sobre la exportación a formato SVG, consulte Exportar a formato SVG.
Parámetro option
Pase un objeto en option conteniendo los valores para definir las propiedades del documento exportado. Las siguientes propiedades están disponibles:
| Constante | Valor | Comentario |
|---|---|---|
| wk CID host domain name | cidHostDomain | Nombre de dominio de host CID: dominio de host que se añadirá a las URL CID generadas incluyendo una "@" como separador. Disponible sólo cuando se utiliza el formato wk mime html. |
| wk embedded pictures | embeddedPictures | Sólo para exportación SVG. Establece si las imágenes se incrustan en el archivo .svg exportado cuando se llama a WP EXPORT DOCUMENT. Valores disponibles: |
| wk factur x | facturX | Sólo para exportación en PDF. Valor: objeto que configura una exportación PDF "Factur-X (ZUGFeRD)" (ver wk factur x object). |
| wk files | Histórico | Sólo para exportación en PDF. Valor: colección de objetos, cada uno de los cuales describe un archivo que se integrará en el documento final (ver wk files collection). Esta funcionalidad sólo se admite en documentos PDF/A-3: cuando se utiliza el atributo wk files, se establece automáticamente la versión "PDF/A-3" (se ignora el atributo wk pdfa version). En caso de una exportación de Factur-X PDF (ver abajo), el primer objeto de la colección debe contener el archivo Factur-X xml. |
| wk google fonts tag | googleFontsTag | Sólo para exportación SVG. Define la regla de importación para fuentes google en el SVG exportado. Valores posibles: |
| wk HTML pretty print | htmlPrettyPrint | El código HTML está formateado para facilitar su lectura. |
| wk max picture DPI | maxPictureDPI | Se utiliza para reducir imágenes a la resolución preferida. Para imágenes SVG en Windows, utilizado para la rasterización. Valores por defecto: 300 (for wk optimized for = wk print) 192 (for wk optimized for = wk screen) Valor máximo posible: 1440 |
| wk optimized for | optimizedFor | Define cómo se optimiza un documento exportado en función de su soporte. Valores posibles:wk print (valor por defecto para wk pdf y wk svg) Las imágenes de mapa de bits pueden reducirse utilizando los PPP definidos por wk max picture DPI o 300 (valor por defecto) y pueden convertirse a PNG si el códec no es compatible con el tipo de exportación. Las imágenes vectoriales se convierten a PNG utilizando los PPP definidos por wk max picture DPI o 300 (sólo Windows). Si una imagen contiene más de un formato, se utiliza el mejor formato para la impresión (por ejemplo, .tiff en lugar de .jpg)wk screen (valor por defecto para wk web page complete y wk mime html). Las imágenes de mapa de bits pueden reducirse utilizando los PPP definidos por wk max picture DPI o 192 (valor por defecto) y pueden convertirse a JPEG (imágenes opacas) o PNG (imágenes transparentes) si el códec no es compatible con el tipo de exportación. Las imágenes vectoriales se convierten a PNG utilizando los PPP definidos por wk max picture DPI o 192 (sólo Windows). Si una imagen contiene más de un formato, se utiliza el formato para la representación en pantalla.wk docx siempre se optimizan para la impresión wk (se ignora la opción wk optimized for). |
| wk page index | pageIndex | Sólo para exportación SVG. Índice de la página a exportar a formato svg (por defecto es 1). El índice de páginas comienza en 1 para la primera página del documento. Nota: el índice de páginas es independiente de la numeración de páginas. |
| wk pdfa version | pdfaVersion | Exporta PDF conforme a una versión PDF/A. Para más información sobre las propiedades y versiones de PDF/A, consulte la página PDF/A en Wikipedia. Valores posibles: wk pdfa2: exporta a la versión "PDF/A-2"wk pdfa3: exporta a la versión "PDF/A-3"wk pdfa2 puede exportar a PDF/A-2 o PDF/A-3 o superior, dependiendo de la implementación de la plataforma. Además, wk pdfa3 significa "exporta a al menos PDF/A-3". En Windows, el archivo PDF de salida siempre será igual a la conformidad deseada. |
| wk recompute formulas | recomputeFormulas | Define si las fórmulas deben volver a calcularse cuando se exportan. Valores posibles: |
| wk visible background and anchored elements | visibleBackground | Muestra o exporta imágenes/color de fondo, imágenes ancladas y cuadros de texto (para mostrar, efecto visible sólo en modo de vista Página o Anidado). Valores posibles: True/False |
| wk visible empty images | visibleEmptyImages | Muestra o exporta un rectángulo negro por defecto para las imágenes que no se pueden cargar o calcular (imágenes vacías o imágenes en un formato no compatible). Valores posibles: True/False. Valor por defecto: True Si el valor es False, los elementos de imagen que falten no se mostrarán en absoluto aunque tengan bordes, ancho, alto o fondo; esto puede afectar al diseño de la página para imágenes en línea. |
| wk visible footers | visibleFooters | Muestra o exporta los pies de página (para la visualización, efecto visible sólo en el modo vista Página). Valores posibles: True/False |
| wk visible headers | visibleHeaders | Muestra o exporta los encabezados (para la visualización, efecto visible sólo en el modo vista Página). Valores posibles: True/False |
| wk visible references | visibleReferences | Muestra o exporta todas las expresiones 4D insertadas en el documento como referencias. Valores posibles: True/False |
| wk whitespace | whitespace | Define el valor css "white-space" para el formato de exportación wk mime html. El estilo white-space css se aplica a los párrafos. Valores posibles: "normal", "nowrap", "pre", "pre-wrap" (por defecto), "pre-line", "break-spaces". |
La siguiente tabla indica la option disponible por cada format:
| wk 4wp | wk docx | wk mime html | wk pdf | wk web page html 4d | wk svg | |
|---|---|---|---|---|---|---|
| wk CID host domain name | - | - |  | - | - | - |
| wk embedded pictures | - | - | - | - | - | (por defecto: true) |
| wk factur x | - | - | - | | - | - |
| wk files | - | - | - | | - | - |
| wk google fonts tag | - | - | - | - | - | (por defecto: false) |
| wk HTML pretty print | (por defecto: false) | - | (por defecto: False) | (por defecto: False) | (por defecto: False) | (por defecto: false) |
| wk max picture DPI | - | siempre 300 | | (por defecto: 300) | - | (por defecto: 300) |
| wk optimized for | - | always wk print | (por defecto: wk screen) | always wk print | - | (por defecto: wk print) |
| wk page index | - | - | - | - | - | (por defecto: 1) |
| wk pdfa version | - | - | - | | - | - |
| wk recompute formulas | - | (por defecto: true) | (por defecto: true) | (por defecto: true) | - | (por defecto: true) |
| wk visible background and anchored elements | - | (por defecto: true) | siempre true | (por defecto: true) | - | (por defecto: true) |
| wk visible empty images | - | (por defecto: true) | (por defecto: true) | (por defecto: true) | - | (por defecto: true) |
| wk visible footers | - | siempre true | siempre false | (por defecto: true) | - | (por defecto: true) |
| wk visible headers | - | siempre true | siempre false | (por defecto: true) | - | (por defecto: true) |
| wk visible references | - | - | - | (por defecto: false) | - | (por defecto: false) |
| wk whitespace | - | - | (por defecto: "pre-wrap") | - | - | - |
Nota de compatibilidad: pasar un valor largo en longint es compatible por razones de compatibilidad, pero se recomienda usar un parámetro objeto.
Ejemplo 1
Quiere exportar el contenido del objeto myArea 4D Write Pro en formato MIME y añadir "gmail.com" como dominio host:
var $option;$export : Object
$option[wk CID host domain name]:="gmail.com"
WP EXPORT VARIABLE(myArea;$export;wk mime html;$option)
Ejemplo 2
Desea enviar un correo electrónico que contenga texto con estilo, referencias 4D e imágenes. Puede utilizar una zona 4D Write Pro exportada en formato MIME y enviada mediante SMTP:
// crea el transportador
$server:=New object
$server.host:="smtp.gmail. om"
$server.port:=465
$server.user:="4D@gmail.com"
$server. assword:="XXX"
$transporter:=SMTP New transporter($server)
WP EXPORT VARIABLE(WParea;$mime;wk mime html)
$mailTmp:=MAIL Convert from MIME($mime)
// añadir imágenes (si las hay)
If($mailTmp.attachments#Null)
$email.attachments:=$mailTmp.attachments
End if
$email.bodyStructure:=$mailTmp.bodyStructure
$email.bodyValues:=$mailTmp.bodyValues
$status:=$transporter.send($email)
If(Not($status.success))
ALERT("An error occurred: "+$status.statusText)
End if
Ejemplo 3
Para exportar la primera página de un 4D Write Pro como SVG en una variable Text y ocultar los encabezados:
var $options : Object
var $destination : Text
$options:=New object
$options[wk optimized for]:=wk screen
$options[wk visible headers]:=False
WP EXPORT VARIABLE(WPArea;$destination;wk svg;$options)
Ver también
4D QPDF (Component) - PDF Get attachments
Blog post - 4D Write Pro: Electronic invoice generation
Blog post - 4D Write Pro: Export to PDF with enclosures
Exporting to HTML and MIME HTML formats
Importing and Exporting in .docx format
WP EXPORT DOCUMENT