WP EXPORT VARIABLE

4D v19

WP EXPORT VARIABLE


WP EXPORT VARIABLE ( docWP ; destino ; formato {; opcoes} )

Parâmetro	Tipo	Descrição
docWP	Objeto	Variável 4D Write Pro
destino	Variável texto, BLOB variável	Variável a receber conteúdos exportados
formato	Inteiro longo	Formato de saída da variável
opcoes	Objeto, Inteiro longo	Opções de exportação

Descrição

O comando WP EXPORT VARIABLE exporta o objeto 4D Write Pro docWP na variável 4D destino com o formato especificado.

Em docWP, passe o objeto 4D Write Pro que quiser exportar.

Em destino, passe a variável texto que quiser preencher com o objeto 4D Write Pro exportado. O tipo desta variável depende de formato de exportação especificado no parâmetro de formato:

Se passar o formato .4wp nativo ou o formato .docx, a variável será de tipo Blob,
Se passar um formato HTML, a variável será de tipo Texto.

No parâmetro formato, passe uma constante de tema Constantes 4D Write Pro definindo o formato de exportação que quiser utilizar. Cada formato se relaciona com um uso específico. Os formatos abaixo são compatíveis:

Constante	Tipo	Valor	Comentário
wk 4wp	Inteiro longo	4	O documento 4D Write Pro é salvado em um formato de arquivo nativo (HTML zipado e imagens salvadas em uma pasta separada). Etiquetas 4D específicas são incluídas e expressões 4D não são computadas. Este formato é particularmente adequado para salvar e arquivar documentos 4D Write Pro em disco sem nenhuma perda.
wk docx	Inteiro longo	7	a extensão .docx de documentos 4D Write Pro é salvada no formato Microsoft Word. Compatibilidade certificada para Microsoft Word 2016 ou mais novo, Entretanto, também é compatível com qualquer versão que seja compatível com formatos .docx (por exemplo, Microsoft Word 2007). As partes do documento exportadas são: Corpo/cabeçalho/rodapés/seções Página / configurações de impressão (margens, cor de fundo/i,agem/bordas/preenchimento/tamanho de papel/orientações) Imagens - inline, ancorada, e padrão de imagem de fundo (definido com wk background image) Variáveis compatíveis e expressões (número de página, número total de páginas, datas, hora, metadata). Variáveis não compatíveis e expressões serão avaliadas e congeladas antes de exportar. Bookmarks Note que configurações 4D Write Pro podem não estar disponíveis ou podem se comportar diferente em Microsoft Word.
wk mime html	Inteiro longo	1	O documento 4D Write Pro se guardam como MIME HTML com documentos os documentos html e as imagens embebidas como partes MIME (codificado em base 64). As expressões se calculam e as etiquetas 4D específicas se eliminam. Este formato é especialmente adequado para o envio de mensagens de email HTML com o comando SMTP_QuickSend.
wk pdf	Inteiro longo	5	Extensão .pdf. O documento 4D Write Pro se guarda em formato PDF, em função do modo de vista Página. Os seguintes metadados são exportados em um documento PDF: Título Autor Assunto Criador de conteúdo Notas: As expressõs se congelam automaticamente quando se exporta o documento Os links aos métodos NÃO são exportados
wk web page html 4D	Inteiro longo	3	O documento 4D Write Pro se guarda como HTML e inclui as etiquetas 4D específicas; cada expressão se insere como um espaço de não separação. Dado que este formato é sem perdas, é apropriado para o armazenamento em um campo texto.

Notas:

"Etiquetas 4D específicas" designa o XHTML 4D com um namespace e estilos CSS 4D.
Para saber mais sobre o formato de documento 4D Write Pro, consulte formato de documento .4wp.
Para ver uma lista de diferenças conhecidas ou incompatibilidade ao usar o formato .docx, consulte Exportar em formato .docx.

parâmetro option

Passe um objeto na opção que contenha os valores para definir as propriedades de documento exportado. As propiedades abaixo estão disponíveis:

Constante	Valor	Comentário
wk CID host domain name	cidHostDomain	Nome de domínio host CID: domínio de host que se agregará às URLs CID geradas, incluída uma '@' como separador. Disponível apenas quando usar o formato wk mime html.
wk HTML pretty print	htmlPrettyPrint	Código HTML é formatado para ser mais fácil de ler.
wk max picture DPI	maxPictureDPI	Se utiliza para voltar a reajustar (reduzir) as imagens à resolução preferida. Para imagens SVG em Windows, utilizadas para rasterização (transformar uma imagem vetorial em píxels). Valores pré-determinados: 300 (para wk optimized for = wk print) 192 (para wk optimized for = wk screen) Valor máximo possível: 1440
wk optimized for	optimizedFor	Define como se otimiza um documento exportado segundo seu suporte. Valores possíveis: wk print (valor predeterminado para wk pdf) As imágens mapa de bits podem ser reduzidas utilizando o DPI definido por wk max picture DPI ou 300 (valor pré-determinado) e podem ser convertirdas a PNG se o códec não for compatível com o tipo de exportação. As imagens vetoriales são convertidas a PNG utilizando o DPI definido por wk max picture DPI ou 300 (Windows unicamente) Si una imagen contiene más de un formato, se utiliza el mejor formato para imprimir (por ejemplo, .tiff o .jpg) wk screen (valor pré-determinado para wk web page complete e wk mime html) As imagens mapa de bits podem ser reduzidas utilizando o DPI definido por wk max picture DPI ou 192 (valor predeterminado) e podem ser convertidas a JPEG (imagens opacas) ou PNG (imagenes transparentes) se o códec não for compatível pelo tipo de exportação As imagens vetoriais são convertidas a PNG utilizando o DPI definido por wk max picture DPI ou 192 (Windows unicamente) Se uma imagem contém mais de um formato, se utiliza o formato para o processamento de tela.
wk recompute formulas	recomputeFormulas	Define se as fórmulas devem ser recalculadas quando forem exportadas. Valores possíveis: true - Valor padrão. Todas as fórmulas são recalculadas false- Não recalcula as fórmulas
wk visible background	visibleBackground	Exibe tanto as imagens de fundo quanto a cor de fundo (efeito visível apenas nos modos de Página e Vista Embebida). Valores Possíveis: True/False
wk visible footers	visibleFooters	Exibe os cabeçalhos (efeito visível apenas em modo Página). Valores possíveis: True/False
wk visible headers	visibleHeaders	Exibe o cabeçalho (efeito visível apenas em modo Página). Valores possíveis: True/False
wk visible references	visibleReferences	Exibe todas as expressões 4D inseridas no documento como referência. Valores possíveis: True/False

A tabela abaixo indica a opção disponível por formato de exportação:

	wk 4wp	wk docx	wk mime html	wk pdf	wk web page html 4D
wk CID host domain name	-	-		-	-
wk HTML pretty print	(por defecto: false)	-	(por defecto: False)	(por defecto: False)	(por defecto: False)
wk max picture DPI	-	siempre 300		(por defecto: 300)	-
wk optimized for	-	siempre wk print	(por defecto:wk screen)	always wk print	-
wk recompute formulas	-	(por padrão: true)	(por padrão: true)	(por padrão: true)	-
wk visible background	-	siempre true	siempre true	(por padrão: true)	-
wk visible footers	-	siempre true	siempre false	(por padrão: true)	-
wk visible headers	-	siempre true	siempre false	(por padrão: true)	-
wk visible references	-	-	-	(por padrão: false)	-

Nota de compatibilidade: passar um valor de tipo inteiro longo em opção for compatível por razones de assistência, mas se recoienda utilizar um parâmetro objeto.

Exemplo 1

Se quiser exportar o conteúdo de objeto 4D Write Pro myArea ao formato MIME e agregar "gmail.com" como dominio host:

 var $option;$export : Objet

 $option[wk CID host domain name]:="gmail.com"

 WP EXPORT VARIABLE(myArea;$export;wk mime html;$option)

Exemplo 2

Se quiser enviar um email texto com estilo, referências 4D e imagens. Pode utilizar uma área 4D Write Pro exportada ao formato MIME e enviá-la utilizando SMTP:

  // criar o 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)

 

  // adicionar imagens (se houver)

 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

Ver também

Exportar em formato .docx
WP EXPORT DOCUMENT