Der Selbermachen-Bugfix 3//Do-It-Yourself bugfix 3

Neulich stieß ich auch das Problem, da ich im Designer keine Bilder mehr durch Doppelklicken eines Bildfeldes hinzufügen konnte.
Alles was ich zu Gesicht bekam, war die barsche Meldung: "Auf Ihrem System wurde kein Bilddatei-Browser gefunden.".

In den Optionen des Designers offenbarte sich das Problem, denn für die Dateiverwaltung war kein Dateibrowser vorhanden und auch nicht auswählbar.
Ursache ist das Fehlen eines Registrierungseintrages für den Dateibrowser den Designer mitbringt.

Abhilfe schaft hier ein kurzer Ausflug in die Windows Kommandozeile.

I recently got a problem in Designer where I wasn't able to add images by double clicking an image field.
All a got was a gruff message saying "Error: Unable to locate an image file browser on your system".

In Designers options dialog showed the dilemma. There wasn't a default file browser available and also not selectable.
The reason is a missing registry entry for the file browser that comes with Designer.

You can fix this with a short excursion into the Windows command line.


Bug – Fehlender Bilddatei-Browser
//
Bug – Missing image file browser

Fehlermeldung - Fehlender Bilddatei-Browser
//
Error - Missing image file browser

Fehlender Dateibrowser im Optionen-Dialog
//
Missing file browser in the options dialog

Selbermachen-Bugfix – Schritt für Schritt
//
Do-It-Yourself Bugfix – Step by Step

Schritt 1 – Öffnen Sie die Kommandozeile (cmd) mit Administrator-Rechten
//
Step 1 – Open the command line (cmd) with admin rights

Schritt 2 – Wechseln Sie mit "cd" das Installationsverzeichnis Ihres Designer z.B. "cd C:\Program Files (x86)\Adobe\Adobe LiveCycle Designer ES3"
//
Step 2 – Use "cd" to go to the Designers installation directory like "cd C:\Program Files (x86)\Adobe\Adobe LiveCycle Designer ES3"

Schritt 3 – Registrieren Sie den Dateibrowser mit dem Befehl "regsvr32.exe FileSystemBrowser.dll" neu.
//
Step 3 – Register the file browser with the command "regsvr32.exe FileSystemBrowser.dll".

Glückwunsch - Sie haben den Dateibrowser erfolgreich registriert
//
Congratulations - You successfully registered the file browser

Schritt 4 – Starten Sie Designer neu und prüfen Sie, ob der Dateibrowser unter "Extras" > "Optionen" wieder verfügbar ist.
//
Step 4 – Restart Designer and under "Tools" > "Options" check if the file browser is available again.

MailTo Macher Makro V1.0//MailTo Maker Macro V1.0

Vor einigen Monaten habe ich ein Makro zum Erstellen von Mail-Skripten in Schaltflächen entworfen.
Das funktionierte eigentlich ganz gut, hatte aber noch Verbesserungspotential.
Zwar konnte man damit die Empfängeradressen auch über SOM-Ausdrücke zur Laufzeit mit Feldwerte befüllen, aber jeweils nur von einem Feld.
Dasselbe war für den Betreff oder die Nachricht selbst gar nicht erst möglich.
Und dann war da noch das Problem, dass die hinzugefügten Skripte nur in der XML Quelle aber nicht im Skripteditor sichtbar waren.

Höchste Zeit für ein Update.
Nach reichlich Kopfzerbrechen kann das Makro nun viel flexibler eingesetzt werden als zuvor.
Mit den neuen Variablen können nun Teile der Empfängeradressen, des Betreff und der Nachricht zur Laufzeit mit Feldwerten aufgefüllt werden.
Auch mehrere Variablen hintereinander sind möglich, ebenso wie Variablen kombiniert mit gewöhnlichem Text.
Das Ergebnis ist nun auch unmittelbar im Skripteditor sichtbar, somit entfällt das nachträgliche Editieren der XML Quelle.

A couple of months ago I designed a macro to create mail scripts for buttons.
It worked but not very well and had room for improvements.
The receivers addresses could indeed be filled at runtime with field values using SOM expression but only on field at once.
And the same wasn't able for the subject nor message.
At least there was that nasty problem that the created scripts were not visible in the script editor but in the XML source.

It's about time for an Update.
After days of brain work the macro now is much more flexible than before.
You can add variables that will be used to fill portions of you receivers addresses, subject or message with field value at runtime.
You can use several variables at once and/or combine them with regular text.
The results now are in the script editor immediately.


Funktionsweise des Makro
//
How the macro works

Schritt 1 – Schaltfläche auswählen und Makro aufrufen
//
Step 1 – Select a button and execute the macro

Schritt 2 – Flex Dialog öffnet sich, ohne weitere Einstellungen
//
Step 2 – Flex Dialogs opens without further settings

Schritt 3 – Werte für Empfängeradresse(n), Betreff und Nachricht eingeben ...
//
Step 3 – Enter values for receiver adress(es), subject or message ...

Schritt 4 – ... oder Variablen zu diesen Felder hinzufügen.
//
Step 4 – ... or add variables to those fields.

Schritt 5 – Ein  Dialog informiert, wo das neue Skript hinzugefügt wurde.
//
Step 5 – A dialogs informs you where the new script was added to.

Schritt 6 – Das neue Skript ist im Skripteditor in click Event zu sehen.
//
Step 6 – The new script is visible under the click event in the script editor.

Aktualisierungen in Version 1.0.4
//
Updates in Version 1.0.4

1. Anführungszeichen oder Apostrophe im Betreff und Nachricht werden nun automatisch escaped, damit die erzeugten Strings durch diese Zeichen nicht unterbrochen werden.
   //
   Quotation marks and apostrophe in the subject and message are now automatically escaped, so the generated string won't be interrupted by those characters.

MailTo Macher-Makro V1.0.4
//
MailTo Maker Macro V1.0.4
https://files.acrobat.com/a/preview/b01040ae-f0cb-4328-8ced-9e33928ee89f

LiveCycle ES3 Service Pack 1

Adobe hat das erste Service Pack für LiveCycle ES3 veröffentlicht.
Für den Designer bringt es einige Bugfixes.
Zum Beispiel wird das nervige Problem der deutschen Version behoben, bei dem Designer mit einem Runtime Error abstürzt, wenn man versucht, einen einmal festgelegten Überlaufkopf- oder fußbereich wieder zu ändern.

Die Versionsnummer des Designer ändert sich durch das Service Pack auf 10.0.3.
Theoretisch würde das Update ja für alle vorherigen Versionen (ADEP Designer 10.0.0/10.0.1) gehen, aber dem ist nicht so.
Durch den Namenswechsel von ADEP zurück zu LiveCycle, hat sich beim Designer einiges mehr geändert, sodass der ADEP Designer nach dem Installieren des Service Packs nicht mehr funktioniert.
Das Service Pack funktioniert nur mit dem LiveCycle Designer ES3 (10.0.2).

Wie schon zuvor erwähnt, können Sie Ihre ADEP Lizenz für die Installation des LiveCycle Designer ES3 verwenden.

Adobe has release the first Service Pack for LiveCycle ES3.
It brings a few bugfixes for Designer.
For example for a very nasty bug in the german version that causes Designer to crash every time you try to change the setting of an overflow leader or trailer.

The Service Pack changes Designers version number to 10.0.3.
You might think it will be usable for all pervious versions (ADEP Designer 10.0.0/10.0.1) , but this is not the case.
With the name changing from ADEP to LiveCycle, several different things in Designer have changed, so ADEP Designer won't work anymore if you install the Service Pack over it.
The Service Pack is only suitable for LiveCycle Designer ES3 (10.0.2).

As I mentioned before, you can use your ADEP licence to install LiveCycle Designer ES3.



Fehlerbehebungen bei LiveCycle Designer ES3 für folgendes Problem
//
Bug Fix for following bug in LiveCycle Designer ES3

Änderungen beim Überlaufkopf- oder -fußbereich im deutschen Designer ...
//
Changing the overflow leader or trailer settings in the german Designer ...

... führt in Version 10.0.0, 10.0.1 und 10.0.2 zum Absturz.
//
... causes an app crash in version 10.0.0, 10.0.1 and 10.0.2.

Download - LiveCycle ES3 Service Pack 1
https://www.adobe.com/cfusion/entitlement/index.cfm?e=lces3_sp1

ADEP Service Pack 1

Adobe hat das erste Service Pack für ADEP veröffentlicht.
Sie können es unter der folgenden Link herunterladen.

Adobe released the first service pack for ADEP.
You can download it under the following link.


Download - ADEP Service Pack 1
https://www.adobe.com/cfusion/entitlement/index.cfm?e=adep_sp1


Fehlerbehebungen bei ADEP Designer für folgende Probleme
//
Bug Fixes for ADEP Designer for following bugs

1. Dateifilter im Öffnen-Dialog zeigt keine entsprechenden Dateien an, wenn Dateityp "Designer-Dateien ( *.pdf, *.xdp) ausgewählt sind.
//
File filter of open dialog doesn't show files, when the file type "Designer files ( *.pdf, *.xdp)" is selected.

Fehlende Dateien im Öffnen-Dialog // Missing files in Open dialog

Korrekte Anzeige der vorhandenen Dateien // Correct view of present files

2. Ein fehlerhaftes Dokument-Level-Skript bewirkt das beim Öffnen einer mit Designer erstellten PDF jedes mal eine Fehlermeldung in der JavaScript-Konsole erscheint (nur bei der deutschen Version).

//

A faulty document level script causes the JavaScript console to report an error, everytime you open a PDF made with Designer (only with german version).

3. JavaScripte mit Sonderzeichen (z:B: äÄöÖüÜߧ€) scheitern kommentarlos oder mit sinnfreien Fehlermeldungen.

//

JavaScripts with special characters (such as äÄöÖüÜߧ€) fail without any feedback or with mindless messages.

Makro-Skript mit einen ä // macro script with an ä

Unsinnige Fehlermeldung beim Scheitern des Makro-Skripts
//
 Mindless error message when the macro script fails

Das Service Pack behebt noch einigen weitere Probleme, die mir selbst aber noch nicht begegnet sind.

Einzelheiten darüber können Sie der Dokumentation entnehmen.

The Service Pack fixes a few more bugs which I've never come across.

For more details refer to the documentation.

Download - ADEP Service Pack 1 Read Me

ADEP_DocServices_10.0.1_ReadMe.pdf

Dialog für Anweisungsenden modifizieren//Modify statement completion dialog

Der Skript-Editor in Designer bietet eine nützliche Funktion zum Anzeigen eines Dialogs mit möglichen Anweisungsenden während der Eingabe von Skripten inklusive der Beschreibung der Parameter.
Toll, aber obwohl die ganze Welt mittlerweile mit Monitoren mit riesigen Auflösungen benutzt, ist der Dialog für diese Funktionen seit Ewigkeiten winzig klein.
Bei Anweisungen wie z.B. "resolveNodes" ist nur ein kleiner Teil der Beschreibung zu lesen und man muss umständlich in dem Dialog scrollen.
Irgendwie mehr hinderlich als nützlich.

Es ist an der Zeit, das zu ändern.
Die folgenden Schritten zeigen, wie man den Dialog mittels der Freeware ResHacker anpassen kann.


Die Modifikation muss in der DesignerResources.dll erfolgen, wenn Ihr Designer eine andere Sprache als Englisch verwendet.
Diese finden Sie im Designer Programmordner z.B. unter C:\Program Files (x86)\Adobe Digital Enterprise Platform\Designer 10.0\DE\DesignerResources.dll.

Wenn Ihr Designer nur in englischer Sprache vorliegt, dann müssen Sie stattdessen die Datei FormDesigner.exe verändern!!!
Diese finden Sie z.B. unter C:\Program Files (x86)\Adobe Digital Enterprise Platform\Designer 10.0\FormDesigner.exe.


Diese Anleitung gilt für die DesignerResources.dll, aber die Vorgehensweise für die FormDesigner.exe ist quasi identisch.

The script editor in Designer has a nice functionality to display a dialog for statement completions while typing scripts including a description of the parameters.
Great, but although the whole world already uses monitors with huge resolutions this dialog is still very tiny.
With statements such as "resolveNodes" you only can see a small portion of the description and laborious have to scroll manually in the dialog.
More hindering that useful.

It's time to change it.
The followings steps explain how to change the dialog with the freeware ResHacker.


The modification has to be done in the DesignerResources.dll, when your Designer runs in another language than English.
You can find the file in the Designer program folder such as C:\Program Files (x86)\Adobe Digital Enterprise Platform\Designer 10.0\DE\DesignerResources.dll.

If you Designer is only in englisch, then you have to modifiy the FormDesigner.exe instead!!!
It located under C:\Program Files (x86)\Adobe Digital Enterprise Platform\Designer 10.0\FormDesigner.exe.

This instruction is related to the DesignerResources.dll, but the procedure for the FormDesigner.exe quasi is identically.

Zu kleiner Dialog für Anweisungsenden im Skript-Editor

//

Too small dialog for statement completion in script editor

Modifikation der DesignerResources.dll - Schritt für Schritt (Auf Ihre eigene Gefahr hin!!!)

//

Modification of DesignerResources.dll - Step by step (At your own risk!!!)

1. Öffnen Sie die DesignerResources.dll mit ResHacker und suchen sie des Dialog 281 im Dialog-Baum. Eine Vorschau des Dialogs wird automatisch angezeigt.

//

Open the DesignerResources.dll in ResHacker and look for dialog 281 in the dialog tree. A preview of the dialog is shown automatically.

2. Markieren Sie die Dialogvorschau und drücken Sie Strg+E, um den Dialog Editor zu öffnen.

//

Select the dialog preview and press crtl+E to open the dialog editor.

3. Ändern Sie die Werte für Breite (144 > 400) und Höhe (137 > 300) und drücken Sie OK.

//

Change the values for width (144 > 400) and height (137 > 300) an press OK.

4. Der Dialog ist nun vergrößert, müssen noch die beiden Felder angepasst werden. 

//

The dialog now is resized. Now the both fields needs to be adjusted. 

5. Markieren Sie das Listenfeld (weiß) und drücken Sie Strg+O, um den Control Editor zu öffnen.

//

Select the listbox (white) and press ctrl+O to open the control editor.

6. Ändern Sie die Werte für Breite (144 > 400) und Höhe (85 > 150) und drücken Sie OK.

//

Change the values for width (144 > 400) and height (85 > 150) an press OK.

7. Das Listenfeld ist nun auch angepasst.

//

Now the listbox is adjusted too.

8. Markieren Sie das Textfeld (grau) und drücken Sie wieder Strg+O.

//

Select the textfield (gray) and press ctrl+O again.

9. Passen Sie die Werte für Oben (86 > 151), Breite (144 > 400) und Höhe (85 > 149) an und drücken Sie OK.

//

Adjust the values for top (86 > 161), width (144 > 400) and height (85 > 149) an press OK.

10. Die Arbeit am Dialog ist damit abgeschlossen.

//

The work at the dialog is finished.

11. Um die Änderungen in die DLL zu schreiben, klicken Sie nun aus Skript kompilieren.

//

To apply the changes to the DLL press compile script.

12. Speichern Sie die DLL als DesignerResources.dll an einem beliebigen Ort.

//

Save the DLL as DesignerResources.dll in any location.

13. Ersetzen Sie die originale DLL (Backup machen!!!) durch Ihre neue im Designer-Programmordner.

//

Replace the original DLL (make a backup!!!) with your new one in the Designer programm folder.

14. Starten Sie Designer und testen Sie den Skript-Editor. Der Dialog ist nun auch für umfangreiche Beschreibungen ausreichend dimensioniert.

//

Start Designer and check the script editor. The dialog now has enough space even for large descriptions.

Lesezeichen in XFA-Formularen//Bookmarks in XFA forms

Mit der Dokumentation von Features hat es Adobe ja manchmal nicht so.
So liefert die Suche nach dem Wort "bookmark" in der aktuellen ADEP Designer Hilfe genau 0 Treffer.
Dabei ist es sehr wohl möglich, Lesezeichen in XFA-Formularen zu erstellen.
Super praktisch das, kann man sich doch das nachträgliche Hinzufügen über Acrobat sparen.

Lesezeichen werden unter dem extras-Objekt von Teilformularen, Feldern oder Inhaltsbereichen erstellt.
Das können Sie entweder per Hand in der XML-Quelle machen oder dafür auch dieses Makro benutzen.

HINWEIS:
Das Makro funktioniert grundlegend auch mit Designer ES2, d.h. im Formularentwurf werden die Lesezeichen auch erstellt.
Aber Designer ES2 scheint die PDF's anders zu rendern als der ADEP Designer, weshalb die Lesezeichen im fertigen PDF-Formular dann nicht angezeigt werden.
Da es von Designer ES2 mehrere Versionen gibt (mit Acrobat, Stand-Alone, mit Workbench, with SAP ...) kann es sein, dass es in der einen funktioniert und in der anderen nicht.

It seems Adobe sometimes doesn't bother to document features.
So the search for the term "bookmark" in the actual ADEP Designer help returns exactly 0 results.
Thereby it's really possible to create bookmarks in XFA forms.
Damned useful as you don't have to do this in Acrobat afterwards.

Bookmarks are created under the extras object of subforms, fields or areas.
You can do this either manually in the XML source or with this macro.

PLEASE NOTE:
Basically this macro will also work in Designer ES2.
This means the bookmarks are created correctly in the form template.
But, Desiger ES2 seams to render the forms in another way as ADEP Designer does, which why the bookmarks aren't visible in the finale PDF form.
As there are several versions of Designer ES2 available (with Acrobat, stand alone, with Workbench, with SAP ...) it's possible that it works with one them but not with the others .

Funktionsweise des Makro

//

How the macro works

Schritt 1 – Zuerst ein oder mehrere Objekte markieren und Makro aus dem Menü aufrufen
//
Step 1 – Select one or more objects first and then execute macro from menu


Schritt 2 – Flex Dialog des Macros öffnet sich
//
Step 2 – Flex Dialog of the macro opens

Schritt 3 – Einstellungen für das erste Objekt vornehmen und mit ">" zum nächsten wechseln
//
Step 3 – Make settings for the first object and go to the next with ">"

Schritt 4 – Einstellungen für alle weiteren Objekte vornehmen und abschließend mit "OK" bestätigen
//
Step 4 – Make settings for all following objects and finally confirm with "OK"

Schritt 5 – Die Lesezeichen werden unter dem Extras-Objekt eines jeden ausgewählten Objekts erstellt
//
Step 5 – The bookmarks will be created under the extras object of each of the selected objects

Schritt 6 – Im PDF-Viewer werden die Lesezeichen angezeigt
//
Step 6 – The PDF viewer shows the bookmarks

Aktualisierungen in Version 0.6
//
Updates in Version 0.6

1. Name des Lesezeichens lässt sich auch von einer Objekteigenschaft (Objektname, Klassenname oder Beschriftung) ableiten
   //
   The bookmark name can be deduced from an object property (object name, class name or caption) 
2. Das Makro kann nun für mehrere, gleichzeitige Auswahlen Lesezeichen mit individuellen Einstellungen erstellen
   //
   The macro now can create bookmarks for several selections at once with individual settings 
3. Objekte, bei denen keine Lesezeichen unterstützt werden, werden vom Makro ignoriert
   //
   Objects that do not support bookmarks are ignored by the macro 
4. Wird kein Name für das Lesezeichen eingegeben, wird automatisch der Name "Lesezeichen" verwendet
   //
   When there is no name defined for the bookmark it will be automatically named "bookmark" 

Aktualisierungen in Version 0.7
//
Updates in Version 0.7

1. Wenn das Marko aufgerufen wird, ohne dass ein Objekt markiert ist, läd das Makro alle unterstützten Objekte aus dem Formularentwurf
   //
   When the macro is executed without any selected object, the macro loads all supported objects from the template 
2. Das Ändern der Anzeigesprache im Makro verändert nun auch die Sprache in den Berichten usw.
   //
   Changing the UI language of the macro now also changes the languages of the macro reports etc.

Aktualisierungen in Version 0.8
//
Updates in Version 0.8

1. Unterstützung von Beschriftungen im Rich Text-Format
   //
   Support of captions with Rich Text formatting 
2. Für eine bessere Übersicht wird der SOM-Ausdruck des ausgewählten Objekts im Makro angezeigt
   //
   The SOM expression of the currently selected object is displayed in the macro for a better overview

Lesezeichen-Makro - Version 0.8
//
Bookmarker Macro - Version 0.8
https://cloud.acrobat.com/file/6c846219-6c0f-4f3d-9769-68bcf2c086aa