Saltar al contenido principal
Versión: 20 R10 BETA

WP EXPORT VARIABLE

WP EXPORT VARIABLE ( wpDoc ; destination ; format {; option} )

ParámetrosTipoDescripción
wpDocObjectVariable 4D Write Pro
destinationText, BlobVariable para recibir los contenidos exportados
formatIntegerFormato de salida variable
optionObject, IntegerOpciones de exportación

Descripción

El comando WP EXPORT VARIABLE exporta el objeto wpDoc 4D Write Pro a la variable destination 4D en el format especificado.

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:

ConstanteTipoValorComentario
wk 4wpInteger4El 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 docxInteger7Extensió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 htmlInteger1El 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 pdfInteger5Extensió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 svgInteger8La 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 4DInteger3El 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:

ConstanteValorComentario
wk CID host domain namecidHostDomainNombre 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 picturesembeddedPicturesSó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:
  • true (por defecto): las imágenes están incrustadas en el archivo .svg exportado
  • false: las imágenes se exportan en una carpeta llamada "filename_images" en el nivel del archivo .svg exportado, "filename" siendo el nombre pasado al comando para el archivo, sin la extensión. The pictures are not embedded, but referenced in the .svg file.
  • Note: If the folder already exists, it is emptied before the file is exported. Si no hay ninguna imagen en la página exportada, se elimina la carpeta
    wk factur xfacturXSólo para exportación en PDF. Valor: objeto que configura una exportación PDF "Factur-X (ZUGFeRD)" (ver wk factur x object).
    wk filesHistóricoSó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 taggoogleFontsTagSólo para exportación SVG. Define la regla de importación para fuentes google en el SVG exportado. Possible values:
  • false (default): No google fonts import rule is added.
  • true: Adds the @import rule to the exported file. Useful if you want to use fonts that are not available by default on Windows or macOS.
  • Note: This property is set to false by default because when enabled, Google fonts override native fonts, and native fonts are generally better rendered in the browser.
    wk HTML pretty printhtmlPrettyPrintEl código HTML está formateado para facilitar su lectura.
    wk max picture DPImaxPictureDPISe 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 foroptimizedForDefine 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). If a picture contains more than one format, the format for screen rendering is used.
  • Nota: los documentos exportados en formato wk docx siempre se optimizan para la impresión wk (la opción wk optimized for se ignora).
    wk page indexpageIndexSó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 versionpdfaVersionExporta 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"
  • Nota: en macOS, 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 formulasrecomputeFormulasDefine si las fórmulas deben volver a calcularse cuando se exportan. Valores posibles:
  • true - Valor por defecto. Se vuelven a calcular todas las fórmulas
  • false - No se vuelven a calcular las fórmulas
  • wk visible background and anchored elementsvisibleBackgroundMuestra 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 imagesvisibleEmptyImagesMuestra 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 footersvisibleFootersMuestra 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 headersvisibleHeadersMuestra o exporta los encabezados (para la visualización, efecto visible sólo en el modo vista Página). Valores posibles: True/False
    wk visible referencesvisibleReferencesMuestra o exporta todas las expresiones 4D insertadas en el documento como referencias. Valores posibles: True/False
    wk whitespacewhitespaceDefine 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".

    The following table indicates the option available per export format:

    wk 4wpwk docxwk mime htmlwk pdfwk web page html 4dwk 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 truesiempre false (por defecto: true)- (por defecto: true)
    wk visible headers-siempre truesiempre 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