Mode débogage

L'équipe en charge de l'implémentation peut exécuter le système en utilisant un mode particulier lors de la configuration de l'application. Pour activer ce mode, saisissez ?debug=true à la fin de l'URL d'accès à l'application. Par exemple, si l'URL standard est http://CD-Production:7500/cis.jsp, saisissez http://CD-Production:7500/cis.jsp?debug=true pour activer le mode configuration.

En outre, si vous disposez d'un accès sécurisé au service applicatif F1OUDBUG, vous pouvez activer ce mode sans modifier l'URL via l'option Menu d'aide - Activer le débogage. Si le mode de débogage est activé, l'entrée du menu d'aide affiche une option Désactiver le débogage, qui vous permet de la désactiver sans modifier l'URL.

Dans ce mode, certains outils pour le débogage deviennent disponibles via une icône visible. Icône de débogage Cliquez sur l'icône pour afficher un panneau coulissant avec les options définies ci-dessous.

Les éléments suivants sont liés au débogueur avancé :

  • L'option Démarrer le débogage ouvre une session de consignation. Au cours de cette session, le traitement de divers objets d'outils de configuration est consigné. Le fichier journal affichera par exemple les zones de données transmises à chaque étape et celles retournées après traitement de chaque étape.
  • L'option Arrêter le débogage mettra fin à la session de consignation.
  • L'option Afficher la trace ouvre une fenêtre contenant la session de consignation. Toutes les étapes sont initialement réduites.
  • L'option Effacer la trace efface votre fichier journal.
Remarque :
Les boutons sont sécurisés. Le service applicatif F1CONFIGLOG est associé à cette fonctionnalité pour définir des restrictions d'accès à ces boutons lors de l'implémentation. Un service d'application supplémentaire F1DEBUG est sélectionné lorsque l'environnement n'est pas un environnement de développement. Une couche de sécurité supplémentaire est ainsi implémentée pour les utilisateurs évoluant dans un environnement de production. (Pour les clients cloud, le débogueur avancé n'est disponible que dans un environnement de développement).

Les fonctions suivantes permettent d'afficher les entrées de journal capturées lors de l'utilisation du système.

  • Le bouton Afficher le journal utilisateur vous permet d'afficher vos propres entrées journal. Vous pouvez indiquer le nombre d'entrées de "suivi" à afficher dans le champ Entrées journal adjacent avant de cliquer sur le bouton. En limitant le nombre d'entrées à afficher, vous n'aurez pas à faire défiler manuellement la liste et vous pourrez consulter directement les entrées les plus récentes.

  • Afficher le journal permet de définir des paramètres avancés. Cette option fournit une plage de dates/heures permettant à un utilisateur de cibler la sortie pour une période spécifique. Par ailleurs, les administrateurs peuvent demander à consulter les journaux des autres utilisateurs. Voici des exemples de cas où cette fonctionnalité est nécessaire :

    • Les journaux de batch et d'intégration sont capturés par des codes utilisateur spéciaux créés pour ce type de traitement. Ces utilisateurs ne représentent généralement pas un être humain et ne peuvent donc pas accéder aux journaux à l'aide de l'option "Afficher le journal utilisateur". C'est donc un autre utilisateur, réel, qui doit accéder à ces journaux.

    • Les administrateurs des clients peuvent souhaiter extraire les journaux pour un utilisateur final, éventuellement à des fins de support technique. Un utilisateur final ne dispose pas nécessairement des compétences techniques nécessaires pour collecter ou évaluer les journaux, ni du privilège d'accès aux journaux pour des raisons de sécurité.

  • L'activation de l'option Débogage global active différentes options de trace ajoutées au journal utilisateur.
Remarque :
Le bouton Afficher le journal utilisateur est sécurisé. Le service applicatif F1USERLOG est associé à cette fonctionnalité pour définir des restrictions d'accès à ce bouton lors de l'implémentation. Seuls les utilisateurs disposant du mode d'accès Administration du service applicatif sont autorisés à afficher les journaux des autres utilisateurs. Ces restrictions peuvent être activées dans les environnements de production.
Remarque :
Si votre environnement configure des règles de protection par occultation, les informations d'identification personnelle peuvent être occultées dans la sortie du journal. Pour plus d'informations, voir Occultation des données pour l'exportation et la journalisation.

Pour les implémentations cloud uniquement, les boutons suivants sont disponibles dans ce mode :

  • Redémarrer les processus de pool de threads - Ce bouton force les conteneurs batch à prendre fin et interrompt tous les batchs en cours d'exécution. De nouveaux conteneurs sont alors lancés et les batchs interrompus reprennent. Reportez-vous au document de référence technique sur les meilleures pratiques en matière de batchs pour plus d'informations sur ce bouton et le moment où il doit être utilisé.

  • Redémarrer les serveurs JAR CM - Ce bouton prend en charge le code Java personnalisé dans le cloud dans certains cas d'utilisation. Pour plus d'informations, reportez-vous au guide d'implémentation des services cloud.

D'autres icônes relatives à la configuration peuvent s'afficher dans différentes zones du système. Par exemple, les zones de l'explorateur peuvent fournir des outils supplémentaires destinés au débogage de la configuration des zones. Ces icônes sont décrites en contexte.

En mode débogage, les listes déroulantes de l'explorateur de données et des zones de matrice IU incluent le code de chaque élément en plus de leur chaîne d'affichage.