How's this for wording?
6.4.15 printer-service-contact-col (collection | unknown)
This REQUIRED Printer Description attribute contains contact information for the service agent responsible for maintaining the Printer, or the 'unknown' out-of-band value if no service agent contact information has been set. Table 12 lists the member attributes defined in this specification. A Printer MUST support the "contact-name" and "contact-uri" member attributes.
A Printer receiving this attribute in a Set-Printer-Attributes operation [RFC3380] replaces the entire existing value with the one received if the Printer acccepted the operation. A Printer receiving this attribute in a Set-Printer-Attributes operation where the collection lacks all the REQUIRED members MUST reject the request and return the 'client-error-bad-request' status code.
Table 12 - "printer-service-contact-col" Member Attributes
Member Attribute Printer Conformance
contact-name (name(MAX)) REQUIRED
contact-uri (uri) REQUIRED
contact-vcard (1setOf text(MAX)) RECOMMENDED
6.4.15.1 contact-name (name(MAX))
This REQUIRED member attribute provides the contact's name, e.g., "Bob Smith".
6.4.15.2 contact-uri (uri)
This REQUIRED member attribute provides a URI that can be used for contacting the Printer service agent, e.g., “mailto:bob at example.com” or "tel:+1-208-123-4567".
6.4.15.3 contact-vcard (1setOf text(MAX))
This RECOMMENDED member attribute contains the contact vCard [RFC6350].
Smith
/**
Smith Kennedy
HP Inc.
*/
> On Apr 23, 2021, at 6:46 AM, Michael Sweet <msweet at msweet.org> wrote:
>> Smith,
>> We wanted "printer-service-contact-col" to be a collection with the same member attributes as "printer-contact-col" and "system-contact-col", so the first form is what you should go with.
>> (FWIW, the printer MIB element is just an octet string that has no defined format...)
>>>> On Apr 22, 2021, at 5:55 PM, Kennedy, Smith (Wireless & IPP Standards) via ipp <ipp at pwg.org> wrote:
>>>> Signed PGP part
>> Hi there,
>>>> I'd like to pre-screen the addition of "printer-service-contact" to IPP Enterprise Printing Extensions v2.0. But I'm unsure how to model it. I have found "printer-contact-col" and "system-contact-col" in IPP System Service (5100.22). Should I clone that?
>>>> X.Y printer-service-contact-col (collection | unknown)
>>>> This REQUIRED Printer Description attribute identifies the Printer service agent. Table 10 lists this attribute's member attributes. When specified in a Set-Printer-Attributes operation [RFC3380], the collection value MUST contain all REQUIRED member attributes as the entire collection value is replaced.
>>>> X.Y.1 contact-name (name(MAX))
>>>> This REQUIRED member attribute contains the contact name, e.g., "Bob Smith".
>>>> X.Y.2 contact-uri (uri)
>>>> This REQUIRED member attribute contains the contact URI, e.g., “mailto:bob at example.com”.
>>>> X.Y.3 contact-vcard (1setOf text(MAX))
>> This RECOMMENDED member attribute contains the contact vCard [RFC6350].
>>>>>>>> Or should I do something simpler, like this:
>>>> X.Y printer-service-contact (uri)
>>>> This REQUIRED Printer Description attribute specifies a URI used to contact the service agent responsible for the Printer. The value MUST use the "mailto", "tel", "http" or "https" URI schemes.
>>>> Thoughts?
>>>> Smith
>>>> /**
>> Smith Kennedy
>> HP Inc.
>> */
>>>>>>>> ________________________
> Michael Sweet
>>>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: Message signed with OpenPGP
URL: <http://www.pwg.org/pipermail/ipp/attachments/20210423/832a64ee/attachment.sig>