Technical product documentation — Metadata for construction documentation

Documentation technique de produits — Métadonnées pour la documentation de construction

General Information

Status
Withdrawn
Publication Date
19-Jul-2000
Withdrawal Date
19-Jul-2000
Current Stage
9599 - Withdrawal of International Standard
Completion Date
04-Sep-2015
Ref Project

Buy Standard

Technical report
ISO/TR 19033:2000 - Technical product documentation -- Metadata for construction documentation
English language
24 pages
sale 15% off
Preview
sale 15% off
Preview

Standards Content (Sample)

TECHNICAL ISO/TR
REPORT 19033
First edition
2000-07-01
Technical product documentation —
Metadata for construction documentation
Documentation technique de produits — Métadonnées pour la
documentation de construction
Reference number
ISO/TR 19033:2000(E)
© ISO 2000

---------------------- Page: 1 ----------------------
ISO/TR 19033:2000(E)
PDF disclaimer
This PDF file may contain embedded typefaces. In accordance with Adobe's licensing policy, this file may be printed or viewed but shall not be
edited unless the typefaces which are embedded are licensed to and installed on the computer performing the editing. In downloading this file,
parties accept therein the responsibility of not infringing Adobe's licensing policy. The ISO Central Secretariat accepts no liability in this area.
Adobe is a trademark of Adobe Systems Incorporated.
Details of the software products used to create this PDF file can be found in the General Info relative to the file; the PDF-creation parameters
were optimized for printing. Every care has been taken to ensure that the file is suitable for use by ISO member bodies. In the unlikely event
that a problem relating to it is found, please inform the Central Secretariat at the address given below.
© ISO 2000
All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized in any form or by any means, elec-
tronic or mechanical, including photocopying and microfilm, without permission in writing from either ISO at the address below or ISO's mem-
ber body in the country of the requester.
ISO copyright office
Case postale 56 • CH-1211 Geneva 20
Tel. + 41 22 749 01 11
Fax + 41 22 749 09 47
E-mail copyright@iso.ch
Web www.iso.ch
Printed in Switzerland
©
ii ISO 2000 – All rights reserved

---------------------- Page: 2 ----------------------
ISO/TR 19033:2000(E)
Contents Page
1 Scope . 1
2 Basic concepts . 1
3 Document management in manual practice . 2
4 Problems in document exchange . 5
5 State-of-the-art document management . 7
6 Examples . 11
7 Views of different parties . 16
8 Standards used in document management . 18
9 Demand for standardization . 21
10 Organization of the standardization work . 21
11 Related standards work/activities . 22
12 Proposed time schedule . 23
Bibliography. 24
©
ISO 2000 – All rights reserved iii

---------------------- Page: 3 ----------------------
ISO/TR 19033:2000(E)
Foreword
ISO (the International Organization for Standardization) is a worldwide federation of national standards bodies (ISO
member bodies). The work of preparing International Standards is normally carried out through ISO technical com-
mittees. Each member body interested in a subject for which a technical committee has been established has the
right to be represented on that committee. International organizations, governmental and non-governmental, in liai-
son with ISO, also take part in the work. ISO collaborates closely with the International Electrotechnical Commission
(IEC) on all matters of electrotechnical standardization.
International Standards are drafted in accordance with the rules given in the ISO/IEC Directives, Part 3.
The main task of technical committees is to prepare International Standards. Draft International Standards adopted
by the technical committees are circulated to the member bodies for voting. Publication as an International Standard
requires approval by at least 75 % of the member bodies casting a vote.
In exceptional circumstances, when a technical committee has collected data of a different kind from that which is
normally published as an International Standard (“state of the art”, for example), it may decide by a simple majority
vote of its participating members to publish a Technical Report. A Technical Report is entirely informative in nature
and does not have to be reviewed until the data it provides are considered to be no longer valid or useful.
Attention is drawn to the possibility that some of the elements of this International Standard may be the subject of
patent rights. ISO shall not be held responsible for identifying any or all such patent rights.
ISO/TR 19033 was prepared by Technical Committee ISO/TC 10, Technical drawings, product definition and related
documentation, Subcommittee SC 8, Construction documentation.
©
iv ISO 2000 – All rights reserved

---------------------- Page: 4 ----------------------
ISO/TR 19033:2000(E)
Introduction
During the last two decades the construction industry has undergone a thorough transition from manual practice to
computer support for the production and exchange of information. However, the manual practices and standards for
handling construction documentation have not undergone a corresponding change. Instead, the well-documented
manual methods for design cooperation and coordination, a system for process quality assurance common to the in-
dustry, are being replaced by procedures specific to projects and companies. The result is that, although every indi-
vidual participant strives to assure the quality of his or her own products and services, the process may fail to
improve overall product quality. In this situation, the information interfaces and networking become key factors.
Nevertheless, electronic document management technologies are well suited to handle the large numbers of docu-
ments used in the construction process, together with the associated reference information. Cost reductions and
quality improvements are immediate incentives. The potential benefits include:
— efficient search and retrieval of specific documents;
— quick and direct propagation of changes;
— automatic workflow procedures;
— documentation of dependent information in document collections;
— reduced administration through integration of document production and management;
— retrieval of knowledge gained from previous projects and common industry sources.
As document management is by its nature an instrument for the exchange of information, the need for standardiza-
tion is evident. Specific properties of the construction process, in particular the presence of many participants tempo-
rarily involved but over a long period of time, make it extremely difficult to arrive at specific agreements between the
different parties and thus promote the importance of standards common to the entire industry. The lack of dominant
actors who would be able to set de-facto standards, as well as the ongoing internationalization of the construction in-
dustry makes dejure standardization within ISO the natural choice for a successful strategy.
ISO/TC 10/SC 8 has identified metadata for technical documents as being a field where the construction industry
would immediately benefit from standardization, and where no standards are presently available. The purpose of this
Technical Report is to further investigate and describe those standardization needs, and to propose standardization
activities within the ambit of ISO/TC 10/SC 8.
©
ISO 2000 – All rights reserved v

---------------------- Page: 5 ----------------------
TECHNICAL REPORT ISO/TR 19033:2000(E)
Technical product documentation — Metadata for construction
documentation
1 Scope
This Technical Report gives guidelines for the electronic management of documents used in the construction indus-
try. It pays particular attention to the transition from manual to computerized processes, and the use of metadata in
document exchange.
2 Basic concepts
2.1 Documents and files
In common language, a document is of paper and contains written or drawn information for a particular purpose. In
many cases, the term document also has a legal aspect, for example, as proof of a legally valid obligation.
In the digital environment, the paper is replaced by a computer-file stored on a digital medium. However, there is no
one-to-one relationship between document and file. The document can be composed of several files, and a file could
contain several documents. Mixed environments, with paper-based documents, also exist.
An extended definition of the term document is offered by ISO/IEC 8613-1. It is “a structured amount of information
for human perception that can be interchanged as a unit between users and systems”. A document can be on paper
or any other media, including computer files or parts thereof, and audio and videotapes.
In this Technical Report paper-based documents and computer files are both regarded as manageable units in the
information-exchange process.
The term document is used to refer to all kinds of units of information that can be managed using an electronic doc-
ument management system (EDMS), the normal term for a computer application that manages documents and files.
2.2 Compound documents and document sets
Documents can be combined in two conceptually distinctive ways:
— a compound document is a homogenous document, consisting of several parts or sections (e.g. a technical spec-
ification made up of sections or a drawing that contains several views);
— a document set is a collection of individual documents, grouped for a specific purpose (e.g. the drawings and
specifications needed for the procurement of a subcontract).
Document management has to consider both combinations and their parts, regardless of whether or not they are
stored as individual computer files. The term collection of documents is used when discussing a number of docu-
ments that are managed together, but not directly related.
2.3 Metadata
In the process of exchanging documents, additional information will need to be attached to each document, to docu-
ment sets and to separate files that are parts of compound documents. Metadata is the term used for this “informa-
tion about the information”. It includes information that is usually part of the document header as well as all other
©
ISO 2000 – All rights reserved 1

---------------------- Page: 6 ----------------------
ISO/TR 19033:2000(E)
kinds of information needed to organize and manage the documents. In manual practice, metadata is transferred us-
ing a number of media, such as letters, labels on envelopes or floppy disks, telephone calls or meetings.
2.4 Model
A model is the representation of real-world objects and their relationships.
A model is built, or instantiated, using a conceptual schema that defines the kinds of objects and relations that exist
in the model. Two kinds of models are of particular interest.
— A building product model describes the physical parts of a building. The conceptual schema for this kind of model
defines the properties of the parts and the relationships between them.
EXAMPLE That a column has length, width, height and material properties, that it connects to floor and a ceiling, and that it
is part of the load-bearing structure.
— A documentation model describes the documents. The conceptual schema for this kind of model defines the
properties of a document and its relations with other documents.
EXAMPLE A plan drawing has size, scale and creator properties, it refers to detail and section drawings and is part of a set
of working drawings. Such properties and relations are metadata for the document.
In the subsequent clauses of this report, the model concept is further elaborated.
3 Document management in manual practice
3.1 General
The tradition of managing documents in manual practice has produced a number of methods for organizing and ex-
changing information. Electronic document management has to consider the same basic needs, and provide a
smooth transition path from manual methods. Each manual operation on a document, or one associated with a doc-
ument, corresponds to a similar operation when using computer applications. What follows is a step-by-step descrip-
tion of the life cycle of technical documents, comparing manual practice with possible computer-aided equivalents.
3.2 Creation of documents
3.2.1 Manual practice
In most cases, before technical documents are created, documentation planning is performed. Preliminary document
lists are made and boundaries for drawings defined. When the documents are created, document headers and title
blocks are filled out with content that is standardized nationally or specified by the client.
3.2.2 Computer-aided equivalent
Here, the planning is done by registering the documents-to-be in a document-management database. Their identities
and positions in the document-set structure and, where applicable, in a compound document, are defined. The meta-
data for each document can be registered when planning the documentation, or later, when the actual document is
created, stored or otherwise managed.
©
2 ISO 2000 – All rights reserved

---------------------- Page: 7 ----------------------
ISO/TR 19033:2000(E)
3.3 Reuse of documents
3.3.1 Manual practice
New documents are often based on older ones. In its most systematic form, template documents or references to
type documents are used. Old documents are used as copies or, when using minor parts thereof, rewritten or re-
drawn. The identity of the old document is sometimes preserved, in particular when there is a copyright requirement.
3.3.2 Computer-aided equivalent
Paper-based documents can be reused by capturing them by scanning and optical recognition of characters (OCR)
or lines (vectorization). The existing documents can then be edited or portions of them can be included in new docu-
ments. Reusing digital documents is of course easier; either copies of, or links to, the documents can be created. In
all cases, metadata that identify the origin of the document can be valuable.
3.4 Document distribution
3.4.1 Manual practice
For each version of a document, distribution is according to agreed distribution lists. A missive explaining the status
of the document and the further particulars regarding the distribution may accompany the document. The receiver
may also acknowledge the distribution.
3.4.2 Computer-aided equivalent
When using computer networks, distribution is easily accomplished automatically by data-communication. Distribu-
tion lists in electronic form can be applied to support the automated routines. Alternatively, no actual distribution is
performed but documents are stored somewhere accessible to project members, and the existence of new versions
is signalled by a message to all those on the distribution list. It is then the responsibility of each to open the docu-
ment. Using appropriate supervision applications, all sending, receiving and reading of documents and messages
can thus be logged.
3.5 Checking and approval of documents
3.5.1 Manual practice
Before a document is used for its final purpose, it is usually quality assured through an approval process that can
contain several steps. In a typical document workflow, the document is first checked internally by the issuer, then in
coordination with other specialists. After any necessary changes have been made, the client finally approves the doc-
ument. In principle, the same procedure is applied to every subsequent revision of the document.
3.5.2 Computer-aided equivalent
Workflow applications allow the setting up of the workflow for approval processes, generally for a project or individu-
ally for a document, document category or set of documents.
3.6 Coordination of documents
3.6.1 Manual practice
Technical documents produced by different actors are usually checked against each other before final release. This
applies in particular to drawings, but also to technical specifications, etc. In the coordination process, special atten-
©
ISO 2000 – All rights reserved 3

---------------------- Page: 8 ----------------------
ISO/TR 19033:2000(E)
tion is given to potential conflict points and zones, where several systems meet or intersect. Quite often, coordination
is performed in steps, for example, technical installations are coordinated first, and then coordinated with the load-
bearing and complementing structures.
3.6.2 Computer-aided equivalent
Analysis can be much enhanced by search and overlay techniques in computer applications. For example, all refer-
ences to a section in a specification document or all occurrences of a specific term can be traced, and layers from
computer-aided design (CAD) drawings showing the different technical systems can be overlaid to show collisions
and other conflicts. The documentation of errors is possible, with links to the affected documents in a document man-
agement database.
3.7 Storage, search and retrieval of documents
3.7.1 Manual practice
Documents are stored in some structured order that facilitates finding and retrieving them. The usual storage sys-
tems in folders, binders and drawers are often standardized within companies, but seldom subject to formal standard-
ization on a wider level. However, national classification systems for building elements, etc. are often used for the
ordering of documents. In addition to the physical placement of the documents, document lists for each project, as
well as project lists for the company, are used.
3.7.2 Computer-aided equivalent
At the basic level, all computer systems use file/directory structures that can be considered equivalent to binders and
drawers in manual practice. Search and retrieval of documents is a basic function of document management sys-
tems. Search is based either on metadata or on the content of the documents (free text search).
For graphical documents, metadata is the most frequent search method (graphical pattern recognition is not yet a
widely exploited technology). Many text documents can be found using free text search, although the existence of key
words and other metadata can substantially improve the quality of searching. Retrieving the documents for viewing,
printing or editing purposes requires knowledge of whether computer applications being used are able to read the
data format, and often how the document is structured (in sections, layers, etc.).
3.8 Revision of documents
3.8.1 Manual practice
Changes prior to the official release of a document are often conducted informally. Revisions on a completed and re-
leased document have to be fully checked and approved, and every actor or party that will be affected has to be no-
tified in accordance with routines established for the project or by standards.
3.8.2 Computer-aided equivalent
An important role of the EDMS is to assure that each document used is the correct version, and that revisions are
correctly performed. Workflow functions can be used to manage revision activities. However, the need for more infor-
mal, but still sufficiently safe, procedures is seldom complied with by existing EDMSs.
©
4 ISO 2000 – All rights reserved

---------------------- Page: 9 ----------------------
ISO/TR 19033:2000(E)
3.9 Archiving and deletion of documents
3.9.1 Manual practice
When a construction project is completed, the documents produced and stored during the project are of varying in-
terest for the future. Some can be directly disposed of, others contain knowledge that can be reused in other projects,
while a third category is documents to be kept and used during the maintenance phase. Sorting can be done by tabs
in the project binder or drawers for sketches and drawings. A similar structure for storing and classifying documents
during the construction and maintenance phases, respectively, facilitates the management of documents during the
entire lifecycle of a building.
3.9.2 Computer-aided equivalent
The sorting of documents can be done efficiently in much the same way, using file structures and metadata. Never-
theless, the long-term readability of documents poses a number of questions concerning the structure of document
sets and compound documents, changing data formats and storage media.
4 Problems in document exchange
4.1 General
Document exchange is conducted frequently during the construction process, as well as during the lifecycle of the
completed building. A number of information problems appear at each exchange stage. The manner in which these
problems are approached often determines whether the document can be efficiently handled and properly used, in
both the short and long term.
Four main problem areas for which information exchange solutions need to be provided can be identified:
— the reading and reproduction of documents (the presentation dimension);
— the identification of related documents (the organizational dimension);
— workflow and the archiving of the document (the life-cycle dimension);
— the connection between documents and parts of the building (the product dimension).
The exchange of metadata between users and systems is yet another problem area.
4.2 Reading and reproduction
A paper-based document can be read without tools other than the reader's senses, but reading a digital document
requires a computer application. When exchanging documents, the receiver must have access to such an applica-
tion, and he or she must also be informed in some way as to which application to use. Also, he or she needs to be
familiar with the structure of the document or document set, as well as how and where it is stored. Metadata in a
standardized format such as pure text is a way of providing such information. Some of these data can refer to national
classification and other industry standards (e.g. document categories).
Furthermore, minor differences, such as application versions, screen and printer-driver software or installed type-
faces can affect the appearance of documents, line breaks, page breaks, etc. If exact reproduction must be guaran-
teed, all such factors have to be controlled. In practice, this cannot be achieved without limiting potential errors, for
example, by choosing a printing format that explicitly describes the exact page layout.
4.3 Organization and relating of documents
When organizing documents related to a project, all participants must agree on a structure for storing and managing
the documents, with special attention given to compound documents and document sets. The structure can be used
©
ISO 2000 – All rights reserved 5

---------------------- Page: 10 ----------------------
ISO/TR 19033:2000(E)
directly by each of the participants, or form an “intermediate structure” used exclusively in a project network with
common storage.
The simplest form of ordering documents for such purposes is the file/directory system. But as soon as there is more
than one way of organizing documents, (e.g. one document is part of two or more document sets), additional infor-
mation has to be provided. The file structure must also be preserved when linked documents are transferred from
one storage place to another. Many communication methods, such as attachments to e-mail messages, do not pro-
vide such mechanisms, but the structure has to be recreated by the recipient.
Under current practice, several methods are combined, ad hoc, for controlling the document structures of digitally
produced and stored documents. A part may be organized in a document management system, but project-specific
manuals, especially for CAD, often play an important role, as do written or verbal agreements. One reason for this is
the incompleteness of most EDMS applications for technical documents, while another is the lack of standards for
the very complex information structures that are often used and the kind of information needed to describe the struc-
tures. The less coordinated the management, the greater the liklihood of errors.
Even more difficult to manage than compound documents consisting of linked files are documents extracted from da-
tabases using various kinds of filters for sorting information. Moreover, there is a need for various kinds of references
and relationships between documents.
4.4 Quality assurance and workflow
Quality assurance within companies is normally subject to strict routines and is set down in manuals. In the project
environment, however, coordinated routines for quality assurance are rare. Fundamental rules for the approval of
documents exist at the national level, but the procedures for coordination of document sets are defined specifically for
each project.
In order to perform a workflow, several pieces of metadata have to be exchanged. The access rights have also to be
controlled, so that every participant can perform the authorized operations on the document, but nothing more. In
many cases this will mean that only certain parts of a compound document ought to be accessible. When a docu-
ment is approved, it should be locked to prevent changes.
4.5 Archiving
For long-term storage, information must be made independent of the person(s) who created it, as well as of the tech-
nical platform (software, hardware and storage medium) used in its creation. Retrieval must be guaranteed through
the use of stable data formats and media. Often, the data will also have to be transformed to accommodate new tech-
nical platforms. The same applies for the information within documents and the metadata used for document man-
agement.
All information needed to search for and retrieve a document must be explicit to a degreee unnecessary during the
project. Additionally, the long lifecycle of buildings often makes it necessary to adapt the information to the user’s ex-
isting storage systems.
4.6 Connection to product
In general, technical documents describe products. For production as well as maintenance purposes, a specific part
or position in the building is a primary search path to documents. The document-management system must provide
connections between specific parts of the building, as well as between product categories and other references.
4.7 Exchange of metadata
Most document-management systems use proprietary solutions for the structuring of metadata, and many also use
them for the format for storing metadata. In a temporary organization such as a construction project, it is of vital im-
portance that the information systems involved be able to exchange information. The demand for neutral formats and
standardized definitions for metadata is obvious.
©
6 ISO 2000 – All rights reserved

---------------------- Page: 11 ----------------------
ISO/TR 19033:2000(E)
A parallel can be found in the CAD domain, where the use of proprietary systems for many years constituted an ob-
stacle to their more widespread use in the construction sector. Not until industry standards for exchange were estab-
lished did CAD become accepted for all kinds and sizes of projects. It can be assumed that the slow introduction of
EDMS in the construction sector has similar causes, and even to a greater extent, as document management is pri-
marily a tool for communication and collaboration rather than the production of documents.
5 State-of-the-art document management
5.1 Environments
Different overall purposes and preconditions for document management can be distinguished by considering the en-
vironment in which the document management is to be implemented. One kind of environment is the relatively stable
context of a company or other organization. Another is the temporary production set-up of a project. Yet another is
the source environment for knowledge to be used in companies as well as project groups. In 5.2, EDMS applications
within these three environments are presented, including examples of practice. The solutions include a variety of
technologies, whose main approaches are given.
5.2 Six technological approaches to document management
5.2.1 General
Present and evolving technology offers several levels of implementation according to the type of information handled
by the system. Requirements for document management can be satisfied to varying extents. For each level the gen-
eral functionality is briefly described in Table 1.
Table 1 — Levels of document management and functionality
Model-based EDMS
Documents extracted from models
Table of contents for documents, models and objects
Document search by any properties of the model objects
Access control by DBMS, on object level
Revision management for objects or documents
Reports freely defined
Dependency network-based EDMS
Change management through document dependencies
Table of contents for documents and links, network or hierarchical
Document search related document parts
Access control operating system or application
Revision management for document and related document parts
Reports defined by system functions
...

Questions, Comments and Discussion

Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.