Utilisation de modèles
Note :
Le chargement dynamique de modèles peut avoir un impact négatif sur les performances. Voir
Remarques relatives aux performances
à la page 12.
Références dans les modèles chargés dynamiquement
Les modèles comportant des dépendances (références externes à des fragments et des images) sont pris en charge si le Processus peut accéder aux fichiers référencés via :
• Des chemins statiques
• Des chemins relatifs par rapport à l'emplacement du modèle de formulaire dans un système de fichiers
• Un URL HTTP
Références dans les modèles du référentiel LiveCycle
Les modèles chargés dynamiquement à partir du référentiel LiveCycle ES2 ne peuvent pas contenir de références à d'autres ressources dans le référentiel. Cela signifie par exemple que les images doivent être incorporées ou utiliser des URL
HTTP, des chemins de fichiers, des URI FTP, etc.
Versions d'application
Il peut exister plusieurs versions d'une ressource dans le référentiel LiveCycle
ES2 qui sont liées à différentes versions de l'application LiveCycle. LiveCycle
Production Print ES2 n'utilisera pas automatiquement la dernière version de l'application.
Dans ce chapitre :
•
Utilisation d'une variable StreamServe pour charger un modèle
à la page 24
•
Utilisation d'une expression SOM pour charger un modèle
à la page 26
•
Chargement direct à partir du référentiel LiveCycle
à la page 27
•
Chargement de polices
à la page 28
23
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
24
Utilisation d'une variable StreamServe pour charger un modèle
Utilisation de modèles
Utilisation d'une variable StreamServe pour charger un modèle
Vous pouvez utiliser une variable StreamServe lorsqu'il est impossible de définir le chemin du modèle par le biais d'une expression SOM, ou lorsque le chemin doit
être spécifié à l'aide d'un script dans StreamServe.
La variable est évaluée une fois pour chaque job, immédiatement après le lancement du Processus. Le modèle est donc utilisé pour tous les enregistrements traités dans le job.
La variable est une chaîne et les chemins de fichier et les URI (fichier, HTTP et
URI de référentiel) sont pris en charge. Ils peuvent être absolus ou relatifs (par rapport au répertoire de travail StreamServer).
Pour les URI HTTP, vous pouvez utiliser l'authentification HTTP simple.
Exemple 1 Exemples de chemins de fichier et d'URI
• Chemin de fichier :
C:\templates\mytemplate.xdp
ou
../../MyTemplate.xdp
• URI de fichier : file:///D:/my%20templates/mytemplate.xdp
• URI HTTP :
HTTP:// www.exampletemplate.com
• URI de référentiel :
LC://myhost:8080/myfolder/myresource.xdp
Exemple 2
Exemple 3
Sélection d'un modèle sur la base de données externes
Le fichier du modèle utilisé pour une catégorie d'utilisateur particulière est stocké sur disque (ou dans une base de données).
Un script StreamServe Avant Processus est utilisé pour lire une valeur dans le fichier, selon la catégorie d'utilisateur, et permet d'attribuer le chemin du modèle
à la variable. Cette dernière est alors reprise pour sélectionner le modèle dans le
Processus.
Exemple de chemin absolu :
$template =”C:\templates\dynamic_invoice.xdp”;
Exemple de chemin relatif (à partir du répertoire de travail) :
$template = “../data/XDP_template/ dynamic_invoice.xdp”;
Sélection d'un modèle sur la base des méta-données
Le chemin du modèle est envoyé à StreamServe sous forme de valeur d'en-tête
HTTP.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Utilisation d'une variable StreamServe pour charger un modèle
Utilisation de modèles
25
Un script extrait cette valeur de l'en-tête HTTP et l'attribue à une variable. Cette dernière est alors reprise pour sélectionner le modèle dans le Processus.
Pour charger un modèle lors de l'exécution à l'aide d'une variable
StreamServe
1
Dans l'outil Processus, sélectionnez
Fichier > Ouvrir un modèle
. La boîte de dialogue Sélection du modèle s'ouvre (voir
Boîte de dialogue Sélection du modèle
).
2
Sélectionnez
Variable StreamServe
et entrez le nom de la variable qui pointe vers le modèle.
3
En cas de connexion à un référentiel LiveCycle, entrez les informations de
connexion au référentiel Runtime
.
4
Si vous utilisez un URI HTTP et l'authentification HTTP simple, sélectionnez
Utiliser l'authentification HTTP simple
et entrez les identifiants de connexion.
5
Cliquez sur
OK
. La fenêtre de démarrage de l'outil Processus s'ouvre.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
26
Utilisation d'une expression SOM pour charger un modèle
Utilisation de modèles
Utilisation d'une expression SOM pour charger un modèle
Utilisation de l'expression SOM
L'expression SOM s'avère utile lorsque le chemin d'accès à un modèle est accessible à partir du DOM de données et lorsque vous devez utiliser un modèle différent pour chacun des enregistrements d'un job d'arrière-plan.
L'expression SOM peut être évaluée une fois pour chaque enregistrement ou page traité. Il est donc possible d'utiliser des modèles différents pour chaque enregistrement ou page traité.
Les chemins de fichier et les URI sont pris en charge de la même façon que pour la variable StreamServe (voir
Utilisation d'une variable StreamServe pour charger un modèle
à la page 24).
Exemple 4 Expression SOM
Le chemin du modèle est enregistré dans un élément du fichier d'entrée.
Une expression SOM pointant vers cet élément permet de sélectionner le modèle dans le Processus.
Pour charger un modèle lors de l'exécution à l'aide d'une expression SOM
1
Dans l'outil Processus, sélectionnez
Fichier > Ouvrir un modèle
. La boîte
de dialogue Sélection du modèle s'ouvre (voir
Boîte de dialogue Sélection du modèle
).
2
Sélectionnez
Expression SOM
et entrez l'expression SOM dans le DOM de données qui pointe vers un modèle.
3
En cas de connexion à un référentiel LiveCycle, entrez les informations de
connexion au référentiel Runtime
.
4
Si vous utilisez un URI HTTP et l'authentification HTTP simple, sélectionnez
Utiliser l'authentification HTTP simple
et entrez les identifiants de connexion.
5
Cliquez sur
OK
. La fenêtre de démarrage de l'outil Processus s'ouvre.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Chargement direct à partir du référentiel LiveCycle
Utilisation de modèles
27
Chargement direct à partir du référentiel
LiveCycle
Les modèles chargés à partir du référentiel LiveCycle le sont de façon statique lors de la conception. StreamServer charge les modèles à partir du référentiel au moment de l'exécution. L'utilisateur peut donc mettre à jour un modèle et stocker une nouvelle version dans le référentiel lors de l'exécution. Le serveur chargera le dernier modèle stocké.
Pour charger un modèle à partir du référentiel LiveCycle
1
Dans l'outil Processus, sélectionnez
Fichier > Ouvrir un modèle
. La boîte de dialogue Sélection du modèle s'ouvre (voir
Boîte de dialogue Sélection du modèle
).
2
Entrez les informations de
connexion au référentiel Runtime
pour le référentiel LiveCycle.
3
Sélectionnez l'option
A partir du référentiel LiveCycle
et accédez à un modèle du référentiel. Les informations de connexion au référentiel
Runtime servent à se connecter au référentiel.
4
Cliquez sur
OK
. La fenêtre de démarrage de l'outil Processus s'ouvre.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
28
Chargement de polices
Utilisation de modèles
Chargement de polices
Pour des raisons de performance, StreamServe charge toutes les polices au démarrage de StreamServer.
Lorsque vous utilisez des modèles statiques, le package d'exportation Design
Center contient toutes les polices référencées.
Lorsque vous utilisez des modèles dynamiques, vous devez inclure manuellement les polices à utiliser.
Vous devez donc ajouter les polices au jeu de ressources d'un Projet.
Pour ajouter les polices au jeu de ressources d'un Projet
Importez manuellement les polices dans le Projet, comme l'explique la
documentation sur Design Center.
Astuce - Variante
Vous pouvez également suivre la procédure suivante pour ajouter manuellement les polices : importez un ou plusieurs modèles XDP contenant toutes les polices que vous souhaitez utiliser en tant que ressources et associez-les une à une à l'outil
Processus (LiveCycle).
Enregistrez le Processus après avoir attaché chaque ressource XPD. Toutes les polices utilisées seront alors automatiquement importées dans le Projet.
Vous pouvez, le cas échéant, supprimer les ressources XPD une fois l'opération terminée. Voir la documentation sur Design Center.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
