> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/documentations/efalia-compose/appic/installation-et-administration/stardebug.md).
# StarDebug
## CONTRAINTES ET PRE-REQUIS
### SYSTEME D’EXPLOITATION
StarXplore fonctionne sous Windows.
| **Système d’Exploitation conseillé** | **Système d’Exploitation obsolète** |
| ------------------------------------ | ----------------------------------- |
| | Windows 98 |
| Windows 2000 Pro/Server, | Windows ME |
| Windows XP Pro | Windows NT 4.0 |
| Windows Server 2003 | (fonctionnalités pas toutes |
| | disponibles) |
### PROCESSEUR MINIMUM
**Processeur minimum requis**
* 300 MHz Intel Pentium/Celeron family
ou
* AMD K6/Athlon/Duron family ou
* tout processeur compatible
### RAM
| **Système d’exploitation** | **Quantité de RAM minimale requise****(1)** |
| ------------------------------------------------------------------------- | ------------------------------------------------------ |
|
Windows 98 Windows ME
Windows NT 4.0
| 64 Mo |
|
Windows 2000 Pro/Server, Windows XP Pro
Windows Server 2003
| 128Mo |
### ESPACE DISQUE
L’Espace disque minimum requis pour l’Application est **30 Mo**.
### RESOLUTION
La résolution conseillée est **1024\*768**.
## CONCEPTS
### POURQUOI STARDEBUG
Un projet de mise en page complète d’un document peut devenir, dans certains cas de Documents très élaborés, un projet complexe exploitant des boucles de type **While**, **For**, etc… avec d’éventuelles imbrications de ce type de construction.
De plus, afin de maîtriser le déroulement de telles boucles, le développeur est forcé d’utiliser des variables qu’il devra incrémenter et mettre à jour au fur et à mesure de l’avancement du traitement du Document final.
Il semble évident dès lors, qu’un outil permettant de suivre pas à pas l’évolution des variables, la création du document final et le traitement des données issues du rapport d’origine, ne peut qu’apporter un confort sans pareil à l’utilisateur / développeur.
C’est dans cet objectif que nous avons développé **StarDebug**.
### LANCEMENT DE STARDEBUG
Deux modes de lancement sont disponibles :
* Le premier consiste à lancer le programme situé dans le Groupe StarJet. Dans ce cas, la fenêtre *Nouvelle session de débogage* apparaît :
Vous devrez saisir le nom des deux fichiers nécessaires à l’exécution de votre session. Ou utiliser les boutons **…** situés en face de chacun de ces champs pour vous permettre de naviguer en mode sélection de fichier.
* Le second consiste à lancer le programme situé dans **StarJet**–**Design**.
Vous pourrez l’obtenir à partir de l’option *Déboguer* du menu *Global*, ou en cliquant sur l’icône qui lui est associée.
Icône associée dans la barre d’outils.
Pour ce type d’appel, il ne vous est pas demandé de saisir ni même de valider le nom des deux fichiers concernés.
Dès que le programme a chargé les fichiers à traiter, voici l’apparence de votre écran :
La fenêtre située en haut à gauche intitulée *Page en cours de traitement dans l’imprimante* est chargée d’afficher la page du document telle qu’elle doit être imprimée. Un dessin représentant une imprimante rayonnante indique qu’aucune page n’est en cours de traitement (ce qui est le cas lorsque le programme démarre).
La fenêtre de droite affiche les différentes commandes de votre projet, au format ASCII.
La fenêtre située en bas à gauche intitulée *Etat du contexte d’exécution* vous donne accès, au travers d’onglets sur lesquels vous pouvez cliquer à tout moment, à des informations concernant l’*imprimante*, les *données*, les *variables*, les *points d’arrêt* et les *messages* éventuels.
L’icône représentant une imprimante, située dans la fenêtre intitulée *Etat du contexte d’exécution* est précédée d’un signe **+**. Il vous suffit de cliquer dessus pour obtenir l’affichage de l’arborescence qui lui est associée :
Le projet n’ayant pas encore démarré, aucune page n’est disponible. L’Overlay (le fond de page) actif est actuellement à la valeur *–1*, ainsi que la police de caractères.
Pour visualiser un état différent, appuyons sur la touche *F7* (exécution en mode Pas à pas)
Vous voyez ici que l’état de votre imprimante a évolué :
* l’overlay actif est maintenant le 2,
* une police est active,
* deux fonds de pages sont dans la mémoire de l’imprimante.
Vous pouvez également regarder les variables de ce projet en cliquant sur l’onglet
*Variables* :
Les variables sont affichées par type. Chaque type est précédé d’un signe **+** s’il n’est pas vide et que les variables qu’il contient ne sont pas affichées, d’un signe **–** si, au contraire, elles le sont.
Double-cliquer maintenant sur la variable de type Prédéfini *SOURCEPAGENUMBER* ou cliquer sur son nom à l’aide du bouton droit et sélectionner dans le menu contextuel proposé l’option *Ajoute toutes les variables de ce type*.
Son contenu est affiché dans la partie inférieure de la fenêtre.
Toutes les variables utilisées par votre projet sont ainsi accessibles pour vous permettre de vérifier leur évolution.
Pour supprimer à un quelconque moment l’affichage d’une variable donnée, cliquer dans la partie inférieure de la fenêtre sur son nom à l’aide du bouton droit et sélectionner dans le menu contextuel qui vous est proposé l’option *Supprimer*.
### ICÔNES D’EXECUTION
Exécution Pas à pas
Saut jusqu’au layout suivant
Stop (surtout utile si une boucle perpétuelle semble survenir
Continuer l’exécution (jusqu’au prochain point d’arrêt s’il y en a un ou jusqu’à la fin du projet)
Aller à la ligne courante
Retour vers StarJet-Design (uniquement si StarDebug est lancé depuis StarJet-Design)
Accès à la page précédente Accès à la page suivante
Accès à la page en cours de traitement Zoom avant
Zoom arrière
Zoom normal (valeur par défaut) Ajuster le Zoom à la largeur de la page Ajuster le Zoom à la hauteur de la page
## MENUS
### MENU FICHIER
Les entrées disponibles dans ce menu dépendent de la manière dont a été lancé StarDebug.
En cas de lancement normal, c’est à dire comme une application Windows traditionnelle, il vous est possible d’ouvrir un autre projet.
***Ouvrir un fichier***
La sélection de cette entrée provoque l’affichage de la boîte de dialogue *Ouvrir* :
Elle vous permet de naviguer dans vos différents répertoires et de sélectionner le projet qui doit être analysé.
Une fois un projet sélectionné, cliquer sur le bouton **Ouvrir** pour valider le choix, ou bien double-cliquer directement sur le nom du projet.
***Option Quitter***
***Option Retour vers StarJet Design***
*Quitter* et *Retour vers StarJet-Design* sont les deux intitulés possibles (selon le mode de lancement de StarDebug) pour en terminer l’exécution.
### MENU EDITION
***Option Rechercher dans le source…***
La sélection de cette entrée provoque l’affichage de la boîte de dialogue *Rechercher* :
Elle vous permet de saisir dans le champ *Rechercher*, la chaîne de caractères recherchée. Vous pourrez également indiquer le sens dans lequel doit s’effectuer la recherche (vers le *Haut* ou vers le *Bas* – valeur par défaut).
Si vous cochez la case *Mot entier uniquement*, la chaîne de caractères devra être encadrée par des blancs pour pouvoir correspondre à votre recherche.
Enfin, si vous cochez la case *Respecter la casse*, la recherche tiendra compte des minuscules et des majuscules pour correspondre à ce qui a été saisi.
***Option Suivant***
Cette entrée du menu permet de continuer la recherche définie par l’action *Rechercher dans le source* et d’atteindre ainsi, si elle existe, l’occurrence suivante de la chaîne de caractères.
### MENU AFFICHAGE
***Option Page Précédente***
L’activation de cette entrée du menu, ou un simple clic sur l’icône qui lui est associée provoque l’affichage dans la fenêtre *Page en cours de traitement dans imprimante* de la page précédent celle qui y est actuellement affichée.
En conséquence, la page concernée apparaîtra en surligné dans la fenêtre *Etat du contexte d’exécution*.
Il est également possible d’obtenir l’affichage de la page de votre choix en cliquant sur la page désirée au sein de la liste des pages disponibles dans la fenêtre *Etat du contexte d’exécution*.
***Option Page suivante***
L’activation de cette entrée du menu, ou un simple clic sur l’icône qui lui est associée provoque l’affichage dans la fenêtre *Page en cours de traitement dans l’imprimante* de la page suivant celle qui y est actuellement affichée.
En conséquence, dans la fenêtre *Etat du contexte d’exécution*, la page concernée apparaîtra en surligné.
Il est également possible d’obtenir l’affichage de la page de votre choix en cliquant sur la page désirée au sein de la liste des pages disponibles dans la fenêtre *Etat du contexte d’exécution*.
***Option Page courante***
L’activation de cette entrée du menu, ou un simple clic sur l’icône qui lui est associée provoque l’affichage dans la fenêtre *Page en cours de traitement dans imprimante* de la page en cours de création.
En conséquence, dans la fenêtre *Etat du contexte d’exécution*, la page concernée apparaîtra en surligné.
***Option Zoom plus***
Cette fonction vous permet d’obtenir un effet de zoom avant : la page de votre Document final est affichée avec un coefficient supérieur de grossissement.
***Option Zoom moins***
Cette fonction vous permet d’obtenir un effet de zoom arrière : la page de votre Document final est affichée avec un coefficient inférieur de grossissement.
***Opton Zoom normal***
Cette fonction vous permet de rétablir le niveau de zoom défini par défaut pour l’affichage de votre Document final.
***Option Largeur de la page***
Cette fonction vous permet d’obtenir un affichage de votre Document final de telle sorte que la largeur de la page coïncide avec la largeur de la fenêtre d’affichage.
***Option Hauteur de page***
Cette fonction vous permet d’obtenir un affichage de votre Document final de telle sorte que la hauteur de page coïncide avec la hauteur de la fenêtre d’affichage.
***Option Préférences***
La sélection de cette entrée provoque l’affichage de la boîte de dialogue **Options d’affichage des sources** :
L’onglet *Coloration syntaxique* vous permet d’affecter aux divers éléments constitutifs de votre source, les couleurs et attributs de police qui vous semblent les plus pertinents.
Pour l’utiliser, sélectionner l’un des éléments présentés dans la liste, puis cliquer sur la couleur de votre choix.
La fenêtre *Apparence* reflètera alors immédiatement le résultat de votre choix. Vous pouvez en outre cocher les cases *Gras* et *Italique* si vous le désirez.
Un clic sur l’onglet *Taille et police* fait apparaître d’autres informations relatives à l’affichage du code:
Vous pouvez y sélectionner la *Police* utilisée, la *Hauteur* de celle-ci et définir le nombre de blancs à utiliser pour représenter une tabulation (champ *Tabulations*).
Au fur et à mesure de vos sélections, la zone *Apparence* sera mise à jour pour refléter vos choix.
## MENU DEBOGUEUR
### OPTION PAS A PAS
Cette fonction demande à StarDebug d’exécuter la commande suivante du projet. L’instruction à exécuter est affichée avec des caractères blancs sur fond rose.
Après exécution de cette instruction, le repère (ligne rose) sera positionné sur la commande suivante, et l’ensemble des fenêtre de StarDebug sera mis à jour pour tenir compte de l’exécution effectuée.
### OPTION SAUT JUSQU’AU LAYOUT SUIVANT
Cette fonction demande l’exécution du projet en cours, jusqu’à ce que soit atteint le Layout qui suit, après test du When qui lui est éventuellement accolé.
Si un Layout est en cours de traitement, quel que soit son type (Overlay, Compute ou Page), celui-ci sera entièrement traité avent le prochain arrêt.
### OPTION CONTINUER L’EXECUTION
Cette fonction déclenche l’exécution du traitement sans interruption jusqu’à ce que l’une de ces deux conditions soit atteinte : fin du traitement ou passage sur un point d’arrêt préalablement établi.
Les conditions d’arrêt sont les suivantes : Fin du traitement, atteinte d’un point d’arrêt positionné ou génération d’un message d’erreur. En ce cas, la fenêtre correspondante est automatiquement activée.
### OPTION STOP
Cette fonction demande l’arrêt immédiat de l’exécution du projet. Elle peut notamment être utile si vous constatez qu’une boucle se déroule sous vos yeux…
### OPTION ALLER A LA LIGNE COURANTE
Demande à StarDebug d’afficher dans la fenêtre source, la ligne de code actuellement à traiter.
Le curseur est alors immédiatement positionné dessus.
### OPTION REDEMARRER LA SESSION
Cette entrée du menu demande le redémarrage complet de votre projet.
### OPTION OUVRIR LA SESSION
Cette entrée du menu n’est disponible que lorsque StarDebug est lancé indépendamment de StarJet-Design.
Elle déclenche l’affichage de la boîte de dialogue suivante :
Si vous choisissez de confirmer ce choix, *StarDebug* retourne à son point de départ en vous demandant de sélectionner le projet à charger ainsi que le fichier de données à traiter cf § Lancement de StarDebug.
### OPTION MARQUER UN ARRÊT SUR LES MESSAGES
Cette option, lorsqu’elle est cochée, provoque un arrêt de l’exécution du traitement et un arrêt du curseur au niveau de la ligne de code génératrice de l’erreur. De plus, l’onglet *Messages* de la fenêtre *Etat du contexte d’exécution* affiche la description de l’erreur.
Par contre, si cette option est décochée, le traitement continue à s’exécuter et seul l’onglet *Messages* de la fenêtre *Etat du contexte d’exécution* est un indicateur de l’erreur.
## MENU FENÊTRE
### OPTION CASCADE
Demande l’affichage des fenêtres de source en cascade.
### OPTION MOSAÏQUE
Demande l’affichage des fenêtres de source en mosaïque.
### OPTION ARRANGER LES ICÔNES
Permet de réarranger les icônes des fenêtres de source réduites.
### OPTION TOUT FERMER
Ferme les différentes fenêtres de source.
## **FENETRES**
### SUIVI D’EXECUTION
Dans cette fenêtre est affiché le code de votre projet.
Cet affichage est effectué en tenant compte des couleurs et autres attributs que pouvez sélectionner par l’option Préférences du menu Affichage.
La commande qui doit être exécutée dès que le traitement reprendra est affichée en lettre blanche sur une ligne rose. Elle est la ligne courante.
Vous pouvez, à l’aide de l’ascenseur situé à droite de cette fenêtre, vous déplacer dans vos lignes de code.
Vous pouvez également y définir des **points d’arrêt**. Pour ce faire appliquez la procédure suivante :
Déplacez-vous dans vos lignes de code afin d’afficher la ligne qui vous intéresse dans la fenêtre
Faites glisser votre curseur vers cette ligne.
Positionnez le précisément dans la marge gauche, face à cette ligne. Lorsque le curseur devient une croix, cliquez.
La ligne de code ainsi marquée apparaît alors en lettres blanches sur fond rouge.
Si vous cliquez sur l’onglet *Points d’arrêt*\*\*,\*\* la fenêtre intitulée *Etat du contexte d’exécution* indique le numéro de ligne de cette commande.
Si, **au niveau de la ligne de code**, vous cliquez sur le bouton gauche, ce point d’arrêt sera supprimé.
En revanche, si vous cliquez sur le bouton droit, cette ligne passera de rouge à jaune. Elle ne sera plus un point d’arrêt (elle n’interrompra pas le déroulement du traitement), mais elle sera toujours visible dans la fenêtre *Etat du contexte d’exécution*.
Ceci vous permettra d’en voir le nombre d’exécutions.
Voici un exemple :
### PAGE EN COURS DE TRAITEMENT DANS L’IMPRIMANTE
Dans cette fenêtre sont affichées les données qui sont envoyées à l’imprimante.
A l’origine, **StarDebug** vous affiche une imprimante flambant neuve, signe de la virginité de ses pages.
Dès qu’une information est envoyée vers votre imprimante, ce petit dessin disparaît au profit d’une page blanche sur laquelle est appliquée l’information expédiée.
Overlay et non une page.
### ETAT DU CONTEXTE D’EXECUTION
Cette fenêtre est probablement la plus riche en informations pour l’utilisateur s’il rencontre un problème de mise au point.
Elle contient des informations sur l’**imprimante**, les **données**, les **variables**, les **points d’arrêt** et sur les **messages**. Ces différentes informations sont accessibles en cliquant sur leurs onglets respectifs.
### ONGLET IMPRIMANTE
Voici un exemple d’affichage de cette fenêtre, après exécution de quelques instructions :
Comme vous pouvez le constater, de nombreuses informations sont à votre disposition sur cette fenêtre :
* Des informations sur l’état de l’imprimante elle-même.
* Action en cours (paramétrage de l’environnement, par exemple), le format de papier ainsi que son orientation, l’Overlay actif à cet instant, le numéro de la police active ainsi que le nombre de pages reçues.
* Une liste des Overlays reçus est également à votre disposition.
Un clic sur l’un d’entre eux provoquera immédiatement son affichage dans la fenêtre *Page en cours de traitement dans l’imprimante*. En outre, il sera surligné dans la liste pour indiquer cette sélection.
Enfin une liste des pages est également disponible. Elle est vide tant qu’aucune page n’a été générée.
### ONGLET DONNEES
Dans cette fenêtre sont affichées les lignes de données en cours de traitement.
Les numéros de ligne et de colonne sur lequel est positionné le curseur sont indiqués dans la ligne de commentaire (plus couramment appelée barre d’état) située au dessous des onglets.
### ONGLET VARIABLES
Dans cette fenêtre, vous pourrez voir l’ensemble des variables de votre projet, classées par type.
Chaque type contenant des variables est précédé par un signe (+) sur lequel vous pouvez cliquer pour voir les variables elles-mêmes.
Pour obtenir l’affichage de la valeur de l’une de vos variables, double-cliquer sur son nom. Elle sera ajoutée dans la fenêtre *Valeurs affichées*.
Vous pouvez également cliquer dessus pour la sélectionner et cliquer sur le bouton droit. Un menu contextuel vous propose alors *Ajoute la variable sélectionnée*.
Vous pouvez également choisir d’afficher toutes les variables de même type.
Pour ce faire, cliquer sur un type de variable pour le sélectionner. Puis cliquer sur le bouton droit et sélectionnez l’entrée *Ajoute toutes les variables de ce type* qui vous est proposée dans le menu contextuel.
Les contenus des variables affichées dans la fenêtre basse seront mis à jour au fur et à mesure du déroulement de votre projet.
Vous pourrez supprimer une variable de cet affichage en la sélectionnant, puis en cliquant sur le bouton droit. Dans le menu contextuel, choisissez l’entrée *Supprimer*.
### ONGLET POINTS D’ARRÊT
Vous pourrez voir dans cette fenêtre les commandes sur lesquelles vous avez posé un point d’arrêt ou dont vous avez demandé le comptage.
Si l’on double-clique sur l’un des points d’arrêts affichés dans la fenêtre *Etat du contexte d’exécution*\*\*,\*\* la fenêtre peut se déplacer automatiquement pour rendre visible l’affichage du code.
En cliquant du bouton droit au sein de cette même fenêtre *Etat du contexte d’exécution*, vous pourrez modifier le type de point d’arrêt en choisissant l’option *Changer le type d’action* et ainsi, le faire passer d’arrêt à comptage ou vice-versa.
De plus, lors du redémarrage d’une session, les points d’arrêts auparavant prédéfinis sont conservés.
### ONGLET MESSAGES
Cette fenêtre recense toutes les messages relatifs aux erreurs contenues dans le code du projet.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://documentation.efalia.com/documentations/efalia-compose/appic/installation-et-administration/stardebug.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.