MODFQMMGR-1053 Add FQM config

mweaver-ebsco · mweaver-ebsco · commit 98fd658f701d · 2026-03-31T15:15:51.000-05:00
diff --git a/fqm-config.toml b/fqm-config.toml
@@ -0,0 +1,53 @@
+[metadata]
+team = "spitfire"
+domain = "other"
+module = "mod-notes"
+
+[[sources]]
+name = "note"
+table = "note"
+
+[[sources]]
+name = "link"
+table = "link"
+
+[[sources]]
+name = "note_link"
+table = "note_link"
+
+[[sources]]
+name = "note_type"
+table = "type"
+
+[[entityTypes]]
+name = "note"
+source = "note"
+schema = "src/main/resources/fqm/schemas/note.yaml"
+permissions = ["notes.collection.get"]
+sort = ["id", "ASC"]
+includeJsonbField = false
+fieldExclusions = ["type", "links"]
+
+[[entityTypes]]
+name = "link"
+source = "link"
+schema = "src/main/resources/fqm/schemas/link.yaml"
+permissions = ["note.links.collection.get"]
+sort = ["id", "ASC"]
+includeJsonbField = false
+
+[[entityTypes]]
+name = "note_link"
+source = "note_link"
+schema = "src/main/resources/fqm/schemas/noteLink.yaml"
+permissions = ["note.links.collection.get"]
+sort = ["note_id", "ASC"]
+includeJsonbField = false
+
+[[entityTypes]]
+name = "note_type"
+source = "note_type"
+schema = "src/main/resources/fqm/schemas/noteType.yaml"
+permissions = ["note.types.collection.get"]
+sort = ["id", "ASC"]
+includeJsonbField = false
diff --git a/src/main/resources/fqm/schemas/link.yaml b/src/main/resources/fqm/schemas/link.yaml
@@ -0,0 +1,3 @@
+# fqm-tools only accepts a file path in `schema = ...`; it cannot target a nested
+# schema fragment there, so this wrapper bridges to the real runtime schema.
+$ref: '../../swagger.api/schemas/link.yaml#/fqmLink'
diff --git a/src/main/resources/fqm/schemas/note.yaml b/src/main/resources/fqm/schemas/note.yaml
@@ -0,0 +1,3 @@
+# fqm-tools only accepts a file path in `schema = ...`; it cannot target a nested
+# schema fragment there, so this wrapper bridges to the real runtime schema.
+$ref: '../../swagger.api/schemas/note.yaml#/note'
diff --git a/src/main/resources/fqm/schemas/noteLink.yaml b/src/main/resources/fqm/schemas/noteLink.yaml
@@ -0,0 +1,35 @@
+# Unlike the other wrappers, note_link has no runtime schema to point at, so this
+# file defines the FQM-only association shape directly.
+type: object
+title: Note-link association
+description: Association between a note and a link record
+properties:
+  noteId:
+    $ref: '../../swagger.api/schemas/common.yaml#/uuid'
+    description: UUID of the associated note
+    x-fqm-value-getter: ${source}.note_id
+    x-fqm-is-id-column: true # There are 2 ID columns here, matching the table's primary key.
+    x-fqm-visibility: "all"
+    x-fqm-essential: true
+    x-fqm-visible-by-default: true
+    x-fqm-joins-to:
+      - targetModule: mod-notes
+        targetEntity: note
+        targetField: id
+        type: equality-cast-uuid
+  linkId:
+    $ref: '../../swagger.api/schemas/common.yaml#/uuid'
+    description: UUID of the associated link
+    x-fqm-value-getter: ${source}.link_id
+    x-fqm-is-id-column: true # There are 2 ID columns here, matching the table's primary key.
+    x-fqm-visibility: "all"
+    x-fqm-essential: true
+    x-fqm-visible-by-default: true
+    x-fqm-joins-to:
+      - targetModule: mod-notes
+        targetEntity: link
+        targetField: link_id
+        type: equality-cast-uuid
+required:
+  - noteId
+  - linkId
diff --git a/src/main/resources/fqm/schemas/noteType.yaml b/src/main/resources/fqm/schemas/noteType.yaml
@@ -0,0 +1,3 @@
+# fqm-tools only accepts a file path in `schema = ...`; it cannot target a nested
+# schema fragment there, so this wrapper bridges to the real runtime schema.
+$ref: '../../swagger.api/schemas/noteType.yaml#/noteType'
diff --git a/src/main/resources/swagger.api/schemas/common.yaml b/src/main/resources/swagger.api/schemas/common.yaml
@@ -11,28 +11,44 @@ metadata:
       type: string
       format: date-time
       description: Date and time when the record was created
+      x-fqm-value-getter: to_char(${source}.created_date, 'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"')
+      x-fqm-visibility: "all"
+      x-fqm-essential: true
     createdByUserId:
       $ref: '#/uuid'
       description: ID of the user who created the record
+      x-fqm-value-getter: ${source}.created_by
+      x-fqm-visibility: "all"
+      x-fqm-essential: true
     createdByUsername:
       type: string
       description: Username of the user who created the record (when available)
+      x-fqm-ignore: true
     createdBy:
       $ref: '#/userInfo'
       description: Additional information of the user who created the record (when available)
+      x-fqm-ignore: true
     updatedDate:
       type: string
       format: date-time
       description: Date and time when the record was last updated
+      x-fqm-value-getter: to_char(${source}.updated_date, 'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"')
+      x-fqm-visibility: "all"
+      x-fqm-essential: true
     updatedByUserId:
       $ref: '#/uuid'
       description: ID of the user who last updated the record
+      x-fqm-value-getter: ${source}.updated_by
+      x-fqm-visibility: "all"
+      x-fqm-essential: true
     updatedByUsername:
       type: string
       description: Username of the user who updated the record (when available)
+      x-fqm-ignore: true
     updatedBy:
       $ref: '#/userInfo'
       description: Additional information of the user who updated the record (when available)
+      x-fqm-ignore: true
   required:
     - createdDate
 
diff --git a/src/main/resources/swagger.api/schemas/link.yaml b/src/main/resources/swagger.api/schemas/link.yaml
@@ -6,16 +6,45 @@ link:
     id:
       type: string
       description: Id of object linked to note
+      x-fqm-value-getter: ${source}.object_id
+      x-fqm-is-id-column: false # Despite the name, this is not the unique ID for the link record.
+      x-fqm-visibility: "all"
+      x-fqm-essential: true
     type:
       type: string
       description: Type of object linked to note
+      x-fqm-value-getter: ${source}.object_type
+      x-fqm-visibility: "all"
+      x-fqm-essential: true
   required:
     - id
     - type
   example:
     id: 1234-5678
     type: package
 
+fqmLink:
+  type: object
+  title: Note link
+  description: Link record for FQM
+  properties:
+    linkId:
+      $ref: 'common.yaml#/uuid'
+      description: UUID primary key of the link row; used by note_link.link_id
+      x-fqm-value-getter: ${source}.id
+      x-fqm-is-id-column: true
+      x-fqm-visibility: "all"
+      x-fqm-visible-by-default: true
+      x-fqm-essential: true
+    id:
+      $ref: '#/link/properties/id'
+    type:
+      $ref: '#/link/properties/type'
+  required:
+    - linkId
+    - id
+    - type
+
 linkStatus:
   type: string
   enum: [ ASSIGNED, UNASSIGNED ]
diff --git a/src/main/resources/swagger.api/schemas/note.yaml b/src/main/resources/swagger.api/schemas/note.yaml
@@ -5,34 +5,61 @@ note:
     id:
       $ref: 'common.yaml#/uuid'
       description: Unique generated identifier for the note
+      x-fqm-value-getter: ${source}.id
+      x-fqm-filter-value-getter: ${source}.id
+      x-fqm-visibility: "all"
+      x-fqm-visible-by-default: true
+      x-fqm-essential: true
     typeId:
       $ref: 'common.yaml#/uuid'
       description: Type id of note
+      x-fqm-value-getter: ${source}.type_id
+      x-fqm-filter-value-getter: ${source}.type_id
+      x-fqm-visibility: "all"
+      x-fqm-essential: true
+      x-fqm-joins-to:
+        - targetModule: mod-notes
+          targetEntity: note_type
+          targetField: id
+          type: equality-cast-uuid
     type:
       type: string
       description: Type of note (configured in settings)
     title:
       type: string
       description: Note title
+      x-fqm-value-getter: ${source}.title
+      x-fqm-visibility: "all"
+      x-fqm-visible-by-default: true
     domain:
       type: string
       description: Domain associated with this note
+      x-fqm-value-getter: ${source}.domain
+      x-fqm-visibility: "all"
+      x-fqm-visible-by-default: true
     content:
       type: string
       description: Content of the note
+      x-fqm-value-getter: ${source}.content
+      x-fqm-visibility: "all"
     popUpOnCheckOut:
       type: boolean
       description: Flag that specify need of pop-up on check-out app
+      x-fqm-value-getter: ${source}.pop_up_on_check_out
+      x-fqm-visibility: "all"
     popUpOnUser:
       type: boolean
       description: Flag that specify need of pop-up on users app
+      x-fqm-value-getter: ${source}.pop_up_on_user
+      x-fqm-visibility: "all"
     links:
       type: array
       description: Collection of links to associated objects
       items:
         $ref: 'link.yaml#/link'
     metadata:
       $ref: 'common.yaml#/metadata'
+      x-fqm-visibility: "all"
   required:
     - typeId
     - domain
diff --git a/src/main/resources/swagger.api/schemas/noteType.yaml b/src/main/resources/swagger.api/schemas/noteType.yaml
@@ -6,14 +6,30 @@ noteType:
     id:
       $ref: 'common.yaml#/uuid'
       description: A UUID identifying this note type
+      x-fqm-value-getter: ${source}.id
+      x-fqm-visibility: "all"
+      x-fqm-essential: true
     name:
       type: string
       description: The unique name of this type
       maxLength: 255
+      x-fqm-value-getter: ${source}.name
+      x-fqm-visibility: "all"
+      x-fqm-essential: true
+      x-fqm-id-column-name: id
+      x-fqm-source:
+        entityTypeId: 5cba8da3-3203-59a4-ad79-f91401850d9f
+        columnName: name
+      x-fqm-value-source-api:
+        path: note-types
+        valueJsonPath: $.noteTypes.*.id
+        labelJsonPath: $.noteTypes.*.name
+      x-fqm-visible-by-default: true
     usage:
       type: object
       readOnly: true
       description: Type usage statistics
+      x-fqm-ignore: true
       properties:
         isAssigned:
           type: boolean
diff --git a/translations/mod-notes/en.json b/translations/mod-notes/en.json
@@ -0,0 +1,32 @@
+{
+  "fqm.entityType.note": "Note",
+  "fqm.entityType.note._description": "Notes stored in mod-notes.",
+  "fqm.entityType.note.id": "Note UUID",
+  "fqm.entityType.note.type_id": "Note type UUID",
+  "fqm.entityType.note.title": "Title",
+  "fqm.entityType.note.domain": "Domain",
+  "fqm.entityType.note.content": "Content",
+  "fqm.entityType.note.pop_up_on_check_out": "Show pop-up on checkout",
+  "fqm.entityType.note.pop_up_on_user": "Show pop-up on user",
+  "fqm.entityType.note.metadata_created_date": "Created at",
+  "fqm.entityType.note.metadata_created_by_user_id": "Created by user UUID",
+  "fqm.entityType.note.metadata_updated_date": "Updated at",
+  "fqm.entityType.note.metadata_updated_by_user_id": "Updated by user UUID",
+  "fqm.entityType.link": "Link",
+  "fqm.entityType.link._description": "Link records used by notes.",
+  "fqm.entityType.link.link_id": "Link UUID",
+  "fqm.entityType.link.id": "Linked record ID",
+  "fqm.entityType.link.type": "Linked record type",
+  "fqm.entityType.note_link": "Note link",
+  "fqm.entityType.note_link._description": "Relationships between notes and link records.",
+  "fqm.entityType.note_link.note_id": "Note UUID",
+  "fqm.entityType.note_link.link_id": "Link UUID",
+  "fqm.entityType.note_type": "Note type",
+  "fqm.entityType.note_type._description": "Configured note types.",
+  "fqm.entityType.note_type.id": "Note type UUID",
+  "fqm.entityType.note_type.name": "Name",
+  "fqm.entityType.note_type.metadata_created_date": "Created at",
+  "fqm.entityType.note_type.metadata_created_by_user_id": "Created by user UUID",
+  "fqm.entityType.note_type.metadata_updated_date": "Updated at",
+  "fqm.entityType.note_type.metadata_updated_by_user_id": "Updated by user UUID"
+}

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# fqm-tools only accepts a file path in `schema = ...`; it cannot target a nested
	`2`	`+# schema fragment there, so this wrapper bridges to the real runtime schema.`
	`3`	`+$ref: '../../swagger.api/schemas/link.yaml#/fqmLink'`