Dépannage élémentaire

Lorsqu'un rapport est affiché au format PDF ou Excel, les images de carte sont chargées dans le serveur EM4C. Les fichiers image sont écrits temporairement sur le disque à l'emplacement spécifié par la propriété IMAGE_TEMP_FOLDER dans <em4c_location>/webapps/em4c/WEB-INF/web.xml. Par défaut, l'emplacement du dossier temporaire des images est <em4c_location>/webapps/em4c/temp/images.

Lors de la résolution des problèmes d'affichage des cartes au format PDF ou Excel, commencez par vérifier que les images de carte ont été chargées dans le dossier temporaire des images sur le serveur EM4C. Si les images ne sont pas chargées, vérifiez que le serveur EM4C est en cours d'exécution et que le dossier temporaire des images est accessible en écriture.

Si les images de carte sont chargées sur le serveur EM4C, mais que la carte n'apparaît toujours pas dans le rapport PDF ou Excel, il s'agit probablement d'un problème de configuration, avec IBM Cognos ou avec Esri Maps for IBM Cognos. Vous pouvez déterminer si la cause du problème provient de votre configuration IBM Cognos ou de votre configuration Esri Maps for IBM Cognos en créant et en testant un rapport avec seulement une image statique. L'image doit se situer sur la passerelle IBM Cognos (par exemple, <cognos_gateway_machine>/ibmcognos/em4c/images/move_down.gif) et doit être référencée avec une URL relative (par exemple, ../em4c/images/move_down.gif). Si l'image n'apparaît pas lorsque vous affichez le rapport aux formats PDF et Excel, le problème provient de votre configuration IBM Cognos.

Si l'image apparaît dans le rapport de test, il est possible que votre configuration Esri Maps for IBM Cognos soit la source du problème. Pour débuter le dépannage, vérifiez que les conditions suivantes sont remplies :

• L'URI de la passerelle EM4C (nom du serveur, port et répertoire virtuel IBM Cognos) et l'URI de la passerelle IBM Cognos doivent être identiques.
• Dans les configurations qui intègrent un protocole de sécurité SSL (Secure Sockets Layer), le répartiteur IBM Cognos télécharge les images de carte via la passerelle IBM Cognos. Cela signifie que les conditions suivantes doivent être vraies :
  • Le serveur Web doit autoriser le processus du répartiteur à émettre des appels HTTP ou HTTPS vers /<ibmcognos>/em4c/cgi-bin/em4c.cgi.
  • Le répartiteur IBM Cognos doit être capable d'approuver le certificat SSL. Consultez la documentation IBM Cognos et la rubrique Les images ne s'affichent pas lorsque le rapport est exécuté au format PDF pour en savoir plus sur ce problème de configuration. Pour plus d'informations, consultez l'article 000012432 de la base de connaissance.
  • Si un pare-feu sépare la passerelle IBM Cognos et le répartiteur IBM Cognos, une règle de pare-feu autorisant le répartiteur à accéder à /<ibmcognos>/em4c/cgi-bin/em4c.cgi doit être créée.

Les polices ne s'affichent pas correctement

Lorsqu'une carte est affichée ou imprimée à partir d'Internet Explorer, certains caractères peuvent ne pas apparaître sur l'image de la carte si le serveur EM4C ne possède pas de police TrueType prenant en charge les caractères affichés sur la carte. Dans ce cas, vous devez rechercher une police TrueType prenant en charge les caractères nécessaires et soit l'installer en tant que police système, soit placer une copie de la police dans le dossier /fonts/fallback du serveur EM4C. Une fois la nouvelle police installée ou placée, vous devez redémarrer le service EM4C pour que les changements entrent en vigueur.

Les rapports comportant plusieurs pages et cartes n'affichent qu'une seule carte

Lorsque vous effectuez le rendu d'une carte au format PDF ou Excel, Esri Maps for IBM Cognos génère une image de la carte telle qu'elle s'affiche en HTML. Pour générer l'image de la carte, Esri Maps for IBM Cognos nécessite que le rendu de la carte soit effectué lorsque le format PDF ou Excel est sélectionné.

Ainsi, si un rapport contient des cartes sur plusieurs pages, seules les cartes figurant sur la page HTML affichée actuellement sont rendues dans le document PDF ou Excel en sortie. Pour imprimer toutes les cartes d'un rapport de plusieurs pages, vous devez imprimer chaque page séparément afin d'en afficher correctement l'instantané de l'image dans la sortie imprimée. Pour chaque page contenant une carte, localisez la page HTML à imprimer, sélectionnez le format de sortie de votre choix, puis recherchez et imprimez la page dans le document en sortie.

Une zone blanche apparaît à la place de la carte

Lorsqu'une zone blanche apparaît à la place de la carte dans un rapport affiché au format PDF ou Excel 2007, le problème peut être lié à l'une des causes suivantes :

• Si l'URI de la passerelle EM4C (nom du serveur, port, etc.) ne correspond pas à l'URI de la passerelle IBM Cognos ou si d'autres erreurs sont commises lors de la configuration de la passerelle EM4C, la carte ne s'affiche pas. Vérifiez que la partie du nom d'hôte de l'URI pour la passerelle EM4C comme pour la passerelle IBM Cognos localhost est remplacée par une adresse IP ou un nom d'hôte réseau. Pour plus d'informations, reportez-vous à la rubrique Configurer la passerelle EM4C
• Lorsque les rapports cartographiques sont affichés aux formats PDF et Excel 2007, une image de la carte est générée et enregistrée sur le serveur EM4C. L'emplacement de stockage de l'image de la carte est indiqué à l'aide d'une URL relative afin que le contenu puisse être enregistré et qu'il soit accessible si le rapport est déplacé dans un environnement configuré avec un répertoire virtuel IBM Cognos différent. Un défaut connu, présent sur certaines versions d'IBM Cognos, empêche le chargement des images à l'aide des URL relatives via des requêtes HTTP. Ce problème peut être résolu en procédant à une mise à niveau vers une version d'IBM Cognos qui comprend un correctif du défaut ou en modifiant manuellement les rapports concernés pour qu'ils utilisent un chemin absolu pour l'URL de l'image de la carte. Pour plus d'informations, consultez l'article 000013621 de la base de connaissance.
• Dans les configurations qui intègrent un protocole de sécurité SSL (Secure Sockets Layer), ce problème peut être déclenché par une chaîne d'approbation incomplète ou manquante pour SSL au sein du magasin de clés IBM Cognos. Dans ce cas, lorsque vous affichez un rapport cartographique au format PDF ou Excel 2007, la passerelle IBM Cognos est incapable d'accéder aux images de carte sur le serveur Web, car aucune chaîne d'approbation pour SSL n'a été établie entre le serveur Web et les composants de niveau d'application IBM Cognos.

  Pour établir la confiance entre le serveur Web et IBM Cognos, l'administrateur IBM Cognos doit importer la chaîne d'approbation du certificat SSL dans le magasin de clés de l'autorité de certification IBM Cognos. Pour plus d'informations, consultez l'article 00012432 de la base de connaissance.

Le rapport n'est pas généré après la sélection d'un format de rapport.

Après la sélection d'un format de rapport tout en consultant un rapport cartographique au format HTML, un pointeur de souris tournoyant risque d'apparaître sur la carte pendant la génération du rapport. Ce problème peut survenir si vous utilisez Mozilla Firefox ou Google Chrome dans un environnement système où Internet Information Services (IIS) est utilisé comme serveur Web pour la passerelle EM4C. Pour plus d'informations et pour savoir comment résoudre ce problème, consultez l'article 000012227 de la base de connaissance.