1 2 November 9, 2010 wd-mfdcopymodel10-2010 Working Draft 3 The Printer Working Group 4 5 6 7 8 Copy Service Semantic Model and Service Interface 9 10 11 12 13 14 15 16 17 18 19 20 Status: Stable Abstract: Network print devices have evolved to support additional multifunction services, in particular Copy Service. When Copy Devices are installed in local office or enterprise networks, they need remote service, device, and job management capabilities so that administrators, operators, and users can monitor their health and status. In addition, such Copy Devices need remote job submission capabilities so that operators and users can create CopyJobs without depending entirely on local console interfaces. This document defines a semantic model for service, device, and job management and job submission for these Copy Devices. 21 22 23 24 25 26 27 28 29 30 31 32 33 Copyright © 2010, Printer Working Group. All rights reserved. November 9, 2010 MFD: Copy Service 34 35 36 37 38 39 Copyright (C) 2010, The Printer Working Group. All rights reserved. This document may be copied and furnished to others, and derivative works that comment on, or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice, this paragraph and the title of the Document as referenced below are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Printer Working Group, a program of the IEEE-ISTO. 40 Title: Network Copy Service Semantic Model and Service Interface 41 42 43 The IEEE-ISTO and the Printer Working Group DISCLAIM ANY AND ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED INCLUDING (WITHOUT LIMITATION) ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 44 45 The Printer Working Group, a program of the IEEE-ISTO, reserves the right to make changes to the document without further notice. The document may be updated, replaced or made obsolete by other documents at any time. 46 47 48 49 The IEEE-ISTO and the Printer Working Group, a program of the IEEE-ISTO take no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. 50 51 52 53 54 55 The IEEE-ISTO and the Printer Working Group, a program of the IEEE-ISTO invite any interested party to bring to its attention any copyrights, patents, or patent applications, or other proprietary rights, which may cover technology that may be required to implement the contents of this document. The IEEE-ISTO and its programs shall not be responsible for identifying patents for which a license may be required by a document and/or IEEE-ISTO Industry Group Standard or for conducting inquiries into the legal validity or scope of those patents that are brought to its attention. Inquiries may be submitted to the IEEE-ISTO by e-mail at: 56 [email protected] 57 58 59 The Printer Working Group acknowledges that the IEEE-ISTO (acting itself or through its designees) is, and shall at all times, be the sole entity that may authorize the use of certification marks, trademarks, or other special designations to indicate compliance with these materials. 60 61 62 Use of this document is wholly voluntary. The existence of this document does not imply that there are no other ways to produce, test, measure, purchase, market, or provide other goods and services related to its scope. 63 Copyright © 2010, Printer Working Group. All rights reserved. Page 2 of 31 November 9, 2010 MFD: Copy Service 64 About the IEEE-ISTO 65 66 67 68 69 70 71 The IEEE-ISTO is a not-for-profit corporation offering industry groups an innovative and flexible operational forum and support services. The IEEE Industry Standards and Technology Organization member organizations include printer manufacturers, print server developers, operating system providers, network operating systems providers, network connectivity vendors, and print management application developers. The IEEE-ISTO provides a forum not only to develop standards, but also to facilitate activities that support the implementation and acceptance of standards in the marketplace. The organization is affiliated with the IEEE (http://www.ieee.org/) and the IEEE Standards Association (http://standards.ieee.org/). 72 73 74 75 For additional information regarding the IEEE-ISTO and its industry programs visit: http://www.ieee-isto.org. 76 77 78 79 80 81 The Printer Working Group (or PWG) is a Program of the IEEE-ISTO. All references to the PWG in this document implicitly mean “The Printer Working Group, a Program of the IEEE ISTO.” The PWG is chartered to make printers and the applications and operating systems supporting them work together better. In order to meet this objective, the PWG will document the results of their work as open standards that define print related protocols, interfaces, data models, procedures and conventions. Printer manufacturers and vendors of printer related software would benefit from the interoperability provided by voluntary conformance to these standards. 82 83 84 In general, a PWG standard is a specification that is stable, well understood, and is technically competent, has multiple, independent and interoperable implementations with substantial operational experience, and enjoys significant public support. 85 Contact information: 86 87 88 89 90 91 92 93 94 95 96 97 The Printer Working Group c/o The IEEE Industry Standards and Technology Organization 445 Hoes Lane Piscataway, NJ 08854 USA About the Printer Working Group MFD Web Page: http://www.pwg.org/mfd MFD Mailing List: [email protected] Instructions for subscribing to the MFD mailing list can be found at the following link: http://www.pwg.org/mailhelp.html Members of the PWG and interested parties are encouraged to join the PWG and MFD WG mailing lists in order to participate in discussions, clarifications and review of the WG product. 98 Copyright © 2010, Printer Working Group. All rights reserved. Page 3 of 31 MFD: Copy Service 99 November 9, 2010 Contents 100 1 Introduction ..................................................................................................................................................... 6 101 2 Summary......................................................................................................................................................... 6 102 103 104 105 106 3 107 108 109 4 110 5 111 112 113 114 115 116 117 6 118 119 120 121 122 123 124 7 125 8 CopyService Theory of Operation ................................................................................................................ 27 126 9 CopyService Interfaces ................................................................................................................................. 27 127 128 129 130 131 132 133 10 134 11 PWG and IANA Registration Considerations................................................................................................ 30 135 12 Internalization Considerations ...................................................................................................................... 30 136 13 Security Considerations ................................................................................................................................ 30 137 138 139 14 140 141 15 3.1 3.2 3.3 3.4 Terminology .................................................................................................................................................... 7 Conformance Terminology .................................................................................................................................... 7 Content Specific Terminology ................................................................................................................................ 7 Model mapping conventions .................................................................................................................................. 7 Naming conventions for Overall specification and this specification ..................................................................... 7 4.1 4.2 Rationale ......................................................................................................................................................... 7 Rationale for this CopyService Specification ......................................................................................................... 7 Out of Scope for CopyService ............................................................................................................................... 7 MFD Model Overview ..................................................................................................................................... 9 6.1 6.2 6.3 6.4 6.5 6.6 CopyService Model Overview ......................................................................................................................... 9 CopyServiceCapabilities ...................................................................................................................................... 10 CopyServiceCapabilitiesReady ........................................................................................................................... 12 CopyServiceConfiguration ................................................................................................................................... 12 CopyServiceDescription ...................................................................................................................................... 14 CopyServiceStatus .............................................................................................................................................. 15 Default CopyJobTicket......................................................................................................................................... 16 CopyJob Model ............................................................................................................................................. 18 7.1 CopyJobReceipt................................................................................................................................................... 19 7.2 CopyJobStatus..................................................................................................................................................... 19 7.3 CopyJobTicket ..................................................................................................................................................... 21 7.3.1 CopyDocumentProcessing ......................................................................................................................... 21 7.3.2 CopyJobDescription .................................................................................................................................... 24 7.3.3 CopyJobProcessing .................................................................................................................................... 25 Conformance Requirements ......................................................................................................................... 29 10.1 Client Conformance Requirements...................................................................................................................... 29 10.2 Copy Service Conformance Requirements ......................................................................................................... 29 10.2.1 Objects ........................................................................................................................................................ 29 10.2.2 Operations ................................................................................................................................................... 29 10.3 Copy Service Elements ....................................................................................................................................... 30 10.4 Extensions ........................................................................................................................................................... 30 14.1 14.2 References .................................................................................................................................................... 30 Normative References ......................................................................................................................................... 30 Informative References ........................................................................................................................................ 31 Author’s Address ........................................................................................................................................... 31 Copyright © 2010, Printer Working Group. All rights reserved. Page 4 of 31 MFD: Copy Service November 9, 2010 142 143 144 Figures Figure 1 High Level CopyService Schema ............................................................................. Error! Bookmark not defined. 145 Figure 2 CopyServiceCapabilities ........................................................................................... Error! Bookmark not defined. 146 Figure 3 CopyServiceConfiguration ........................................................................................ Error! Bookmark not defined. 147 Figure 4 CopyServiceDescription............................................................................................ Error! Bookmark not defined. 148 Figure 5 CopyServiceStatus ................................................................................................... Error! Bookmark not defined. 149 Figure 6 DefaultCopyJobTicket ............................................................................................................................................. 17 150 Figure 7 JobTable ................................................................................................................................................................. 18 151 Figure 8 High Level CopyJob View ....................................................................................................................................... 19 152 Figure 9 CopyJobStatus .......................................................................................................... Error! Bookmark not defined. 153 Figure 10 CopyJobTicket ...................................................................................................................................................... 21 154 Figure 11 CopyDocumentProcessing (Input) ........................................................................................................................ 22 155 Figure 12 CopyDocumentProcessing (Output) ..................................................................................................................... 23 156 Figure 13 CopyJobDescription .............................................................................................................................................. 24 157 Figure 14 CopyJobProcessing .............................................................................................................................................. 26 158 159 160 161 Tables Table 1 CopyServiceCapabilities .......................................................................................................................................... 11 162 Table 2 Mandatory User Operations ..................................................................................................................................... 27 163 Table 3 Optional User Operations......................................................................................................................................... 28 164 Table 4 Administrative Operations ........................................................................................................................................ 28 165 166 Copyright © 2010, Printer Working Group. All rights reserved. Page 5 of 31 MFD: Copy Service November 9, 2010 167 1 Introduction 168 169 170 171 172 This document specifies the PWG abstract model for Copy Services of a Multifunction Device (MFD). Included in this document is the content specific terminology, data model, the theory of operation, the CopyService interfaces and the conformance requirements. The MFD Copy Service abstract models include the functional models and interfaces of the associated Copy Services for a local network or enterprise-connected multifunction device. 173 2 Summary 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 The MFD service addressed in this specification is the CopyService. The CopyService responds to queries about its capabilities, configuration and descriptive information. It responds to queries for information about CopyJobs. It manages and processes CopyJobs with its associated CopyJobTicket. The CopyService, by definition, takes an input Hardcopy Document and produces an output Hardcopy Document. Although the CopyService usually has some internal representation for the digital form of the document that is being copied, the internal representation is not visible to the user. The result of this is that a CopyService contains zero or more Jobs and the Jobs do not contain any documents. Each CopyJob can contain a CopyJobTicket which provides descriptive information (i.e., CopyJobDescription) as well as CopyJobProcessing and CopyDocumentProcessing instructions. CopyJobProcessing instructions apply to the Job as a whole. CopyDocumentProcessing instructions specify processing instructions applied to either the input or output Hardcopy Document. The input processing semantics are based on Scan Service Semantics [WSSCAN, PWG5108.2] while the output processing semantics are based on Print Service Semantics [RFC2911, PWG5105.1]. A client application interacting with the CopyService contains a Copy Client. A Copy Client interacts with the End User to obtain the End User’s Intent and uses the Copy Client to communicate with the CopyService that will execute the CopyJob according to the End User Intent. CopyJobTemplates contain instructions representing preconfigured Copy intent that can be used as is or modified by the End User. Once the End User is satisfied with the CopyJobTemplate the Copy Client uses the CopyJobTemplate as the CopyJobTicket in the job submission to the CopyService. CopyJobTemplates may be obtained in a number of ways. Those methods are outside the scope of this specification. The Copy scenarios addressed in this specification range from walk-up users that use MFD’s front panel to initiate a CopyJob to remote users that use their computers to initiate a CopyJob. The assumption is that it is possible to implement a Network Connected Copy Client that is accessible via the device’s front panel. The model also supports external security services that protects against unauthorized use of the CopyServices and access of Copy digital data. Copyright © 2010, Printer Working Group. All rights reserved. Page 6 of 31 MFD: Copy Service November 9, 2010 204 3 Terminology 205 3.1 Conformance Terminology 206 See [RFC2119]for conformance terminology used. There are no Copy specific conformance terms. 207 3.2 Content Specific Terminology 208 209 210 211 212 213 214 215 216 See [MFD] for common MFD terminology used. For this service the “<service>” in the MFD Terminology section is replaced with “Copy”. The terms used in this document are: ActiveJobs, CopyDevice, Copy Intent, CopyJob, CopyJobReceipt, CopyJobTemplate, CopyJobTicket, Attribute, Client, CrossFeed direction, DefaultCopyJobTicket, Digital Document, Element, Feed direction, Group Element, Hardcopy Document, Job History, Job Ticket, Local Client, PhysicalCopyJobTicket, Remote Client, Scan Device, Scan Region, Sequence, Service, Slow Scan Direction, Software, Template, Users, X, Y. 217 3.3 218 219 220 221 222 223 The CopyService model is described in this document as an XML schema. This is for the sake of convenience and does not require a protocol mapping involving XML. The top level objects such as SystemConfiguration, Services, and their associated Jobs can be represented in any number of ways. Abstractly they are objects which contain attributes or properties that express characteristics of the object. For the remainder of this document references to attribute or element refer to XML attributes and XML elements respectively. Either of these can be abstractly considered to be attributes or properties of abstract objects. 224 3.4 225 226 227 228 229 230 231 232 The MFD Overall specification [MFD] describes common concepts and terms used for all of the services hosted on a multifunction device. That includes the objects and their attributes in the multifunction device data model. The MFD Overall specification [MFD] uses abstract names for the semantic elements (e.g. Job State). This document describes a specific service and uses an XML schema to represent the objects and attributes. XML elements cannot have names with an embedded whitespace. The names for objects and their attributes used by this specification are the names from the XML Schema (e.g. JobState). The names can be easily mapped between the two specifications by inserting or removing the whitespace in the name (e.g. Job State ≡ JobState). 233 4 Rationale 234 4.1 235 236 237 238 239 240 241 In order to support common functionality for copying using multifunction devices, there is a need to develop a semantic model and a set of abstract operations and elements for Copy related services. In order to implement an abstract model of the operations and elements for Copy related services, there is need to map them onto implementable applications and communication protocols that support interactions between Copy Clients and CopyServices. There is a need to define a binding of the abstract model into Web Service Schema and Web Service protocol stack. 242 4.2 243 244 245 246 247 The basic CopyService model defined in this document is targeted to support enterprise Copy applications. However this document does not specify any application specific semantics. The MFD Working Group charter [CHAR] defines the following as out of scope: There is no Copy specific terminology. Model mapping conventions Naming conventions for Overall specification and this specification Rationale for this CopyService Specification Out of Scope for CopyService 1. Semantics of any compound service such as Copy-And-Email. Copyright © 2010, Printer Working Group. All rights reserved. Page 7 of 31 MFD: Copy Service 248 249 250 251 252 November 9, 2010 2. Semantics of any workflow protocol, i.e., sequencing and coordination of CopyJobs across multiple services. 3. Semantics of any CopyService management operations for MFDs that are not network connected. Copyright © 2010, Printer Working Group. All rights reserved. Page 8 of 31 November 9, 2010 MFD: Copy Service 253 254 5 MFD Model Overview 255 256 257 See [MFD] for the overall MFD model. CopyService fits within the MFD model as one of a number of services that can be hosted on a multifunction device (i.e., System). The critical MFD container object with regard to describing CopyService is Services. 258 259 One of the MFD’s services is CopyService. There can be multiple instances of a CopyService hosted, each with its own set of defaults and capabilities (e.g., separate Job queues). 260 261 262 The System has a SystemConfiguration object that contains all the subunits that comprise the MFD. Each CopyService instance contains a service specific view of the subunits used by that service instance. The CopyService element CopyServiceConfiguration contains the service specific view of the associated Subunits. 263 264 6 CopyService Model Overview 265 266 Below is the top level view of the CopyService schema. 267 268 269 270 271 272 273 274 275 276 277 278 Figure 1 High Level CopyService Schema The MFD System supports zero or more CopyServices. A CopyService is hosted locally on an MFD or remotely on another computer. The CopyService model has an Active Job queue, a Job History and a set of elements which includes CopyService status, configuration, description, defaults, and processing capabilities. The CopyServiceCapabilities group element contains the CopyJobTicketCapabilities. The CopyJobTicketCapabilities represents the allowed values supported by the CopyService for a CopyJobTicket. The CopyJobTicketCapabilities includes three sub elements. The CopyJobDescriptionCapabilities element indicates what job description elements are supported by the service instance. The CopyDocumentProcessingCapabilities group element has all processing elements for scanning the input Hardcopy Document and printing the output Hardcopy Document. The Copyright © 2010, Printer Working Group. All rights reserved. Page 9 of 31 MFD: Copy Service November 9, 2010 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 CopyJobProcessingCapabilites group element includes all supported processing elements for CopyJobs. The details of each processing element are specified in §6.1. 319 6.1 320 321 322 323 324 325 326 The CopyServiceCapabilities is a container element containing CopyJobTicketCapabilities that provides information about the elements that can be used in CopyJobTickets. The values of the elements in CopyJobTicketCapabilities indicate all the supported values for a CopyJobTicket submitted to the CopyService instance (e.g., all the media loaded in the InputTrays or available in nearby storage locations). The names of the elements within the CopyJobTicketCapabilities are the same as those in the DefaultCopyJobTicket. See §7.3 for the names of theCopyDocumentProcessingCapabilities ( In and Out), CopyJobDescriptionCapabilities, and CopyJobProcessingCapabilities elements. 327 328 329 330 331 332 333 Although most of the elements have the same name as their CopyJobTicket counterparts the syntax is often different. For example an element such as InputSource that is a single keyword in CopyJobTicket, it is a sequence of keywords in CopyServiceCapabilities. The values list the allowed values for the CopyJobTicket element. Some elements that are of the data type integer in a CopyJobTicket are a range of integers in CopyJobTicketCapabilities. Other elements that are simple strings or predefined ranges in the CopyJobTicket are simply boolean values in CopyJobTicketCapabilities, indicating support for the associated CopyJobTicket elements. See [MFD] for details on the syntax. The CopyServiceCapabilitiesReady group element represents the allowed values for a CopyJobTicket that do not require operator intervention (e.g., the media that is actually loaded in an input tray). The details are specified in §6.2 CopyServiceConfiguration provides a CopyService specific view into the Subunits that are associated with this service instance. Only Subunits that are used by the CopyService will appear in this element. The details of each subunit are detailed in §6.3. To see all the subunits for the MFD the System element provides an all encompassing view. The CopyServiceDescription group element includes descriptive information such as service name and information, and has extension point for vendor specific information. These description elements are settable by Administrators. The details of the CopyServiceDescription elements are specified in §6.5. The CopyServiceDefaults group element contains the DefaultCopyJobTicket. The DefaultCopyJobTicket contains the CopyDescription, CopyJobProcessing and CopyDocumentProcessing default values. The values contained in DefaultCopyJobTicket are the values that will be used by the CopyService when processing a CopyJobTicket which does not specify a different value. The values for this are populated in an implementation specific manner. The details of the DefaultCopyJobTicket are specified in §6.7. The CopyServiceStatus group element is an extension of the PWG service status class that includes elements such as ID, state, service counters, state messages and state reasons. State messages are localized state reasons. The only CopyService specific status extensions are the CopyService specific counters. The details of the elements in the CopyServiceStatus group are specified in §6.6. A CopyService contains zero or more jobs. Since the input and output of a CopyService is a Hardcopy Document, there is no document object to represent an implementation specific internal Digital Document. The CopyService does not expose any Digital Document associated with a CopyJob. Therefore, each job has exactly zero documents. The CopyService organizes its CopyJobs in a minimum of two job queues: (1) ActiveJobs, (2) JobHistory. ActiveJobs is a queue maintaining a list of jobs that are pending or processing. The JobHistory queue maintains a log of CopyJobs that have reached a terminating state (i.e., Completed, Aborted, and Canceled). The retention period for jobs in the JobHistory list is implementation specific but MUST NOT be less than 300 seconds. Each CopyJob can contain a CopyJobTicket which provides descriptive information as well as job processing and document processing instructions. CopyJobProcessing instructions apply to the Job as a whole while CopyDocumentProcessing instructions specify processing instructions applied to either the input or output Hardcopy Documents. The input processing semantics are based on Scan Service Semantics while the output processing semantics are based on Print Service Semantics. CopyServiceCapabilities 334 Copyright © 2010, Printer Working Group. All rights reserved. Page 10 of 31 November 9, 2010 MFD: Copy Service 335 336 337 338 Figure 2 CopyServiceCapabilities 339 340 341 Table 1 CopyServiceCapabilities Group CopyDocumentProcessingCapabilities (In) CopyDocumentProcessingCapabilities (Out) Elements described in [MFD] NumberUp, PresentationDirectionNumberUp, AutoSkewCorrection, ColorEntry, ContentType, Exposure, FilmScanMode, ImagesToTransfer, InputSource, Resolutions1, Rotation, Scaling, DocumentSizeAutoDetect, ScanRegions, Sides NumberUp, PresentationDirectionNumberUp, Copies, CoverBack, CoverFront, FinishingsCol, ForceFrontSide, ImpositionTemplate, InsertSheet, Media, MediaType, MediaColSupported2, MediaInputTrayCheck, OrientationRequested, OutputBin, OutputDevice, Overrides, PageDelivery, PageRanges, PagesPerSubset, PrintContentOptimized, Quality, Resolutions1, SeparatorSheets, SheetCollate, Sides, XImagePosition, XImageShift, XSide1ImageShift, XSide2ImageShift,, YImagePosition, YImageShift, YSide1ImageShift, YSide2ImageShift, CopyJobDescriptionCapabilities ElementsNaturalLanguage, JobAccountingID, JobAccountingUserID, JobInformation, JobMandatoryElements, JobMessageFromOperator, JobMessageToOperator, JobName, JobOriginatingUserName, JobOriginatingUserUri, JobPassword, JobPasswordEncryption, KOctets, TemplateCreatorName, TemplateId, TemplateInfo, TemplateName, TemplateType CopyJobProcessingCapabilities JobDelayOutputUntil, JobDelayOutputUntilTime, JobHoldUntil, JobHoldUntilTime, JobMandatoryElements, JobPhoneNumber, JobPriority, JobRecipientName, BatchMode, JobAccountingSheets, JobCopies, JobCoverBack, JobCoverFront, JobErrorSheet, JobFinishings, JobFinishingsCol, JobSaveDisposition, Copyright © 2010, Printer Working Group. All rights reserved. Page 11 of 31 November 9, 2010 MFD: Copy Service JobSheetMessage, JobSheets, JobSheetsCol, MultipleSetOriginal, OutputBin, Overrides Resolution in the CopyJobTicket’s CopyDocumentProcessing is a single instance of Resolution from the sequence of Resolutions elements in CopyDocumentProcessingCapabilities. This applies to both In and Out. 2 MediaCol in the CopyJobTicket is a sequence (i.e. MediaColSupported) of MediaCol elements in CopyDocumentProcessingCapabilities 1 342 343 344 345 346 347 . 348 6.2 349 350 351 352 353 354 355 CopyServiceCapabilitiesReady is a container element containing CopyJobTicketCapabilities that provides information about the elements that can be used in CopyJobTickets. The values of the elements in CopyJobTicketCapabilities indicate all the values for a CopyJobTicket that can be submitted to the CopyServer instance and applied without operator intervention. .(i.e., the Media currently loaded in the InputTrays) . The names of the elements within CopyServiceCapabilitiesReady are the same as those in CopyServiceCapabilities. See §6.1 for the names of theCopyDocumentProcessingCapabilities ( In and Out), CopyJobDescriptionCapabilities, and CopyJobProcessingCapabilities elements. CopyServiceCapabilitiesReady 356 357 6.3 CopyServiceConfiguration 358 359 360 361 362 363 The types of Subunits defined in the MFD Model and Overall Semantics specification [MFD] that are applicable to a CopyService are Console, Cover, Finisher, InputChannel, InputTray, Interface, Interpreter, Marker, MediaPath, OutputChannel, OutputTray, Processor, ScanMediaPath, Scanner, Storage and optionally VendorSubunits. There are no standard subunits unique to the CopyService Copyright © 2010, Printer Working Group. All rights reserved. Page 12 of 31 November 9, 2010 MFD: Copy Service 364 365 Figure 3 CopyServiceConfiguration 366 367 368 369 6.4 CopyServiceDefault 370 371 372 373 374 375 376 The CopyServiceDefaults is a containter element. It contains the DefaultCopyJobTicket that provides the values that will be used if the element is omitted in a CopyJob’s CopyJobTicket. Note that the processing instructions are not bound to the CopyJob until the CopyJob is actually processed. The values from DefaultCopyJobTicket are not copied to the Job’s CopyJobTicket. If CopyJobReceipt (See §7.1) is supported, the combined elements from the user supplied CopyJobTicket and the applied values from the DefaultCopyJobTicket are copied to CopyJobReceipt. Copyright © 2010, Printer Working Group. All rights reserved. Page 13 of 31 November 9, 2010 MFD: Copy Service 377 378 379 380 381 382 383 Figure 4 CopyServiceDefaults For descriptions of the elements that comprise CopyJobDescription, CopyJobProcessing and CopyDocumentProcessing see §7.3 on CopyJobTicket below. 384 6.5 CopyServiceDescription 385 386 387 388 Below is a view of the CopyService’s CopyServiceDescription . CopyServiceDescription provide Descriptive information for the CopyService. The element values are administratively set. The element values can be directly or modified indirectly through an operation. Copyright © 2010, Printer Working Group. All rights reserved. Page 14 of 31 November 9, 2010 MFD: Copy Service 389 390 Figure 5 CopyServiceDescription 391 392 393 394 395 The elements common to all <service>ServiceDescriptions are described in the MFD Model and Overall Semantics specification [MFD]. Those elements are identified in the above diagram as being included in the yellow box. There are no elements specific to the CopyServiceDescription except the usual extension point (i.e., Any). 396 6.6 397 398 399 400 401 402 403 CopyServiceStatus Below is a view of the CopyService’s CopyServiceStatus. CopyServiceStatus provide state information for the CopyService. The elements values are maintained by automata and cannot be directly set. The element values can be modified indirectly through an operation. For example PauseCopyService operation on the CopyService may result in the change of the State and StateReasons elements. Copyright © 2010, Printer Working Group. All rights reserved. Page 15 of 31 November 9, 2010 MFD: Copy Service 404 405 406 407 408 409 410 411 412 413 414 Figure 6 CopyServiceStatus The elements common to all <service>ServiceStatus are described in the MFD Model and Overall Semantics specification [MFD]. Those elements are identified in the above diagram as being included in the yellow box. The remaining elements are taken from <service> ServiceStatus. These elements are described in the MFD Model and Overall Semantics specification [MFD]. 6.7 415 416 Copyright © 2010, Printer Working Group. All rights reserved. Page 16 of 31 MFD: Copy Service November 9, 2010 417 418 419 420 421 Copyright © 2010, Printer Working Group. All rights reserved. Page 17 of 31 November 9, 2010 MFD: Copy Service 422 7 CopyJob Model 423 424 425 426 Below is the top level view of CopyJob. The jobs appear in one of two lists. Pending and active jobs appear in ActiveJobs. Jobs that have reached a terminal state (i.e., Completed, Aborted, and Canceled) appear in JobHistory. The amount of time a Job is retained in the JobHistory is implementation specific but MUST NOT be less than 300 seconds. 427 428 Figure 7 JobTable 429 430 431 432 433 434 435 436 437 438 As indicated below CopyJobs MUST contain zero documents. This is because the CopyService takes as input a Hardcopy Document and produces a Hardcopy Document as output. Any internal digital document representation is not visible to the User and is handled in an implementation specific manner. The state of the job is described in CopyJobStatus. CopyJobTicket contains descriptive information about the Job (i.e., CopyJobDescription) and processing instructions for the Job (i.e., CopyJobProcessing). CopyJobTicket also contains document processing instructions (i.e., CopyDocumentProcessing). CopyDocumentProcessing are broken into two sets. The Input set applies to image acquisition (i.e., scanning) and the Output set applies to the production of the output Hardcopy Document (i.e., printing). CopyJobTicket represent the End User’s intent while CopyJobReceipt represent what the CopyService actually did. Copyright © 2010, Printer Working Group. All rights reserved. Page 18 of 31 November 9, 2010 MFD: Copy Service 439 440 Figure 8 High Level CopyJob View 441 442 443 7.1 CopyJobReceipt 444 445 446 447 448 This element has exactly the same structure as CopyJobTicket. For each processing element of a CopyJob, it records the actual value used by the CopyService for processing the CopyJob. It contains the elements supplied by the Copy Client and applied to the job, any element or values substitutions made by the CopyService and any default elements or values applied by the CopyService. See §7.3 for element descriptions. 449 7.2 450 451 452 Below is a view of the CopyJob’s CopyJobStatus. CopyJobStatus provides state information for the CopyJob. The elements are maintained by automata and cannot be directly set. The element values can be modified indirectly CopyJobStatus Copyright © 2010, Printer Working Group. All rights reserved. Page 19 of 31 November 9, 2010 MFD: Copy Service 453 454 455 through an operation. For example, CancelCopyJob operation on the CopyJob may result in the change of the State and StateReasons elements. 456 457 458 459 460 461 Figure 9 CopyJobStatus The elements common to all <service>JobStatus are described in the MFD Model and Overall Semantics specification [MFD]. Those elements are identified in the above diagram as being included in the yellow box. The Copyright © 2010, Printer Working Group. All rights reserved. Page 20 of 31 November 9, 2010 MFD: Copy Service 462 463 464 465 remaining elements are taken from <service>JobProcessing. These elements are described in the MFD Model and Overall Semantics specification [MFD]. 466 7.3 467 468 469 470 CopyJobTicket contains description and processing elements provided by the Copy client during CopyJob creation. This information is used by the CopyService during the processing of a CopyJob. This information is made available to Copy Clients through the GetCopyJobElements operation. CopyJobTicket 471 472 Figure 10 CopyJobTicket 473 474 7.3.1 CopyDocumentProcessing 475 476 477 478 479 480 CopyDocumentProcessing provides the document processing instructions that have been requested by the Copy Client at the job level. Each element has a MustHonor attribute to indicate whether documents within the job must be processed according to what the user has requested. The CopyDocumentProcessing instructions are broken into two sets. The Input set applies to image acquisition (i.e., scanning) and the Output set applies to the production of the output Hardcopy Document (i.e., printing). Copyright © 2010, Printer Working Group. All rights reserved. Page 21 of 31 November 9, 2010 MFD: Copy Service 481 482 483 Figure 11 CopyDocumentProcessing (Input) 484 485 The elements in the Input set are a subset of the ScanDocumentProcessing element in the Scan Service and are described in the MFD Model and Overall Semantics specification [MFD]. Copyright © 2010, Printer Working Group. All rights reserved. Page 22 of 31 November 9, 2010 MFD: Copy Service 486 487 488 489 490 491 492 Figure 12 CopyDocumentProcessing (Output) The elements in the Output set are a subset of the PrintDocumentProcessing element in the Print Service and are described in the MFD Model and Overall Semantics specification [MFD]. Copyright © 2010, Printer Working Group. All rights reserved. Page 23 of 31 November 9, 2010 MFD: Copy Service 493 494 7.3.2 CopyJobDescription 495 496 497 Below is a view of the CopyJob’s CopyJobDescription . These elements are set by the Copy Client during job creation. 498 499 Figure 13 CopyJobDescription 500 Copyright © 2010, Printer Working Group. All rights reserved. Page 24 of 31 MFD: Copy Service November 9, 2010 501 502 503 504 505 The elements common to all <service>JobDescriptions are described in the MFD Model and Overall Semantics specification [MFD]. Those elements are identified in the above diagram as being included in the yellow box. There are no elements specific to the CopyJobDescription except the usual extension point (i.e., Any). 506 7.3.3 CopyJobProcessing 507 508 509 510 511 CopyJobProcessing provides the job processing instructions that have been requested by the Copy Client. Each element has a MustHonor attribute. When the value of MustHonor is true, the CopyService does not process the job unless the element is supported; otherwise the CopyService processes the job with its best effort. Copyright © 2010, Printer Working Group. All rights reserved. Page 25 of 31 November 9, 2010 MFD: Copy Service 512 513 514 515 516 517 518 Figure 14 CopyJobProcessing The elements common to all <service>JobProcessing are described in the MFD specifications [MFD]. Those elements are identified in the above diagram as being included in the yellow box. The remaining elements are taken from PrintJobProcessing. These elements are described in the MFD Model and Overall Semantics specification [MFD]. Copyright © 2010, Printer Working Group. All rights reserved. Page 26 of 31 November 9, 2010 MFD: Copy Service 519 520 521 522 8 CopyService Theory of Operation 523 524 The CopyService follows the behaviors and state transitions defined in the MFD Model and Overall Semantics specification [MFD]. 525 9 CopyService Interfaces 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 The CopyService provides a set of service interfaces that is the same for a co-located local Copy Client or a Remote Copy Client via a local interface, a local area network, or the Internet. A user makes a CopyService request by interacting directly with the CopyService or indirectly through a local Copy Client via the MFD UI or a Remote Copy Client via its software application UI. The requests below that are expected to have parameters are defined as containing an extension point indicating that vendors may extend the request with additional information. Responses to operations that fail are expected to return a fault. Responses that are expected to have no parameters are defined as containing an extension point indicating that vendors may extend the request with additional information. The semantics for these operations are the same as the operations specified in the MFD Model and Overall Semantics specification [MFD]. The exception is that since the CopyService does not expose a document no operations(e.g., SetCopyDocumentElements) or elements (e.g., CopyDocumentProcessing) associated with a document object are applicable to this service. In the table below required parameters are in bold and option operations and parameters are in italic font. 542 Table 2 Mandatory User Operations User Operation Name CancelCopyJob CreateCopyJob GetActiveCopyJobs GetCopyJobElements GetCopyJobHistory GetCopyServiceElements SetCopyJobElements ValidateCopyJobTicket Input Parameters ElementsNaturalLanguage, JobId, Message, RequestingUserName CopyJobTicket, ElementsNaturalLanguage, RequestingUserName ElementsNaturalLanguageRequested, limit,, RequestingUserName ElementsNaturalLanguageRequested, JobId, RequestedElements, RequestingUserName ElementsNaturalLanguageRequested, limit,, RequestingUserName ElementsNaturalLanguageRequested, RequestedElements, RequestingUserName CopyJobTicket, JobId,, ElementsNaturalLanguage, Message, RequestingUserName CopyJobTicket, ElementsNaturalLanguage, RequestingUserName Copyright © 2010, Printer Working Group. All rights reserved. Output Parameters JobId, UnsupportedElements ActiveJobs, ElementsNaturalLanguage CopyJobElements, ElementsNaturalLanguage JobHistory, ElementsNaturalLanguage CopyServiceElements, ElementsNaturalLanguage UnsupportedElements UnsupportedElements Page 27 of 31 November 9, 2010 MFD: Copy Service 543 Table 3 Optional User Operations User Operation Name CancelCurrentCopyJob CancelMyCopyJobs HoldCopyJob ReleaseCopyJob ResubmitCopyJob ResumeCopyJob SuspendCurrentCopyJob 544 Input Parameters ElementsNaturalLanguage, JobIds, Message, RequestingUserName ElementsNaturalLanguage, JobId, Message, RequestingUserName ElementsNaturalLanguage JobId, JobHoldUntil | JobHoldUntilTime, Message, RequestingUserName ElementsNaturalLanguage JobId, Message, RequestingUserName CopyJobTicket, ElementsNaturalLanguage, JobId, RequestingUserName ElementsNaturalLanguage JobId, Message, RequestingUserName ElementsNaturalLanguage JobId, Message, RequestingUserName Output Parameters JobIds JobId, UnsupportedElements Table 4 Administrative Operations Administrative Operation Name CancelCopyJobs DisableCopyService EnableCopyService HoldNewCopyJobs PauseCopyService PauseCopyServiceAfterCurrentJob PromoteCopyJob ReleaseNewCopyJobs RestartCopyService ResumeCopyService SetCopyServiceElements ShutdownCopyService StartupCopyService Input Parameters ElementsNaturalLanguage, JobIds, Message, RequestingUserName ElementsNaturalLanguage, Message, RequestingUserName ElementsNaturalLanguage, Message, RequestingUserName ElementsNaturalLanguage JobHoldUntil | JobHoldUntilTime, Message, RequestingUserName ElementsNaturalLanguage Message, RequestingUserName ElementsNaturalLanguage Message, RequestingUserName ElementsNaturalLanguage JobId, Message, PredecessorJobId, RequestingUserName ElementsNaturalLanguage, Message, RequestingUserName ElementsNaturalLanguage, Id, IsAcceptingJobs, Message, RequestingUserName, ServiceType, StartServicePaused ElementsNaturalLanguage, Message, RequestingUserName CopyServiceElements, ElementsNaturalLanguage, Message, RequestingUserName ElementsNaturalLanguage, Id, Message, RequestingUserName, ServiceType ElementsNaturalLanguage, Id, IsAcceptingJobs, Message, RequestingUserName, ServiceType, StartServicePaused Copyright © 2010, Printer Working Group. All rights reserved. Output Parameters JobIds UnsupportedElements Page 28 of 31 November 9, 2010 MFD: Copy Service 545 546 547 10 Conformance Requirements 548 549 550 This section describes conformance issues and requirements. This document introduces model entities such as objects, operations, elements, element syntaxes, and element values. These conformance sections describe the conformance requirements which apply to these model entities. 551 10.1 Client Conformance Requirements 552 553 554 555 A conforming client MUST support all REQUIRED operations as defined in this document. For each parameter included in an operation request, a conforming client MUST supply a value whose type and value syntax conforms to the requirements of the Model document as specified in Section 9. A conforming client MAY supply any extensions in an operation request, as long as they meet the requirements in Section 10.4. 556 557 When sending a request, a conforming client NEED NOT supply any parameters that are indicated as OPTIONALLY supplied by the client. 558 559 A client MUST be able to accept any of the elements defined in the model, including their full range that may be returned to it in a response from a Copy Service 560 561 562 563 An operation response may contain elements and/or values that the client does not expect. Therefore, a client implementation MUST gracefully handle such responses and not refuse to inter-operate with a conforming Copy Service that is returning extended elements and/or values that conform to Section 10.4 . Clients may choose to ignore any parameters, elements, or values that they do not understand. 564 10.2 Copy Service Conformance Requirements 565 566 This section specifies the conformance requirements for conforming implementations with respect to objects, operations, and attributes. 567 568 10.2.1 Objects 569 570 571 Conforming implementations MUST implement all of the model objects and the mandatory elements they contain as defined in this specification in the indicated sections: 572 573 Section 6 - CopyService Section 7 - CopyJob 574 10.2.2 Operations 575 576 Conforming Copy Service implementations MUST implement all of the REQUIRED model operations, including REQUIRED responses, as defined in this specification in section 9: CancelCopyJob CreateCopyJob ValidateCopyJobTicket 577 578 579 580 581 582 GetActiveCopyJobs GetCopyJobHistory GetCopyServiceElements GetCopyJobElements Conforming Copy Service MUST support all REQUIRED operation elements and all values of such elements if so indicated in the description. Conforming Copy Service MUST ignore all unsupported or unknown operation elements received in a request, but MUST reject a CreateCopyJob request that contains an unknown element that contains the MustHonor attribute with a value of ‘true’. Copyright © 2010, Printer Working Group. All rights reserved. Page 29 of 31 MFD: Copy Service November 9, 2010 583 10.3 Copy Service Elements 584 Conforming Copy Service MUST support all of the REQUIRED object elements, as defined in this specification. 585 586 587 If an object supports an element, it MUST support only those values specified in this document or through the extension mechanism described in section 10.4. It MAY support any non-empty subset of these values. That is, it MUST support at least one of the specified values and at most all of them. 588 10.4 Extensions 589 590 591 592 593 Conforming Copy Service MAY support extensions. To extend the model the extensions MUST be fully qualified. The qualified name MUST NOT be in the PWG target namespace. When extending the model with new elements the new elements MUST be added at the extension points at the end of the associated sequence of elements. Extended values for elements MUST conform to the extension patterns defined in the element schema. Implementers are free to add vendor specific operations to the service. 594 11 PWG and IANA Registration Considerations 595 596 This specification abides by the guidelines set forth in the” MFD Model and Overall Semantics” specification (section 10). 597 12 Internalization Considerations 598 599 This specification abides by the guidelines set forth in the” MFD Model and Overall Semantics” specification (section 11). 600 13 Security Considerations 601 602 This specification abides by the guidelines set forth in the” MFD Model and Overall Semantics” specification (section 12). 603 14 References 604 14.1 Normative References 605 606 607 [MFD] 608 609 610 [PWG5105.1] <AddPWGDocumnentNumberHere/> MFD Model and Overall Semantics version 1, <AddDateHere/>, W. Wagner, <AddDocumentsUrlHere/> PWG 5105.1-2004 Printer Working Group (PWG) Semantic Model version 1, January 20, 2004, P. Zehler, T.Hastings, S. Albright, ftp://ftp.pwg.org/pub/pwg/candidates/cs-sm10-20040120-5105.1.pdf 611 612 613 [PWG5108.2] 614 615 [RFC2119] PWG 5108.2-2009 Network Scan Service Semantic Model and Service Interface version 1, April 10, 2009, N. Chen, P. Zehler, ftp://ftp.pwg.org/pub/pwg/candidates/cs-sm20-scan10-20090410-5108.02.pdf RFC 2119, “Key words for use in RFCs to Indicate Requirement Levels”, S. Bradner , March 1997. Copyright © 2010, Printer Working Group. All rights reserved. Page 30 of 31 MFD: Copy Service 616 617 618 [RFC2911] 619 620 621 [WS-SCAN] November 9, 2010 RFC 2911 “Internet Printing Protocol/1.1 Model and Semantics”, September 2000, T. Hastings, R. Herriot, R. deBry, S. Isaacson, P. Powell, ftp://ftp.rfc-editor.org/in-notes/rfc2911.txt “CopyService DefinitionVersion 1.0 For Web Services on Devices”, November 2006, Microsoft, M Fenelon, http://www.microsoft.com/whdc/connect/rally/wsdspecs.mspx 622 623 14.2 Informative References 624 625 626 [CHAR] “Charter of the PWG Multifunction Device (MFD) Working Group”, May 4, 2007, P. Zehler, I. McDonald, ftp://ftp.pwg.org/pub/pwg/mfd/charter/ch-mfd-20070504.pdf 627 15 Author’s Address 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 Peter Zehler Xerox Research Center Webster Email: [email protected] Voice: (585) 265-8755 Fax: (585) 265-7441 US Mail: Peter Zehler Xerox Corp. 800 Phillips Rd. M/S 128-25E Webster NY, 14580-9701 Additional contributors: Nancy Chen – OkiData Lee Farrell – Cannon Ira McDonald – High North Bill Wagner – TIC Copyright © 2010, Printer Working Group. All rights reserved. Page 31 of 31
© Copyright 2026 Paperzz