Converter documentos 4D Write para 4D Write Pro

4D Write Pro pode abrir e converter documentos 4D Write conservando a maioria de suas propriedades específicas:

Na imagem acima, temos uma área 4D Write à esquerda e uma área de 4D Write Pro à direita (criada com o novo objeto da biblioteca de objetos - ver abaixo). O conteùdo da área 4D Write foi recuperado simplesmente usando o comando WP New:

Mas como 4D Write só pode ser utilizado com versóes 4D v16 32 bits, deve converter seus documentos 4D Write antes de mudar à versão 64 bits.

Diferentemente de 4D Write, 4D Write Pro não é um plug-in, pois está totalmente integrado em 4D. Lembre que 4D Write Pro utiliza a mesma licença que 4D Write. Necessita ter esta licença instalada em sua aplicação para habilitar a funcionalidade.

Os objetos 4D Write Pro permitem importar documentos 4D Write de duas maneiras:

• Para os arquivos 4D Write armazenados em disco, pode utilizar o comando WP Import document,
  Os arquivos 4D Write (.4w6, .4w7 e modelos .4wt) devem ser convertidos em arquivo 4D Write Pro (.4wp).
  
    // Primeiro, converter arquivos .4w6 em arquivos .4w7 com comandos 4D Write
 $offscreen:=WR New offscreen area
 WR OPEN DOCUMENT($offscreen;"myFile.4w6";"4WR6")
 WR SAVE DOCUMENT($offscreen;"myFile.4w7";"4WR7")
 WR DELETE OFFSCREEN AREA($offscreen)
  
  
  
    // Depois converter .4w7 em .4wp com comandos 4D Write Pro
 C_OBJECT($docWritePro)
 $docWritePro:=WP Import document("myFile.4w7")
 WP EXPORT DOCUMENT($docWritePro;"myFile.4wp")
• Para os arquivos 4D Write armazenados em campos BLOB, pode utilizar o comando WP New,Os arquivos 4D Write armazenados em campos BLOB ou Imagem devem ser transferidos a um campo Objeto.
  
    // De um campo Imagem a um campo Objeto, passando por um BLOB
  // [DocWRITE]WritePictArea_ é um campo imagem
  // $Blob is a BLOB
  // [DocWRITE]WriteProArea é um campo Objeto
 $offscreen:=WR New offscreen area
 WR PICTURE TO AREA($offscreen;[DocWRITE]WritePictArea_)
 $Blob:=WR Area to blob($offscreen;1)
 [DocWRITE]WriteProArea :=WP New($Blob)
 WR DELETE OFFSCREEN AREA($offscreen)
  
  
  
    // De um campo BLOB a um campo Objeto
  // [DocWRITE]WriteBLOBArea_ is a BLOB field
  // [DocWRITE]WriteProArea is an object field
 [DocWRITE]WriteProArea :=WP New([DocWRITE]WriteBLOBArea_)

Notas de compatibilidade:

• Só são compatíveis os documentos 4D Write de última geração ( "4D Write v7").
• Comprove as funcionalidades e objetos importáveis consultando: Que propriedades se conservam de 4D Write?
• Copiar e colar desde um documento 4D Write a uma área 4D Write Pro pelo momento não é compatível. Um documento 4D Write só pode ser importado utilizando os comandos da linguagem 4D Write Pro.
• Em Windows, as funcionalidades de 4D Write Pro são apoiadas em Direct2D. Com máquinas en Windows 7 ou Windows Server 2008, tenha certeza de que foi instalado o componente Platform Update for Windows para que possa se beneficiar da versão requerida de Direct2D.

Em 4D v16, a biblioteca de objetos pré-configurados de editor de formulários inclui o novo objeto de formulário 4D Write Pro. Ao arrastar e soltar este objeto em um formulário insere automaticamente uma área 4D Write Pro pré-configurada associada a um subformulário Widget 4D Write Pro que contenha painéis de controle para administrar o conteúdo da área:

Para saber mais, ver 4D Write Pro area.

Na estrutura de seu banco de dados, todo campo Objeto 4D pode ser usado para armazenar documentos 4D Write Pro. Quando tiver definido o campo Objeto destinado a armazenar os documentos 4D Write Pro, só pode fazer referência a ele desde o formulário que contenha a área. No editor de formulários, introduza o nome do campo utilizando a notação padrão "[Tabela]Campo" na área Nome da variável da Lista de propriedades da área 4D Write Pro:

A  seguir, a área 4D Write Pro é associada ao campo de tipo Objeto.

O filtro não estava ativo para os documentos 4D Write Pro em versões anteriores. Se seus documentos 4D Write Pro fazem referência a métodos 4D, já não são avaliados corretamente quando tenham se convertidos a 4D v16 ou superior. As mensagens são mostradas como "## Error # 48".
Neste caso, deve agregar os métodos à lista de métodos permitidos utilizando o comando SET ALLOWED METHODS.

Novos comandos foram modificados e os já existentes foram evolucionados para trabalhar com 4D Write Pro:

• OBJECT SET HORIZONTAL ALIGNMENT: este comando é compatível com objetos 4D Write Pro. Para as áreas de 4D Write Pro somente, agora está disponível uma nova constante wk justify para o parâmetro alinhação para os objetos 4D Write Pro, o que permite estabelecer uma alinhação justificada.
• OB SET: este comando compatível com a definição de atributos em objetos 4D Write Pro, da mesma maneira que WP SET ATTRIBUTES. A  sintaxe abaixo é compatível:
  OB SET ( objSel | wpDoc; atribNom ; atribValor {; atribNom2 ; valorAtrib2 ; ... ; atribNomN ; atribValorN} )
  Limitação: não pode se passar um campo imagem ou uma variável diretamente como um valor de atributo.
• OB Get: este comando é compatível com a definição de atributos em objetos 4D Write Pro, da mesma maneira que WP GET ATTRIBUTES.  A sintaxe abaixo é compatível:
  OB Get ( objSel | wpDoc; atribNom ) -> Resultado da função
  Este comando tem a mesma limitação que OB SET: não pode utilizar um campo ou uma variável imagem diretamente como um valor de atributo.
• "Stringifying" os atributos 4D Write Pro: converte um objeto 4D Write Pro em JSON utilizando JSON Stringify, só o atributo "title" estará disponível na string de saída.
  Os atributos personalizados, se houver, serão "stringificados" (ver "Utilizar atributos personalizados" em Armazenar os documentos 4D Write Pro nos campos objeto 4D).
• QUERY BY ATTRIBUTE: como é especificado na seção Armazenar os documentos 4D Write Pro nos campos objeto 4D, o comando QUERY BY ATTRIBUTE é compatível com os atributos 4D Write Pro (internos e personalizados) quando os documentos são armazenados nos campos Objeto.

A partir de 4D v16, pode salvar e voltar a abrir documentos 4D Write Pro desde e até o disco sem nenhuma perda utilizando o formato nativo .4wp.

O formato .4wp consiste em uma pasta zip cujo nome é o título do documento e cuyo conteúdo é texto HTML e imagens:

• O texto HTML combina HTML regular com expressões 4D (que não são calculadas), assim como etiquetas 4D específicas,
• As imagens são armazenadas em uma pasta com o mesmo nome que o título do documento, junto ao arquivo HTML.

Dado que os documentos .4wp são baseados em HTML, podem ser importados ou abertos em qualquer aplicação externa compatível com HTML.

Nota: o formato interno dos documentos 4D Write Pro é uma extensão HTML proprietária, compatível com HTML5/XHTML5, mas que admite seu próprio subconjunto de atributos e etiquetas HTML/CSS. Como resultado, só os documentos HTML exportados por 4D Write Pro podem ser abertos por 4D Write Pro sem nenhum risco de perda de dados.