Bei der erstmaligen Installation von iPaper2 werden einige Demo Vorlagen in den Vorlagen Order kopiert. Nachdem diese Dateien kopiert wurden wird das Flag „copydefstat“ in der iPaper.XML Datei auf „True“ gesetzt.

Ist das Flag gesetzt werden die Demo Vorlagen nicht kopiert – auch wenn ein neuer Ordern ausgewählt wird der noch keine Demo Vorlagen enthält. Wird iPaper2 mit einer individuellen Konfigurations Datei per Commandline – /configfile=…. und /configreadonly=1 gestartet dann kann es sehr wohl wieder vorkommen dass die Demo Vorlagen nochmals kopiert und immer wieder eingefügt werden da iPaper nicht in der Lage ist die Config Datei zu überschreiben und das Statusflag „copydefstat“ bleibt auf „False“

Ebenso kann es vorkommen dass eine individuelle iPaper.XML Config Datei verwendet wird bei der das Flag „copydefstat“ fehlt und die Datei nur die Definition eines anderen Vorlagen Ordners enthält. Fehlt der „copydefstat“ Paramter so wird als Default „False“ angenommen und die Demo Vorlagen werden kopiert.

iPaper2 verfügt über die Möglichkeit die Einstellungen der Software und aller Funktionen von außen per XML Kommandos zu steuern und zu beeinflussen. Das betrifft die Grund-Einstellungen beim Start von iPaper2. Zusätzlich ist es damit auch möglich die Grundsettings dynamisch während der Verarbeitung der einzelnen PDF Dateien zu übersteuern. Dies kann entweder über eine extern zur Verfügung gestellte XML Datei erfolgen oder aber die XML Information wird „mitgedruckt“, vor der Verarbeitung im Dokument gesucht, extrahiert und für die Steuerung der Weiterverarbeitung herangezogen. Nach dem Extrahieren der XML Information aus dem PDF lassen sich die Seiten auf welchen sich die XML Information befunden hat aus dem Ergebnisdokument entfernen und löschen.

Über diese Steuerbefehle können sowohl die gewünschten Verarbeitungsschritte (Actions) für die Weiterverarbeitung der PDF Datei gesteuert, Voreinstellungen getroffen aber auch Elemente und Funktionen des User Interfaces deaktiviert werden.

iPaper2 – Dokumentation – XML Kommandos >>>

iPaper2 speichert alle seine Einstellungen in einer einzigen XML Datei – der iPaper.XML. Der  iPaper2 Client kann über eine Commandline Option mit unterschiedlichen Konfigurationen gestartet werden.  Ebens0 kann per Commandline Option unterbunden werden dass geänderte Einstellungen in die Konfigurationsdatei zurückgeschrieben werden – diese kann „Read-Only“ gesetzt werden.

iPaper2 – Client Commandline Parameter:

• /configfile=<the fully qualified path to the config file>
• /configreadonly=1|0 (this option has only effect if the /configfile is present

Das iPaper Setup installiert standardmäßig neben dem „normalen“ iPaper PDF Druckertreiber einen zusätzlichen Treiber der in der Lage ist eingestellte Blättränder zu berücksichtigen. Die Installation dieses zusätzlichen iPaper Treibers kann über einen Commandline Paramter unterbunden werden.

INST2NDPD=1|0

1 – zusätzlicher Treiber wird installiert

0 – zusätzlicher Treiber wird nicht installiert

msiexec /i iPaperNET_Client.msi INST2NDPD=0

Silent Setup: msiexec /i iPaperNET_Client.msi INST2NDPD=0 /quiet

Das iPaper 2 Userinterface ist multilinual ausgelegt – d.h. es können neue Sprachversionen hizugefügt und ergänzt werden. Standardmäßig sind die Sprachen English und Deutsch vorhanden.

Zur Übersetzung haben wir ein Tool entwickelt um die Ressourcen Dateien (RESX – XML Dateien) zu erzeugen und zu bearbeiten. Die RESX Dateien kann man jedoch nicht direkt verwenden – diese müssen erst in DLL´s verpackt und konvertiert werden.

With the tool we wrote – Translation.NET – it is possible to create resx files with other languages. That tool can easy used to translate the files but you can also send us the resx files, then we include them to the setup.

There is another solution, using WinRes to translate the satellite assemblies, but to use that tool the NET Framework SDK should be installed on the workstation. There are some problems:

• The translated resource may also contain the changed position of a control.
• New controls will not be translated, because the customer uses an old version of the satellite assemblies.

With the WinRes it is also possible to change the layout of the windows. But the resgen.exe and al.exe should be called to generate satellite assemblies.

The solution with the satellite assemblies should be applied when the application is completely ready, no more changes will be on the UI (or very few changes).

The NET Framework SDK is free of charge.

• NET 2.0 SDK (older) >>>
• Windows SDK (the latest development runtimes, tools) >>>

There is also a simple way.

• Translate the resx files with our tool
• Create .resources file from the resx files
• Compile the .resources file to .resources.dll (satellite assembly)

There are 2 NET tools, one generates .resources file from .resx and the another combines the .resources file to one (or more) satellite assembly.

The commands/tools are:
„%ProgramFiles%\Microsoft SDKs\Windows\v6.0A\Bin\ResGen.exe“ „D:\Programe May.NET\Translation Example\MainApplication\Form1.de-DE.resx“ „D:\Programe May.NET\Translation Example\MainApplication\MainApplication.Form1.de-DE.resources“

„%ProgramFiles%\Microsoft SDKs\Windows\v6.0A\Bin\al.exe“ /t:lib /culture:de-DE /out:“D:\Programe May.NET\Translation Example\MainApplication\bin\Debug\de-DE\MainApplication.resources.dll“ /embed:“D:\Programe May.NET\Translation Example\MainApplication\MainApplication.Form1.de-DE.resources“

The input file for the resgen is the Form1.de-DE.resx – this file can be created easily with the Translation.NET application.

The output after resgen.exe is the MainApplication.Form1.de-DE.resources

Using the al.exe (assembly linker) the MainApplication.Form1.de-DE.resources is embedded in a satellite assembly MainApplication.resources.dll.

The satellite assemblies should be copied in a subfolder of the application installation file. The subfolder name should be the same as specified in the /culture parameter, in our case de-DE

So the installation folder should look like:
MainApplication.exe
de-DE\MainApplication.resources.dll (the german resources)
it-IT\MainApplication.resources.dll (the italian resources)
…

Download Translation Example from here >>>

you will find a sample application and command file (createResources.cmd) which does these steps.

Another problem can be the deployment of these files. Under Windows Vista and Windows 7 (and also on XP with the latest updates) there is no possibility to write / copy files to the %ProgramFiles% folder, how you can deploy these files ? A solution would be to create a setup for these files and install it in the iPaper.NET application installation directory as subfolders.

Wir arbeiten gerade daran das iPaper Gesamtsetup zu überarbeiten und als MSI Setup zu implementieren. Als ersten Schritt ist jetzt der auf der aktuellen Version 3.14.2 basierende iPaper PDF Druckertreiber verfügbar. Für das Update muss der bereits installierte „iPaper PDF“ Treiber deinstalliert werden – nicht jedoch die „iPaper“ Software – Danach kann der neue iPaper PDF Druckertreiber über den Aufruf von  Setup.exe installiert werden.

Download – iPaper PDF Druckertreiber Version 3.14.2 >>>