Saltar para o conteúdo principal
Versão: 21 R2 BETA

WP EXPORT VARIABLE

WP EXPORT VARIABLE ( wpDoc : Object ; destination : Text, Blob ; format : Integer {; option : Object, Integer} )

ParâmetroTipoDescrição
wpDocObject→Variável 4D Write Pro
destinationText, Blob→Variable to receive exported contents
formatInteger→Formato de saída variável
optionObject, Integer→Opções de exportação

Descrição​

The WP EXPORT VARIABLE command exports the wpDoc 4D Write Pro object to the 4D destination variable in the specified format.

Em wpDoc, passe o objeto 4D Write Pro que você deseja exportar.

In destination, pass the variable that you want to fill with the exported 4D Write Pro object. O tipo dessa variável depende do formato de exportação especificado no parâmetro format:

  • If you pass the native .4wp format or the .docx format, the variable will be of the Blob type,
  • If you pass an HTML or SVG format, the variable will be of the Text type.

In the format parameter, pass a constant from the 4D Write Pro Constants theme to set the export format you want to use. Each format is related to a specific use. São suportados os seguintes formatos:

ParâmetrosTipoValorComentário
wk 4wpInteger4O documento 4D Write Pro é salvo em um formato de arquivo nativo (zipado HTML e imagens salvas em uma pasta separada). Tags específicas 4D estão incluídas e expressões 4D não são calculadas. Este formato é particularmente adequado para salvar e arquivar documentos 4D Write Pro no disco sem qualquer perda.
wk docxInteger7Extensão .docx. O documento 4D Write Pro é salvo no formato Microsoft Word . Suporte certificado para Microsoft Word 2010 e mais recentes.

As partes do documento exportadas são:
Corpo / cabeçalhos / rodapés / seçõesPágina de exibição / configurações de impressão (margem, cor / imagem, bordas, preenchimento, tamanho do papel / orientação)Imagens - inline, ancorada, e padrão de imagem de fundo (definido com imagem de fundo wk)Variáveis e expressões compatíveis (número de páginas, data, hora, metadados). Variáveis e expressões não compatíveis serão avaliadas e congeladas antes da exportação. inks -
BookmarksURLsNote que algumas configurações 4D Write Pro podem não estar disponíveis ou se comportar de forma diferente no Microsoft Word.
wk mime htmlInteger1O documento 4D Write Pro é salvo como MIME HTML padrão com documentos HTML e imagens incorporadas como partes MIME (codificado em base64). As expressões são calculadas e links de métodos e tags 4D específicos são removidos. Apenas caixas de texto ancoradas na visualização incorporada são exportadas (como divs). Este formato é particularmente adequado para enviar e-mails em HTML com o comando.
wk pdfInteger5Extensão .pdf. O documento 4D Write Pro é salvo no formato PDF, com base no modo de visualização de página. Os seguintes metadados são exportados em um documento PDF: título autor título conteúdo autor Notas: As expressões são calculadas automaticamente e os valores são congelados ao exportar o documento. Os links a métodos NÂO são exportados.
wk svgInteger8A página 4D Write Pro documento é salva no formato SVG, com base no modo de visualização de página. Nota: ao exportar para SVG, você só pode exportar uma página de cada vez. Use wk page index para especificar qual página exportar.
wk web page html 4DInteger34D Write Pro document is saved as HTML and includes 4D specific tags; each expression is inserted as a non-breaking space. Since this format is lossless, it is appropriate for storing purposes in a text field.

Notas:

  • "4D tags específicas" significa 4D XHTML com um namespace 4D e estilos 4D CSS
  • Para mais informações sobre o formato 4D Write Pro do documento, consulte formato do documento .4wp.
  • Para visualizar uma lista das diferenças conhecidas ou incompatibilidades ao usar o formato .docx, consulte Importando e Exportando no formato .docx.
  • When exporting to SVG format with this command, images are embedded in base64 format.
  • Para obter mais informações sobre exportação para o formato SVG, consulte Exportando para o formato SVG.

Parâmetro option​

Passe um objeto em opção contendo os valores para definir as propriedades do documento exportado. As seguintes propriedades estão disponíveis:

ParâmetrosValorComentário
wk CID host domain namecidHostDomainNome de domínio host CID: domínio host que será adicionado aos URLs de CID gerados, incluindo um '@' como separador. Disponível somente quando o formato wk mime html é usado.
wk embedded picturesembeddedPicturesSomente para exportação SVG. Define se as imagens são incorporadas no arquivo .svg exportado quando você chamar WP EXPORT DOCUMENT. Valores disponíveis:
  • true (padrão): Imagens são incorporadas no exportado. arquivo vg
  • false: Imagens são exportadas em uma pasta chamada "filename_images" no nível do exportado. arquivo vg, "nome do arquivo" sendo o nome do arquivo passado para o comando sem a extensão. 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. Se não houver nenhuma imagem na página exportada, a pasta será excluída
    wk factur xfacturXSomente para exportação em PDF. Valor: objeto que configura uma exportação de PDF "Factur-X (ZUGFeRD)" (consulte wk factur x object).
    wk filesfilesSomente para exportação em PDF. Valor: coleção de objetos, cada um deles descrevendo um arquivo a ser incorporado no documento final (consulte wk files collection). Este recurso só é suportado em documentos PDF/A-3: quando o atributo wk files é usado, a versão "PDF/A-3" é definida automaticamente (o atributo wk pdfa version é ignorado). Em caso de exportação Factur-X PDF (ver abaixo), o primeiro objeto da coleção deve conter o arquivo xml Factur-X.
    wk google fonts taggoogleFontsTagSomente para exportação SVG. Define a regra de importação para fontes do google no SVG exportado. Possible values:
  • false (default): No google fonts import rule is added.
  • true: Adds the @import rule to the exported file. Útil se você quiser usar fontes que não estão disponíveis por padrão no Windows ou macOS.
    • Nota: Essa propriedade é definida como falso por padrão porque quando habilitada As fontes do Google substituem fontes nativas, e as fontes nativas são geralmente melhor renderizadas no navegador.
    wk HTML pretty printhtmlPrettyPrintCódigo HTML está formatado para ser mais fácil de ler.
    wk max picture DPImaxPictureDPIUsado para reamostragem de imagens (reduzindo) para resolução preferida. Para imagens SVG no Windows, usado para o rasterização. Valores padrão: 300 (para wk otimizado para = wk print) 192 (para wk otimizado para = wk screen) Valor máximo possível: 1440
    wk optimized foroptimizedForDefine como um documento exportado é otimizado com base em seu meio pretendido. Valores possíveis:
  • wk print (valor padrão para wk pdf e wk svg) Imagens de Bitmap podem ser reduzidas usando o DPI definido por wk max image DPI ou 300 (valor padrão) e pode ser convertido em PNG se o codec não for suportado para o tipo de exportação. Imagens vetoriais são convertidas para PNG usando o DPI definido por wk max image DPI ou 300 (apenas Windows). Se uma imagem contiver mais de um formato, será usado o melhor formato para impressão (por exemplo, .tiff em vez de .jpg)
  • wk screen (valor padrão para wk web page complete e wk mime html). Imagens de Bitmap podem ser redimensionadas usando o DPI definido por wk max image DPI ou 192 (valor padrão) e pode ser convertido em JPEG (imagens opacas) ou PNG (imagens transparentes) se o codec não for suportado pelo tipo de exportação. Imagens vetoriais são convertidas para PNG usando o DPI definido por wk max image DPI ou 192 (apenas Windows). Se uma imagem contiver mais de um formato, será utilizado o formato para a renderização de tela. U
    • Nota: Documentos exportados em formato wk docx são sempre otimizados para impressão wk (wk otimizado para opção é ignorado).
    wk page indexpageIndexSomente para exportação SVG. Índice da página a ser exportada para formato svg (o padrão é 1). O índice da página começa em 1 para a primeira página do documento. Nota: o índice de páginas é independente da numeração de páginas.
    wk pdfa versionpdfaVersionExporta PDF de acordo com a versão PDF/A. Para obter mais informações sobre propriedades e versões PDF/A, consulte a página PDF/A na Wikipedia. Valores possíveis:
  • wk pdfa2: Exporta para a versão "PDF/A-2"
  • wk pdfa3: Exporta para a versão "PDF/A-3"
  • Nota: No macOS, 'wk pdfa2' pode exportar para PDF/A-2 ou PDF/A-3 ou superior, dependendo da implementação da plataforma. Além disso, wk pdfa3 significa "exporta para pelo menos PDF/A-3". No Windows, o arquivo PDF de saída será sempre igual à conformidade desejada.
    • wk recompute formulasrecomputeFormulasDefine se fórmulas devem ser recalculadas quando exportadas. Valores possíveis:
  • true - Valor padrão. Todas as fórmulas são recalculadas
  • false - Não calcular as fórmulas
    • wk visible background and anchored elementsvisibleBackgroundExibe ou exporta imagens de fundo/cor, imagens ancoradas e caixas de texto (para exibição, efeito visível no modo de visualização de página ou apenas no modo de visualização incorporado). Valores possíveis: True/False
    wk visible empty imagesvisibleEmptyImagesExibe ou exporta um retângulo preto padrão para imagens que não podem ser carregadas ou calculadas (imagens vazias ou imagens em um formato não suportado). Valores possíveis: Verdadeiro/Falso. Valor padrão: Verdadeiro Se o valor for Falso, elementos da imagem ausentes não serão exibidos de forma alguma, mesmo se eles tiverem fronteiras, largura, altura ou fundo; isso pode impactar o layout da página para imagens embutidas.
    wk visible footersvisibleFootersExibe ou exporta os rodapés (para exibição, efeito visível no modo de visualização da página) Valores possíveis: True/False
    wk visible headersvisibleHeadersExibe ou exporta os cabeçalhos (para exibição, efeito visível no modo de visualização da página) Valores possíveis: True/False
    wk visible referencesvisibleReferencesExibe ou exporta todas as expressões 4D inseridas no documento como referências. Valores possíveis: True/False
    wk whitespacewhitespaceSets the "white-space" css value for wk mime html export format. O estilo CSS do espaço branco é aplicado aos parágrafos. Valores possíveis: "normal", "nowrap", "pre", "pre-wrap" (padrão), "pre-line", "break-spaces".

    A tabela a seguir indica a option disponível por format de exportação:

    wk 4wpwk docxwk mime htmlwk pdfwk web page html 4dwk svg
    wk CID host domain name-----
    wk embedded pictures----- (padrão: true)
    wk factur x-----
    wk files-----
    wk google fonts tag----- (padrão: false)
    wk HTML pretty print (padrão: false)- (padrão: False) (padrão: False) (padrão: False) (padrão: false)
    wk max picture DPI-sempre 300 (padrão: 300)- (padrão: 300)
    wk optimized for-always wk print (padrão: wk screen)always wk print- (padrão: wk print)
    wk page index----- (padrão: 1)
    wk pdfa version-----
    wk recompute formulas- (padrão: true) (padrão: true) (padrão: true)- (padrão: true)
    wk visible background and anchored elements- (padrão: true)sempre true (padrão: true)- (padrão: true)
    wk visible empty images- (padrão: true) (padrão: true) (padrão: true)- (padrão: true)
    wk visible footers-sempre truesempre false (padrão: true)- (padrão: true)
    wk visible headers-sempre truesempre false (padrão: true)- (padrão: true)
    wk visible references--- (padrão: false)- (padrão: false)
    wk whitespace-- (padrão: "pre-wrap")---

    Nota de compatibilidade: Passar um valor longint na option é suportado por razões de compatibilidade. mas é recomendado usar um parâmetro [object](# "Dados estruturados como um objeto 4D nativo".

    Exemplo 1​

    You want to export the contents of the myArea 4D Write Pro object in MIME format and add "gmail.com" as the host domain:

     var $option;$export : Object
     
     $option[wk CID host domain name]:="gmail.com"
     
     WP EXPORT VARIABLE(myArea;$export;wk mime html;$option)

    Exemplo 2​

    You want to send an email containing styled text, 4D references and images. You can use a 4D Write Pro area exported in MIME format and sent using SMTP:

      // create the transporter
     $server:=New object
     $server.host:="smtp.gmail.com"
     $server.port:=465
     $server.user:="4D@gmail.com"
     $server.password:="XXXX"
     
     $transporter:=SMTP New transporter($server)
     
     WP EXPORT VARIABLE(WParea;$mime;wk mime html)
     
     $mailTmp:=MAIL Convert from MIME($mime)
     
      // add pictures (if any)
     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

    Exemplo 3​

    To export the first page of a 4D Write Pro as SVG in a Text variable and hide the headers:

     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)

    Veja também​

    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