Technical Minutes 2020 01 31 - adewg/ICAR GitHub Wiki

ICAR Animal Data Exchange Working Group – Technical meeting 31 January 2020

  • Apologies: Kor, David, Conny, Beate, Henning
  • In attendance: Andrew, Andreas, Anton, Arjan, Bert, Erwin, John, Sven.

1. Open source licence (GitHub issue 10)

  • Noted that the Apache 2.0 Licence has been approved by the full Working Group, by ICAR management, and by almost all contributors. Waiting on one more confirmation, then will publish on GitHub.

2. Heat Event (GitHub issue 58)

  • Agreed to the proposal except a small capitalisation change.
  • Discussed the Device Reference type
  • Decided to add Accelerometer to the enumeration.

3. Device API (GitHub issue 59)

  • Agreed to the proposal with no further changes
  • Noted that supported messages are the JSON message names - e.g. icarMilkingVisitEventResource.

4. Test Messages (GitHub issue 13)

  • Noted the good work that Anton has done to create an example application and example data.

Example data

  • Anton is happy to contribute the example data (he has created examples for Finland), breaking these into files.
  • Swagger does not support displaying any external referencing data in the Swagger UI (noted in issue).
  • Decided to put the example data into separate files, and reference these from Swagger even though they will not display nicely in the UI.

Example application

Anton currently runs this in a free Azure environment. The source code could potentially be made available as it is in Azure DevOps. It would not be suitable for a heavy load.

Example OpenAPI specification

  • Should the example be kept in a single file with tags, or broken into separate OpenAPI files for groups of related messages or GET vs updates?
  • We thought it good to break into separate files, will see how motivated people are to do this.

5. Webinar on the ICAR ADE specifications

  • The committee discussed Bert's provisional agenda and proposed dates (21 and 22 April).
  1. Welcome and introduction (Andrew)
  2. Explain the messages that have been defined (Erwin)
  3. Demonstrate the prototype (Anton)
  4. Demonstrate how this works in the JoinData exchange (Arjan)
  5. Allow up to 30 minutes for questions.
  • Johannes will send an invite.
  • Sven suggested asking the participants at the end of the meeting if they would like an additional and more detailed webinar on a specific topic. We all agreed.
  • We want to have a practice prior to the meeting, suggested 2 April.
  • Andrew to have a slide with working group members and manufacturers collaborating in testing

6. Requests for timing of the 1.0 release

  • We have a release candidate and messages under development - when will we announce the first release? Are Heat, Device, Weight the remaining messages before 1.0?
  • Will need to have a process of managing and announcing addition of new messages after 1.0.
  • Recommended V 1.0 should include existing Milking Visit, Reproduction, Movement and Registration, Weight, Device, Heat.
  • Need to ensure Swagger files are the way we want them.

7. Preparation for next meeting 14 February

  1. What is missing for V 1.0 release?
  2. Cow Lactation Event (Erwin to prepare proposal)
  3. Finalise Weight issue (Andrew seeking advice)
  4. Versioning strategy and announcements for later versions.
  5. Recommended URL scheme, and how breaking versions might be handled. Noted that the next meeting will be an hour later (9am CET rather than 8am CET).