JSConstraintsDebug

JSConstraintsDebug (JSConstraintsDebug.exe) är ett kommandoradsverktyg som tillhandahåller felsökningsstöd för JavaScript-begränsningar när du utvecklar en V4-skrivardrivrutin.

Var kan jag ladda ned JSConstraintsDebug?

JSConstraintsDebug.exe ingår i Microsoft Windows Driver Kit (WDK). Information om hur du hämtar WDK finns i Nedladdningar av Windows Driver Kit.

Verktyget kör var och en av följande relevanta startpunkts-API:er på JavaScript-begränsningarna för den riktade drivrutinen mot den användaringivna utskriftsbiljetten:

PTGetPrintCapabilities

PTConvertDevModeToPrintTicket

TConvertPrintTicketToDevMode

PTSammanfogaOchValideraUtskriftsbiljett

Under körningen frågar verktyget efter ett lämpligt IDE-felsökningsprogram, till exempel Visual Studio. När du väljer detta kommer källkoden för begränsningarna att öppnas och stoppas vid ett JavaScript-felsökningsuttryck.

Följ dessa steg för att felsöka JS-begränsningsfiler:

  1. Öppna ett kommandotolksfönster.

  2. Kör verktyget JSConstraintsDebug.exe och ange minst skrivarnamnet och sökvägen till en testutskriftsbiljett.

  3. Välj det felsökningsverktyg som du vill använda.

Köra JSConstraintsDebug i användarläge

Förhöjd behörighet krävs för att aktivera felsökning av JS-funktioner. Om du vill köra i användarläge måste följande registernyckel anges innan du kör JSConstraintsDebug.exe:

Nyckelnamn

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print

Värdenamn

AktiveraJavaScriptFelsökning

Typ

DWORD

Värde

1

JavaScript-felsökningsuttryck

Brytpunkter kan skapas i JavaScript-källa med hjälp av debugger-sats. Detta pausar åtgärden i Visual Studio och tillåter stegvis felsökning. Dessa instruktioner kan infogas i någon av JavaScript-begränsnings-API:erna.

Till exempel:

function validatePrintTicket(PrintTicket, scriptContext)
{
    debugger; // debug tool will pause at this breakpoint
    ...
}

Kommandosyntax för JSConstraintsDebug

JSConstraintsDebug <PrinterName> <PrintTicket> [MergePrintTicket] [Constraints]

Kommandoparametrar

Parameterar Beskrivning

PrinterName

Obligatoriskt. Anger strängnamnet för en utskriftsdrivrutin som innehåller källfilen JS-begränsningar. Den här drivrutinen används för alla felsökningsåtgärder.

PrintTicket

Obligatoriskt. Anger sökvägen och namnet på en XML-fil för utskriftsbiljett som ska valideras.

MergePrintTicket

Valfritt. Anger sökvägen och namnet på en XML-fil för utskriftsbiljett som ska användas för att verifiera en sammanslagningsåtgärd.

Om den här parametern inte har angetts konverteras standard-DevMode till en utskriftsbiljett och skickas till API:et Merge and Validate .

Begränsningar

Valfritt. Anger sökvägen och namnet på en JavaScript-begränsningsfil som ersätter den befintliga begränsningskällan som finns i målskrivarens drivrutin innan du felsöker.

Not Om du anger en begränsningsfil med parametern Constraints skrivs befintlig källkod över i måldrivrutinen.

Exempel

Felsöka en utskriftsdrivrutin mot en känd testutskriftsbiljett.

JSConstraintsDebug “Contoso Printer” PrintTicket.xml

Felsöka en utskriftsdrivrutin med en ny begränsningskälla mot en känd testutskriftsbiljett.

JSConstraintsDebug “Contoso Printer” PrintTicket.xml Constraints.js

Testa sammanslagning och validera operationer mellan två anpassade utskriftsbiljetter.

JSConstraintsDebug “Contoso Printer” PrintTicket.xml PrintTicket2.xml