WP Import document

4D v20 R7

WP Import document


WP Import document ( rotaArquivo {; opção} ) -> Resultado

Parâmetro	Tipo	Descrição
rotaArquivo	String	Rota a um documento 4D Write (.4w7 ou .4wt) ou um documento 4D Write Pro (.4wp)
opção	Inteiro longo, Objeto	Opção de importação para expressões HTML
Resultado	Objeto	Objeto 4D Write Pro

Descrição

O comando WP Import document [#descv] converte um documento 4D Write ou 4D Write Pro existente (,4wp, .4w7 ou .4wt) ou documento MS Word (.docx) a um novo objeto 4D Write Pro [#descv].

No parâmetro rotaArquivo, passe a rota completa de um documento 4D Write armazenado no disco. Os tipos abaixo são compatíveis:

documentos 4D Write anteriores (.4w7 ou .4wt). Para uma lista detalhada de propriedades 4D Write que são atualmente suportadas em objetos 4D Write Pro, veja a seção Importar documentos 4D Write.
documentos de formato 4D Write Pro (.4wp). Para saber mais sobre o formato de documento 4D Write Pro document format, veja formato de documento .4wp.
documentos em formato .docx. Para saber mais sobre isso, veja Exportar em formato .docx.

Deve ser passado uma rota completa, a não ser que o documento esteja localizado no mesmo nível do arquivo de estrutura, em cujo caso você deve passar seu nome.

Nota: Se quiser importar um documento armazenado em um campo 4D BLOB, também pode usar o comando WP New.

Um erro é retornado se o parâmetro rotaArquivo for inválido, ou se o arquivo estiver faltando ou ainda se o formato do arquivo não for compatível.

O parâmetro opcional opção permite definir opções de importação para:

longint

Como padrão, expressões HTML inseridos em documentos legados 4D Write não são importados (não há compatibilidade com 4D Write Pro support). Se passar a constante wk import html expressions as text, expressões HTML serão importadas como texto raw dentro das tags ##htmlBegin## e ##htmlEnd## -- que exige ações de formatação depois. Por exemplo:

##htmlBegin##<span>Imported title<b>bold</b></span>##htmlEnd##

object

Pode passar um objeto para definir como os atributos a seguir são manejados durante a operação de importação:

Atributos	Tipo	Descrição
anchoredTextAreas	Text	Para MS Word (.docx) documentos. Especifica como áreas de texto ancoradas são manejadas. Valores disponíveis: ancorado (padrão) - áreas de texto ancoradas são tratadas como caixas de texto. inline - Imagens ancoradas são tratadas como texto inline na posição da âncora. ignore (padrão) - áreas de texto ancorado são ignoradas. Nota: o layout e o número de páginas no documento podem mudar. Veja Como importar .docx
anchoredImages	Text	Apenas para documentos MS Word (.docx) apenas. Especifica como imagens ancoradas são manejadas. Valores possíveis: all (padrão) - todas as imagens ancoradas são importadas como imagens ancoradas. Qualquer imagem com quebra de texto é importada como imagem inline. ignoreWrap - Imagens ancoradas são importadas, mas qualquer quebra de texto ao redor da imagem é ignorado. ignore - Imagens ancoradas não são importadas.
sections	Text	Apenas para documentos MS Word (.docx). Especifica como seções são manejadas. Valores possíveis: all (padrão) - Todas as sessões são importadas. Sessões contínuas, pares, ímpares são convertidas para sessões padrão. ignore - Seções são convertidas para seções padrão 4D Write Pro (layout A4 retrato sem cabeçalho ou rodapé). Nota: todas as quebras de seção são convertidas para quebras de página exceto quebras de seção contínua que são ignoradas.
fields	Text	Apenas para documentos MS Word (.docx). Especifica como campos .docx que não podem ser converitods a fórmulas 4D Write Pro são manejados. Valores disponíveis: ignore - campos .docx são ignorados. label - referências de campo .docx são importadas como etiquetas dentro de colchetes dobros ("{{ }}"). Ex: O campo "ClientName" poderia ser importado como {{ClientName}}. value (padrão) - o último valor computado para o campo .docx (se disponível) como importado. Nota: se um campo .docx correspondente a uma variável 4D Write Pro, o campo é importado como uma fórmula e essa opção é ignorada.
borderRules	Text	Apenas para documentos MS Word (.docx). Especifica como bordas de parágrafo são manejadas. Valores disponíveis: collapse - formatação de parágrafo é modificada para imitar automaticamente bordas colapsadas. Note que a propriedade colapso só funciona durante a operação de importação. Se uma folha de estilo com uma configuração automática de colapso de borda é reaplicada depois da operação de importação, então a configuração é ignorada. noCollapse (padrão) - Formatação de parágrafo não é modificada.
preferredFontScriptType	Text	Apenas para documentos MS Word (.docx). Especifica o corpo tipográfico a usar quando diferentes tipos estiverem definidos para uma mesma fonte em OOXML. Valores disponíveis: latin (padrão) - script Latino bidi - script bidirecional. Adequado se o documento for principalmente texto bidirecional da esquerda para a direita (left-to-right -LTR) ou direita para a esquerda (RTL) (por exemplo em árabe ou hebraico). eastAsia - Script para leste asiático. Adequado se seu documento estiver majoritariamente em textos asiáticos.
htmlExpressions	Text	Apenas para documentos 4D Write (.4w7). Especifica como as expressões HTML são manejadas. Valores disponíveis: rawText - Expressões HTML são importadas como texto raw dentro das tags ##htmlBegin## e ##htmlEnd## ignore (padrão) - expressões HTML são ignoradas.
importDisplayModeTexto		Só para documentos 4D Write (.4w7). Especifica como se gerencia a visualização da imagem. Valores disponíveis: legacy - o modo de visualização da imagem 4W7 se converte utilizando uma imagem de fundo se for diferente da escala de ajuste. noLegacy (predeterminado): o modo de visualização da imagem 4W7 se converte no atributo imageDisplayMode se for diferente da escala de ajuste.

Nota de Compatibilidade:

As folhas de estilo de caracteres em documentos herdados de 4D WRite usam um mecanismo patenteado, que não é compatível mais com 4D Write Pro. Para obter os melhores resultados para textos importados, atributos de folha de estilo devem ser convertidos para atributos de estilo "hard coded/codificados". Folhas de estilo de caractere "legado" não são importadas e não são mais referenciadas no documento.

A Compatibilidde para importação em formato .docx só é certificada para Microsoft Word 2010 ou mais recentes. Versões anteriores, Microsoft Word 2007 especialmente, podem ter problemas na importação

Exemplo 1

 C_OBJECT(WPDoc)

 WPDoc:=WP Import document("C:\\documents\\4DWriteDocs\\Letter.4w7")

Exemplo 2

Se quiser importar um documento .docx e quiser que as bordas do parágrafo estejam colapsadas como estão em MS Word:

 $options:=New object

 $options.borderRules:="collapse" //colapsa as bordas de parágrafo enquanto converte

 

 wpDoc:=WP Import document(«mydoc.docx»;$options)

Se quiser importar campos originais .docx como texto (para campos não convertidos para 4D formulas):

 $options:=New object

 $options.fields:="label" //para campos não convertidos, importa referências campo como texto entre {{ e }}

 

 wpDoc:=WP Import document(«mydoc.docx»;$options)

Se quiser importar um documento .docx cujo texto é principalmente em japonês:

 $options:=New object

 $options.preferredFontScriptType:="eastAsia" //força a conversão para scripts fonte eastAsia

 

 wpDoc:=WP Import document(«mydoc.docx»;$options)

Ver também

WP New