Background

W3C XML Schema patterns

There are four well-knows XML Schema design patterns. They are:

• Russian Doll

• Garden of Eden

• Salami Slice

• Venetian Blind

These patterns are referenced in this document. Useful resources for understanding them include:

• https://www.balisage.net/Proceedings/vol25/print/Bruggemann-Klein01/BalisageVol25-Bruggemann-Klein01.html

• Introducing Design Patterns in XML Schemas (oracle.com)

• XML Schema Design Patterns · Saumil Patel

OAGIS maintenance approach and release packages

OAGIS 10.6

OAGi manually maintained OAGIS versions through version 10.6. last manually-maintained version. OAGIS 10.6 was offered in four release packages (“editions”):

• Enterprise

• Platform PATTERN

• Standalone-PATTERN

• Standalone-PATTERN

OAGIS 10.7 and later

Beginning with OAGIS 10.7, OAGi began maintaining OAGIS with Score. OAGi ceased to advertise availability of any XML Schema expressions of OAGIS while quietly making the Platform and Standalone-PATTERN editions available to members on request.

Miscellaneous

1. What XML Schema design patterns are possible with JSON schema?

2. Use of the word “canonical”

Use cases

Use case 1

JSON schema of entire model in one file.

Use case 2

JSON schema of entire model in one file per component with the set of files zipped.

Use case 4

XML schema of each component tagged noun in one file each with the set of files zipped.

Use case 5

XML file of entire model.

Use case 6

Entire model expressed as Hugo-formatted documentation

API design

API parameters

1. Model subset: What part of the model needs to be expressed?

   1. All

   2. A root component (e.g., BOM)

   3. A set of root components (e.g., BOM, ProcessPurchaseOrder, NotifyShipment)

   4. All components with a specified tag (e.g., noun)

2. Expression type: What is the expression type? (Is there a better name for this other than “expression type”?)

   1. XML Schema

   2. JSON Schema

   3. OAS? (Jim doesn’t think this makes sense)

   4. XMI

   5. Documentation

   6. OWL?

   7. RDF Schema?

3. Pattern: For some expression types, what is the pattern (e.g., Garden of Eden)

4. File system structure: For some expression types, what is the file/folder naming conventions and structure

5. Internal file organization: For some expression types, how content is organized within files. (e.g., Within XML schemas list element declarations first in alphabetical order followed by type definitions in alphabetical order)