Convertir los documentos 4D Write en 4D Write Pro

4D Write Pro puede abrir y convertir documentos 4D Write conservando la mayoría de sus propiedades específicas:

En la imagen de arriba, tenemos un área 4D Write a la izquierda y un área de 4D Write Pro a la derecha (creada con el nuevo objeto de la librería de objetos - ver abajo). El contenido del área 4D Write se recuperó simplemente usando el comando WP New:

Pero como 4D Write sólo se puede utilizar con versiones 4D v16 32 bits, debe convertir sus documentos 4D Write antes de cambiar a la versión 64 bits.

A diferencia de 4D Write, 4D Write Pro no es un plug-in, sino que está totalmente integrado en 4D. Tenga en cuenta que 4D Write Pro utiliza la misma licencia que 4D Write. Necesita tener esta licencia instalada en su aplicación para habilitar la funcionalidad.

Los objetos 4D Write Pro permiten recuperar los documentos 4D Write de dos maneras:

• Para los archivos 4D Write almacenados en disco, puede utilizar el comando WP Import document. Los archivos 4D Write (.4w6, .4w7 y plantilla .4wt) deben convertirse en archivo 4D Write Pro (.4wp).
  
    // Primero, convertir archivos .4w6 en archivos .4w7 con 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)
  
  
  
    // Luego convertir .4w7 en .4wp con comandos 4D Write Pro
 C_OBJECT($docWritePro)
 $docWritePro:=WP Import document("myFile.4w7")
 WP EXPORT DOCUMENT($docWritePro;"myFile.4wp")

• Para los archivos 4D Write almacenados en el archivo de datos, puede utilizar el comando [#title id="3680"/]. Los archivos 4D Write almacenados en campos BLOB o Imagen deben transferirse a un campo Objeto.
  
    // De un campo Imagen a un campo Objeto, pasando por un BLOB
  // [DocWRITE]WritePictArea_ es un campo imagen
  // $Blob is a BLOB
  // [DocWRITE]WriteProArea es un 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 un campo BLOB a un campo Objeto
  // [DocWRITE]WriteBLOBArea_ is a BLOB field
  // [DocWRITE]WriteProArea is an object field
 [DocWRITE]WriteProArea :=WP New([DocWRITE]WriteBLOBArea_)

Notas de compatibilidad:

• Sólo se soportan los documentos 4D Write de última generación ( "4D Write v7").
• Compruebe las funcionalidades y objetos importables consultando: ¿Qué propiedades se conservan de 4D Write?
• Copiar y pegar desde un documento 4D Write a un área 4D Write Pro por el momento no se soporta. Un documento 4D Write sólo se puede importar utilizando los comandos del lenguaje 4D Write Pro.
• En Windows, las funcionalidades de 4D Write Pro se apoyan en Direct2D. Con máquinas en Windows 7 o Windows Server 2008, asegúrese de que se ha instalado el componente Platform Update for Windows para que pueda beneficiarse de la versión requerida de Direct2D.

En 4D v16, la librería de objetos preconfigurados del editor de formularios incluye el nuevo objeto de formulario 4D Write Pro. Al arrastrar y soltar este objeto en un formulario inserta automáticamente un área 4D Write Pro preconfigurada asociada a un subformulario Widget 4D Write Pro que contiene paneles de control para administrar el contenido del área:

Para más información, ver Área 4D Write Pro.

En la estructura de su base de datos, todo campo Objeto 4D puede usarse para almacenar documentos 4D Write Pro. Una vez definido el campo Objeto destinado a almacenar los documentos 4D Write Pro, sólo puede hacer referencia a él desde el formulario que contiene el área. En el editor de formularios, introduzca el nombre del campo utilizando la notación estándar "[Tabla]Campo" en el área Nombre de la variable de la Lista de propiedades del área 4D Write Pro:

A continuación, el área 4D Write Pro se asocia al campo de tipo Objeto.

El filtrado no estaba activo para los documentos 4D Write Pro en versiones anteriores. Si sus documentos 4D Write Pro hacen referencia a métodos 4D, ya no se evaluarán correctamente una vez que se conviertan a 4D v16 o superior. Los mensajes se mostrarán como "## Error # 48".
En este caso, debe agregar los métodos a la lista de métodos permitidos utilizando el comando SET ALLOWED METHODS.

Se han añadido nuevos comandos y los ya existentes han evolucionado para trabajar con 4D Write Pro:

• OBJECT SET HORIZONTAL ALIGNMENT: este comando soporta objetos 4D Write Pro. Para las áreas de 4D Write Pro solamente, ahora está disponible una nueva constante wk justify para el parámetro alineación para los objetos 4D Write Pro, lo que le permite establecer una alineación justificada.
• OB SET: este comando soporta la definición de atributos en objetos 4D Write Pro, de la misma manera que WP SET ATTRIBUTES. Se soporta la siguiente sintaxis:
  OB SET ( objSel | wpDoc; atribNom ; atribValor {; atribNom2 ; valorAtrib2 ; ... ; atribNomN ; atribValorN} )
  Limitación: no puede pasar un campo imagen o una variable directamente como un valor de atributo.
• OB Get: este comando soporta la definición de atributos en objetos 4D Write Pro, de la misma manera que WP GET ATTRIBUTES.  Se soporta la siguiente sintaxis:
  OB Get ( objSel | wpDoc; atribNom ) -> Resultado de la función
  Este comando tiene la misma limitación que OB SET: no puede utilizar un campo o una variable imagen directamente como un valor de atributo.
• "Stringifying" los atributos 4D Write Pro: si convierte un objeto 4D Write Pro en JSON utilizando JSON Stringify, sólo el atributo "title" estará disponible en la cadena de salida.
  Los atributos personalizados, si los hay, serán "stringificados" (ver "Utilizar atributos personalizados" en la sección Almacenar los documentos 4D Write Pro en los campos objeto 4D).
• QUERY BY ATTRIBUTE: como se especifica en la sección Almacenar los documentos 4D Write Pro en los campos objeto 4D, el comando QUERY BY ATTRIBUTE soporta los atributos 4D Write Pro (internos y personalizados) cuando los documentos se almacenan en los campos Objeto.

A partir de 4D v16, puede guardar y volver a abrir documentos 4D Write Pro desde y hacia el disco sin ninguna pérdida utilizando el formato nativo .4wp.

El formato .4wp consiste en una carpeta zip cuyo nombre es el título del documento y cuyo contenido es texto HTML e imágenes:

• El texto HTML combina HTML regular con expresiones 4D (que no se calculan), así como también etiquetas 4D específicas,
• Las imágenes se almacenan en una carpeta con el mismo nombre que el título del documento, junto al archivo HTML.

Dado que los documentos .4wp se basan en HTML, pueden importarse o abrirse en cualquier aplicación externa compatible con HTML.

Nota: el formato interno de los documentos 4D Write Pro es una extensión HTML propietaria, compatible con HTML5/XHTML5, pero que admite su propio subconjunto de atributos y etiquetas HTML/CSS. Como resultado, sólo los documentos HTML exportados por 4D Write Pro pueden ser abiertos por 4D Write Pro sin ningún riesgo de pérdida de datos.