Fichiers de configuration / Imprimante PDF
Le programme est hautement contrôlable grâce aux nombreuses options de réglage. Chacun des paramètres possibles peut affecter directement la sortie ou l'expérience utilisateur. Lorsque le programme est exécuté, les paramètres sont lus à partir d'une série de fichiers de configuration. Ces fichiers et leur emplacement sont décrits plus en détail ci-dessous.
Les fichiers de configuration sont essentiellement des fichiers texte qui contiennent les paramètres de programme nécessaires dans une structure de fichiers INI. Les paramètres peuvent être modifiés via la boîte de dialogue des options du programme ou l'API de l'imprimante. Des modifications peuvent également être apportées en ouvrant les fichiers avec le Bloc-notes ou tout autre éditeur de texte possible. Les fichiers peuvent être enregistrés en Unicode, UFT-8 ou simplement en encodage ANSI ordinaire.
Paramètres Runonce
Lorsqu'un travail d'impression est envoyé au programme, un fichier runonce est recherché. Le fichier de configuration runonce (runonce.ini) est utilisé pour contrôler la création de PDF à partir d'un autre programme. Un fichier de configuration runonce n'est valide que pour un seul travail d'impression et est ensuite automatiquement supprimé de l'imprimante PDF. Tous les autres fichiers de configuration sont ignorés s'il existe un fichier runonce.
Paramètres normaux
Dans le cas où aucun fichier de configuration runonce.ini n'existe (la plupart du temps uniquement requis et utile pour une utilisation programmatique ou des environnements multi-utilisateurs), le programme vérifie s'il peut trouver un fichier de configuration settings.ini pour les paramètres normaux. Le fichier de configuration settings.ini est modifié directement par la boîte de dialogue des options, que vous pouvez appeler via le menu Démarrer. Il contient la configuration normale de l'imprimante PDF dans le contexte utilisateur respectif.
Les fichiers settings.ini et user.ini sont créés après l'ouverture de la fenêtre de dialogue Options d'imprimante 7-PDF et après avoir enregistré les paramètres de la boîte de dialogue pour la première fois. Immédiatement après une installation, le répertoire est toujours vide.
Après l'enregistrement, la boîte de dialogue des options crée alors les fichiers INI...
Paramètres globaux
Les paramètres du fichier de configuration normal peuvent être remplacés par le fichier de configuration global (global.ini). Un fichier de configuration globale peut forcer des paramètres globaux, par rapport au paramètre normal, qui devraient être activés pour tous les utilisateurs d'un système (exemple: imprimante réseau PDF). S'il existe des paramètres dans le fichier de configuration normal et dans le fichier global, les paramètres du fichier de configuration globale ont toujours la priorité. L'existence d'un fichier de configuration global n'a aucun effet, s'il existe un fichier de configuration runonce - alors il sera utilisé!
Paramètres par défaut
Les paramètres par défaut (defaults.ini) sont les paramètres utilisés si aucune valeur n'a été spécifiée ailleurs.
Paramètres utilisateur
Un fichier de configuration utilisateur (user.ini) est créé pour stocker les informations de chemin de stockage, telles que celles du dernier fichier ou du dernier répertoire actif de l'utilisateur.
Runonce - Paramètres - Programmable ou pour la génération de fichiers PDF à accès protégé dans des environnements multi-utilisateurs (environnements Citrix, serveur de terminaux)
Lorsqu'un travail d'impression est dirigé vers le programme, la première étape consiste à rechercher un fichier runonce. Les fichiers de configuration runonce ont la priorité la plus élevée pour l'imprimante 7-PDF. Le fichier de configuration runonce est utilisé pour contrôler la génération de PDF à partir d'un autre programme tiers (propre programme qui préconfigure l'imprimante 7-PDF via COM, macros VBScript, etc.). Un fichier de configuration runonce n'est valide que pour un travail d'impression à la fois, puis est automatiquement supprimé de l'imprimante PDF. Tous les autres fichiers de configuration sont ignorés s'il existe un fichier runonce.
Traitement simultané des travaux d'impression PDF
Les travaux d'impression PDF déclenchés simultanément de ce type peuvent poser problème, car un runonce.ini peut être remplacé par un deuxième travail d'impression déclenché par programme. Pour éviter cela, un fichier de configuration runonce spécial peut être créé par programmation à partir de la spécification supplémentaire du nom du document. L'existence d'un tel fichier runonce_documentname.ini est reconnue par l'imprimante 7-PDF et utilisée pour le document respectif à convertir en PDF avant de rechercher un fichier de configuration runonce.ini normal. Vous pouvez lier des configurations dynamiques de l'imprimante au travail d'impression PDF en spécifiant le nom du document et également empêcher le remplacement des fichiers de configuration si des travaux d'impression sont déclenchés simultanément.
Comment obtenir le nom du document pour un travail d'impression PDF afin de pouvoir le programmer selon ce schéma pour créer un fichier de configuration runonce_dokumentnamen.ini spécial dans le code source? La façon la plus simple de le faire est de regarder la boîte de dialogue du spouleur de l'imprimante 7-PDF.
La figure suivante montre la boîte de dialogue du spouleur d'un travail d'impression PDF sur une imprimante 7-PDF, qui a été lancée à partir de l'application Windows Microsoft Word Viewer pour un document Word avec le nom de fichier infile.doc.
Pour cette demande de spoule, un fichier de configuration runonce_documentname.ini approprié ressemblerait exactement à la figure ci-dessous:
Vous pouvez voir que les espaces dans le nom de document du fichier de configuration runonce_documentname.ini ont été remplacés par des codes conformes au codage URL%20 = espaces.
Dans Delphi, cela a été implémenté dans le code source comme suit:
djobname:= 'Microsoft Word Viewer - ' + ExtractFileName(txtInFile.Text);
rp:=oPDF.getSettingsFilePath(true);
djobname := StringReplace(djobname, '#','%23',[rfIgnoreCase, rfReplaceAll]);
djobname := StringReplace(djobname, ' ','%20',[rfIgnoreCase, rfReplaceAll]);
oPDF.WriteSettingsFile(ExtractFilePath(rp)+'runonce_'+djobname+'.ini');
Un caractère # existant dans le document à imprimer serait remplacé par l'URL codant %23 , un espace par %20 etc.
Le chemin dans lequel le fichier runonce à créer doit être stocké est déterminé dans la source par la méthode COM getSettingsFilePath()
. Le fichier de configuration runonce_documentname.ini est enregistré via la méthode COM WriteSettingsFile()
dans la dernière instruction.
Noms de fichiers et emplacements
Le tableau ci-dessous répertorie les différents fichiers de configuration du programme et leurs emplacements de stockage. Le tableau contient également des constantes telles que CSIDL_LOCAL_APPDATA, CSIDL_APPDATA et CSIDL_COMMON_APPDATA. Ils représentent les répertoires de profil utilisateur spéciaux ou les répertoires système du système d'exploitation. Ces emplacements varient en fonction de la version du système d'exploitation et de la langue.
Runonce Settings | runonce.ini | {CSIDL_LOCAL_APPDATA}\PDF Writer\printername\ |
Paramètres normaux | settings.ini | {CSIDL_APPDATA}\PDF Writer\printername\ |
Paramètres généraux | global.ini | {CSIDL_COMMON_APPDATA}\PDF Writer\printername\ |
Paramètres standard | defaults.ini | {CSIDL_COMMON_APPDATA}\PDF Writer\printername\ |
User Settings | user.ini | {CSIDL_APPDATA}\PDF Writer\printername\ |
Le nom de l'imprimante doit être extrait du nom de fichier ou du chemin d'accès mentionné ci-dessus, que vous souhaitez contrôler avec les paramètres du ou des fichiers de configuration.
Si vous souhaitez voir les valeurs de votre système pour CSIDL_LOCAL_APPDATE, CSIDL_APPDATA et CSIDL_COMMON_APPDATA, vous pouvez lancer gui.exe depuis le chemin d'installation de l'imprimante 7-PDF avec le paramètre info. Ensuite, une fenêtre de message apparaît avec les chemins de stockage des fichiers de configuration individuels.
Commande DOS complète: gui.exe info printer="7-PDF Printer"
Le chemin d'accès des fichiers de configuration sous une installation allemande de Windows 7.
Le chemin d'accès des fichiers de configuration sous une installation allemande de Windows XP.
Encoding
Les fichiers de configuration prennent en charge plusieurs types d'encodage. Selon l'encodage utilisé, l'encodage utilisé doit être inséré dans l'en-tête du fichier de configuration. Seul ANSI n'en a pas besoin. Cependant, ANSI ne peut pas contenir tous les caractères internationaux possibles. Si vous utilisez l'API d'imprimante, l'encodage est déterminé par l'API elle-même.
Les fichiers Unicode contiennent 0xFF et 0xFE dans le préfixe de fichier. Cette signature spécifie "Little Endian Unicode". L'autre type Unicode est "Big Endian Unicode" et est identifié par un préfixe 0xFE suivi de 0xFF. "Little Endian" est utilisé de préférence.
Les fichiers UTF-8 doivent commencer par la séquence d'octets 0xEF, 0xBB, 0xBF.