Serveur d'impression

Impression de PDF dans Application Express 3.1 et versions ultérieures – Bien choisir son serveur d impression

Le 3 mai 2019 - 16 minutes de lecture


Oracle Application Express Retour à la page d'accueil Oracle APEX Impression PDF dans Application Express
  1. Introduction et architecture
  2. Options de configuration
    2.1 Norme
    2.2 Avancé
    2.3 Avantages de l'utilisation de BI Publisher dans Application Express
  3. Installation et configuration d'Oracle BI Publisher sous Windows
    3.1 Prérequis
    3.2 Installation de BI Publisher
    3.3 Configuration d'Application Express pour utiliser BI Publisher
  4. Installation et configuration d'Oracle BI Publisher sous Linux
    4.1 Conditions préalables
    4.2 Installation de BI Publisher
    4.3 Configuration d'Application Express pour utiliser BI Publisher
  5. Installer et configurer Apache FOP
    5.1 Prérequis
    5.2 Instructions
  6. Configuration d'autres moteurs de traitement XSL-FO
1. Introduction et architecture Application Express 3.0 introduit la possibilité d’exporter une région de rapport au format PDF – essentiellement, l’impression d’un rapport. Ceci est défini de manière déclarative et est disponible pour toutes les régions du rapport. Les utilisateurs d'Application Express peuvent désormais afficher et imprimer des rapports avec des en-têtes de page répétés sur chaque page et un contenu conforme aux divers formats de page. Pour ce faire, les données de rapport sont converties au format PDF à l'aide d'un serveur de rapports défini en externe. Des améliorations d'impression supplémentaires ont été intégrées à Oracle Application Express 3.1 dans les attributs d'impression de région et les requêtes de rapport. Le diagramme ci-dessous illustre l’architecture d’impression PDF Application Express:
Architecture d'impression d'application PDF Express Express

Lorsque l'utilisateur final de l'application clique sur un lien d'impression, la demande est envoyée au moteur Application Express (qui fait partie de la base de données Oracle). Le moteur Oracle APEX génère ensuite les données de rapport correspondantes au format XML et le modèle de rapport au format XSL-FO ou RTF. Le moteur de génération de rapports externe transforme ensuite les données et le modèle en un fichier PDF qui est affiché à l'utilisateur final à l'aide du servlet de conversion fourni avec BI Publisher 10.1.3.2 (anciennement appelé Oracle XML Publisher). Toute cette complexité architecturale est transparente pour les utilisateurs finaux et les développeurs. Les utilisateurs finaux cliquent simplement sur les liens d'impression et les développeurs définissent simplement les régions de manière à prendre en charge l'impression PDF.

Retour au sommet

2. Options de configuration Votre serveur de rapports peut être Oracle BI Publisher, OC4J avec Apache FOP ou un autre moteur de traitement XSL-FO standard. Si vous choisissez BI Publisher comme serveur de rapports, vous bénéficierez d'un niveau de fonctionnalité supérieur. Pour répondre aux différences de fonctionnalités, Oracle Application Express propose deux niveaux de fonctionnalités: Standard et Avancé. Avec Standard, vous êtes limité aux modèles de rapport basés sur XSL-FO. 2.1 Norme

La configuration standard peut être implémentée avec Apache FOP ou un autre moteur de traitement XSL-FO standard. Depuis Application Express 3.0.1, une configuration prise en charge de FOP Apache en conjonction avec Oracle Containers for J2EE (version 10.1.3.2 ou ultérieure) est incluse. Ceci fournit un formatage déclaratif des régions de rapport et des requêtes de rapport avec un contrôle de base sur les attributs de page. Ces attributs incluent l'orientation, la taille, les formats d'en-tête de colonne, l'en-tête de page et le pied de page. Les captures d'écran suivantes illustrent la configuration standard:

Zone de rapport avec lien d'impression Sortie PDF du rapport standard Sortie PDF en utilisant des couleurs de fond

2.2 Avancé

La configuration avancée nécessite une licence valide pour Oracle BI Publisher. Avec la configuration avancée, vous disposez de toutes les fonctionnalités de la configuration standard, ainsi que de la possibilité de définir des présentations de rapports RTF développées à l'aide du plug-in de modèle de mots de l'éditeur BI. Cela permet un contrôle graphique facile sur tous les aspects de votre rapport. Vous pouvez ajouter des logos à vos pages, ajouter des sauts de contrôle complexes et avoir un contrôle total de la pagination. Vous pouvez même incorporer des graphiques et créer des rapports qui ressemblent exactement aux formulaires gouvernementaux standard. Les captures d'écran suivantes illustrent la configuration avancée:

Demande de subvention Master Detail avec des pauses Plusieurs graphiques et rapports

Il existe également un guide pour la création avancée de rapports PDF: Comment créer un rapport PDF détaillé.

2.3 Avantages de l'utilisation de BI Publisher dans Application Express

L'utilisation de BI Publisher en tant que serveur d'impression Application Express permet de créer des applications plus robustes et professionnelles.

  • Sans couture: Les fonctionnalités d'impression sont entièrement intégrées à Application Express.
  • Formats de sortie multiples: Peut générer des sorties Word, Excel et HTML en plus du PDF.
  • Mise en page de rapport robuste: Les développeurs peuvent utiliser des modèles RTF offrant un contrôle nettement plus important sur les ruptures de contrôle, les en-têtes et les pieds de page, ainsi que la possibilité d'intégrer des graphiques.
  • Prise en charge des polices non européennes occidentales: Capacités de localisation supérieures, comprenant une prise en charge complète de CJK, BiDi, Unicode et MLS.
  • Exporter / importer un seul fichier: Les dispositions de rapport RTF font partie de la définition de votre application. Elles sont donc exportées et importées avec l'application.
  • Pris en charge par Oracle: Avec BI Publisher, vous utilisez un produit Oracle pris en charge.

Outre les avantages de l'utilisation de BI Publisher dans Application Express, BI Publisher peut également être bénéfique pour votre organisation.

  • Calendrier et livraison
  • Créer des rapports basés sur plusieurs requêtes SQL
  • Support de base de données hétérogène
  • Éclatement
  • Signaler la mise en cache
  • Haute performance

Retour au sommet

3. Installation et configuration de Oracle BI Publisher sous Windows 3.1 Prérequis

Pour utiliser Oracle BI Publisher en tant que serveur de rapports, vous devez installer Oracle Business Intelligence Publisher, version 10.1.3.2.1 ou ultérieure. Ceci peut être téléchargé à partir du lien ci-dessous sous la licence de développeur OTN (… licence d'utilisation limitée des programmes uniquement pour développer un seul prototype de votre application, et à aucune autre fin …).

Téléchargements Oracle Business Intelligence Publisher, sélectionnez la dernière version de BI Publisher.

Vous pouvez également télécharger le logiciel Desktop en même temps. Cela vous permettra de créer des modèles RTF à utiliser dans vos rapports. Vous trouverez plus d'informations sur Oracle BI Publisher sur leur site OTN.

Notez s'il vous plaît:
1) La version minimale requise de BI Publisher, qui prend en charge l'intégration à Oracle Application Express, est la version 10.1.3.2. XML Publisher a été renommé BI Publisher avec la version actuelle 10.1.3.2. XML Publisher 5.6.2 ne prend pas en charge l'intégration à Oracle Application Express, il ne peut pas être utilisé comme moteur de rendu PDF.

2) Si vous rencontrez l'erreur suivante lorsque vous essayez de charger un exemple de fichier XML lors de la construction d'un modèle, "Erreur de compilation dans le module masqué: Module_starter", cela est dû à un correctif de sécurité Windows. La solution de contournement est la suivante:

  1. Allez au menu de démarrage:
    Tous les programmes -> Oracle BI Publisher Desktop -> Générateur de modèles pour le langage Word
  2. choisissez votre langue
  3. Cliquez sur OK

Vous devriez maintenant pouvoir utiliser le plug-in normalement.

3.2 Installation de BI Publisher

  1. Décompressez bipublisher_windows_x86_101321_disk1.zip dans un nouveau répertoire ( le_dir). Il est important que le chemin du répertoire ne contienne aucun espace, par exemple. n'utilisez pas 'C: … Mes documents Editeur BI'.
  2. Aller vers le_dir Windows Disk1 install
  3. Double-cliquez sur setup.exe
    Cela vous mènera à l'installateur Oracle
  4. Suivez les instructions à l'écran pour effectuer les sélections suivantes.
    • Pour Destination, entrez BIHOME
    • Pour le type, sélectionnez Basic
      Cela installe Oracle Containers for Java, Sun JDK, …
    • Définir un mot de passe administrateur OC4J
    • Sur la dernière page, 'Fin de l'installation', notez le numéro de port. Ce sera dans l'URL donnée qui peut être utilisée pour accéder à BI Publisher (par exemple 9704). Vous devez également noter le nom d'utilisateur et le mot de passe afin de pouvoir les utiliser ultérieurement si vous souhaitez vérifier que votre serveur XMLP est opérationnel.

Votre serveur de publication BI doit maintenant être opérationnel. Si vous souhaitez vérifier votre installation, vous pouvez accéder au serveur BI Publisher à partir du menu Démarrer de Windows sous "Oracle – BIHOME". Sélectionnez BI Publisher Server et si les écrans de connexion apparaissent, votre serveur est en cours d'exécution. Si vous le souhaitez, vous pouvez vous connecter à l'aide du nom d'utilisateur et du mot de passe fournis par le programme d'installation (par exemple, Administrateur / Administrateur).

3.3 Configuration d'Application Express pour utiliser BI Publisher

Pour utiliser BI Publisher comme serveur de rapports, accédez d’abord aux paramètres d’impression de rapport:

  1. Accéder à la page d'accueil des services d'administration
  2. Sélectionnez Gérer le service
  3. Sélectionnez Paramètres d'instance, sous Gérer les paramètres d'environnement.
  4. Cliquez sur Impression de rapport pour vous concentrer uniquement sur les attributs d'impression de rapport.

Maintenant, spécifiez les attributs suivants:

  • Oracle BI Publisher: Support avancé
  • Protocole du serveur d'impression: HTTP ou HTTPS (dépend de votre configuration)
  • Adresse hôte du serveur d'impression: le nom d'hôte de la machine sur laquelle vous avez installé BI Publisher – par exemple. myhost.mycompany.com
  • Port du serveur d'impression: le port indiqué à la fin de l'installation de BI Publisher – par exemple. 9704
  • Script serveur d'impression: / xmlpserver / convert

Pour plus d'informations sur BI Publisher, reportez-vous au site OTN BI Publisher. Application Express est compatible avec BI Publisher 10.1.3.2 et les versions ultérieures.

Retour au sommet

4. Installation et configuration de Oracle BI Publisher sous Linux 4.1 Conditions préalables

Pour utiliser Oracle BI Publisher en tant que serveur de rapports, vous devez installer Oracle Business Intelligence Publisher, version 10.1.3.2.1 ou ultérieure. Ceci peut être téléchargé à partir du lien ci-dessous sous la licence de développeur OTN (… licence d'utilisation limitée des programmes uniquement pour développer un seul prototype de votre application, et à aucune autre fin …).

Téléchargements Oracle Business Intelligence Publisher, sélectionnez la dernière version de BI Publisher.

Vous pouvez également télécharger le logiciel Desktop en même temps. Cela vous permettra de créer des modèles RTF à utiliser dans vos rapports. Vous trouverez plus d'informations sur Oracle BI Publisher sur leur site OTN.

Avant d'installer Oracle BI Publisher, assurez-vous que Java SDK 1.5.0 est installé sur votre système. Le SDK Java peut être téléchargé ici:

Téléchargements

Remarque: le nom de version de Sun était à l'origine de la plate-forme Java 2, Standard Edition 1.5.0 (Kit de développement J2SE 1.5.0). Le système de numérotation est passé à 5.0 (J2SE 5.0). 1.5.0 et 5.0 font référence à la même plate-forme et au même produit.

4.2 Installation de BI Publisher

Sur la base de la version de BI Publisher téléchargée, sélectionnez la documentation appropriée dans la documentation de BI Publisher et suivez le guide d'installation fourni dans la rubrique Mise en route.

Une fois l'installation de BI Publisher terminée, vous devez démarrer OC4J. Après avoir démarré OC4J, vous devez ouvrir la page de démarrage de BI Publisher pour vérifier que BI Publisher est opérationnel. Si vous ne savez pas quelle adresse d'hôte ni quel port vous devez utiliser lors de sa configuration dans Application Express, veuillez référencer l'adresse d'hôte et le port indiqués dans le champ URL de votre navigateur après avoir ouvert la page de démarrage de BI Publisher.

4.3 Configuration d'Application Express pour utiliser BI Publisher

Pour utiliser BI Publisher comme serveur de rapports, accédez d’abord aux paramètres d’impression de rapport:

  1. Accéder à la page d'accueil des services d'administration
  2. Sélectionnez Gérer le service
  3. Sélectionnez Paramètres d'instance, sous Gérer les paramètres d'environnement.
  4. Cliquez sur Impression de rapport pour vous concentrer uniquement sur les attributs d'impression de rapport.

Maintenant, spécifiez les attributs suivants:

  • Oracle BI Publisher: Support avancé
  • Protocole du serveur d'impression: HTTP ou HTTPS (dépend de votre configuration)
  • Adresse hôte du serveur d'impression: le nom d'hôte de la machine sur laquelle vous avez installé BI Publisher – par exemple. myhost.mycompany.com
  • Port du serveur d'impression: le port indiqué à la fin de l'installation de BI Publisher – par exemple. 9704
  • Script serveur d'impression: / xmlpserver / convert

Pour plus d'informations sur BI Publisher, reportez-vous au site OTN BI Publisher. Application Express est compatible avec BI Publisher 10.1.3.2 et les versions ultérieures.

Retour au sommet

5. Installer et configurer Apache FOP 5.1 Prérequis

Une configuration prise en charge de Apache FOP en conjonction avec Oracle Containers for J2EE (version 10.1.3.2 ou ultérieure) est fournie avec Application Express 3.0.1. L’installation d’Apache FOP est incluse dans la distribution Application Express sous répertoire_installation_apex/utlities/fop/fop.war.

Notez s'il vous plaît – Depuis Application Express 3.0.1, Apache FOP associé à Oracle Containers for J2EE (version 10.1.3.2 ou ultérieure) est un serveur de rapports pris en charge, mais uniquement lorsqu'il est installé à l'aide des fichiers fournis. Les autres configurations d'Apache FOP ne sont pas prises en charge. Les questions relatives aux autres configurations doivent être publiées sur le forum OTN Application Express.

Avant de commencer, vous devez avoir installé Oracle Containers for J2EE (OC4J). La version suivante d'OC4J a été vérifiée pour fonctionner avec la solution FOP décrite ci-dessous.

  • Conteneurs Oracle pour J2EE (10.1.3.2 ou supérieur)

Étape 1: Installation du fichier WAR

Placez le fichier fop.war (situé dans répertoire_installation_apex/ utlities / fop) dans un emplacement accessible sur votre ordinateur local. Vous suivez ensuite les instructions ci-dessous ou vous pouvez visualiser le processus en exécutant cette viewlet.

  1. Accédez à votre console Oracle Enterprise Manager OC4J, par exemple: http: // localhost: 8888 / em /.
  2. Sélectionnez l'onglet Applications
  3. Sélectionnez le bouton de déploiement
  4. Dans la page "Déployer: Archiver", utilisez l'option "L'archive est présente sur l'hôte local. Téléchargez l'archive sur le serveur sur lequel le contrôle du serveur d'applications est en cours d'exécution". Utilisez le navigateur de fichiers pour sélectionner le fichier fop.war et cliquez sur le bouton "Suivant"
  5. Sur la page "Déployer: Attributs de l'application", définissez l'option "Nom de l'application" sur "fop", désactivez l'option "Racine de contexte" et cliquez sur le bouton "Suivant".
  6. Sur le déploiement: Paramètres de déploiement cliquez sur le bouton "Déployer"

Étape 2: configurer Oracle Application Express pour qu'il utilise le JSP pour l'impression au format PDF

Une fois le FOP installé, accédez aux paramètres d’impression de rapport:

  1. Accéder à la page d'accueil des services d'administration
  2. Sélectionnez Gérer le service
  3. Sélectionnez Paramètres d'instance, sous Gérer les paramètres d'environnement.
  4. Cliquez sur Impression de rapport pour vous concentrer uniquement sur les attributs d'impression de rapport.

Maintenant, spécifiez les attributs suivants:

  • Oracle BI Publisher: Support standard
  • Protocole du serveur d'impression: HTTP ou HTTPS (dépend de votre configuration)
  • Adresse hôte du serveur d'impression: le nom d'hôte de la machine sur laquelle le conteneur java est en cours d'exécution – par exemple. myhost.mycompany.com
  • Port du serveur d'impression: le port d'écoute de l'OC4J – par exemple. 8888
  • Script serveur d'impression: /fop/apex_fop.jsp

Assurez-vous que vous entrez les paramètres du serveur d'impression exactement tels que spécifiés, n'utilisez pas http: // devant votre nom d'hôte, n'utilisez pas de signe deux-points sur vos paramètres de port et n'utilisez pas un "/" après le nom JSP, uniquement avant: "/fop/apex_fop.jsp".

Retour au sommet

6. Configuration d'autres moteurs de traitement XSL-FO Si vous préférez utiliser un autre moteur de traitement XSL-FO, vous devez créer un noeud final offrant des fonctionnalités similaires à celles de l'exemple JSP fourni pour l'exemple Fache Apache ci-dessus. Seuls les serveurs de rapports pris en charge par Oracle BI Publisher et l'installation décrite ci-dessus d'Apache FOP avec Oracle Containers for J2EE (version 10.1.3.2 ou ultérieure) sont pris en charge. Les questions relatives à d'autres moteurs de traitement XSL-FO doivent être publiées sur le forum OTN Application Express.

Retour au sommet

7. Activation des services réseau dans Oracle Database 11g Par défaut, la capacité d'interagir avec les services réseau est désactivée dans Oracle Database 11g version 1 (11.1). Par conséquent, si vous exécutez Oracle Application Express avec Oracle Database 11g version 1 (11.1), utilisez le nouveau package DBMS_NETWORK_ACL_ADMIN pour accorder des privilèges de connexion à tout hôte pour l'utilisateur de la base de données FLOWS_030100. Si vous n'accordez pas ces privilèges, vous rencontrez des problèmes d'impression de PDF / rapports. En particulier, vous obtiendrez le message d'erreur suivant:

ORA-20001: Le moteur d'impression n'a pas pu être atteint car
l'URL spécifiée est incorrecte ou une URL de proxy doit être spécifiée.

Suivez les étapes mentionnées dans le Guide d'installation d'Oracle Application Express, Activation des services réseau dans Oracle Database 11g. Reportez-vous également à la section de résolution des problèmes si vous recevez une erreur ACL ORA-44416: non valide après l'exécution du script précédent.

Retour au sommet

Commentaires

Laisser un commentaire

Votre commentaire sera révisé par les administrateurs si besoin.