ONIX for Repertoire: message format overview

Transcription

1 ONIX for Repertoire: message format overview Version.0, February 2008 CONTENTS LIST Page. Introduction Repertoire Notification Definitions Repertoire Detail Resources Excluded Controlled values and the ONIX IFFRO Dictionary Resource description in ONIX-RP Repertoire Notification types Areas for possible further development Resource Lists ONIX-RP Header ONIX-RP Repertoire Notification RepertoireDetail DetailByResource DetailByResourceClass PriceDefinition ONIX-RP Resource List...8 Earlier versions of this overview were used as the basis for the application guidelines produced by each of the ONIX IFRRO pilots in Immediately before Version.0 was released, a number of final modifications and corrections were made to the format specification, and these may not all be reflected in the pilot documentstion. Please note that, where there is any discrepancy between the pilot guidelines and this overview, the overview should be taken as authoritative.

2 . Introduction This document is an overview of the ONIX for Repertoire (ONIX-RP) format. It should be read in conjunction with the companion document ONIX for Repertoire: message structure, which provides further technical details of the XML structure. The table below gives a top-level view of the revised format: <ONIXRepertoireMessage version=.0 > 2 <Header> A header identifying the sender and receiver, and giving other control information 3 <RepertoireNotification> A composite that notifies new or changed repertoire 4 <ResourceList> An ONIX-RP message consists of (i) a message header (<Header>) which identifies sender and receiver and carries a limited amount of other data pertinent to the message as a whole; (ii) an unlimited number of <RepertoireNotification> composites, which may be of the same or different types, and may relate to the same or different repertoires; and (iii) an unlimited number of <ResourceList> composites (see section 4 below). For the purposes of the ONIX IFRRO messages, a repertoire is defined as a set of resources in which the control of certain rights is held by a particular party, and which is identified typically for the purpose of delegating those rights from one party to another. [For repertoire management from UK publishers to PLS to CLA and onward to CCC (and possibly other agencies), it makes sense to treat the set of resources covered by a publisher s mandate (or more accurately, a Publishing Rights Controller s mandate) as a distinct repertoire with a unique identifier. This is not, however, in any way assumed in the message format. A repertoire may be any set of resources that it is convenient and practical to manage as such, and to which a unique identifier can be assigned by the agency responsible.] 2. Repertoire Notification The <RepertoireNotification> composite, shown in more detail on the next page, is organized into three main parts: (a) A non-repeating <Definitions> composite which, in the present ONIX-RP version, is used only to carry price definitions if required, although it may be required for other things in future extensions of the format; (b) A repeatable <RepertoireDetail> composite carrying statements about rights and resources that are part of the repertoire; and (c) A repeatable <ResourcesExcluded> composite carrying details of resources that are completely excluded from the repertoire (as distinct from being excluded from, say, a particular license in which other resources are included). 2. Definitions The <Definitions> composite carries any entity definitions that are required to support the rest of the content of a <RepertoireNotification> composite. In the present version of the ONIX-RP message, the only circumstance in which entity definitions will be invoked is when repertoire detail involves the specification of prices relating to a particular license or to a particular form of usage. In this case, each price will be defined in a <PriceDefinition> and assigned a label by which it can be referenced elsewhere in a <SubjectToPayment> element. If, however, the repertoire is sub-licensed on the basis of default price rates established by inter-agency agreement, no such definitions need to be carried. In this document we will sometimes refer to a Publishing Rights Controller, or PRC, when talking about a publisher in its role as a delegator of rights. 2

3 <RepertoireNotification> A composite that notifies new or changed repertoire 2 <RepertoireIdentifier> A unique identifier of a repertoire -n 3 <Definitions> A composite that defines entities referred to in a Repertoire Notification 4 <PriceDefinition> A composite that defines a price referred to in a Repertoire Notification 5 <UsageDefinition> A composite that defines a usage referred to in a Repertoire Notification (placeholder for future use) 6 <RepertoireDetail> A composite that specifies rights and resources that together form part of a repertoire 7 <DelegatedRightByLicense> A composite that specifies licenses under which defined resources may be sub-licensed by the delegate 8 <DelegatedRightByUsage> A composite that specifies a usage for which defined resources may be sub-licensed by the delegate 9 <WholeRepertoireExceptAs Specified/> An XML empty element whose presence indicates that the preceding delegated rights detail applies to the whole of the repertoire except as otherwise specified 0 <DetailByResource> A composite that specifies a resource that is part of a repertoire <DetailByResourceClass> A composite that specifies a resource class, together with any exclusions from that class 2 <ExcludingResources> A composite that specifies resources or resource classes that are excluded from a specified class 3 <ResourcesExcluded> A composite that specifies resources to be excluded completely from a repertoire 4 <DetailByResource> A composite that specifies a resource to be excluded completely from a repertoire 5 <DetailByResourceClass> A composite that specifies a resource class to be excluded completely from a repertoire, together with any exclusions from that class 6 <ExcludingResources> A composite that specifies resources or resource classes that are excluded from a specified class 0- -n A <UsageDefinition> is also included, but only as a placeholder, to be specified in detail as and when it becomes clear that there is a need to cover usages that cannot be defined simply by a Dictionary term. In future, particularly if there is a move to specify individual licensable usages instead of relying on standard licenses, it may be necessary to add more entity definitions. The <Definitions> composite precedes the <RepertoireDetail> elements that use the definitions. This sequence is expected to be helpful when a large Repertoire Notification is processed by a receiving system. 2.2 Repertoire Detail Within the <RepertoireDetail> composite, delegated rights can be specified by license or by usage (although the latter functionality remains much less developed than the former, since examples of its practical application are not readily available). Resources can be detailed by individual titles, or by resource classes (again, the latter functionality is less well-developed, for similar reasons); or delegated rights can be specified as applying to the whole repertoire. Exceptions to resource classes can be specified either as subclasses or as lists of individual titles. In this way, an instance of <RepertoireDetail> can fully specify any set of resources that shares a set of delegated rights, and that is part of a repertoire. 3

4 2.3 Resources Excluded The <ResourcesExcluded> composite has the sole function of specifying resources that are to be excluded completely from a repertoire. Excluded resources can be detailed by individual titles, or by resource classes; and exceptions to resource classes can be specified either as sub-classes or as lists of individual titles. The PLS-to-CLA use cases examined in Pilot 2 have found no application for <ResourcesExcluded>; however, this does not necessarily mean that these elements will not be needed elsewhere. 2.4 Controlled values and the ONIX IFFRO Dictionary Wherever the overview refers to ONIX controlled values, this means that the element in question either must or may carry a value taken from the OLT IFRRO Dictionary, which is being developed to provide a value set appropriate to IFRRO member applications as these are specified in detail. Alternatively the element may in certain circumstances carry a local controlled value: see the companion document ONIX IFRRO Dictionary Notes. 2.5 Resource description in ONIX-RP Resource description is limited to title, authorship, publisher and imprint, each represented by a composite that is structured to a similar level as in existing ONIX product information formats. Note that the detailed nomenclature is not the same as in, say, ONIX for Books, in order to maintain the internal consistency of the ONIX IFFRO formats, but there is a very simple mapping. 2.6 Repertoire Notification types As a result of the work carried out in Pilot 2, three major types of repertoire notification have so far been specified: New or Confirmed Mandate: used to notify a new mandate from a rights controller, or confirm in full an existing mandate. Include In Repertoire: used to add resources to a repertoire, usually as a result of their having been traded from one rights controller to another. ChangeTerms: used to communicate changes in delegated rights (license inclusions / exclusions) and prices. From the point of view of the format definition, it is always possible to add other types if found necessary. 2.7 Areas for possible further development Version 0.9 of the format was substantially based on the original Strawman document. As a result of piloting, it has now developed to the point where it is no longer considered useful to maintain a detailed mapping to the elements in the Strawman. However, it should be noted that four areas from the original document are still not fully developed: (a) Contact information for parties associated with the repertoire (see Strawman 6..3d and 6..4d). It is questionable whether a Repertoire Notification is the right place to communicate standing information about the parties involved in delegation of rights, or changes to such information. (b) Constraints on permitted usages ( ). It is difficult to define a suitable structure at this stage, since we have little or no evidence of what the requirements will be if and when ONIX-RP begins to be used for delegation of rights by usage rather than rights by license. (c) Reporting and Other conditions ( b and c). (d) Identifying rights controllers (6.4). The requirement for this needs to be more fully defined. All of these four aspects have been parked for the time being. 4

5 3. Resource Lists During the course of Pilot 2 it became apparent that there was a need under various different circumstances for one RRO to send to another a list of resources that it considered to be part of a rights controller s repertoire, without thereby implying any change either in the definition of the repertoire or in the applicable terms. To accommodate this, the ONIX-RP format has been extended to include, alongside the <Repertoire Notification> entity, a separate and very simple <Resource List> entity, using a limited set of elements taken from the full notification. The two entity types to be sent in a single message, so that, for example, a New Mandate notification may be accompanied by a <ResourceList> that communicates titles that the sender believes to be covered by the mandate, but that do not constitute a definition of the mandate repertoire. As the summary table below indicates, the format consists simply of a few identification and housekeeping elements, followed by an unlimited number of <DetailByResource> composites, each representing a single resource. <ResourceList> 2 <RepertoireIdentifier> A unique identifier of a repertoire -n 3 <DetailByResource> A composite that specifies a resource that is part of a repertoire 5

6 4. ONIX-RP Header <Header> Message header 2 <Sender> The sender of a message (coded identifier or name or both) 3 <SenderRole> A controlled value specifying the role of an ONIX-RP message sender if not the delegator of rights 4 <SenderIdentifier> Composite: a coded identifier of a message sender; repeatable only if a sender has two or more identifiers taken from different schemes 5 <SenderIDType> A code indicating a scheme from which a sender identifier is taken 6 <IDTypeName> The name of a proprietary scheme, if applicable 0-7 <IDValue> An identifier value, from a specified scheme 8 <SenderName> The name of a sender organization 0-9 <SenderContact> The name of a contact person in a sender organization <Sender > An address for a sender contact 0- <Addressee> An addressee of a message (coded identifier or name or both) -n 2 <AddresseeIdentifier> Composite: a coded identifier of a message addressee; repeatable only if an addressee has two or more identifiers taken from different schemes 3 <AddresseeIDType> A code indicating a scheme from which a sender identifier is taken 4 <IDTypeName> The name of a proprietary scheme, if applicable 0-5 <IDValue> An identifier value, from a specified scheme 6 <AddresseeName> The name of an addressee organization 0-7 <AddresseeContact> The name of a contact person in an addressee organization 0-8 <Addressee > An address for an addressee contact 0-9 <Test/> An XML empty element which, if present, specifies that a message is a test 0-20 <MessageNumber> Message sequence number 0-2 <MessageRepeat> A number which distinguishes any repeat transmissions of a message 0-22 <SentDateTime> The date, and optionally the time, when a message was sent 23 <MessageNote> A free-text note about the contents of the message 0-24 <CurrencyCode> An ISO code for the currency of monetary amounts (if any) specified in the message 0- Copyright EDItEUR & IFRRO 6

7 5. ONIX-RP Repertoire Notification <RepertoireNotification> A composite that notifies new or changed repertoire -n 2 <NotificationType> An ONIX controlled value specifying a type of a Repertoire Notification, eg new mandate, change terms 3 <ReasonForNotification> An ONIX controlled value specifying a reason for sending a Repertoire Notification 4 <NotificationID> A sender-assigned identifier that is unique within the sequence of Repertoire Notifications sent by the Sender to the Addressee (replaces composite in Version 0.9) 5 <NotificationEffectiveDate> The date on which the changes notified in the Repertoire Notification become effective, expressed as YYYYMMDD 0-6 <RepertoireIdentifier> A composite that uniquely identifies a repertoire; mandatory, and repeatable -n only if the repertoire has two or more identifiers taken from different schemes. 7 <RepertoireIDType> An ONIX controlled value identifying a scheme from which a repertoire identifier is taken 8 <IDTypeName> A name of a proprietary scheme, if applicable 0-9 <IDValue> An identifier value, from a specified scheme 0 <RepertoireDescription> A title or description given by the sender to the repertoire to which a Repertoire 0- Notification refers <RepertoireAnnotation> A composite that carries an annotation relating to the repertoire to which a Repertoire Notification refers 2 <RepertoireAnnotation An ONIX controlled value specifying a type of a repertoire annotation 0- Type> 3 <AnnotationText> The text of the annotation 4 <RepertoireRelatedAgent> A composite that specifies an Agent that is related to a repertoire, and its relationship to the repertoire, typically used to identify a rights controller who holds or manages rights in the repertoire 5 <RepertoireAgentRelator> An ONIX controlled value specifying a relationship between a repertoire and a related agent 6 <AgentIdentifier> A composite that carries an identifier of an agent; repeatable only if an agent has two or more identifiers taken from different schemes 7 <AgentIDType> An ONIX controlled value identifying a scheme from which an agent identifier is taken 8 <IDTypeName> A name of a proprietary scheme, if applicable 0-9 <IDValue> An identifier value, from a specified scheme 20 <Name> A name of an agent or agent class 0-0- Copyright EDItEUR & IFRRO 7

8 2 <AgentAnnotation> A composite that carries an annotation relating to an agent, typically used to carry an explanatory note about a rights controller 22 <AgentAnnotationType> An ONIX controlled value specifying the type of an agent annotation 0-23 <AnnotationText> The text of the annotation 24 <AgentRelatedName> A composite that specifies a name, typically of an imprint or subsidiary, that is related to an agent. Listing such names here means that they do not limit the scope of the repertoire, but indicates that publications bearing these names are normally controlled by the rights controller identified in <RepertoireRelated Agent>. 25 <AgentNameRelator> An ONIX controlled value specifying a relationship between an agent and a related name 26 <NameIdentifier> A composite that carries an identifier of a related name; repeatable only if a name has two or more identifiers taken from different schemes 27 <NameIDType> An ONIX controlled value identifying a scheme from which a name identifier is taken 28 <IDTypeName> A name of a proprietary scheme, if applicable 0-29 <IDValue> An identifier value, from a specified scheme 30 <Name> A related name, typically of an imprint or subsidiary 0-3 <NameAnnotation> A composite that carries an annotation relating to a name, typically used to carry an explanatory note about an imprint 32 <NameAnnotation An ONIX controlled value specifying the type of a name annotation 0- Type> 33 <AnnotationText> The text of the annotation 34 <RepertoireRelated Mandate> A composite that specifies a mandate that is related to a repertoire, and its relationship to the repertoire 35 <RepertoireMandate Relator> An ONIX controlled value specifying a relationship between a repertoire and a related mandate 36 <MandateIdentifier> A composite that carries an identifier of a mandate 37 <MandateIDType> An ONIX controlled value identifying a scheme from which a mandate identifier is taken; repeatable only if a mandate has two or more identifiers taken from different schemes 38 <IDTypeName> A name of a proprietary scheme, if applicable 0-39 <IDValue> An identifier value, from a specified scheme 40 <Name> A name of a mandate 0-4 <MandateRelatedTime Point> A composite that specifies a date that is related to a mandate, and its relationship to the mandate 0-42 <MandateTimePoint Relator> An ONIX controlled value specifying a relationship between a mandate and a related time point Copyright EDItEUR & IFRRO 8

9 43 <TimePointIdentifier> A composite that carries an identifier of a time point 44 <TimePointIDType> An ONIX controlled value specifying a form of a time point identifier, eg YYYY 45 <IDValue> A time point identifier in a specified form 46 <RepertoireDefinition> An ONIX controlled value that specifies whether a repertoire is defined by the resources specified in successive <RepertoireDetail> elements, or otherwise (eg as all eligible resources controlled by a mandating rights controller) 47 <Definitions> A composite that defines entities referred to in a Repertoire Notification 0-48 <PriceDefinition> A composite that defines a price that is referred to in a Repertoire Notification see expansion in section <UsageDefinition> A composite that defines a usage referred to in a Repertoire Notification: at present, this is a placeholder only the expansion will be added when found necessary 50 <RepertoireDetail> A composite that specifies rights and resources that together form part of a -n repertoire: repeat for each part of the notified repertoire that has different delegated rights and/or pricing see expansion below 5 <ResourcesExcluded> A composite that specifies resources and/or resource classes to be excluded 0- completely from a repertoire 52 <DetailByResource> A composite that specifies a resource expansion as in <RepertoireDetail> 53 <DetailByResourceClass> A composite that specifies a resource class, together with any exclusions from that class expansion as in <RepertoireDetail> 0- -n Copyright EDItEUR & IFRRO 9

10 5. RepertoireDetail <RepertoireDetail> A composite that specifies rights and resources that together form part of a repertoire 2 <DelegatedRightBy License> A composite that specifies license inclusions and/or exclusions, and if applicable prices, that apply to part of a repertoire 3 <IncludeUnderLicense> A composite that specifies a license or package of licenses under which specified resources are included: either <includeunderlicense> or <Exclude FromLicense> must be present in any instance of <DelegatedRightByLicense> 4 <LicenseType> An ONIX controlled value that uniquely identifies either a single license (eg CCC APS) or a package of licenses (eg all PLS/CLA core licences) 5 <UsageWithinLicense> A composite that specifies a usage type within a license type that is specifically permitted or prohibited: this is a placeholder, to be fully defined when the requirement is clear 6 <SubjectToPayment> Either (a) an ONIX controlled value specifying a price class, or (b) a label assigned in a Price Definition to identify a price set by a rights controller. Specifies payment(s) applying to usage under the license type(s) listed in preceding <IncludeUnderLicense> elements. 7 <ExcludeFromLicense> A composite that specifies a license or license class from which specified 0- resources must be excluded 8 <LicenseType> An ONIX controlled value that uniquely identifies either a single license (eg -n CCC APS) or a package of licenses (eg all PLS/CLA core licences) 9 <WithinTerritory> A composite that specifies a territory for which rights are delegated 0 <PlaceIDType> An ONIX controlled value specifying a scheme from which a place identifier is taken, eg ISO country codes <IDValue> An identifier value from a specified scheme, repeatable (eg) for multiple -n countries 2 <FromTimePoint> A composite that specifies a time from which a delegation of rights is effective 0-3 <TimePointIDType> An ONIX controlled value specifying a form of a time point identifier, eg YYYY 4 <IDValue> A time point identifier in the form specified in the <TimePointIDType> element 5 <ToTimePoint> A composite that specifies a time to which a delegation of rights is effective 0-6 <TimePointIDType> An ONIX controlled value specifying a form of a time point identifier, eg YYYY 7 <IDValue> A time point identifier in the form specified in the <TimePointIDType> element -n Copyright EDItEUR & IFRRO 0

11 8 <DelegatedRightBy Usage> A composite that specifies a usage for which all or part of a repertoire may be licensed by the delegate 9 <LicensableUsage> Either (a) an ONIX controlled value specifying a usage as a defined term, or (b) a label assigned in a Usage Definition to identify a usage 20 <WithinTerritory> A composite that specifies a territory for which rights are delegated 2 <PlaceIDType> An ONIX controlled value specifying a scheme from which a place identifier is taken, eg ISO country codes 22 <IDValue> An identifier value from a specified scheme, repeatable (eg) for multiple -n countries 23 <FromTimePoint> A composite that specifies a time from which a delegation of rights is effective 0-24 <TimePointIDType> An ONIX controlled value specifying a form of a time point identifier, eg YYYY 25 <IDValue> A time point identifier in a specified form 26 <ToTimePoint> A composite that specifies a time to which a delegation of rights is effective 0-27 <TimePointIDType> An ONIX controlled value specifying a form of a time point identifier, eg YYYY 28 <IDValue> A time point identifier in a specified form 29 <UsageQuantity> A composite that specifies a quantity attribute of a usage, eg an extent or volume limit permitted for the usage 30 <UsageQuantityType> An ONIX controlled value specifying a type of a usage quantity 3 <UsageQuantityDetail> A composite that carries details of a quantity -n 32 <Proximity> An ONIX controlled value specifying a relationship between a quantity and a 0- <Value> stated in the composite, eg is less than, is not more than ; the default is is exactly 33 <Value> A decimal numeric value 34 <MeasureUnit> An ONIX controlled value specifying a unit of measure 35 <ReferenceUnit> An ONIX controlled value specifying a unit to which a quantity refers, if this is 0- not implied by the <UsageQuantityType> 36 <SubjectToPayment> Either (a) an ONIX controlled value specifying a price class, or (b) a label -n assigned in a Price Definition to identify a price set by a rights controller. Specifies payment(s) applying to a usage. 37 <WholeRepertoireExcept AsSpecified/> An XML empty element that indicates that the preceding delegated rights detail applies to the whole of the repertoire except for any resources or resource classes that are specified in separate <RepertoireDetail> elements. In other words, it establishes default delegated rights detail for a repertoire. If this element is present, there must be no <DetailByResource> or <DetailBy ResourceClass> elements in the same instance of <RepertoireDetail>. 0- Copyright EDItEUR & IFRRO

12 5.2 DetailByResource 38 <DetailByResource> A composite that specifies a resource. Used where Repertoire Detail is expressed wholly or partly in terms of individual titles. Repeat for each title listed in the <RepertoireDetail> composite. 39 <ResourceCategory> A composite that specifies a category to which a resource belongs 40 <ResourceCategoryType> An ONIX controlled value specifying a scheme from which a resource category is taken 4 <CategoryTypeName> A name of a proprietary scheme, if applicable 0-42 <CategoryValue> An category value from a specified scheme 43 <ResourceIdentifier> A composite that carries a unique identifier of a resource; repeatable only if a resource has two or more identifiers taken from different schemes 44 <ResourceIDType> An ONIX controlled value specifying a scheme from which a resource identifier is taken 45 <IDTypeName> A name of a proprietary scheme, if applicable 0-46 <IDValue> An identifier value from a specified scheme 47 <ResourceTitle> A composite that carries a title of a resource 48 <TitleType> An ONIX controlled value specifying a type of a title 0-49 <TitleText> The text of a title 50 <Subtitle> A subtitle associated with a title 0-5 <Contributor> A composite that identifies and/or names a single author or other contributor in a structured form 52 <ContributorRole> An ONIX controlled value specifying a role that is played by a contributor to a resource, eg author 53 <ContributorIdentifier> A composite that carries an identifier of a contributor; repeatable only if a contributor has two or more identifiers taken from different schemes: each instance of the <Contributor> composite must carry either a <Contributor Identifier> or a name or both. 54 <ContributorIDType> An ONIX controlled value specifying a scheme from which a contributor identifier is taken 55 <IDTypeName> A name of a proprietary scheme, if applicable 0-56 <IDValue> An identifier value from a specified scheme Copyright EDItEUR & IFRRO 2

13 57 <PersonName> A composite that specifies a name of a person 58 <PersonNameForm> An ONIX controlled value identifying a form of a person name: the default is unspecified, but the inclusion of this element will make it possible in future to control the format of person names, if so required 59 <Name> A name of a person, in the form specified, if <PersonNameForm> is included 60 <OrganizationName> A composite that specifies a name of an organization 6 <OrganizationName An ONIX controlled value identifying a form of an organization name: the 0- Form> default is unspecified, but the inclusion of this element will make it possible in future to control the format of organization names, if so required 62 <Name> A name of a person, in the form specified, if <OrganizationNameForm> is included 63 <Publisher> A composite that identifies and/or names a single publisher in a structured form 64 <PublishingRole> An ONIX controlled value specifying a role that is played in the publishing of a resource 65 <PublisherIdentifier> A composite that carries an identifier of a publisher; repeatable only if a publisher has two or more identifiers taken from different schemes: either a <PublisherIdentifier> or a <Name> (or both) must be present in any instance of the <Publisher> composite 66 <PublisherIDType> An ONIX controlled value specifying a scheme from which a publisher identifier is taken 67 <IDTypeName> A name of a proprietary scheme, if applicable 0-68 <IDValue> An identifier value from a specified scheme 69 <Name> A name of a publisher 0-70 <Imprint> A composite that identifies and/or names an imprint or brand in a structured 0- form 7 <ImprintIdentifier> A composite that carries an identifier of an imprint or brand; repeatable only if an imprint has two or more identifiers taken from different schemes: either an <ImprintIdentifier> or a <Name> (or both) must be present in any instance of the <Imprint> composite 72 <ImprintIDType> An ONIX controlled value specifying a scheme from which an imprint identifier is taken 73 <IDTypeName> A name of a proprietary scheme, if applicable 0-74 <IDValue> An identifier value from a specified scheme 75 <Name> A name of an imprint or brand 0-0- Copyright EDItEUR & IFRRO 3

14 76 <ResourceRelated Resource> 77 <ResourceResource Relator> A composite that specifies a resource that is related to a resource: used here typically in order to specify a parent resource of which the listed resource is a part eg in the case of an article from a journal An ONIX controlled value specifying a relationship of a resource to a resource 78 <ResourceIdentifier> A composite that carries an identifier of a resource; repeatable only if a resource has two or more identifiers taken from different schemes 79 <ResourceIDType> An ONIX controlled value specifying a scheme from which a resource identifier, is taken 80 <IDTypeName> A name of a proprietary scheme, if applicable 0-8 <IDValue> An identifier value from a specified scheme 82 <ResourceRelatedTime Point> A composite that specifies a time point that is related to a resource: used here in order to specify a date at which a run of a serial resource begins or ends: only the two elements shown below are used in this context 83 <ResourceTimePoint An ONIX controlled value specifying a relationship of a time point to a resource Relator> 84 <TimePointIdentifier> A composite that carries an identifier of a time point 85 <TimePointIDType> An ONIX controlled value specifying a form of a time point identifier, eg YYYY 86 <IDValue> A time point identifier in a specified form -n Copyright EDItEUR & IFRRO 4

15 5.3 DetailByResourceClass 87 <DetailByResourceClass> A composite that specifies a resource class that is part of a repertoire, together with any exclusions from that class 88 <ResourceCategory> A composite that specifies a category to which a resource belongs, when a category is part of the definition of a resource class 89 <ResourceCategoryType> An ONIX controlled value specifying a scheme from which a resource category is taken 90 <CategoryTypeName> A name of a proprietary scheme, if applicable 0-9 <CategoryValue> An category value from a specified scheme 92 <ResourceRelatedAgent> A composite that specifies an agent or agent class that is related to a resource class, when a relationship to an agent or agent class is part of the definition of a resource class 93 <ResourceAgentRelator> An ONIX controlled value specifying a relationship between a resource class and a related agent or agent class 94 <AgentIdentifier> A composite that carries an identifier of an agent or agent class; repeatable only if an agent has two or more identifiers taken from different schemes 95 <AgentIDType> An ONIX controlled value identifying a scheme from which an agent identifier is taken 96 <IDTypeName> A name of a proprietary scheme, if applicable 0-97 <IDValue> An identifier value, from a specified scheme 98 <Name> A name of an agent or agent class 0-99 <ResourceRelatedTime Point> 00 <ResourceTimePoint Relator> A composite that specifies a time point that is related to a resource class, and its relationship to the resource class An ONIX controlled value specifying a relationship between a resource and a related time point 0 <TimePointIdentifier> A composite that carries an identifier of a time point 02 <TimePointIDType> An ONIX controlled value specifying a form of a time point identifier, eg YYYY 03 <IDValue> A time point identifier in a specified form 04 <ResourceRelatedPlace> A composite that specifies a place that is related to a resource class, and its relationship to the resource class; repeatable only if a place has two or more identifiers taken from different schemes 05 <ResourcePlaceRelator> An ONIX controlled value specifying a relationship between a resource and a related place Copyright EDItEUR & IFRRO 5

16 06 <PlaceIdentifier> A composite that carries an identifier of a place; repeatable only if a place has two or more identifiers taken from different schemes 07 <PlaceIDType> An ONIX controlled value identifying a scheme from which a place identifier is taken 08 <IDValue> An identifier value, from a specified scheme 09 <Name> A name of a place 0-0 <ResourceRelatedName> A composite that specifies a name, typically of an imprint or subsidiary, that is related to a resource class, and its relationship to the resource class. An imprint or subsidiary name is listed here only if it defines a section of a repertoire, eg with different terms from the rest. <ResourceNameRelator> An ONIX controlled value specifying a relationship between a resource and a related name 2 <NameIdentifier> A composite that carries an identifier of a name; repeatable only if a name has two or more identifiers taken from different schemes: either a <NameIdentifier> or a <Name> (or both) must be present in any instance of the <Resource RelatedName> composite 3 <NameIDType> An ONIX controlled value identifying a scheme from which a name identifier is taken 4 <IDTypeName> A name of a proprietary scheme, if applicable 0-5 <IDValue> An identifier value, from a specified scheme 6 <Name> 0-7 <ExcludingResources> A composite that specifies resources or resource classes to be excluded from 0- the class specified in an instance of <DetailByResourceClass> 8 <DetailByResource> A composite that specifies a resource: expansion as on previous pages 9 <DetailByResourceClass> A composite that specifies a resource class: expansion as on previous pages Copyright EDItEUR & IFRRO 6

17 5.4 PriceDefinition <PriceDefinition> A composite that defines a price that is referred to in a Repertoire Notification -n 2 <PriceLabel> A label assigned here to the price for unambiguous internal reference within the ONIX <RepertoireNotification> document only 3 <PriceAnnotation> A composite that carries an annotation relating to a price 4 <PriceAnnotationType> An ONIX controlled value specifying a type of a price annotation 0-5 <AnnotationText> The text of an annotation 6 <PriceAmount> The amount of a price as a decimal number 7 <CurrencyCode> An ISO currency code if the price amount is not in a default currency specified in the message header 8 <ChargeUnit> An ONIX controlled value specifying a unit of content or activity for which a charge is made, eg page, article 9 <PriceQuantity> A composite that specifies a quantity attribute of a price, eg an extent limit permitted for the stated price 0 <PriceQuantityType> An ONIX controlled value specifying a type of a price quantity <PriceQuantityDetail> A composite that carries details of a quantity -n 2 <Proximity> An ONIX controlled value specifying a relationship between a quantity and the 0- <Value> stated in the composite, eg is less than, is not more than ; the default is is exactly 3 <Value> A decimal numeric value 4 <MeasureUnit> An ONIX controlled value specifying a unit of measure 5 <ReferenceUnit> An ONIX controlled value specifying a unit to which a quantity refers, if this is 0- not implied by the <PriceQuantityType> 6 <VolumeDiscount> An ONIX controlled value specifying an applicable volume discount or discount 0- class that is standard in a particular context: <VolumeDiscount> and <VolumeDiscountDetail> are mutually exclusive in any instance of <PriceDefinition> 7 <VolumeDiscountDetail> A composite that specifies a volume discount set by an individual rights controller 8 <VolumeUnit> An ONIX controlled value specifying a unit of volume, eg copies 9 <MinimumVolume> The minimum volume required to qualify for a specified volume discount 20 <MaximumVolume> The maximum volume qualifying for a specified volume discount 0-2 <PercentageDiscount> A discount expressed as a percentage of the <PriceAmount>: either 0- <PercentageDiscount> or <DiscountedPriceAmount> must be present in any instance of <VolumeDiscountDetail> 22 <DiscountedPriceAmount> A discounted price expressed as an absolute amount per unit 0- Copyright EDItEUR & IFRRO 7 0-

18 6. ONIX-RP Resource List <ResourceList> A composite that lists resources that belong to a repertoire 2 <ReasonForNotification> An ONIX controlled value specifying a reason for sending a Resource List 3 <NotificationID> A sender-assigned identifier that is unique within the sequence of Resource Lists sent by the Sender to the Addressee 4 <RepertoireIdentifier> A composite that uniquely identifies a repertoire with which a Resource List is -n associated; mandatory, and repeatable only if the repertoire has two or more identifiers taken from different schemes. 5 <RepertoireIDType> An ONIX controlled value identifying the scheme from which the identifier in the <IDValue> element is taken 6 <IDTypeName> A name of a proprietary scheme, if applicable 0-7 <IDValue> An identifier of the type specified in the <RepertoireIDType> element 8 <DetailByResource> A composite that specifies a resource. Repeat for each title listed in the <ResourceList> composite. Expansion as in <RepertoireDetail> -n Copyright EDItEUR & IFRRO 8