Capability (C005):— representing_documents Date: 2010/11/19 15:15:37
Revision: 1.25

Issue raised against: representing_documents

OTHER issues


Open issue Issue: SMB-1 by Sean Barker (2004-09-16) minor_technical issue
Resolution: Accept. Status: open

The capability mentions indirectly Partial_document_assignment, but does not provide any further information. Details of Partial_document_assignment should either be provided within the capability, or referenced as part of Referencing_document. (A matching issue has been raised against Referencing_document.)


Open issue Issue: DNV-15 by Sylvia Schwab on behalf of DNV (07-03-07) major_technical issue
Resolution: Accept. Status: open

OASIS referencing_documents (C037) is going to be deleted. Representing_documents (C005/rep_doc) includes much more than actually needed. Therefore a new template should be created in C005 to represent document when referenced.

Proposal: NEW template represent_document_without_view (rep_doc_w_out_view), containing Document and Document_version with identifiers on both and optional classification on Document without document_assignment.

Naming consideration: Is it possible to name the template referencing_document_version (ref_doc_vers) instead of rep_doc_w_out_view?


Open issue Issue: DNV-16 by Sylvia Schwab on behalf of DNV (07-03-07) major_technical issue
Resolution: Accept. Status: open

It should be possible to identify a type of document by classification.

Proposal: Add optional classification to Document for all templates related to representing_document.


Open issue Issue: DNV-17 by Sylvia Schwab on behalf of DNV (07-03-07) major_technical issue
Resolution: Accept. Status: open

It should be possible to assign a document, independent of its views, to product and support data.

Proposal: NEW template assigning_referenced_document (asg_ref_doc), containing Document and Document_version with identifiers on both and optional classification on Document + Document_assignment with classification.

Note: differs from DVN-15 because of document_assignment.


Open issue Issue: DNV-26 by Sylvia Schwab on behalf of DNV (07-03-07) major_technical issue
Resolution: Accept. Status: open

It is necessary to reference parts of a document content, e.g. chapter, section, table, figure, page number etc. Entity Partial_document_assignment is missing from OASIS C005.

Proposal part1: The entity Partial_document_assignment must be added to C005 or in a new capability.

Proposal part2: NEW template Assigning_partial_document (asg_partial_doc), consisting of Partial_document_assignment with classification + Document and Document_version with identifiers on both and optional classification on Document (ref to new template DNV-15).

GENERAL issues


Closed issue Issue: RBN-1 by Rob Bodington (04-07-29) minor_technical issue
Resolution: Accept. Status: closed

There should be some description about how to represent document properties.
Comment: (Tim Turner on behalf of UK MoD TES/ILS and Eng Pol under UK_Defence Development Programme. Dec 15 2006)
Document properties are handled by the assigning_document_properties capability and is refered to within the section document properties.


Closed issue Issue: NN-1 by Nigel Newling (05-11-17) minor_technical issue
Resolution: Accept. Status: closed

In Figures 6 and 7, should Class be used? Use External_class and Subset if not standardized but business specific reference data.
Comment: (Tim Turner on behalf of UK MoD TES/ILS and Eng Pol under UK_Defence Development Programme. Dec 15 2006)
Diagrams were drawn prior to decision to use External_class. Will be removed/updated.


Closed issue Issue: NN-2 by Nigel Newling (05-11-17) minor_technical issue
Resolution: Accept. Status: closed

How are logical sections of documents i.e. chapters represented?
Comment: (Tim Turner on behalf of UK MoD TES/ILS and Eng Pol under UK_Defence Development Programme. Dec 15 2006)
They can be represented as a number of document_definitions which are defined against a particular document_version according to the chapters/sections required for the document. Each definition has an .id (labeled through reference data) which is used to provide the section/chapter number. Sequential sections/chapters can be represented through the document_definition_relationship mechanism (ref data in this case would be "sequential". For the case where a chapter needs to be broken down into separate sub-sections, or perhaps by pages, "decomposition" should be used. This can be used to provide the logical structure of a document. The name of each section/chapter can also be (optionally) provided through reference data, plus any additional context information as additional text. In addition, each definition may be represented as individual files (digital files if using digital documents, else hardcopy components of physical_documents). If the different chapters/section/pages etc.. are defined in separate files, then a single document_definition can be used but with many component files. The different sections can then be related through the use of the file_relationship entity using the "sequential" or "decomposition" reference data as required.


Closed issue Issue: RBN-2 by Rob Bodington (06-06-28) minor_technical issue
Resolution: Accept. Status: closed

Template assigning_document: The reference parameters would be better named doc not descr The path, and figures are missing
Comment: (Tim Turner on behalf of UK MoD TES/ILS and Eng Pol under UK_Defence Development Programme. Dec 15 2006)
Template parameters have now been updated. Figures and path added.


Closed issue Issue: RBN-3 by Rob Bodington (07-08-09) minor_technical issue
Resolution: Accept. Status: closed

Moved template assigning_partial_document assigning_referenced_document representing_document_without_view to NDLO templates