4D Write Dokumente in 4D Write Pro konvertieren

4D Write Pro kann bisherige 4D Write Dokumente öffnen und konvertieren und unterstützt die meisten spezifischen Eigenschaften:

Im Bild sehen Sie links einen 4D Write Bereich und rechts einen 4D Write Pro Bereich (erstellt mit dem neuen Objekt aus der Bibliothek - siehe unten). Der Inhalt des 4D Write Bereichs wurde einfach über die Funktion WP New übertragen:

Da jedoch 4D Write nur mit 32-bit Versionen von 4D v16 verwendbar ist, müssen Sie Ihre 4D Write Dokumente vor dem Wechsel auf die 64-bit Version konvertieren.

Im Gegensatz zu 4D Write ist 4D Write Pro kein Plug-In, sondern direkt in 4D integriert. Beachten Sie, dass 4D Write Pro dieselbe Lizenz wie 4D Write verwendet. Diese Lizenz muss in Ihrem Programm installiert sein, damit Sie 4D Write Pro nutzen können.

4D Write Pro Objekte ermöglichen, 4D Write Dokumente auf zwei Wegen zu importieren:

• Für 4D Write Dateien, die auf der Festplatte gespeichert sind, verwenden Sie die Funktion WP Import document. 4D Write Dateien (.4w6, .4w7, und .4wt - Vorlage) müssen in 4D Write Pro Dateien (.4wp) konvertiert werden.
  
    // Zuerst mit 4D Write Befehlen .4w6 Dateien in .4w7 Dateien konvertieren
 $offscreen:=WR New offscreen area
 WR OPEN DOCUMENT($offscreen;"myFile.4w6";"4WR6")
 WR SAVE DOCUMENT($offscreen;"myFile.4w7";"4WR7")
 WR DELETE OFFSCREEN AREA($offscreen)
  
  
  
    // Dann mit 4D Write Pro Befehlen .4w7 in .4wp konvertieren
 C_OBJECT($docWritePro)
 $docWritePro:=WP Import document("myFile.4w7")
 WP EXPORT DOCUMENT($docWritePro;"myFile.4wp")

• Für 4D Write Dateien, die in einer Datei gespeichert sind, verwenden Sie die Funktion WP New. In BLOB oder Bildfeldern gespeicherte 4D Write Dateien müssen in Objektfelder gesetzt werden.
  
    // Von einem Bildfeld in ein Objektfeld über ein BLOB
  // [DocWRITE]WritePictArea_ is a picture field
  // $Blob is a BLOB
  // [DocWRITE]WriteProArea is an Object field
 $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)
  
  
  
    // Von einem BLOB Feld in ein Objektfeld
  // [DocWRITE]WriteBLOBArea_ is a BLOB field
  // [DocWRITE]WriteProArea is an object field
 [DocWRITE]WriteProArea :=WP New([DocWRITE]WriteBLOBArea_)

Hinweise zur Kompatibilität:

• Nur 4D Write Dokumente der letzten Generation (4D Write v7) werden unterstützt.
• Unter Welche Eigenschaften von 4D Write werden übernommen? erfahren Sie, welche Features und Objekte sich importieren lassen.
• Kopieren aus einem 4D Write Dokument und Einsetzen in einen 4D Write Pro Bereich wird derzeit nicht unterstützt. Ein 4D Write Dokument lässt sich nur über Befehle der 4D Write Pro Programmiersprache importieren.
• Unter Windows basieren 4D Write Pro Features auf Direct2D. Stellen Sie bei Rechnern mit Windows 7 oder Windows Server 2008 sicher, dass die Komponente Platform Update for Windows installiert ist, damit Sie die erforderliche Direct2D Version nutzen können.

In 4D v16 enthält die Objektbliothek das neue Formularobjekt 4D Write Pro. Setzen Sie dieses Objekt per Drag-and-Drop in ein Formular, erscheint automatisch ein vorkonfigurierter 4D Write Pro Bereich mit zugeordnetem Assistenten, der verschiedene Steuer-Panels zum Gestalten des Inhalts bietet:

Weitere Informationen dazu finden Sie im Abschnitt 4D Write Pro Area.

In Ihrer Datenbankstruktur lässt sich jedes 4D Feld vom Typ Objekt zum Speichern von 4D Write Pro Dokumenten verwenden. Ist es angelegt, können Sie im Formular mit dem 4D Write Bereich darauf verweisen. Im Formulareditor geben Sie für den 4D Write Pro Bereich den Feldnamen in der Standardform "[Tabelle]Feld" im Bereich Variablenname der Eigenschaftenliste ein:

Ihr 4D Write Pro Bereich wird dann dem Feld vom Typ Objekt zugewiesen und stellt sicher, dass sein Inhalt automatisch mit jedem Datensatz gesichert wird.

Das Filtern für 4D Write Pro Dokumente war in vorigen Versionen nicht aktiviert. Enthalten Ihre 4D Write Pro Dokumente Verweise auf 4D Methoden, werden diese nach dem Konvertieren in 4D v16 oder höher nicht mehr korrekt bewertet. An ihrer Stelle erscheint eine Meldung "## Error # 48".
In diesem Fall müssen Sie diese Methoden über den Befehl SET ALLOWED METHODS zur Liste der zugelassenen Methoden hinzufügen.

In 4D Write Pro wurden vorhandene Befehle weiter ausgebaut und neue hinzugefügt:

• OBJECT SET HORIZONTAL ALIGNMENT: Dieser Befehl unterstützt 4D Write Pro Objekte. Für den Parameter Ausrichtung gibt es die neue Konstante wk justify, um 4D Write Pro Objekte im 4D Write Pro Bereich auszurichten.
• OB SET: Dieser Befehl unterstützt die Definition von Attributen in 4D Write Pro Objekten, er funktioniert auf die gleiche Art wie WP SET ATTRIBUTES. Es gilt folgende Syntax:
  OB SET ( objSel | wpDoc; attribName ; attribValue {; attribName2 ; valeurAttrib2 ; ... ; attribNameN ; attribValueN} )
  Einschränkung: Sie können direkt als Attributwert kein Feld vom Typ Bild oder Variable übergeben. 
• OB Get: Dieser Befehl unterstützt die Definition von Attributen in 4D Write Pro Objekten, er funktioniert auf die gleiche Art wie WP GET ATTRIBUTES. Es gilt folgende Syntax:
  OB Get ( objSel | wpDoc; attribName ) -> Funktionsergebnis
  Diese Funktion hat die gleiche Einschränkung wie OB SET: Sie können direkt als Attributwert kein Feld vom Typ Bild oder Variable übergeben.
• 4D Write Pro Attribute als String setzen: Konvertieren Sie ein 4D Write Pro Objekt mit JSON Stringify in JSON, ist im Ausgabestring nur das Attribut "title" verfügbar.
  Eigene Attribute werden, sofern vorhanden, als String gesetzt. Weitere Informationen dazu finden Sie im Abschnitt Eigene Attribute verwenden.
• QUERY BY ATTRIBUTE: Dieser Befehl unterstützt interne und eigene 4D Write Pro Attribute, wenn die Dokumente in Objektfeldern gespeichert werden. Weitere Informationen dazu finden Sie im Abschnitt 4D Write Pro Dokumente in 4D Objektfeldern speichern.

Ab 4D v16 können Sie 4D Write Pro Dokumente mit dem native Format .4wp auf die Festplatte sichern und erneut öffnen.

Das .4wp Format ist ein Zip Ordner mit dem Dokumenttitel als Namen und HTML Text und Bilder als Inhalt:

• HTML Text setzt sich aus regulärem HTML mit 4D Ausdrücken (die nicht berechnet werden) sowie spezifischen 4D Tags zusammen,
• Bilder werden in einem Ordner neben der HTML Datei unter dem gleichen Namen wie der Dokumenttitel gespeichert.

Da .4wp Dokumente auf HTML basieren, lassen sie sich in jede externe Applikation, die HTML unterstützt, importieren oder öffnen.

Hinweis: Das interne Dokumentformat von 4D Write Pro ist eine proprietäre HTML Extension, die mit HTML5 oder XHTML5 kompatibel ist, jedoch ihre eigene Untermenge von HTML/CSS Attributen und Tags unterstützt. Deshalb können nur die von 4D Write Pro exportierten HTML Dokumente ohne Risiko von Datenverlust wieder von 4D Write Pro geöffnet werden.