Public Page

2021-08-03 Architecture Meeting Minutes

Owned by Paulette Reed
Aug 03, 2021
3 min read

Public Page

 

      
   CIECA 500 Westover Dr  #11617; Sanford,  NC  27330 

 

Date

Aug 3, 2021

ANTITRUST STATEMENT

As participants in this meeting, we need to be mindful of the constraints of antitrust laws. There shall be no discussions of agreements or concerted actions that may restrain competition. This prohibition includes the exchange of information concerning individual prices, rates, coverages, market practices, claims settlement practices, or any other competitive aspect of an individual company’s operation. Each participant is obligated to speak up immediately for the purpose of preventing any discussion falling outside these bounds.

Agenda

  • Antitrust and Meeting minutes acceptance

  • Clarify last week notes about moving Properties to the schema instead of BMS

  • Recap work meeting progress

  • Work on VIN Decoder API

  • Work on Common Aggregates

Meeting Minutes

  • Antitrust Accepted

  • Meeting Minutes Accepted

  • The BMS information being moved to the Schema

    • The Description from the BMS can be moved to the schema and the Field Attributes and size are there already.

    • At this time there is the BMS, Word document with this information. Will we use Word to document the APIs.

      • We will try to use API tools and documentation techniques, which means we will be staying away from Word documents.

    • A reason to leave the descriptions out is because of the size that it will add to the schema.

      • We do not want the schemas to be large and cumbersome and complex

      • The idea of adding simple descriptions that follow the same pattern, would be good to have in the schema, we just need to make sure they are simple and concise.

    • When we translate from YAML to JSON; maybe we can can strip them out. So they would not be in the JSON Open API code.

    • We also want to make sure not to include Code List that are not used in the schema.

  • Bundling

    • JSON schemas based on CIECA standards but making sure they are simplified.

    • The XML seemed to be a good process but looking at the XML compared to the JSON and REST world, they are very large.

    • We want to make our CIECA CAPIS messages as simplified and small as we can make them.

    • We mentioned removing code list that are not used from the schema, but we should also look at removing sections of code list that are not used. For example, we have over 400 Country Codes in the Country Code Code List; however, we use US and Canada in most transactions.

    • Dan has been digging into the structuring of Complex Schemas using Bundling. The concept is that you would have a JSON File/Object for every property you were going to include in the schema and would use $ref to bring the properties into the schema.

      • The Committee Members like the thought of having the property, such as Address defined once and using it for all the schemas.

      • Dan is going to work on the examples he has been working on and plans to present the concept to the committee next week.

  • Review of Working Session

    • We successfully mapped GitHub to Stoplight

    • We walked through the Stoplight and GitHub changes

Great Meeting everyone

Up Next

  • Antitrust and Meeting minutes acceptance

  • Continue working with Stoplight for Vin Decoder

  • Common Aggregates

 

Participants

  • Paulette Reed (Scribe)

  • Andy Bober

  • Dan Webster

  • Mike Hastings

  • Paul Barry

  • Jeff Schroder

Participants in the meetings are noted for your information.  If you have questions on the committee’s activities, please contact a recent attendee. Architecture Committee