인쇄를 위한 디바이스의 웹 서비스(WS 인쇄)
Important
최신 인쇄 플랫폼은 Windows에서 프린터와 통신하는 데 선호되는 수단입니다. 프린터 장치 개발을 위해 Windows 10 및 11의 인쇄 환경을 사용자 지정하려면 MICROSOFT의 IPP 받은 편지함 클래스 드라이버와 PSA(인쇄 지원 앱)를 사용하는 것이 좋습니다.
자세한 내용은 인쇄 지원 앱 디자인 가이드참조하세요.
인쇄용 디바이스의 웹 서비스(WS-Print)는 주변 장치를 인쇄하고 스캔하기 위한 연결 프로토콜을 제공하기 위해 도입되었습니다.
개요
웹 서비스 기술은 정보를 설명하고 공유하기 위한 일반적인 프레임워크를 제공합니다. 따라서 Windows에는 네트워크 연결 디바이스에서 서비스를 사용하고 제어하기 위한 프로토콜 집합이 함께 제공됩니다.
장치 제조업체가 Windows 장치 연결, 설치 및 사용와 관련하여 향상된 고객 환경을 활용할 수 있도록, 인쇄 및 스캔을 위한 네 가지 웹 서비스 사양이 있습니다.
WS-Print v1.1
Windows 8의 경우 WSD(디바이스)의 웹 서비스에 대한 인쇄 스키마가 v1.1로 업데이트되었습니다. 이 버전의 스키마(WS-Print v1.1이라고 함)는 향상된 드라이버 구성, 잉크/토너에 대한 더 나은 색 표현 및 디바이스 모델 ID를 지원하도록 업데이트되었습니다.
WS-Print v1.2
Windows 8.1 경우 WS-Print에는 WS-Print v1.1에 사용되는 모든 작업 및 스키마 요소가 포함되지만 디바이스의 웹 서비스에 대한 인쇄 서비스 정의가 업데이트되었습니다. 그리고 인쇄를 위한 디바이스의 새 웹 서비스는 WS-Print v1.2입니다.
WS-Print v1.2에서는 새 스키마 요소 및 새 작업이 추가되었습니다. 새 스키마 요소 "SupportsWSPrintV12"는 WS-Print V1.2에 대한 지원을 식별하는 데 사용됩니다. 새 작업인 "SetPrinterElements"를 사용하면 클라이언트가 프린터에서 스키마 요소의 값을 설정할 수 있습니다. 예를 들어 클라이언트는 프린터에서 잉크젯 헤드를 다시 정렬하는 데 사용할 "InkHeadAlignmentValue"라는 사용자 지정 요소를 설정할 수 있습니다.
편의를 위해 이 사양은 다운로드 섹션에서 WSD(Web Services Description Languages) 및 XSD(XML 스키마 정의)와 함께 완전한 독립 실행형 형식으로 제공됩니다. 디바이스 사양의 이러한 4가지 웹 서비스는 WDK(Windows 드라이버 개발 키트)를 참조하는 포함된 기술 문서 라이선스 계약에 포함됩니다.
다음 섹션에서는 WS-Print의 다양한 측면에 대한 자세한 정보를 제공합니다.
시퀀스 다이어그램
다음 시퀀스 다이어그램에서는 지원되는 WS-Print 네임스페이스의 버전을 확인한 다음 확장된 스키마 요소를 검색하기 위해 클라이언트와 프린터 간의 상호 작용을 보여 줍니다.
WS-Print v1.1 시퀀스 다이어그램
다음은 WS-Print v1.1을 지원하는 프린터의 상호 작용 시퀀스 다이어그램입니다.
ws-print v1.1 지원과 관련된 클라이언트-프린터 상호 작용 및 프린터 설명 및 구성에 대한 후속 쿼리를 보여 주는 시퀀스 다이어그램
프린터에서 WS-Print v1.1을 지원하는 경우 클라이언트의 GetPrinterElements(wprt:PrinterDescription) 쿼리에 대한 응답으로 프린터는 정보를 다시 전송하여 이를 나타냅니다.
프린터가 WS-Print v1.1을 지원하는지 확인한 후 클라이언트는 GetPrinterElements(wprt11:DriverConfiguration) 쿼리를 보내고 프린터는 요청된 드라이버 구성 정보로 응답합니다.
WS-Print v1.2 시퀀스 다이어그램
WS-Print v1.2를 지원하는 프린터의 상호 작용 시퀀스 다이어그램은 다음과 같습니다.
ws-print v1.2 지원과 관련된 클라이언트 프린터 상호 작용 및 프린터 설명 및 구성에 대한 후속 쿼리를 보여 주는 시퀀스 다이어그램
프린터에서 WS-Print v1.2를 지원하는 경우 클라이언트의 GetPrinterElements(wprt:PrinterDescription) 쿼리에 대한 응답으로 프린터는 정보를 다시 전송하여 이를 나타냅니다.
또한 프린터는 GetPrinterElements(wprt:PrinterDescription) 호출에 대한 응답으로 wprt12:SupportsWSPrintV12를 반환해야 합니다. 그런 다음 클라이언트는 SetPrinterElements 작업을 호출하여 WS-Print 디바이스에서 지원하는 스키마에 하나 이상의 데이터 요소를 설정할 수 있습니다.
프린터가 WS-Print v1.2를 지원하는지 확인한 후 클라이언트는 GetPrinterElements(wprt12:DriverConfiguration) 쿼리를 보내고 프린터는 요청된 드라이버 구성 정보로 응답합니다.
네임스페이스
WS-Print v1.1 네임스페이스
네임스페이스:<https://schemas.microsoft.com/windows/2010/06/wdp/printv11>XML 네임스페이스 정의:xmlns:wprt12="<https://schemas.microsoft.com/windows/2012/10/wdp/printV12>"
WS-Print v1.2 네임스페이스
네임스페이스:<https://schemas.microsoft.com/windows/2010/06/wdp/printv11>XML 네임스페이스 정의:xmlns:wprt12="<https://schemas.microsoft.com/windows/2012/10/wdp/printV12>"
WS-Print 1.1 지원 지정
WS-Print 1.1 요소를 지원하는 프린터는 wprt11:SupportsWSPrintv11을 포함하도록 PrinterDescription을 업데이트해야 합니다. wprt11:SupportsWSPrintv11을 지정하지 않고 true로 설정하면 WSDMon은 프린터에서 WS-Print 1.1 요소를 요청하지 않습니다.
Windows에서 해당 네임스페이스의 다른 요소를 쿼리하려면 WS-Print v1.1을 지원하는 인쇄 디바이스에 PrinterDescription에 다음 콘텐츠가 포함되어야 합니다.
<soap:Envelope
...
xmlns:wprt11="https://schemas.microsoft.com/windows/2010/06/wdp/printv11">"
...
<wprt11:SupportsWSPrintv11>true</wprt11:SupportsWSPrintv11>
...
다음 XML 코드 조각은 WSD 인쇄 서비스 사양 v1.0에서 파생되며 이전 섹션에 있는 콘텐츠의 적절한 사용량을 보여 줍니다.
<soap:Envelope
xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
xmlns:wsa="https://schemas.xmlsoap.org/ws/2004/08/addressing"
xmlns:wprt="https://schemas.microsoft.com/windows/2006/08/wdp/print"
xmlns:wprt11="https://schemas.microsoft.com/windows/2010/06/wdp/printv11">"
<soap:Header>
<wsa:To>https://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:To>
<wsa:Action>
https://schemas.microsoft.com/windows/2006/08/wdp/print/GetPrinterElementsResponse
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
<wsa:RelatesTo>uuid:MsgIdOfTheGetPrinterElementsRequest</wsa:RelatesTo>
</soap:Header>
<soap:Body>
<wprt:GetPrinterElementsResponse>
<wprt:PrinterElements>
<wprt:ElementData Name="wprt:PrinterDescription" Valid="true">
<wprt:PrinterDescription>
<wprt:ColorSupported>true</wprt:ColorSupported>
<wprt:DeviceId>MFG:Acme;MDL:PrintMaster 9020</wprt:DeviceId>
<wprt:MultipleDocumentJobsSupported>true</wprt:MultipleDocumentJobsSupported>
<wprt:PagesPerMinute>20</wprt:PagesPerMinute>
<wprt:PagesPerMinuteColor>8</wprt:PagesPerMinuteColor>
<wprt:PrinterName xml:lang="en-AU, en-CA, en-GB, en-US">
Accounting Printer in Copy Room 2
</wprt:PrinterName>
<wprt:PrinterInfo xml:lang="en-AU, en-CA, en-GB, en-US">
Printer for use of Accounting only
</wprt:PrinterInfo>
<wprt:PrinterLocation xml:lang="en-AU, en-CA, en-GB, en-US">
LA Campus – Building 3
</wprt:PrinterLocation>
<wprt11:SupportsWSPrintv11>true</wprt11:SupportsWSPrintv11>
</wprt:PrinterDescription>
</wprt:ElementData>
</wprt:PrinterElements>
</wprt:GetPrinterElementsResponse>
</soap:Body>
</soap:Envelope>
다음 XML 코드 조각은 WS-Print v1.1을 지원하는 인쇄 디바이스의 스키마를 보여 줍니다.
<xs:schema targetNamespace="https://schemas.microsoft.com/windows/2010/06/wdp/printv11"
xmlns:wprt11="https://schemas.microsoft.com/windows/2010/06/wdp/printv11"
xmlns:xs="https://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified">
<xs:annotation>
<xs:documentation>
WS-Print Extensions for Driver Configuration and Consumable Definition
Copyright 2010 Microsoft Corp. All rights reserved
</xs:documentation>
</xs:annotation>
<xs:annotation>
<xs:documentation> A Boolean element that denotes support for WS-Print V11 extensions
</xs:documentation>
</xs:annotation>
<xs:element name="SupportsWSPrintv11" type="xs:boolean"/>
WS-Print 1.2 지원 지정
WS-Print 1.2 요소를 지원하는 프린터는 wprtV12:SupportsWSPrintV12를 포함하도록 PrinterDescription을 업데이트해야 합니다. wprtV12:SupportsWSPrintV12를 지정하지 않고 true로 설정하면 WSDMon은 프린터에서 WS-Print 1.2 요소를 요청하지 않습니다.
Windows에서 해당 네임스페이스의 다른 요소를 쿼리하려면 WS-Print v1.2를 지원하는 인쇄 디바이스에 PrinterDescription에 다음 콘텐츠가 포함되어야 합니다.
<soap:Envelope
…
xmlns:wprtV12="https://schemas.microsoft.com/windows/2012/10/wdp/printV12">
…
<wprtV12:SupportsWSPrintV12>true</wprtV12:SupportsWSPrintV12>
…
</soap:Envelope>
다음 XML 코드 조각은 WSD 인쇄 서비스 사양 v1.2에서 파생되며 이전 섹션에 있는 콘텐츠의 적절한 사용량을 보여 줍니다.
<soap:Envelope
xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
xmlns:wsa="https://schemas.xmlsoap.org/ws/2004/08/addressing"
xmlns:wprt="https://schemas.microsoft.com/windows/2006/08/wdp/print"
xmlns:wprtV12="https://schemas.microsoft.com/windows/2012/10/wdp/printV12">
<soap:Header>
<wsa:To>https://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:To>
<wsa:Action>
https://schemas.microsoft.com/windows/2006/08/wdp/print/GetPrinterElementsResponse
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
<wsa:RelatesTo>uuid:MsgIdOfTheGetPrinterElementsRequest</wsa:RelatesTo>
</soap:Header>
<soap:Body>
<wprt:GetPrinterElementsResponse>
<wprt:PrinterElements>
<wprt:ElementData Name="wprt:PrinterDescription" Valid="true">
<wprt:PrinterDescription>
<wprt:ColorSupported>true</wprt:ColorSupported>
<wprt:DeviceId>MFG:Acme;MDL:PrintMaster 9020</wprt:DeviceId>
<wprt:MultipleDocumentJobsSupported>true</wprt:MultipleDocumentJobsSupported>
<wprt:PagesPerMinute>20</wprt:PagesPerMinute>
<wprt:PagesPerMinuteColor>8</wprt:PagesPerMinuteColor>
<wprt:PrinterName xml:lang="en-AU, en-CA, en-GB, en-US">
Accounting Printer in Copy Room 2</wprt:PrinterName>
<wprt:PrinterInfo xml:lang="en-AU, en-CA, en-GB, en-US">
Printer for use of Accounting only</wprt:PrinterInfo>
<wprt:PrinterLocation xml:lang="en-AU, en-CA, en-GB, en-US">
LA Campus – Building 3</wprt:PrinterLocation>
<wprtV12:SupportsWSPrintV12>true</wprtV12:SupportsWSPrintV12>
</wprt:PrinterDescription>
</wprt:ElementData>
</wprt:PrinterElements>
</wprt:GetPrinterElementsResponse>
</soap:Body>
</soap:Envelope>
다음 세 섹션의 스키마 예제에서는 WS-Print V1.1에서 도입된 일부 새 요소를 사용하는 방법을 보여 줍니다. WS-Print V1.1 네임스페이스에 도입된 모든 요소에 대한 자세한 내용은 아래 다운로드 섹션에 나열된 WS-Print v1.0 – v1.2에 대한 지원 파일을 참조하세요.
향상된 드라이버 구성
이 스키마는 이 디바이스에 대한 디바이스별 GPD 또는 PPD 구성 파일을 제공합니다.
<xs:annotation>
<xs:documentation>Driver Configuration File definition</xs:documentation>
</xs:annotation>
<xs:element name="DriverConfiguration" type="wprt11:DriverConfigurationType"/>
<xs:complexType name="DriverConfigurationType">
<xs:sequence>
<xs:element name="GPDConfigFile" type="xs:string" minOccurs="0" />
<xs:element name="PPDConfigFile" type="xs:string" minOccurs="0" />
<xs:any namespace="##other" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:anyAttribute namespace="##other" processContents="lax" />
</xs:complexType>
디바이스 모델 ID
다음 스키마는 디바이스에 대한 ModelID를 설명하고 디바이스 메타데이터 검색에 사용됩니다. ModelID에 대한 자세한 내용은 ModelID 요소를 참조 하세요.
<xs:annotation>
<xs:documentation> Print Device Model Id value for device differentiation</xs:documentation>
<xs:documentation> Always represented as a GUID</xs:documentation>
</xs:annotation>
<xs:element name="DeviceModelId" type="wprt11:DeviceModelIdGuidType"/>
<xs:simpleType name="DeviceModelIdGuidType">
<xs:restriction base="xs:string">
<xs:length value="36"/>
</xs:restriction>
</xs:simpleType>
잉크/토너 색 표현 값
다음 스키마는 특정 잉크 또는 토너 형식의 색을 나타내는 RGB 트리플을 검색합니다. 이 값은 앱 UI에 색을 더 잘 표시할 수 있도록 잉크 또는 토너 소모품에 대해 지정해야 합니다.
<xs:annotation>
<xs:documentation>
Ink/Toner Color Representation definition
A 6-digit hex representation of the RGB color value this Consumable entry represents.
Examples of these values are:
Black – 000000
Red – FF0000
White – FFFFFF
Magenta – FF00FF
Cyan – 00FFFF
Yellow – FFFF00
Blue – 0000FF
</xs:documentation> </xs:annotation>
<xs:element name="ColorRepresentation" type="wprt11:ColorRepType"/>
<xs:simpleType name="ColorRepType">
<xs:restriction base="xs:string">
<xs:length value="6"/>
</xs:restriction>
</xs:simpleType>
이 항목의 앞부분에서 설명한 대로 WS-Print v1.2 섹션에서 WS-Print V1.2 네임스페이스를 사용하여 다음과 같은 새 작업이 도입되었습니다.
SetPrinterElements
SetPrinterElements 작업은 새로운 작업이며 클라이언트가 프린터에서 스키마 요소의 값을 설정할 수 있도록 합니다. SetPrinterElements 작업에는 8개의 요청 요소와 4개의 응답 요소가 있습니다. 요청 및 응답 요소는 WS-Print 디바이스 스키마와 관련하여 데이터 삽입 및 검색에 대한 세밀한 제어를 클라이언트에 제공합니다.
예를 들어 ElementPath 데이터 요소(SetPrinterElements 작업의 일부)는 설정할 Data 요소의 프린터 스키마 내의 위치를 나타내는 XPath 문자열입니다.
SetPrinterElements 작업에 대한 자세한 내용은 아래 다운로드 섹션에 나열된 WS-Print v1.0 – v1.2에 대한 지원 파일을 참조하세요.
다운로드
WS-Print v1.0 – v1.2에 대한 사양 및 지원 파일
파일:디바이스 설명에서 웹 서비스에 대한 디바이스정의 V1.0 인쇄: Microsoft Word 문서 및 지원 파일이 포함된 2.64MB zip 파일; 2013년 9월 16일
사양 및 지원 파일
파일:디바이스 설명에서 웹 서비스에 대한 디바이스정의 V1.0 인쇄: Microsoft Word 문서 및 지원 파일이 포함된 76KB 자체 추출 파일; 2007년 1월 29일
파일:디바이스에서 웹 서비스에 대한 서비스 정의 V1.0 검사 설명: (Microsoft Word 문서 및 지원 파일이 포함된 1.5MB zip 파일; 2012년 2월 9일)
파일:디바이스 설명에서 웹 서비스에 대한 디바이스정의 V1.0 검사: (Microsoft Word 문서 및 지원 파일이 포함된 76KB 자체 추출 파일; 2007년 1월 29일)