Partager via

Test d’exactitude GDL

  • Article

Ce test automatisé est exécuté par l’outil GDLCheck. L’outil exécute une syntaxe GDL (Generic Description Language) case activée qui analyse et charge les fichiers GDL, spécifie les configurations, obtient des instantanés XML et recherche des erreurs de syntaxe.

Détails du test

   
Spécifications
  • Device.Imaging.Printer.Base.GDLFile
  • Device.Imaging.3DPrinter.Base.GDLFile
Plateformes
  • Windows 10, éditions clientes (x86)
  • Windows 10, éditions clientes (x64)
  • Windows Server 2016 (x64)
  • Windows 10, éditions clientes (Arm64)
Versions prises en charge
  • Windows 10
  • Windows 10, version 1511
  • Windows 10, version 1607
  • Windows 10 version 1703
  • Windows 10, version 1709
  • Windows 10 version 1803
  • Windows 10, version 1809
  • Windows 10 version 1903
  • Prochaine mise à jour de Windows 10
Durée d’exécution attendue (en minutes) 2
Catégorie Scénario
Délai d’expiration (en minutes) 120
Nécessite un redémarrage false
Nécessite une configuration spéciale false
Type automatique

 

Documentation supplémentaire

Les tests de cette zone de fonctionnalité peuvent avoir une documentation supplémentaire, y compris les conditions préalables, l’installation et les informations de résolution des problèmes, que vous trouverez dans les rubriques suivantes :

Exécution du test

Avant d’exécuter le test, effectuez la configuration du test comme décrit dans les conditions requises pour le test : Conditions préalables au test d’imprimante.

Dépannage

Pour la résolution des problèmes génériques des échecs de test HLK, consultez Résolution des échecs de test HLK Windows.

Pour plus d’informations sur la résolution des problèmes, consultez Résolution des problèmes liés aux tests Device.Imaging.

Plus d’informations

Ce test envoie toutes les erreurs d’analyse et la sortie de débogage à Gdlcheck.xml. Le test traite les arguments de ligne de commande de gauche à droite. Chaque argument est séparé du suivant par un espace. Vous devez spécifier toutes les options avant de spécifier le nom du fichier racine GDL.

Vous pouvez exécuter cet outil de test à partir du Kit de pilotes Microsoft® Windows (WDK) ou par lui-même à partir de l’invite de commandes. Cet outil journalise les résultats dans un fichier journal Windows Test Technologies (WTT). Vous pouvez configurer l’outil pour journaliser les informations à différents niveaux de détail. L’outil nécessite la description de l’imprimante générique racine (GPD) ou le fichier GDL que vous souhaitez valider, ainsi que tous les autres fichiers GPD ou GDL auxquels le fichier racine fait référence.

GDLCheck écrit toutes les sorties de débogage dans le fichier GDLCheck.xml.

La syntaxe de cet outil est la suivante :

GDLCheck.exe [-Verbosity=n], where n is a number from 0 to 4 specifying the verbosity level of parser messages. Verbosity 4 is the most verbose and Verbosity 0 is the least verbose. [-Personality[=persona]] Generate Personality Aware snapshot. (To enable all personalities, use -Personality alone.) [-DisplaySynthesizedFeatures] [-GenerateSchema] (GDLschema.xsd) for XML snapshot. [-DoNotGenerateXMLSnapshot] [-DisplayOnlyStickyFeatures] [-DisplayValidatedConfiguration] [-ParserContext=n] where n is a number from 0 to 9. Initial context is 0. [-PrefaceFile=<full path to file that holds Preface>] [-DeviceConfiguration[=Feature1.Option1[:Feature2.Option2[:Feature3.Option3...]]] [-DocumentConfiguration[=Feature1.Option1[:Feature2.Option2[:Feature3.Option3...]]] (Always generates XML Snapshot.) <-PrinterName=<name of an installed printer> | GDL root file path1 [GDL root file path2...]> [-?] Display this message.

La liste suivante décrit quelques exemples de commandes GDLCheck :

  • GDLCheck.exe -DisplayValidatedConfiguration -DeviceConfiguration -DocumentConfiguration basic.gdl

    Cette commande génère une instantané XML dans le fichier GDLsnapshot.xml à l’aide des configurations d’appareil et de document par défaut. Le fichier basic.gdl implémente les fonctionnalités de base dont vous avez besoin pour satisfaire les productions de construction racine que le fichier stdschem.gdl définit. La sortie de débogage suivante montre un exemple de ce qui se produit si vous spécifiez l’option -DisplayValidatedConfiguration .

    ==== Validated Configuration ====PaperSize:LETTERResolution:Option1RESDLL:UniresDLLInputBin:UPPERIf you execute the same command with hplj5si.gdl (instead of basic.gdl), you will see the following debug output.==== Validated Configuration ====Memory:4096KBPrinterHardDisk:FALSEDuplexUnit:InstalledPageProtect:OFF==== Validated Configuration ====Memory:4096KBPrinterHardDisk:FALSEDuplexUnit:InstalledPageProtect:OFFPaperSize:LETTEROrientation:PORTRAITDuplex:NONEResolution:Option1Halftone:HT_PATSIZE_AUTORESDLL:UniresDLLOutputBin:Option1Collate:OFFStapling:Option1InputBin:Option1

  • GDLCheck.exe -GenerateSchema -DoNotGenerateXmlSnapshot basic.gdl

    Cette commande produit le schéma pour le instantané XML, mais pas le instantané lui-même. Vous trouverez le schéma dans le fichier GDLschema.xsd. Cette commande affiche les options -GenerateSchema et -DoNotGenerateXmlSnapshot . Cette option désactive instantané création. Par défaut, Gdlcheck génère le instantané XML, sauf si vous spécifiez l’option -DoNotGenerateXmlSnapshot.

  • GDLCheck.exe -PrefaceFile=preface.gdl -DisplayValidatedConfiguration -DeviceConfiguration -DocumentConfiguration basic.gdl

    Cette commande montre comment utiliser l’option -PrefaceFile dans Gdlcheck pour spécifier un fichier de préface. Pour effectuer ce test, commentez ou supprimez la ligne « *Include : « stdschmx.gdl » du fichier basic.gdl, car le fichier preface.gdl inclut déjà cette ligne. Le résultat de l’exécution de cette commande est le même que pour le premier exemple de commande.

  • GDLCheck.exe -DisplaySynthesizedFeatures -DoNotGenerateXmlSnapshot synfea.gdl

    Cette commande montre comment utiliser l’option -DisplaySynthesizedFeatures pour vérifier la création de fonctionnalités synthétisées. La sortie de débogage suivante montre un exemple de ce qui se produit si vous exécutez cette commande. Notez que, étant donné que cette commande n’utilise pas l’option -DoNotGenerateXmlSnapshot, le test ne crée pas le instantané XML.

    === Begin Contents of Synthesized Features Buffer ===*Feature: SynFea_InputBinENVFEED{*FeatureType: SYNTHESIZED_PROPERTY*Name: "Optional Envelope Feeder"*Option: NotInstalled{*Name: "Not installed"*Constraints: InputBin.ENVFEED}*Option: Installed{*Name: "Installed"}}=== End Contents of Synthesized Features Buffer ===

    Notez que vous n’avez pas besoin d’utiliser l’option -DoNotGenerateXmlSnapshot si vous souhaitez utiliser l’option -DisplaySynthesizedFeatures . Vous pouvez également utiliser la commande suivante :

    GDLCheck.exe -DisplaySynthesizedFeatures -DisplayValidatedConfiguration -DeviceConfiguration -DocumentConfiguration synfea.gdl

    Cette commande génère la sortie de débogage suivante :

    === Begin Contents of Synthesized Features Buffer ===*Feature: SynFea_InputBinENVFEED{*FeatureType: SYNTHESIZED_PROPERTY*Name: "Optional Envelope Feeder"*Option: NotInstalled{*Name: "Not installed"*Constraints: InputBin.ENVFEED}*Option: Installed{*Name: "Installed"}}=== End Contents of Synthesized Features Buffer ======= Validated Configuration ====SynFea_InputBinENVFEED:NotInstalled==== Validated Configuration ====SynFea_InputBinENVFEED:NotInstalledPaperSize:LETTERResolution:Option1RESDLL:UniresDLLInputBin:UPPER

  • GDLCheck.exe -DisplayValidatedConfiguration -DeviceConfigurationMemory.8192KB:PrinterHardDisk.TRUE -cOrientation.LANDSCAPE_CC90:Resolution.Option2:PaperSize.LEGAL hplj5si.gdl

    Cette commande montre comment utiliser les options -DeviceConfiguration et -DocumentConfiguration pour définir vos propres configurations d’appareil et de document. La sortie de débogage suivante montre un exemple de ce que vous pouvez voir quand vous exécutez cette commande.

    ==== Validated Configuration ====Memory:8192KBPrinterHardDisk:TRUEDuplexUnit:InstalledPageProtect:OFF==== Validated Configuration ====Memory:8192KBPrinterHardDisk:TRUEDuplexUnit:InstalledPageProtect:OFFPaperSize:LEGALOrientation:LANDSCAPE_CC90Duplex:NONEResolution:Option2Halftone:HT_PATSIZE_AUTORESDLL:UniresDLLOutputBin:Option1Collate:OFFStapling:Option1InputBin:Option1

  • Vous pouvez utiliser l’argument -ParserContext dans GDLCheck pour valider plusieurs fichiers GDL racine dans une seule exécution de GDLCheck. Voici la syntaxe de cette commande :

    GDLCheck.exe -Preface=c:\test\preface.gdl -DisplayValidatedConfiguration -DeviceConfiguration -DocumentConfiguration c:\test\basic.gdl -ParserContext=1 -Preface=c:\test\preface.gdl -DisplayValidatedConfiguration -Verbosity=1 -Personality=Persona1 -GenerateSchema -DeviceConfiguration -DocumentConfiguration c:\test\personatest.gdl

    Cet exemple montre également comment utiliser l’option -Personality pour spécifier une personnalité pour la génération de l’instantané XML sensible à la personnalité.

Paramètres

Nom du paramètre Description des paramètres
CommandStringOptions Arguments de commande.
LLU_LAU Utilisateur local logique.
LLU_NetAccessOnly Utilisateur local logique : accès réseau uniquement.
TestExecutableName Nom de l’exécutable de test.
WDKPrinterName Nom de l’imprimante.