From 091c1dd9c7f07b77c2922dff8570aab68a82cc45 Mon Sep 17 00:00:00 2001 From: Pasi Paasiala Date: Tue, 5 Aug 2014 14:36:13 +0300 Subject: [PATCH 1/6] Improved documentation for the root and markup. --- Documentation/README.md | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) diff --git a/Documentation/README.md b/Documentation/README.md index 88c87399..5ea85363 100644 --- a/Documentation/README.md +++ b/Documentation/README.md @@ -29,14 +29,15 @@ Globally Unique ID in the IFC format. This format is used only when referring to * This document describes the BCF format that is used to exchange topics, such as, issues, scenes, etc. between different BIM software. ### BCF file structure -In the root of the BCF file is an XML file defining project related information. The name of this file is project.xml. This file follows the project.xsd schema. - -A BCF file is a zip containing one folder for each topic. The folder name is the GUID of the topic. This GUID is in the UUID form. The folder contains the following files: +A BCF file is a zip containing one folder for each topic. The root of the BCF zip contains the following files. * project.bcfp (optional) - - An XML file referencing the extension.xsd to a project. + - An XML file referencing the extension.xsd to a project. The schema for this file is project.xsd. * bcf.version * An XML file following the version.xsd schema with information of the BCF schema used. The file content should be identical to the contents of [bcf.version](bcf.version "bcf.version") + +The folder name is the GUID of the topic. This GUID is in the UUID form. The folder contains the following files: + * markup.bcf * An XML file following the markup.xsd schema that is described below. * viewpoint.bcfv @@ -103,9 +104,22 @@ In addition it has the following nodes: Element | Optional | Description | :-----------|:------------|:------------ -ReferenceLink | Yes | Reference to the topic in, for example, a work request management system. Title | No | Title of the topic. +Guid | No | The topic identifier +ReferenceLink | Yes | Reference to the topic in, for example, a work request management system. +Description | Yes | Description of the topic +Priority | Yes | Topic priority. The list of possible values are defined in the extension schema Index | Yes | Number to maintain the order of the topics. +CreationDate | Yes | Date when the topic was created +CreationAuthor | Yes | User who created the topic +ModifiedDate | Yes | Date when the topic was last modified +ModifiedAuthor | Yes | User who modified the topic +AssignedTo | Yes | The user to whom this topic is assigned to +BimSnippet | Yes | BimSnippet related to the project +DocumentReference | Yes | List of references related to the topic +TopicType | Yes | The type of the topic (the options can be specified in the extension schema) +TopicStatus | Yes | The status of the topic (the options can be specified in the extension schema) + ### BimSnippet (optional) BimSnippet is an additional file containing information related to one or multiple topics. For example, it can be an IFC file containing provisions for voids. @@ -278,4 +292,3 @@ The Color in Component node in visualization is used specify a custom color for - From 0a872fed0438e47e1ba753b1c270a99eb47d820f Mon Sep 17 00:00:00 2001 From: Pasi Paasiala Date: Tue, 5 Aug 2014 14:49:33 +0300 Subject: [PATCH 2/6] Removed duplicate documentation of BimSnippet and DocumentReference. Synchronized Comment documentation with the schema. --- Documentation/README.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/Documentation/README.md b/Documentation/README.md index 5ea85363..6cd27430 100644 --- a/Documentation/README.md +++ b/Documentation/README.md @@ -115,8 +115,6 @@ CreationAuthor | Yes | User who created the topic ModifiedDate | Yes | Date when the topic was last modified ModifiedAuthor | Yes | User who modified the topic AssignedTo | Yes | The user to whom this topic is assigned to -BimSnippet | Yes | BimSnippet related to the project -DocumentReference | Yes | List of references related to the topic TopicType | Yes | The type of the topic (the options can be specified in the extension schema) TopicStatus | Yes | The status of the topic (the options can be specified in the extension schema) @@ -173,9 +171,9 @@ Date | No | Date of the comment Author |No | Comment author Comment | No | The comment text Topic | No | Back reference to the topic GUID. -AuthorEmail | No | Email address of the comment author. -Priority | Yes | Priority of the comment (Predefined list in “extension.xsd”) - +ReplyToComment | Yes | Guid of the comment to which this comment is a reply +ModifiedDate | Yes | The date when comment was modified +ModifiedAuthor | Yes | The author who modified the comment ### Viewpoints The markup file can contain multiple viewpoints related to one or more comments. A viewpoint has also the Guid attribute for identifying it uniquely. In addition, it has the following nodes: From 7fccb5675d3522f2209559cf70931b1c33e137f8 Mon Sep 17 00:00:00 2001 From: Pasi Paasiala Date: Wed, 6 Aug 2014 13:18:49 +0300 Subject: [PATCH 3/6] Improve documentation for color. --- Documentation/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/README.md b/Documentation/README.md index 6cd27430..e9ddb451 100644 --- a/Documentation/README.md +++ b/Documentation/README.md @@ -198,7 +198,7 @@ Attribute | Optional | Description | IfcGuid | Yes | Select the component in a BIM tool Selected | Yes | This flag is true if the component is actually involved in the topic. If the flag is false, the component is involved as reference. Visible | Yes | This flag is true when the component is visible in the visualization. By setting this false, you can hide components that would prevent seeing the topic from the camera position and angle of the viewpoint. -Color | Yes | Color of the component. This can be used to provide special highlighting of components in the viewpoint. +Color | Yes | Color of the component. This can be used to provide special highlighting of components in the viewpoint. The color is given in ARGB format. In addition, it has the following information: From 2806354b97cab35033d9d03f0f25fadb1846f64f Mon Sep 17 00:00:00 2001 From: Pasi Paasiala Date: Wed, 6 Aug 2014 14:12:46 +0300 Subject: [PATCH 4/6] Added folder structure for test cases. --- Test Cases/Markup/README.md | 1 + Test Cases/Project/README.md | 1 + Test Cases/README.md | 16 ++++++++++++++++ Test Cases/Real World/README.md | 1 + Test Cases/Visualization/README.md | 1 + 5 files changed, 20 insertions(+) create mode 100644 Test Cases/Markup/README.md create mode 100644 Test Cases/Project/README.md create mode 100644 Test Cases/README.md create mode 100644 Test Cases/Real World/README.md create mode 100644 Test Cases/Visualization/README.md diff --git a/Test Cases/Markup/README.md b/Test Cases/Markup/README.md new file mode 100644 index 00000000..07871192 --- /dev/null +++ b/Test Cases/Markup/README.md @@ -0,0 +1 @@ +This folder contains test cases that mainly deal with textual information, Title, Description, Comments, etc. diff --git a/Test Cases/Project/README.md b/Test Cases/Project/README.md new file mode 100644 index 00000000..32396afb --- /dev/null +++ b/Test Cases/Project/README.md @@ -0,0 +1 @@ +This folder contains test cases with examples of using extension schema diff --git a/Test Cases/README.md b/Test Cases/README.md new file mode 100644 index 00000000..0dfdf751 --- /dev/null +++ b/Test Cases/README.md @@ -0,0 +1,16 @@ +# Test Case Instructions + +This folder contains test cases for testing BCF 2.0 file exchange. Each test case should meet the following requirements: + +* Simplicity: Test case should test one thing at a time +* Completeness: All necessary files need (e.g. IFC and BCFZIP) files need to be available +* Documentation: Document describing the test case must be provided, preferably with images + +To provide test cases, create a fork of the repository, commit your test cases there and create a pull request. + +The test cases are divided in the following folders depending on their primary focus: + +* Markup: Test cases that mainly deal with textual information, Title, Description, Comments, etc. +* Visualization: Test Cases that deal with visualization +* Project: Examples of using extension schema +* Real world: Examples of real world test cases \ No newline at end of file diff --git a/Test Cases/Real World/README.md b/Test Cases/Real World/README.md new file mode 100644 index 00000000..24738677 --- /dev/null +++ b/Test Cases/Real World/README.md @@ -0,0 +1 @@ +This folder contains examples of real world test cases. When providing IFC files, please zip them. \ No newline at end of file diff --git a/Test Cases/Visualization/README.md b/Test Cases/Visualization/README.md new file mode 100644 index 00000000..295695ed --- /dev/null +++ b/Test Cases/Visualization/README.md @@ -0,0 +1 @@ +This folder contains test cases that deal with visualization From afbc8eaf8483a5f6267a7b18536cbcce9dcb6b6a Mon Sep 17 00:00:00 2001 From: Pasi Paasiala Date: Tue, 26 Aug 2014 08:12:39 +0300 Subject: [PATCH 5/6] Improved documentation regarding viewpoint and snapshot files. --- Documentation/README.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/Documentation/README.md b/Documentation/README.md index e9ddb451..f79e0482 100644 --- a/Documentation/README.md +++ b/Documentation/README.md @@ -42,10 +42,10 @@ The folder name is the GUID of the topic. This GUID is in the UUID form. The fol * An XML file following the markup.xsd schema that is described below. * viewpoint.bcfv * An XML file following the visinfo.xsd schema that is described below (for compatibility with BCF 1.0). - * Multiple viewpoints are possible in BCF 2.0. Names of these files are not predefined. + * Multiple viewpoints are possible in BCF 2.0. Names of these files are not predefined. Note: One viewpoint needs to be be named viewpoint.bcfv even in the case of multiple viewpoints. * snapshot.png * A snapshot related to the topic (for compatibility with BCF 1.0). -Multiple snapshots are possible in BCF 2.0. Names of these files are not predefined. +Multiple snapshots are possible in BCF 2.0. Names of these files are not predefined. Note: One snapshot needs to be named snapshot.png even in the case of multiple viewpoints. *Note: The elements in the XML files must appear in the order given in the schemas and described below.* @@ -289,4 +289,3 @@ The Color in Component node in visualization is used specify a custom color for - From 7eacb51adb656dbc8f5c6ca82fc879544b10d79d Mon Sep 17 00:00:00 2001 From: Pasi Paasiala Date: Wed, 27 Aug 2014 12:48:58 +0300 Subject: [PATCH 6/6] Removed outdated AssignedTo documentation. --- Documentation/README.md | 10 ---------- 1 file changed, 10 deletions(-) diff --git a/Documentation/README.md b/Documentation/README.md index f79e0482..a37bfc80 100644 --- a/Documentation/README.md +++ b/Documentation/README.md @@ -147,18 +147,9 @@ ReferencedDocument | Yes | URI to document.
IsExternal=false “..\example Description | Yes | Description of the document - ### RelatedTopics (optional) Relation between topics (Clash -> PfV -> Opening) -### AssignedTo (optional) -A topic can be assigned to a person. - -Element | Optional | Description | -:-----------|:------------|:------------ -AssignedToEmail | Yes | The email-address of the person the topic is assigned to -AssignedToName | Yes | The name of the person the topic is assigned to - ### Comment The markup file can contain comments related to the topic. Their purpose is to record discussion between different parties related to the topic. Comment has also the Guid attribute for identifying it uniquely. In addition, it has the following nodes: @@ -288,4 +279,3 @@ The Selected flag in Component node in visualization is used as a hint to the vi The Color in Component node in visualization is used specify a custom color for a given component. When the flag is true, the component is considered visible, the values of Visible and Selected flags can be ignored and they don't need to be exported. -