Partilhar via

Teste de correção de GDL

  • Artigo

Esse teste automatizado é executado pela ferramenta GDLCheck. A ferramenta executa uma sintaxe de GDL (linguagem de descrição genérica) marcar que analisa e carrega arquivos GDL, especifica configurações, obtém instantâneos XML e procura erros de sintaxe.

Detalhes do teste

   
Especificações
  • Device.Imaging.Printer.Base.GDLFile
  • Device.Imaging.3DPrinter.Base.GDLFile
Plataformas
  • Windows 10, edições de cliente (x86)
  • Windows 10, edições de cliente (x64)
  • Windows Server 2016 (x64)
  • Windows 10, edições de cliente (Arm64)
Versões com suporte
  • Windows 10
  • Windows 10, versão 1511
  • Windows 10, versão 1607
  • Windows 10, versão 1703
  • Windows 10, versão 1709
  • Windows 10, versão 1803
  • Windows 10, versão 1809
  • Windows 10, versão 1903
  • Próxima atualização para Windows 10
Tempo de execução esperado (em minutos) 2
Categoria Cenário
Tempo limite (em minutos) 120
Requer reinicialização false
Requer configuração especial false
Tipo automático

 

Documentação adicional

Os testes nessa área de recurso podem ter documentação adicional, incluindo pré-requisitos, configuração e informações de solução de problemas, que podem ser encontradas nos tópicos a seguir:

Executando o teste

Antes de executar o teste, conclua a configuração de teste conforme descrito nos requisitos de teste: Pré-requisitos de teste de impressora.

Solucionando problemas

Para solução de problemas genéricos de falhas de teste do HLK, consulte Solução de problemas de falhas de teste do Windows HLK.

Para obter informações de solução de problemas, consulte Solução de problemas de teste de dispositivo.geração de imagens.

Mais informações

Esse teste envia todos os erros de análise e saída de depuração para Gdlcheck.xml. O teste processa argumentos de linha de comando da esquerda para a direita. Cada argumento é separado do próximo com um caractere de espaço. Você deve especificar todas as opções antes de especificar o nome do arquivo raiz GDL.

Você pode executar essa ferramenta de teste no WDK (Microsoft® Windows Driver Kit) ou por si só no prompt de comando. Essa ferramenta registra os resultados em um arquivo de log WTT (Windows Test Technologies). Você pode configurar a ferramenta para registrar informações em diferentes níveis de detalhamento. A ferramenta requer a GPD (descrição da impressora genérica) raiz ou o arquivo GDL que você deseja validar e quaisquer outros arquivos GPD ou GDL referenciados pelo arquivo raiz.

GDLCheck grava toda a saída de depuração no arquivo GDLCheck.xml.

A sintaxe dessa ferramenta é a seguinte:

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.

A lista a seguir descreve alguns comandos GDLCheck de exemplo:

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

    Esse comando produz um instantâneo XML no arquivo GDLsnapshot.xml usando as configurações padrão do dispositivo e do documento. O arquivo basic.gdl implementa os recursos básicos necessários para atender às produções de construção raiz definidas pelo arquivo stdschem.gdl. A saída de depuração a seguir mostra um exemplo do que ocorre se você especificar a opção -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

    Esse comando produz o esquema para o instantâneo XML, mas não o instantâneo em si. Você pode encontrar o esquema no arquivo GDLschema.xsd. Esse comando mostra a opção -GenerateSchema e a opção -DoNotGenerateXmlSnapshot . Essa opção desativa instantâneo criação. Por padrão, gdlcheck produz o instantâneo XML, a menos que você especifique a opção -DoNotGenerateXmlSnapshot.

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

    Este comando mostra como usar a opção -PrefaceFile em Gdlcheck para especificar um arquivo de prefácio. Para executar esse teste, comente ou remova a linha "*Incluir: "stdschmx.gdl" do arquivo basic.gdl porque o arquivo preface.gdl já inclui essa linha. O resultado da execução desse comando é o mesmo que o resultado do primeiro comando de exemplo.

  • GDLCheck.exe -DisplaySynthesizedFeatures -DoNotGenerateXmlSnapshot synfea.gdl

    Este comando mostra como usar a opção -DisplaySynthesizedFeatures para verificar a criação de recursos sintetizados. A saída de depuração a seguir mostra um exemplo do que ocorre se você executar esse comando. Observe que, como esse comando não usa a opção -DoNotGenerateXmlSnapshot, o teste não cria o instantâneo 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 ===

    Observe que você não precisa usar a opção -DoNotGenerateXmlSnapshot se quiser usar a opção -DisplaySynthesizedFeatures . Use também o seguinte comando:

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

    Esse comando produz a seguinte saída de depuração:

    === 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

    Este comando mostra como usar as opções -DeviceConfiguration e -DocumentConfiguration para definir suas próprias configurações de dispositivo e documento. A saída de depuração a seguir mostra um exemplo do que você pode ver ao executar esse comando.

    ==== 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

  • Você pode usar o argumento -ParserContext em GDLCheck para validar mais de um arquivo GDL raiz em uma única execução de GDLCheck. Veja a seguir a sintaxe deste comando:

    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

    Este exemplo também mostra como usar a opção -Personality para especificar uma personalidade para a geração da instantâneo XML com reconhecimento de personalidade.

Parâmetros

Nome do parâmetro Descrição do parâmetro
CommandStringOptions Argumentos de comando.
LLU_LAU Usuário Local Lógico.
LLU_NetAccessOnly Usuário Local Lógico: somente acesso à rede.
TestExecutableName Nome executável de teste.
WDKPrinterName Nome da impressora.