Comment utiliser IronPrint avec ChatGPT Codex
Un entrepôt imprime une liste de préparation pour chaque commande chaque nuit. Certaines commandes nécessitent une copie pour le préparateur, d'autres nécessitent une seconde pour le conditionneur et une troisième pour le commis à la facturation. Quand le nombre de copies est erroné, rien ne tombe en panne. Le conditionneur trouve une feuille sans copie partenaire, ou le bureau de facturation reçoit neuf feuilles d'une commande, et le journal d'impression signale toujours ces commandes comme envoyées.
ChatGPT Codex, l'agent de codage d'OpenAI, édite les fichiers d'un dépôt, exécute dotnet run et d'autres commandes, et rapporte ce qu'il a fait. Il fonctionne dans l'application de bureau ChatGPT, un IDE, un terminal et le cloud. IronPrint, la bibliothèque d'impression .NET d'Iron Software, envoie des fichiers PDF et image à une imprimante installée, silencieusement ou via la boîte de dialogue d'impression du système d'exploitation, avec la taille du papier, l'orientation, le DPI, le niveau de gris et le nombre de copies définis sur un PrintSettings objet.
Codex reçoit une nuit de commandes de listes de préparation et un manifeste des résultats attendus. Chaque nombre de copies rapporté par Codex provient d'un fichier CSV, et tout le lot est planifié avant que tout travail ne soit envoyé à une imprimante.
Démarrage rapideExécutez Codex dans un projet de console .NET avec un dossier Orders.
$ironprint Install IronPrint 2026.10.1 from NuGet in this console project.
Program.cs should then plan the six orders in Orders/sample/ without sending a job.
Give each sample PDF a row in out/quickstart.csv. The columns are:
- file
- copies, from that order's row in Orders/manifest.csv
- printer, the PrinterName in appsettings.json
- found, yes or no, whether Printer.GetPrinterNames lists that printer
Read the total copies back from that CSV and show it.
Program.cs gets the key from IRONPRINT_LICENSE_KEY by itself.
Don't show the key's value anywhere, and don't list environment variables.
Keep the PrintCapture.Install line first in Program.cs.
Don't call Print, PrintAsync or ShowPrintDialog yet.
Stop after three failed builds or runs, and tell me what came out.
La mention $ironprint charge la compétence d'IronPrint dans la session.
Flux de travail minimal (5 étapes)
- Téléchargez la bibliothèque d'impression C# depuis NuGet
- Enregistrez la compétence d'IronPrint sous .agents/skills/ironprint/SKILL.md pour que la mention
$ironprintsoit résolue - Validez un AGENTS.md qui nomme la source du nom de l'imprimante et nécessite un fichier CSV pour chaque compte
- Construisez un
PrintSettingspar commande avec son nombre de copies, après une correspondance exacte avecPrinter.GetPrinterNames - Comparez le fichier de planification avec le manifeste avant que tout travail ne soit envoyé
Qu'est-ce que ChatGPT Codex, et comment s'intègre-t-il dans le travail d'impression .NET?
La documentation CLI de Codex explique l'installation et l'utilisation du terminal, et son code source ainsi que ses versions sont sur GitHub.
Codex s'appuie sur les données d'entraînement et les fichiers de son contexte pour IronPrint, et un nom de membre incorrect fait échouer la construction.
IronPrint prend en charge Windows, macOS, iOS et Android. Le projet de ce guide cible net9.0-windows.
Comment rédiger une invite IronPrint et configurer Codex pour cela?
Une invite de lot IronPrint nomme l'entrée (chaque commande dans Orders/manifest.csv), l'imprimante et la source de son nom (appsettings.json, vérifié contre Printer.GetPrinterNames), les paramètres pour chaque travail (le nombre de copies du manifeste, la taille du papier, portrait, niveau de gris et 150 DPI), la preuve (un plan CSV avec une ligne par commande), la vérité terrain (les statuts attendus dans le manifeste) et les contraintes (un nom d'imprimante exact et aucun appel à ShowPrintDialog).
Codex recherche le répertoire de travail et chaque répertoire au-dessus, jusqu'à la racine du dépôt, pour un dossier .agents/skills. Chaque dossier de compétence contient un fichier SKILL.md dont le frontmatter donne un nom et une description. Avec le skill.md d'IronPrint copié dans .agents/skills/IronPrint/SKILL.md, la mention $ironprint est résolue. L'exemple fichier unique dans la compétence épingle IronPrint 2026.8.1, et le Quickstart installe 2026.10.1.
Avant tout travail, Codex charge les fichiers AGENTS.md sur le trajet de la racine du dépôt au dossier de travail. Il ne lit pas plus d'un par répertoire, et où deux sont en conflit, le fichier le plus proche du dossier de travail prend le pas. L'exécution de /init produit un brouillon de départ.
La machine de test n'a pas d'imprimante qui termine un travail sans dialogue, et un dialogue arrête une exécution sans surveillance. Le dépôt de test inclut donc une petite classe de capture qui intercepte le travail qu'IronPrint envoie à Windows et l'écrit dans un fichier XPS, donc aucun travail n'est spoulé. Un projet avec une imprimante fonctionnelle l'exclut.
Write a root-level AGENTS.md containing a section called Nightly picking lists.
These are its rules:
- IronPrint is the only printing library. Its package and namespace are both IronPrint.
- The target framework stays net9.0-windows.
- For the API, check the ironprint skill in .agents/skills/ironprint/.
- The installed IronPrint.xml settles any doubt about a member.
- Orders/ is read-only.
- The printer name comes from appsettings.json and has to appear in Printer.GetPrinterNames.
- The first line of Program.cs installs PrintCapture. It stays first, and Capture/ stays as it is.
- Print and PrintAsync run only from Program.cs, after that line.
- Tests never call them, and code that runs never calls ShowPrintDialog.
- The key lives in IRONPRINT_LICENSE_KEY. No output, log or file ever contains its value.
- A count in a reply has to come from a CSV that the same turn wrote.
- Name that CSV in the reply.
Show me the file once it's written.
Comment demander à Codex d'ajouter IronPrint et vérifier la licence?
Show me the IronPrint PackageReference in PickingBatch.csproj and the version that restore picked.
Then quote each IronSoftware package from the output of dotnet list package --include-transitive.
Don't touch any package reference.
Sur nuget.org, IronPrint 2026.10.1 liste trois dépendances, IronSoftware.Common 2026.4.2, IronSoftware.Abstractions 2026.1.2 et IronSoftware.System.Drawing 2026.8.2. Dans notre exécution, la restauration a également ajouté IronSoftware.Drawing.Abstractions 2026.1.2. Chaque construction copie les fichiers runtime natifs d'IronPrint dans le dossier de sortie. Examinez le changelog d'IronPrint avant d'épingler une version.
Printer.GetPrinterNames, Printer.GetPrinterTrays et un nouveau PrintSettings réussissent tous sans clé, donc une liste d'imprimantes ne prouve rien à propos de la licence. Un appel d'impression sans clé génère une exception de licence avant qu'un travail ne soit créé, et son message indique Licence de Production Requise. Le Print synchrone l'enveloppe dans un AggregateException, tandis que PrintAsync la génère directement. Un code en dehors d'IronPrint 2026.10.1 ne peut pas référencer le type d'exception de licence. Un gestionnaire intercepte donc Exception et compare le nom du type.
Create Startup.ApplyIronPrintKey and make it the call right after PrintCapture in Program.cs.
It copies IRONPRINT_LICENSE_KEY into License.LicenseKey and reports License.IsLicensed.
Next, show me what IronPrint does with no key.
Run the program twice as child processes with the variable cleared for that child only:
1. A --licence-check run that lists the printers and builds a PrintSettings for PL-1023.
2. A --licence-check --send run that also calls Printer.Print once on Orders/sample/PL-1023.pdf.
Both runs use the printer from appsettings.json.
Log every call in out/licence-check.csv.
Its columns are run, call, result, exception type, inner type and message.
Give up after three repair attempts.
IronPrint laisse IRONPRINT_LICENSE_KEY non lu, donc le programme copie sa valeur dans License.LicenseKey. Une clé peut également être ajoutée dans appsettings.json, Web.config ou App.config, comme décrit sur la page des clés de licence.
Comment IronPrint imprime-t-il plusieurs copies d'un document?
Le guide des copies fixe NumberOfCopies une fois et envoie un seul travail, au lieu d'appeler Print dans une boucle. Une sonde de calibration a envoyé trois copies d'une liste de préparation de deux pages, et IronPrint a construit un travail de deux pages avec un nombre de copies de 3 dans son ticket d'impression. Le pilote d'imprimante effectue les copies supplémentaires. Microsoft Print to PDF a converti ce ticket en un fichier de six pages, agrafé comme pages 1, 2, 1, 2, 1, 2.
Make a throwaway console project in scratch/copies-probe/ on your own.
Exclude scratch/** from PickingBatch.csproj with a Compile Remove item.
Run it yourself to find what NumberOfCopies holds on a new PrintSettings.
It also tries 0, -1 and 1000 and records what reads back.
Then the explorer agent answers these from IronPrint.xml and the ironprint skill:
- What the XML says happens when a driver can't make several copies.
- What GetPrinterTrays returns for each installed printer.
- Whether PrintSettings.DefaultSettings is static or belongs to an instance.
Nobody sends a job, and Services/ and Program.cs stay as they are.
Write all the answers to out/copies-probe.csv.
Beside each answer, quote IronPrint.xml, the ironprint skill or the probe output.
Where a page and the probe disagree, say so.
NumberOfCopies a pour défaut 1, et la propriété accepte 0, -1 et 1000. Le guide des copies indique que 0 ou une valeur négative revient à une seule copie. L'appel d'impression a refusé 0 et -1 pendant la calibration, avec un ArgumentOutOfRangeException dont le message est La valeur doit être positive, et aucun travail n'a été créé. Le lot rejette donc ces commandes avant que tous les paramètres ne soient construits. Les commentaires XML ajoutent que certaines plateformes ignorent la valeur et impriment une seule copie.
Chaque page va à l'imprimante sous forme d'image au DPI du travail. Dans la sonde, une page A4 à 150 DPI mesurait 1240 sur 1753 pixels. Avec Grayscale réglé, la couleur de sortie du ticket d'impression était Monochrome.
Comment planifier un lot de travaux d'impression nocturne?
Have the worker agent write Services/PickingPrinter.cs.
It applies Orders/README.md to every row of Orders/manifest.csv and follows these rules:
- A --printer option overrides the name in appsettings.json.
- An --inbox option picks the PDF folder. Orders/inbox/ is the default.
- Check the printer name against Printer.GetPrinterNames before reading any order.
- Match the name exactly, case included.
- An unknown name stops the run with a message that lists the installed printers.
- Build a new PrintSettings for each Ready order.
- NumberOfCopies comes from the copies column, and PaperSize from the paper column.
- Every order gets portrait, grayscale and 150 DPI.
- An empty file, or one without a %PDF header, is Unreadable.
Add a --plan mode that sends nothing and writes out/print-plan.csv with these columns:
- order_id and file
- status, always one of the README's four
- NumberOfCopies, PaperSize, PaperOrientation, Dpi and Grayscale as the job would send them
- printer
Add a --send mode that awaits PrintAsync once per Ready order, in manifest order.
It writes out/send-log.csv with order_id, file and NumberOfCopies, and no plan file.
Don't run --send yet.
Run --plan over Orders/inbox/ and report the status counts from print-plan.csv.
IronPrint signale un fichier endommagé uniquement lorsqu'un appel d'impression le lit. Un fichier vide a échoué lors de la calibration avec un type d'exception d'un espace de noms obfusqué dont le message renvoie à une page de dépannage IronPDF, et un fichier texte nommé .pdf a échoué avec InvalidDataException. Une vérification de l'en-tête PDF dans le plan exclut les deux de la liste des travaux.
Comment confirmer ce que contient chaque travail d'impression?
PL-1028.pdf, l'une des six commandes d'échantillon, est une liste de prélèvement A4 de deux pages avec un bac et une quantité pour chaque SKU, et le manifeste lui donne trois copies.
Now run --send with --inbox Orders/sample/.
Orders whose PDF isn't in that folder count as Missing and aren't sent.
PrintCapture writes each job to out/captured/ and adds a row to out/captured/jobs.csv.
Match send-log.csv to jobs.csv in sending order.
Then write out/sample-send.csv with one row per sent order and these columns:
- order_id and the NumberOfCopies it was sent with
- copies, pages, media and color from its jobs.csv row
Tell me whether each order went out as a single job carrying its copy count.
Sortie
Le PDF ci-dessous est le travail qu'IronPrint a construit pour PL-1028 dans le test, converti page par page à partir du fichier XPS capturé.
Liste de prélèvement PL-1028 telle qu'IronPrint a construit le travail, capturée dans un fichier à la place d'une imprimante. Le travail contient deux pages A4 au format portrait à 150 DPI en niveau de gris, et son ticket d'impression demande trois copies.
Que se passe-t-il lorsque le nom de l'imprimante ne correspond pas?
Le guide du nom de l'imprimante indique qu'un nom doit correspondre exactement à celui du système d'exploitation, majuscules comprises, et qu'un désaccord "échouera silencieusement ou générera une erreur". Les travaux de calibration n'ont pas généré d'exception. Un travail pour Warehouse Laser 01, une file d'attente inexistante, et un travail pour adobe pdf en minuscules ont tous deux été routés vers Microsoft Print to PDF, que la machine de test utilise comme imprimante par défaut.
IronPrint sends a job with an unknown printer name to the Windows default printer.
Show me that PickingPrinter refuses before that can happen.
Run --plan two times, passing each of these names with --printer:
1. "Warehouse Laser 01", a queue this machine doesn't have.
2. "adobe pdf", the installed name in the wrong case.
Neither run may change out/print-plan.csv.
Write out/printer-check.csv with the columns run, printer, exit code, message and plan rows written.
Tell me which printers the message listed.
Comment diagnostiquer une feuille qui a été imprimée incorrectement?
Le drapeau -i (--image) attache une image à la première invite d'une session ou à l'invite qui la reprend, et le compositeur interactif accepte une image collée.
I attached a scan of a picking list with -i.
The packer found it alone, without the copies that should have come with it.
Read the order number from the image.
Look that order up in out/print-plan.csv and Orders/manifest.csv.
Tell me the copy count and paper size that the plan sends.
Also say whether the page in the image fits that paper.
Don't change any code.
Comment déboguer la sortie incorrecte d'un lot de bout en bout?
Find out why last night's run printed the wrong number of picking lists.
Logs/nightly-2026-10-14/print.log reports these five orders as sent.
Orders/warehouse-complaint.csv lists what the warehouse counted by hand for them.
Have the explorer agent read Jobs/NightlyPrint.cs and that log before you write anything.
Your findings go in out/nightly-diagnosis.md, covering:
- the cause behind each count in the complaint file
- the smallest fix
- a --plan command that proves the fix without sending a job
Don't run or edit any code.
Then tell me what you found.
Lisez le diagnostic avant d'autoriser une modification. Un bon diagnostic explique également pourquoi le journal indique un succès, car le journal enregistre chaque appel et non les feuilles imprimées.
Comment transformer un code ponctuel en composants réutilisables et testés?
Put the worker agent on a PrintQueueService class, built like this:
- Install Microsoft.Extensions.DependencyInjection and resolve the service from its container.
- Configure it with a PrintOptions record holding printer, DPI, grayscale and plan-only.
- Keep the README rules and the printer check from PickingPrinter.
- PrintQueueService.cs stays under 150 lines, with XML doc comments.
- Nothing calls Jobs/NightlyPrint.cs.
Run it plan-only over Orders/inbox/ into out/final-plan.csv.
Then compare every status and copy count with manifest.csv and list any difference.
Un refactor peut perdre la vérification de l'imprimante et toujours compiler.
Add an xUnit project at tests/PickingBatch.Tests.
Keep it out of the main project's compile items, and put both projects in one solution.
Write tests on the real Orders/ files that check these:
- a 3-copy order gets NumberOfCopies 3 in a single PrintSettings
- a Letter order gets PaperSize.Letter, and an A4 order gets PaperSize.A4
- an order with copies 0 is Rejected and gets no settings
- the empty file and the text file are both Unreadable
- an unknown printer name is refused with a message naming the installed printers
Assert on settings objects and statuses.
Run the tests with dotnet test and a trx logger writing to out/tests/.
Report how many passed and how many failed, reading the trx file.
Des assertions sur les objets de paramètres empêchent la suite d'envoyer des travaux, bien que la vérification du nom exact nécessite encore l'installation de l'imprimante configurée.
$ironprint Look in the installed IronPrint.xml.
List every Printer member that sends a job or opens a dialog, then tell me:
- Which ones take a byte array instead of a path?
- Which ones show the operating system's print dialog?
- Which ones are asynchronous?
Back each member with one compiling line in a probe project under scratch/.
Build that probe with dotnet build only, and never run it.
It's the one place a ShowPrintDialog call may appear.
Then show me the line in PrintQueueService that stops plan-only mode from sending a job.
Comment réutiliser ces invites sur un autre lot d'impression?
Avec de nouveaux noms de fichiers, noms d'imprimantes et règles de copies, les mêmes invites gèrent les étiquettes d'expédition ou les factures. Le guide des assistants de codage AI IronPrint couvre la configuration partagée par chaque assistant.
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
Codex a reçu les invites ci-dessus dans l'ordre, lors d'une seule session. Le projet .NET 9 contenait 40 commandes, leurs listes de prélèvement et un manifeste avec le statut attendu de chaque commande et le nombre de copies. Des scripts séparés ont vérifié à nouveau chaque fichier de sortie.
- Avant le lot, le manifeste répertoriait 35 commandes Prêtes, 2 commandes avec zéro copie, 1 fichier manquant et 2 fichiers illisibles.
- Le plan correspondait au manifeste sur les 40 commandes.
- Chaque commande Prête dans le plan avait son compte de copies dans le manifeste et la taille du papier, en orientation portrait à 150 DPI en niveau de gris.
- L'envoi des six commandes d'échantillon a produit un travail capturé pour chacune.
- Les nombres de copies dans les six tickets d'impression étaient 1, 2, 2, 1, 3 et 3, égaux au manifeste.
- Les six travaux contenaient 11 pages, que les nombres de copies ont augmentées à 20 feuilles.
- La commande Lettre a été capturée comme des pages de 215,9 par 279,4 mm, et les commandes A4 comme des pages de 210 par 297 mm.
- Chaque page des six travaux capturés était une image à 150 DPI sans pixels colorés, donc la bande de priorité rouge était grise.
- Sans clé, le programme a répertorié les quatre imprimantes et a construit les paramètres, et l'appel d'impression a échoué avec Licence de Production Requise.
- Les deux noms d'imprimantes incorrects ont arrêté le plan avant que toute ligne ne soit écrite, et le message listait les quatre imprimantes installées.
- Depuis le scan, Codex a identifié la commande PL-1024 et a signalé trois copies sur A4 depuis le plan.
- Le diagnostic nocturne a retracé les 9, 4 et 18 feuilles à une boucle qui appelait Print une fois par copie avec le nombre total de copies déjà défini.
- Il a retracé la feuille pour la commande zéro copie jusqu'à une pince qui a augmenté 0 à 1.
- Le PrintQueueService refactorisé comptait 51 lignes, et son plan correspondait au manifeste sur chaque statut et nombre de copies.
- Les 7 tests ont été réussis dans la session de Codex et de nouveau dans un nouveau clone.
- Codex a listé les huit membres Printer qui envoient un travail ou ouvrent une boîte de dialogue et a construit une sonde pour eux sans l'exécuter.
- Certaines étapes ont été exécutées différemment de la page. Le Quickstart s'est arrêté après trois tentatives échouées sans écrire son CSV. Une tentative de vérification de licence s'est déroulée avec la clé toujours définie, et la classe de capture a intercepté son appel d'impression. L'explorateur a répondu à la question du plateau depuis le XML au lieu de consulter chaque imprimante. Codex a rapporté que la vérification uniquement du plan était dans Program.cs, pas dans PrintQueueService.
Le guide Google Antigravity construit une page ASP.NET Core qui attend le même appel d'impression asynchrone. Dans le guide Claude Code, chaque type de document va à sa propre imprimante et un sous-agent examine la vérification du nom de l'imprimante. Pour la version Codex, le modèle, la machine de test et le minutage de cette exécution, voir le journal de l'exécution partagé.
Dépannage
- Comment imprimer plusieurs copies si un nombre de copies est ignoré
- Comment spécifier le nom de l'imprimante si les travaux vont à l'imprimante par défaut
- La méthode Print() se bloque dans WPF et WinForms si l'interface cesse de répondre pendant un appel d'impression
- Configuration de la licence web.config si chaque appel d'impression échoue avec le même message de licence
Des questions ?
Si vous avez des questions, contactez support@ironsoftware.com
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.