ISO/IEC JTC 1/SC 32/WG2 N1792

Size: px

Start display at page:

Download "ISO/IEC JTC 1/SC 32/WG2 N1792"

Brenda Willis
5 years ago
Views:

1 ISO/IEC JTC 1/SC 3/WG N179 Date: REPLACES: ISO/IEC JTC 1/SC 3 Data Management and Interchange Secretariat: United States America (ANSI) Administered by Farance Inc. on behalf ANSI DOCUMENT TYPE TITLE SOURCE Editor, PROJECT NUMBER STATUS REFERENCES ACTION ID. REQUESTED ACTION DUE DATE Summary Voting/Table Replies - Editor's Draft Resolution Comments Summary Voting on 3N80 ISO/IEC CD Information Technology - Metadata Registries (MDR) - Part 5: Naming and identification principles, Ed 3 - Editor's Draft Resolution Comments WG is requested to resolve the s. The document did not obtain substantial support. ACT Number Pages 16 LANGUAGE USED DISTRIBUTION English P & L Members SC Chair WG Conveners and Secretaries Dr. Timothy Schoechle, Secretary, ISO/IEC JTC 1/SC 3 Farance Inc *, 3066 Sixth Street, Boulder, CO, United States America Telephone: ; Timothy@Schoechle.org available from the JTC 1/SC 3 WebSite *Farance Inc. administers the ISO/IEC JTC 1/SC 3 Secretariat on behalf ANSI

2 ISO/IEC JTC 1/SC 3 N331 Summary Voting on Document SC 3 N 80 Title: ISO/IEC CD Information Technology - Metadata Registries (MDR) - Part 5: Naming and identification principles, Ed 3 Project: P Member Approval Approval with Comments Disapprov al with Comments Abstention with Comments Canada 1 China 1 Czech Republic 1 Egypt 1 Finland 1 Germany 1 India 1 Japan 1 Korea, Republic 1 Portugal 1 Russian Federation 1 United Kingdom 1 United States 1 Total P O Member Austria Belgium France 1 Ghana Hungary Indonesia Italy Kazakhstan Netherlands, The Norway Romania Poland Sweden Switzerland Total O Dr. Timothy Schoechle, Secretary, ISO/IEC JTC 1/SC 3 Farance Inc *, 3066 Sixth Street, Boulder, CO, United States America Telephone: ; Timothy@Schoechle.org available from the JTC 1/SC 3 WebSite *Farance Inc. administers the ISO/IEC JTC 1/SC 3 Secretariat on behalf ANSI

3 COMMENTS: Canada NO. See s below: Finland ABSTAIN. Lack expertise and interest. India ABSTAIN. Lack expertise and interest. Japan YES. See s below: Portugal ABSTAIN. Lack expertise and interest. United Kingdom NO. See s below: United States NO. See s below:

4 Date: Document: N80 Project:CD MB/ NC Line number Clause/ Figure/ Table/ Comments Proposed change Observations the secretariat All All - ge Canada disapproves the draft for the reasons below. Since the new template allows for text to be referenced using line numbers, we generated a line numbered version the text which is attached at the bottom this document, and we have referenced those line numbers in our s Introduction Para 6 Ed The use 'They' at the beginning a paragraph requires the reader to look backwards to see what it refers to. 18, Scope Para 1 Te The response to CN01 on the previous ballot stated that 'Identification' should be dropped from the title the document. If this is, then all reference to Identification should be removed Reference Ed The reference to [ISO/IEC :01] should be [ISO/IEC :013] Reference Ed The reference to [ISO/IEC :01] should be [ISO/IEC :013] Reference Ed The reference to [ISO/IEC :01] should be [ISO/IEC :013] Reference Ed The reference to [ISO/IEC :01] should be [ISO/IEC :013] Reference Ed The reference to [ISO/IEC :01] should be [ISO/IEC :013] Canada will change its vote to Approval if the s below are satisfactorily addressed. Canada asks that future ballot texts include line numbers so that: a) all NBs can reference them in making their ballot s; and, b) The Project Editor(s) can collate all NB s by line reference in order to prepare a single integrated document all NB s, thereby greatly facilitating resolution ballot s pertaining to similar NB s and resolving the same.. Change 'They' to 'Names'. Remove the discussion Identification from the Scope, except to refer the reader to Edition 3 part 6. This should be done via a footnote. Make the correction. Make the correction. Make the correction. Make the correction. Make the correction. The editor will attempt to use the version with line numbers; note that the version generated by did not convey on the originally distributed copy these s. ; a resolution from WG is in process Reference Ed The reference to [ISO/IEC :01] should Make the correction. 1 MB = Member body / NC = National Committee (enter the ISO 3166 two-letter country code, e.g. CN for China; s from the ISO/CS editing unit are identified by **) ISO/IEC electronic balloting ing template/version page 1 16

5 Date: Document: N80 Project:CD MB/ NC 1 Line number Clause/ Figure/ Table/ 08 be [ISO/IEC :013] Comments Proposed change Observations the secretariat Reference Ed The reference to [ISO/IEC :01] should be [ISO/IEC :013] 65, 66 4 Conformanc e 75 4 Conformanc e 76, 77 4 Conformanc e 86, 87 4 Conformanc e Para 1 Ed In the first sentence: "A registry containing a set designatable items associated with a namespace which conform to naming conventions so that:" It is unclear on a first reading that "which conform" is supposed to refer back to the 'designatable items', not the namespace. The sentence needs to be clarified. Para Ed The use 'shall be' seems inappropriate in: Para 3 Ed In the sentence: "A registry in which every namespace conforms to this part shall be a conforming registry." "A registry containing a set designatable items associated with a namespace which conform to naming conventions so that:" It is unclear on a first reading that "which conform" is supposed to refer back to the 'designatable items', not the namespace. The sentence needs to be clarified. Para 4 Ed The use 'shall be' seems inappropriate in: "A registry in which every namespace strictly conforms to this part shall be a strictly conforming registry." Make the correction. Reword as: "A registry containing a namespace associated with a set designatable items which conform to naming conventions so that:" Reword as: "A registry in which every namespace conforms to this part is a conforming registry." Reword as: "A registry containing a namespace associated with a set designatable items which conform to naming conventions so that:" Reword as: "A registry in which every namespace strictly conforms to this part is a strictly conforming registry." and remove the extra space before nd 'strictly' Reference Ed The reference to [ISO/IEC :01] should Make the correction. 1 MB = Member body / NC = National Committee (enter the ISO 3166 two-letter country code, e.g. CN for China; s from the ISO/CS editing unit are identified by **) ISO/IEC electronic balloting ing template/version page 16

6 Date: Document: N80 Project:CD MB/ NC 1 Line number Clause/ Figure/ Table/ 14 in Line 1 be [ISO/IEC :013] Comments Proposed change Observations the secretariat Line 1 Ed The reference to Clause 4 should be Clause 5. Make the correction Para Ed The reference to [ISO/IEC :01] should be [ISO/IEC :013] Para 3 Ed The reference to [ISO/IEC :01] should be [ISO/IEC :013] Para 1, nd sentence Te The statement "The uniqueness rule resides in the Namespace class as discussed above" is inappropriate, since the rules described in 8.1. apply to a Namespace, not a Naming Convention. 451, All Te The current text relates to uniqueness names within a Namespace. Use a Naming Convention may lead to potential clashes for names similar items. A naming convention can enable uniqueness names by specifying one or more rules to be used when a potential name clash is detected. All All Te If any further problems are discovered before or during the Ballot Resolution Meeting, and a consensus can be reached on a solution, then they should be corrected. Make the correction. Make the correction. For this part, add text allowing a uniqueness rule to be specified for a Naming Convention, even though there is no place to store it in the registry specified by Part 3. WG should consider an amendment to part 3 to add a uniqueness rule on a Naming Convention. Add some text to this effect, with examples such rules (e.g. using a suffix or other qualifier to make a name unique.) To be determined at the BRM as required. The line numbers used above reference the attached version the text. We added line numbers to make the references more precise. END 3N80T-text_for_ ballot-cd_ _w 1 MB = Member body / NC = National Committee (enter the ISO 3166 two-letter country code, e.g. CN for China; s from the ISO/CS editing unit are identified by **) ISO/IEC electronic balloting ing template/version page 3 16

7 ISO/IEC CD Naming and identification principles Date: 013/4/1 Document: 3N80T Project: MDR-5 MB/ NC 1 Line number (e.g. 17) Clause/ Figure/ Table/ (e.g. Comments Proposed change Observations the secretariat JP 01 JP 0 JP ED Duplicate Line Remove line resolved - two subclauses will be added to make the differing levels conformance explicit. 9.1 ED rules may be recorded is inconsistent with the Conformance clause (4). It says shall have its rules documented. 900 Annex B Semantic Rules c. ED Japanese translation Total Amount is incorrect. Change to rules shall be recorded 総計 should be 合計金額. resolved - text will be added to clause 9.1 to clarify JP Annex B Semantic Rules g. ED Japanese translation Amount is incorrect. 計 should be 金額 JP Annex B Syntactic Rules d. ED Japanese translation Cost Budget Period Total Amount is incorrect. 経費予算期間総計 or 経費予算期間総計 should be 経費予算期間金額合計 or 経費予算期間金額合計 JP Annex B Lexical Rules d. ED Japanese translation Cost Budget Period Total Amount is incorrect. 経費予算期間総計 or 経費予算期間総計 should be 経費予算期間金額合計 or 経費予算期間金額合計 1 MB = Member body / NC = National Committee (enter the ISO 3166 two-letter country code, e.g. CN for China; s from the ISO/CS editing unit are identified by **) ISO/IEC/CEN/CENELEC electronic balloting ing template/version page 1 16

8 Template for s and secretariat observations Date: April 013 Document: ISO/IEC CD (3) 4 5 (6) (7) GB 01 General ed There are a number instances where "Error! Reference source not found" appears on our copy, for example in headers and footers and the main title. GB 0 Forward ed The list parts might be incorrect as the future Parts and 4 are still to be agreed. Sort out automatic referencing. Amend as necessary. GB 03 Introduction ed The opening sentence could be more explicit. Amend to read "This part ISO/IEC contains both principles and rules." GB 04 1 (Scope) Para 1, Line 1 GB 05 3 (Terms and definitions) ed ed The derivation the terms concept, data element concept, etc originate. It is not necessary to include 3.1, 3.4, 3.5, 3.8, 3.10 and 3.1 since these are all copied from and the text clause 3 says that the terms and definitions in other parts all apply. However, it could be argued that they make this part more readable as a stand-alone document by their inclusion. Add "defined in part 3 this International Standard" after "the following items." Consider removing these definitions. GB te Registered item is not defined. If this definition is to be kept, add a definition registered item. GB te Is this an appropriate definition object for this standard? Would a definition that is more closely aligned with an object in object oriented analysis and design be more appropriate? Consider revising the definition. This is an artifact the pdf conversion. The editor will make a good-faith attempt to correct it. resolved - the text will be amended as the parts evolve. resolved - the definitions will be left as they are. GB te Representation class is not defined. Add a definition representation class. - GB will suggest a substitute definition. NOTE Columns 1,, 4, 5 are compulsory. ISO electronic balloting ing template/version page 1 16

9 Template for s and secretariat observations Date: April 013 Document: ISO/IEC CD (3) 4 5 (6) (7) GB Note te The term data model is ambiguous. It sometimes means the way that data is represented in a database (for example, the relational data model) and at other times it means the representation as a model the information to be stored in an information system for a particular universe discourse (for example, the XYZ Company data model, which may be represented as an IDEF1X model, as a UML class diagram,etc). GB Line 1 ed There is a reference to clause 4, which is the conformance clause this standard. Is clause 5 the correct reference, or is the reference to clause 4 a different standard? GB 11 Annex A A.1, Line 1 ed There is a reference to clause 8. Is clause 9 the correct reference? Disambiguate the meaning. It is assumed that the second meaning is what is required. If so, the term "information model" may be preferable. Amend reference. Amend reference. - "information model" will be added to the list examples. GB 1 Annex A A.5, Table ed On the odd numbered pages the right hand edge the table is missing. GB 13 Annex A A.5, Table, last row Adjust table. ed There are some strange lines over the first two columns. None provided. GB 14 Annex B Line 1 ed There is a reference to clause 8. Is clause 9 the correct reference? GB 15 Annex B ed The Korean characters have not printed on the pdf copy provided. Amend reference. None provided. This is an artifact the pdf conversion. The editor will make a good-faith attempt to correct it. The editor will investigate this issue and attempt to resolve it. NOTE Columns 1,, 4, 5 are compulsory. ISO electronic balloting ing template/version page 16

10 Template for s and secretariat observations Date: April 013 Document: ISO/IEC CD (3) 4 5 (6) (7) Intro nd para ed The paragraph seems out place and does not make sense. Intro 3 rd para te names (signs or combinations signs) is inconsistent with the rest the document. It is not correct given that the term name is a synonym for designation. Intro 6 th para; 1 st sentence Re-write the nd paragraph as A naming convention may be based on principles. In addition, it may contain formal and informal inputs, such as guidelines, recommendations, company policies, programming conventions, specifications, procedures, and so on. Combine paragraphs and 3 by inserting re-written nd paragraph after the nd sentence the 3 rd paragraph. 3 rd para Remove parenthetical phrase. not - did not gain consensus support the working group ed Use the word rigor seems harsh. Use detail and enforcement instead. not -did not gain consensus support the working group Intro 7 th para ed First sentences are confusing. It is not clear what designation in reference to most metamodel items means. Re-write the sentences as follows: In this international standard the use the root name in the classes Namespace and Naming Convention should be interpreted broadly and not necessarily restricted to names. not - did not gain consensus support the working group Intro 7 th para; last sentence 1 1 st para; 1 st sentence NOTE Columns 1,, 4, 5 are compulsory. ISO electronic balloting ing template/version te te In the last sentence, the term name as defined in Part 5 is not synonymous with designation as defined in Part 3. Use the word instruction is confusing. This Part provides principles for constructing names, codes, and identifiers. Instead, re-write the last sentence as This Part will continue to use the term name for constructs that, for purposes this Part, are linguistic designations. Some designations, such as codes, are not linguistic. Recommend replacing first sentence with This Part ISO/IEC provides principles for constructing names, codes, and identifiers. The principles give guidance on the formulation rules that constitute a naming convention. Names, codes, and identifiers are the output not - did not gain consensus support the working group not - this inconsistent with 0 page 1 16

11 Template for s and secretariat observations Date: April 013 Document: ISO/IEC CD (3) 4 5 (6) (7) naming conventions. Names for the following items in may be generated by a naming convention: concept, data element concept, conceptual domain, data element, and value domain st para, 3 rd sentence ed The text shifts to MDR in particular. Start a new paragraph at the beginning the 3 rd sentence nd para, nd sentence te The words can apply are unnecessarily timid. The principles do apply. Remove can th para; 1 st sentence ed Reference to designations refers to Part 3, not Part 5. Suggest sticking with names. Replace designations with names. not - did not gain consensus support the working group Note te Name as defined subsumes both term and appellation as defined in Add a Note as follows: Note: Term and appellation as defined in ISO are both kinds name. not - did not gain consensus support the working group definition te Since naming conventions have names, codes, and identifiers as output, then the definition should change. Then, this new definition is slightly altered from the one in Part 3.p Replace definition with specification how signs denoting names, codes, and identifiers are formulated not - this inconsistent with 0 Add Note 1 13 Note: This definition is slightly generalized from the one in ISO/IEC This reflects the fact that ISO/IEC has scope beyond MDR. 3.1 definition ed textural is a misspelling. Change textural to textual. 3.1 definition te The definition uses the opening words textual string or symbol. This can be generalized and Substitute perceivable object for textual string or symbol. Then add not - did not gain consensus support the NOTE Columns 1,, 4, 5 are compulsory. ISO electronic balloting ing template/version page 16

12 Template for s and secretariat observations Date: April 013 Document: ISO/IEC CD (3) 4 5 (6) (7) US made stronger, even though it changes the definition as it appears in Part 3. 3 new te Need definition for the term identifier. Identifier 3 new te Need definition for the term code. Code Note: The definition in Part 3 is a specialization this definition. This is a stronger and much more general statement, yet it leaves the older definition in Part 3 still valid. Now an icon or a volt is a sign by this definition. representation an object by a sign which denotes it and which is intended for dereferencing the object denoted collection rules that maps the elements one set on to the elements another (ISO/IEC 9789:1994) Note: In ISO/IEC 9789:1994, - first set is the coded set and the second set is the code element set - the relationship cardinality from the code element set to the coded set is one-tomany. working group not - this inconsistent with 0 not -this inconsistent with 0 NOTE Columns 1,, 4, 5 are compulsory. ISO electronic balloting ing template/version page 3 16

13 Template for s and secretariat observations Date: April 013 Document: ISO/IEC CD (3) 4 5 (6) (7) 16 4 all te Scope section ( nd para) states broad applicability, yet conformity is only about a registry. Add conformity statements as follows: A system containing a set designatable items associated with a namespace which conform to naming conventions so that: each item shall be named in accordance with a naming convention,, but the language will be made consistent with each naming convention shall have its scope documented, each naming convention shall have its authority documented, each naming convention should have its semantic rules documented, each naming convention should have its syntactic rules documented, each naming convention should have its lexical rules documented, and each naming convention should have its uniqueness rules documented, then that namespace is in conformance with this part A system in which every namespace conforms to this part shall be a conforming system. A system containing a set designatable items associated with a namespace which conform to NOTE Columns 1,, 4, 5 are compulsory. ISO electronic balloting ing template/version page 4 16

14 Template for s and secretariat observations Date: April 013 Document: ISO/IEC CD (3) 4 5 (6) (7) naming conventions so that: each item shall be named in accordance with a naming convention, each naming convention shall have its scope documented, each naming convention shall have its authority documented, each naming convention shall have its semantic rules documented, each naming convention shall have its syntactic rules documented, each naming convention shall have its lexical rules documented, and each naming convention shall have its uniqueness rules documented, then that namespace is in strict conformance with this part A system in which every namespace strictly conforms to this part shall be a strictly conforming system , 9 throughout te Names, codes, and identifiers are the output a naming convention nd and 3 rd paras NOTE Columns 1,, 4, 5 are compulsory. ISO electronic balloting ing template/version ed nd paragraph is disallowing synonyms if the switch is set to yes. Substitute the words names, codes, and identifiers for each instance the word name in the clauses. Add sentence to end each paragraph alerting the reader by using these terms. not - this inconsistent with 0 page 5 16

15 Template for s and secretariat observations Date: April 013 Document: ISO/IEC CD (3) 4 5 (6) (7) 3 rd paragraph is disallowing homonyms if the switch is set to yes st para te The relationship between a Namespace and a Naming Convention in Ed3 is many-tomany. So, the uniqueness rule in each the Namespaces that relate to a particular Naming Convention may differ. Therefore, uniqueness for a Naming Convention is not well-defined if we rely on expressing that in Namespace.. Replace text in clause 8. with The Naming Convention class in Edition 3 ISO/IEC provides a location in the metamodel for recording most the rules for any particular naming convention. The rules contained in the Naming Convention class are: - scope rule - authority rule - semantic rule - syntactic rule - lexical rule These are all the type Text and are meant to allow as much complexity in description as needed to describe each rule. 18 addresses this issue. The editor will change this clause to agree with the sense both MB's s. See sub-clause 9.7 for a discussion the uniqueness rules all te The discussion the Uniqueness Principle and the rules it may direct is too sparse. Uniqueness for a Naming Convention is not specified through Namespaces. Add wording that describes what uniqueness rules provide. Uniqueness rules in a naming convention cannot guarantee uniqueness in a namespace, because several naming conventions may apply to the names there. But, a naming convention can enable uniqueness there through its application. 19 addresses this issue. The editor will change this clause to agree with the sense both MB's s. 1 Annex B new ed Need example naming convention that produces identifiers as informative annex, similar to Annex A. US will provide the example in new Annex B. not - this inconsistent with 0 Annex C new ed Need example naming convention that produces codes as informative annex, similar to Annex A. US will provide the example in new Annex C. not - this inconsistent with 0 NOTE Columns 1,, 4, 5 are compulsory. ISO electronic balloting ing template/version page 6 16

16 Template for s and secretariat observations Date: April 013 Document: ISO/IEC CD (3) 4 5 (6) (7) 3 Annexes B and C titles ed New Annexes B and C described above require renaming old Annexes B and C. Rename Annex B and Anne C to Annex D and Annex E, respectively. not - this inconsistent with 0 NOTE Columns 1,, 4, 5 are compulsory. ISO electronic balloting ing template/version page 7 16

ISO/IEC JTC 1/SC 32 N 2432

ISO/IEC JTC 1/SC 32 N 2432 Date: 2013-10-24 REPLACES: ISO/IEC JTC 1/SC 32 Data Management and Interchange Secretariat: United States of America (ANSI) Administered by Farance Inc. on behalf of ANSI DOCUMENT