Functional requirement

VSS item

GraphQL correspondance

•  Model can be specified in multiple files.

Include

•  Human-friendly context is provided.

Concatenated path

• docs/_TYPE
• Hierarchy outside GraphQL (context, field...)

•  Properties can be grouped. Hierarchical concept scheme to group properties belonging to the same area of interest is supported.

Branch type

Aggregate

Struct

• type based
• grouping is implicit

•  Properties whose values do not change often can be specified.

Attribute type

• A field is specified.

•  Properties whose value might change often can be specified as observable or actuatable.

Sensor type

Actuator type

• A field is specified. The associated value is assigned with the instance data

•  Definitions can be reused when there are multiple occurrences.

Instances

• It is possible to specify that a field can have multiple instances. 

  enum CarDoorPosition {
    FRONT_L
    FRONT_R
    REAR_L
    REAR_R
  }
  
  type Car {
    id: ID!
    make: String!
    model: String!
    doors: [CarDoor!]!
  }
  
  type CarDoor {
    id: ID!
    position: CarDoorPosition!
  }

•  Arrays or lists are supported.

Arrays (i.e., datatype[])

• supported by the language with [ ]
  

  type Vehicle {
    id: ID!
    make: String!
    model: String!
    doors: [String!]!
  }

•  Extended list of primitive datatypes is supported.

(u)intX, boolean, float, double, string

• Custom scalars can be defined as an extension. In the GraphQL schema we might have something like:
  

  scalar Int8 @specifiedBy(url: "xsd:byte")
  scalar UInt8 @specifiedBy(url: "xsd:unsignedByte")
  scalar Int16 @specifiedBy(url: "xsd:short")
  scalar UInt16 @specifiedBy(url: "xsd:unsignedShort")
  scalar UInt32 @specifiedBy(url: "xsd:unsignedInt")
  scalar Int64 @specifiedBy(url: "xsd:long")
  scalar UInt64 @specifiedBy(url: "xsd:unsignedLong")
  
  # Here xsd is the namespace <http://www.w3.org/2001/XMLSchema#>.

•  Units and quantity kind can be specified.

Unit

Dimension

• via types and enums

typeDrivingJourney {
driver: Person!
passengers: [Person!]
vehicle: Vehicle!
road: [Road]
maxSpeed(unit: SpeedUnit = KILOMETERS_PER_HOUR): Float
}

enumSpeedUnit {
KILOMETERS_PER_HOUR
MILES_PER_HOUR
}

•  Default values can be specified.

Default

• handling of default values depends on your server-side implementation
• It can be added for informative purposes as a comment in the schema

•  Allowed values can be specified.

allowed: [‘value1’, ..., ‘valueN’]

• Use enums
  

  enum Color {
    RED
    GREEN
    BLUE
  }
  
  type Car {
    id: ID!
    make: String!
    model: String!
    color: Color!
  }

•  A custom redefinition of the concepts is possible.

Overlay

• schema stiching
• schema extension

•  Min and max expected values can be specified.

min: 0

max: 100

• custom scalar type and directive
• implementation of the necessary validation logic on the server-side
• Alternative: include the information in the comment.

•  Concepts in the model can evolve.

deprecation

• @deprecated directive

•  Model can be specified in multiple files.

Include

• It is possible to specify schema across multiple files.
• Command Line tool has to include all files/links.