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.