Transition plan for Annotations

Development work to prep AP, snowstorm, release systems, etc

• MAINT-2493 - Annotations: Change annotations refset column languageCode to languageDialectCode (this relates to content stored in the Terminology Server, rather than the column headings in the file) - complete
• INFRA-12849 - Annotations: Change annotations refset column languageCode to languageDialectCode - complete
• INFRA-12258 - Add attribution to Orphanet - in progress
• INFRA-12737 and INFRA-12763 these relate to the data type metadata we declare for these two refsets in the Refset Descriptor - now complete.

PWI will be starting to add attributions to Production w/b 13 May 2024 and we also need to test out a release that pulls refset descriptor changes from Snowstorm rather than an externally maintained S3 folder.

Changes to the Annotations Refset format:

• The languageCode field was specified as the two characters of ISO-639-1 code for the language of the annotation text.
  • The change is to include support for specifying dialect when it is applicable by adhering to RFC 5646.
  • This allows the combination of two characters of ISO 639-1 code and two uppercase letters of country code (ISO 3166) separated by a hyphen.
• The "languageCode" will be changed to "languageDialectCode" in the field column of BOTH REFSETS. (see INFRA-12849 - Getting issue details... STATUS )
  • The metadata concept 1304275002 |Language or dialect code (foundation metadata concept)| will be used for the metadata of this column in the descriptor refset.
• The changes will apply to both the Member Annotation String Value reference set + Component Annotation String Value reference set

Fixes to the refsetDescriptor records (see INFRA-12737 for details):

• 1. The AttributeType for the 0 refsetDescriptor record for both Member + Component Annotations needs to be changed from:
  • 900000000000461009 |Concept type component|
    • to
  • 900000000000460005 |Component type (foundation metadata concept)|
  • (see comments in 5.2.4.9 Member Annotation String Value Reference Set + https://jira.ihtsdotools.org/browse/INFRA-12763 for details)
• .
• 2. The languageDialect column for a) the 3 refsetDescriptor record for Member Annotations + b) the 2 refsetDescriptor record for Component Annotations
• , needs to be changed from:
  • 1296895003 |Language code (foundation metadata concept)|
    • to the new concept
  • 1304275002 |Language or dialect code (foundation metadata concept)|
  • (see comments in https://jira.ihtsdotools.org/browse/MAINT-2493)
  • .
• 3. The AttributeType for a) the 4 refsetDescriptor record for Member Annotations + b) the 3 refsetDescriptor record for Component Annotations , needs to be changed from:
  • 900000000000459000 (AttributeType)
    • to
  • 900000000000465000 (String)
  • (see comments in https://ihtsdo.freshdesk.com/a/tickets/49483)
  • They are correct in the following Docs, but the entries in the descriptor records are incorrect and need correcting.  
    • https://confluence.ihtsdotools.org/display/WIPRELFMT/5.2.4.9+Member+Annotations+String+Value+Reference+Set + 
    • https://confluence.ihtsdotools.org/display/WIPRELFMT/5.2.4.8+Component+Annotations+String+Value+Reference+Set