...
Notez qu'esup-sgc s'appelle donc lui-même, via chromium et les outils ghostscript et imagemagick, on arrive ici à retrouver un BMP reprenant exactement le thème/look de la carte que l'on obtient via une impression HTML (telle que le propose esup-sgc pour permettre l'usage de tout type d'imprimante à carte).
Aussi il faudra avoir une installation serveur permettant cette génération bmp : en plus de wget, chromium, imagemagick... il faudra s'assurer que les fonts/polices utilisées dans votre thème de carte sont bien présentes sur votre serveur.
À minima, vous pouvez par exemple installer les principales polices proposées au travers des paquets de votre distribution linux : sous debian/trixie :
| Bloc de code | ||
|---|---|---|
| ||
sudo apt install -y fonts-dejavu fonts-liberation fonts-noto-core fonts-noto-cjk fonts-noto-extra fonts-urw-base35 |
| Avertissement |
|---|
Les commandes bash résultant des configurations BMP_COMMAND_BLACK_PRINTER, BMP_COMMAND_COLOR_PRINTER et BMP_COMMAND_VIRTUAL (pour l'affichage de la carte 'dématérialisée' sur mobile par exemple) sont exécutées par esup-sgc dans un répertoire temporaire propre à chaque commande (et dont le nom de dossier est forgé via l'id de la carte, le type de conversion et le timestamp). Ainsi en utilisant des chemins relatifs pour les fichiers pdf/images intermédiaires, comme proposé dans les configurations par défaut, esup-sgc peut appeler ces commandes en parallèle pour plusieurs cartes sans risque de conflit ou d'écrasement des fichiers temporaires. Chaque commande s'exécute dans son propre environnement (dossier) isolé, garantissant que les fichiers intermédiaires générés pour une carte n'interfèrent pas avec ceux des autres processus en cours. Cela permet à esup-sgc d'optimiser le traitement des cartes tout en maintenant l'intégrité des données, même lors d'exécutions simultanées. Utiliser un chemin absolu pour les fichiers intermédiaires est à proscrire, cela pourrait entraîner des erreurs graves, comme l'impression d'une carte avec les informations d'une personne, mais attribuée à une autre. |
Pour que ces commandes fonctionnent, il faut :
...
- pour ImageMagick le format PDF ne soit pas désactivé (il faudra peut-être commenter <policy domain="coder" rights="none" pattern="PDF" /> dans /etc/ImageMagick-6/policy.xml par exemple pour ce faire)
...
| Avertissement |
|---|
Les commandes bash résultant des configurations BMP_COMMAND_BLACK_PRINTER, BMP_COMMAND_COLOR_PRINTER et BMP_COMMAND_VIRTUAL (pour l'affichage de la carte 'dématérialisée' sur mobile par exemple) sont exécutées par esup-sgc dans un répertoire temporaire propre à chaque commande (et dont le nom de dossier est forgé via l'id de la carte, le type de conversion et le timestamp). Ainsi en utilisant des chemins relatifs pour les fichiers pdf/images intermédiaires, comme proposé dans les configurations par défaut, esup-sgc peut appeler ces commandes en parallèle pour plusieurs cartes sans risque de conflit ou d'écrasement des fichiers temporaires. Chaque commande s'exécute dans son propre environnement (dossier) isolé, garantissant que les fichiers intermédiaires générés pour une carte n'interfèrent pas avec ceux des autres processus en cours. Cela permet à esup-sgc d'optimiser le traitement des cartes tout en maintenant l'intégrité des données, même lors d'exécutions simultanées. Utiliser un chemin absolu pour les fichiers intermédiaires est à proscrire, cela pourrait entraîner des erreurs graves, comme l'impression d'une carte avec les informations d'une personne, mais attribuée à une autre. |
Pour que ces commandes fonctionnent, il faut :
- installer wget, chromium, imagemagick (convert), ghostscript (commande gs)
- pour ImageMagick le format PDF ne soit pas désactivé (il faudra peut-être commenter <policy domain="coder" rights="none" pattern="PDF" /> dans /etc/ImageMagick-6/policy.xml par exemple pour ce faire)
- modifier la configuration pour renseigner l'url de votre sgc, modifier éventuellement chromium par chromium-browser suivant votre distribution
- faire en sorte que le wget sur le serveur fonctionne : il vous faudra autoriser la propre IP d'esup-sgc à appeller son propre service REST : dans security.properties, ajoutez l'IP du sgc au niveau de accessRestrictionWSRestApi - esup-sgc lui-même doit en effet pouvoir accéder à /wsrest/view/ (d'où le bind-adress ici en cohérence avec le fichier applicationContext-security.xml)
En plus de wget, chromium, imagemagick... il faudra s'assurer que les fonts/polices utilisées dans votre thème de carte sont bien présentes sur votre serveur.
À minima, vous pouvez par exemple installer les principales polices proposées au travers des paquets de votre distribution linux : sous debian/trixie :
| Bloc de code | ||
|---|---|---|
| ||
sudo apt install -y fonts-dejavu fonts-liberation fonts-noto-core fonts-noto-cjk fonts-noto-extra fonts-urw-base35 |
...
Pour tester, allez dans 'admin' < 'themes cartes', sélectionnez un thème pour lequel au moins une carte existe avec ce thème, et vérifiez que dans le bloc "Prévisualisation BMP - édition en 1 passe" vous retrouvez bien une image de la carte dédiée au ruban noir et blanc et une autre dédiée aux rubans couleur. Si ça ne fonctionne pas, regardez dans les logs pour corriger le problème (sécurité, commande non fonttionnelle à tester et mettre au point depuis /tmp, etc.). Chaque commande étant censée produire un (et un seul) fichier card.bmp
...
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<c:if test="${type == 'black'}">
<style>
#right img {
display: none !important;
}
</style>
</c:if>
<c:if test="${type == 'color'}">
<style>
#left p,
#left img {
display: none !important;
}
</style>
</c:if> |
Enfin la visualisation de la "carte virtuelle" issue de la commande BMP_COMMAND_VIRTUAL peut également avoir l'intérêt de vous donner un aperçu de l'ensemble de la carte ; notamment is vous devez positionner des éléments couleurs et noir&blanc imbriqués.
ESUP-SGC-CLIENT et Imprimantes
...