Skip to content

Commit ac85505

Browse files
ronaldtseronaldtse
committed
feat: update 5005: update document and provide schemas and new examples
1 parent ce60618 commit ac85505

6 files changed

Lines changed: 93 additions & 113 deletions

File tree

‎sources/express-changes/document.adoc‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,4 +40,6 @@ include::sections/06-mapping-change.adoc[]
4040

4141
include::sections/aa-examples.adoc[]
4242

43+
include::sections/ab-schemas.adoc[]
44+
4345
include::sections/az-bibliography.adoc[]

‎sources/express-changes/examples/arm.changes.yaml‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# yaml-language-server: $schema=https://www.expresslang.org/schemas/changes/v1/schema_changes.yaml
2+
---
3+
schema: Document_and_version_identification_arm
4+
editions:
5+
- version: '2'
6+
- version: '3'

‎sources/express-changes/examples/mapping.changes.yaml‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# yaml-language-server: $schema=https://www.expresslang.org/schemas/changes/v1/mapping_changes.yaml
2+
---
3+
schema: dimension_tolerance
4+
editions:
5+
- version: '6'
6+
mappings:
7+
- description: Geometric_dimension entity and attributes mapping has been updated
8+
- description: Angle_plus_minus_bounds and Length_plus_minus_bounds mappings was
9+
added
10+
- version: '7'
11+
mappings:
12+
- description: Angle_plus_minus_bounds mapping has been updated
13+
- description: Length_plus_minus_bounds mapping has been updated
14+
- description: Applied_activity_assignment ENTITY mapped
15+
- version: '8'
16+
mappings:
17+
- description: Geometric_dimension entity and attributes mapping has been updated

‎sources/express-changes/examples/mim.changes.yaml‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# yaml-language-server: $schema=https://www.expresslang.org/schemas/changes/v1/schema_changes.yaml
2+
---
3+
schema: Document_and_version_identification_mim
4+
editions:
5+
- version: '2'
6+
deletions:
7+
- type: USE_FROM
8+
name: Product_identification_mim
9+
- version: '3'
10+
additions:
11+
- type: USE_FROM
12+
name: product_definition_schema
13+
interfaced_items:
14+
- product_category
15+
- product_related_product_category

‎sources/express-changes/examples/support_resource_schema.changes.yaml‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# yaml-language-server: $schema=https://www.expresslang.org/schemas/changes/v1/schema_changes.yaml
2+
---
3+
schema: support_resource_schema
4+
editions:
5+
- version: '2'
6+
description: |-
7+
The definitions of the following EXPRESS entity data types were modified:
8+
9+
* identifier;
10+
* label;
11+
* text.
12+
additions:
13+
- type: FUNCTION
14+
name: type_check_function
15+
modifications:
16+
- type: FUNCTION
17+
name: bag_to_set
18+
- version: '4'
19+
description: |-
20+
The following entity types had been introduced to support external element references outside the local population of entity instances:
21+
22+
* component_path_shape_aspect;
23+
* externally_defined_item_with_multiple_references;
24+
* generic_product_definition_reference;
25+
* product_definition_reference;
26+
* product_definition_reference_with_local_representation.
27+
28+
The following entity types had been introduced to support the the characterization of objects:
29+
30+
* characterized_chain_based_item_within_representation;
31+
* characterized_item_within_representation;
32+
* characterized_product.
33+
34+
The following select types from the basic_attribute_schema had been converted into extensible selects and then extended in several other schemas:
35+
36+
* description_attribute_select;
37+
* id_attribute_select;
38+
* name_attribute_select;
39+
* role_select.
40+
modifications:
41+
- type: FUNCTION
42+
name: type_check_function

‎sources/express-changes/sections/aa-examples.adoc‎

Lines changed: 11 additions & 113 deletions
Original file line numberDiff line numberDiff line change
@@ -7,138 +7,36 @@ This annex provides example of the EXPRESS Changes YAML format.
77

88
=== Schema change
99

10-
This example shows schema changes made to a resource schema,
11-
`support_resource_schema` across two editions: version 2 and version 4.
10+
This example shows schema changes made to the `support_resource_schema`, a
11+
resource schema.
1212

1313
[source,yaml]
1414
----
15-
---
16-
schema: support_resource_schema
17-
editions:
18-
- version: '2'
19-
description: |-
20-
The definitions of the following EXPRESS entity data types were modified:
21-
22-
* identifier;
23-
* label;
24-
* text.
25-
additions:
26-
- type: FUNCTION
27-
name: type_check_function
28-
modifications:
29-
- type: FUNCTION
30-
name: bag_to_set
31-
- version: '4'
32-
description: |-
33-
The following entity types had been introduced to support external element references outside the local population of entity instances:
34-
35-
* component_path_shape_aspect;
36-
* externally_defined_item_with_multiple_references;
37-
* generic_product_definition_reference;
38-
* product_definition_reference;
39-
* product_definition_reference_with_local_representation.
40-
41-
The following entity types had been introduced to support the the characterization of objects:
42-
43-
* characterized_chain_based_item_within_representation;
44-
* characterized_item_within_representation;
45-
* characterized_product.
46-
47-
The following select types from the basic_attribute_schema had been converted into extensible selects and then extended in several other schemas:
48-
49-
* description_attribute_select;
50-
* id_attribute_select;
51-
* name_attribute_select;
52-
* role_select.
53-
modifications:
54-
- type: FUNCTION
55-
name: type_check_function
15+
include::../examples/support_resource_schema.changes.yaml[]
5616
----
5717

58-
This example shows schema changes made to the ARM `Analytical_model_arm` schema
59-
across several editions: version 2, version 3, version 4, and version 5.
18+
This example shows schema changes made to the ARM
19+
`Document_and_version_identification_arm` schema.
6020

6121
[source,yaml]
6222
----
63-
---
64-
schema: Analytical_model_arm
65-
editions:
66-
- version: '2'
67-
additions:
68-
- type: TYPE
69-
name: am_property_assignment_select
70-
modifications:
71-
- type: TYPE
72-
name: model_parameter_type
73-
- type: ENTITY
74-
name: Analytical_model
75-
- type: ENTITY
76-
name: Analytical_model_application
77-
- type: ENTITY
78-
name: Analytical_model_parameter
79-
- type: ENTITY
80-
name: Digital_analytical_model_port
81-
- type: ENTITY
82-
name: Digital_analytical_model_vector_port
83-
deletions:
84-
- type: USE_FROM
85-
name: Specification_document_arm
86-
- type: REFERENCE_FROM
87-
name: product_identification_arm
88-
interfaced_items:
89-
- types_of_product
90-
- version: '3'
91-
additions:
92-
- type: TYPE
93-
name: am_parameter_assignment_select
94-
modifications:
95-
- type: ENTITY
96-
name: Transform_port_variable
97-
- version: '4'
98-
description: The name of the Application Object Analog_port_variable was changed
99-
to Port_variable.
100-
- version: '5'
101-
additions:
102-
- type: USE_FROM
103-
name: Part_template_arm
104-
- type: ENTITY
105-
name: reference_part_template_for_analytical_model
23+
include::../examples/arm.changes.yaml[]
10624
----
10725

108-
This example shows schema changes made to the MIM `Analytical_model_mim` schema
109-
across two editions: version 4 and version 5.
26+
This example shows schema changes made to the MIM
27+
`Document_and_version_identification_mim` schema.
11028

11129
[source,yaml]
11230
----
113-
---
114-
schema: Analytical_model_mim
115-
change_edition:
116-
- version: '4'
117-
deletions:
118-
- type: ENTITY
119-
name: analog_port_variable
120-
- version: '5'
121-
additions:
122-
- type: USE_FROM
123-
name: Part_template_mim
31+
include::../examples/mim.changes.yaml[]
12432
----
12533

12634

12735
=== Mapping change
12836

129-
This example shows mapping changes made to the `product_as_individual_assembly_and_test`
130-
schema across two editions: version 2 and version 5.
37+
This example shows mapping changes made to the `dimension_tolerance` mapping.
13138

13239
[source,yaml]
13340
----
134-
---
135-
schema: product_as_individual_assembly_and_test
136-
editions:
137-
- version: '2'
138-
mappings:
139-
- description: Applied_activity_assignment mapping updated
140-
- description: Applied_process_operation_occurrence mapping updated
141-
- description: Applied_test_activity mapping updated
142-
- version: '5'
143-
description: Mapping specifications updated.
41+
include::../examples/mapping.changes.yaml[]
14442
----

0 commit comments

Comments
 (0)