row display column

common/proto/search.proto

@@ -32,6 +32,9 @@ message SearchResponse {
     float score = 2;
     string content_json = 3;
     string table_name = 4;
+    // Configured human-readable value for this row.
+    string row_display_value = 5;
+    string row_display_column = 6;
   }
   repeated Hit hits = 1;
 }

common/proto/search2.proto

@@ -40,6 +40,8 @@ message Search2Response {
     int64 id = 1;
     string content_json = 2; // No score - this is SQL-based
     optional string match_info = 3; // Info about which columns matched
+    string row_display_value = 4; // Configured human-readable value for this row
+    string row_display_column = 5;
   }
   repeated Hit hits = 1;
   int32 total_count = 2; // Total matching records (for pagination)

common/proto/table_definition.proto

@@ -80,6 +80,10 @@ message PostTableDefinitionRequest {
 
   // ISO-4217 base currency used by every MONEY column in this table.
   string base_currency = 6;
+
+  // Column whose value identifies a row to users in pickers. "id" is always
+  // valid; otherwise this must name one of the user-defined columns above.
+  string row_display_column = 7;
 }
 
 // Defines append-only column additions for an existing table.
@@ -157,6 +161,9 @@ message ProfileTreeResponse {
 
     // Other tables this one references (based on link definitions only).
     repeated string depends_on = 3;
+
+    // Column whose value is used as the human-readable row label.
+    string row_display_column = 4;
   }
 
   // Profile (schema) entry.
@@ -231,6 +238,7 @@ message TableDetail {
   repeated ColumnDefinition columns = 3;
   repeated ScriptInfo scripts = 4;
   string base_currency = 5;
+  string row_display_column = 6;
 }
 
 // A script that targets a specific column in a table.

common/proto/tables_data.proto

@@ -241,6 +241,11 @@ message GetTableDataResponse {
   // All values are returned as TEXT via col::TEXT and COALESCEed to empty string
   // (NULL becomes ""). The row is returned only if deleted = FALSE.
   map<string, string> data = 1;
+
+  // Configured human-readable value for this row. Empty when that column is
+  // NULL/empty; clients should then visibly fall back to the row id.
+  string row_display_value = 2;
+  string row_display_column = 3;
 }
 
 // Count non-deleted rows.

common/src/proto/komp_ac.search.rs

@@ -41,6 +41,11 @@ pub mod search_response {
         pub content_json: ::prost::alloc::string::String,
         #[prost(string, tag = "4")]
         pub table_name: ::prost::alloc::string::String,
+        /// Configured human-readable value for this row.
+        #[prost(string, tag = "5")]
+        pub row_display_value: ::prost::alloc::string::String,
+        #[prost(string, tag = "6")]
+        pub row_display_column: ::prost::alloc::string::String,
     }
 }
 #[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord, ::prost::Enumeration)]

common/src/proto/komp_ac.search2.rs

@@ -49,6 +49,11 @@ pub mod search2_response {
         /// Info about which columns matched
         #[prost(string, optional, tag = "3")]
         pub match_info: ::core::option::Option<::prost::alloc::string::String>,
+        /// Configured human-readable value for this row
+        #[prost(string, tag = "4")]
+        pub row_display_value: ::prost::alloc::string::String,
+        #[prost(string, tag = "5")]
+        pub row_display_column: ::prost::alloc::string::String,
     }
 }
 #[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord, ::prost::Enumeration)]

common/src/proto/komp_ac.table_definition.rs

@@ -45,6 +45,10 @@ pub struct PostTableDefinitionRequest {
     /// ISO-4217 base currency used by every MONEY column in this table.
     #[prost(string, tag = "6")]
     pub base_currency: ::prost::alloc::string::String,
+    /// Column whose value identifies a row to users in pickers. "id" is always
+    /// valid; otherwise this must name one of the user-defined columns above.
+    #[prost(string, tag = "7")]
+    pub row_display_column: ::prost::alloc::string::String,
 }
 /// Defines append-only column additions for an existing table.
 #[derive(serde::Serialize, serde::Deserialize)]
@@ -129,6 +133,9 @@ pub mod profile_tree_response {
         /// Other tables this one references (based on link definitions only).
         #[prost(string, repeated, tag = "3")]
         pub depends_on: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
+        /// Column whose value is used as the human-readable row label.
+        #[prost(string, tag = "4")]
+        pub row_display_column: ::prost::alloc::string::String,
     }
     /// Profile (schema) entry.
     #[derive(Clone, PartialEq, ::prost::Message)]
@@ -231,6 +238,8 @@ pub struct TableDetail {
     pub scripts: ::prost::alloc::vec::Vec<ScriptInfo>,
     #[prost(string, tag = "5")]
     pub base_currency: ::prost::alloc::string::String,
+    #[prost(string, tag = "6")]
+    pub row_display_column: ::prost::alloc::string::String,
 }
 /// A script that targets a specific column in a table.
 #[derive(Clone, PartialEq, Eq, Hash, ::prost::Message)]

common/src/proto/komp_ac.tables_data.rs

@@ -186,6 +186,12 @@ pub struct GetTableDataResponse {
         ::prost::alloc::string::String,
         ::prost::alloc::string::String,
     >,
+    /// Configured human-readable value for this row. Empty when that column is
+    /// NULL/empty; clients should then visibly fall back to the row id.
+    #[prost(string, tag = "2")]
+    pub row_display_value: ::prost::alloc::string::String,
+    #[prost(string, tag = "3")]
+    pub row_display_column: ::prost::alloc::string::String,
 }
 /// Count non-deleted rows.
 #[derive(Clone, PartialEq, Eq, Hash, ::prost::Message)]