@cplace/test-mcp-server 1.0.0 → 1.1.0

package/dist/widget-specifications/cf.platform.connectedMatrix/_overview.md

@@ -0,0 +1,189 @@
+## Overview
+
+Visualizes the content of a table broken down according to two search criteria.
+
+The Connected Matrix Widget organizes pages from a search result into a two-dimensional grid structure based on two configurable attributes. Each axis represents a categorical dimension (such as team members, time periods, risk levels, or features), and the intersection cells contain the pages matching those coordinate combinations.
+
+As part of the "connected widget" family, this widget integrates with a table widget to share search queries, filters, and permissions. This makes it particularly valuable for visualizing relationships and distribution patterns that would be difficult to spot in traditional list or table formats.
+
+## Primary Use Cases
+
+### Responsibility Assignment (RACI Matrix)
+- **X-axis**: Team members or organizational roles
+- **Y-axis**: Tasks, deliverables, or activities
+- **Purpose**: Show who is responsible, accountable, consulted, or informed for each task
+- **Value**: Quickly identify gaps in responsibility coverage or overallocation
+
+### Risk Assessment Matrix
+- **X-axis**: Risk likelihood (Low, Medium, High)
+- **Y-axis**: Risk impact (Low, Medium, High)
+- **Purpose**: Position risks by probability and severity
+- **Value**: Visual prioritization based on standard risk management framework
+
+### Resource Allocation Over Time
+- **X-axis**: Time periods (weeks, months, quarters)
+- **Y-axis**: Projects, teams, or resources
+- **Purpose**: Show which resources are allocated where and when
+- **Value**: Identify scheduling conflicts and resource constraints
+
+### Product Feature Comparison
+- **X-axis**: Products or product versions
+- **Y-axis**: Features or requirements
+- **Purpose**: Show feature availability across product lines
+- **Value**: Gap analysis and feature parity visualization
+
+### Stakeholder Mapping
+- **X-axis**: Interest level in the project
+- **Y-axis**: Influence or power level
+- **Purpose**: Map stakeholders by engagement characteristics
+- **Value**: Guide communication and engagement strategies
+
+### Cross-Functional Dependencies
+- **X-axis**: Departments or organizational units
+- **Y-axis**: Projects or initiatives
+- **Purpose**: Visualize organizational dependencies
+- **Value**: Identify collaboration needs and organizational silos
+
+## Design Considerations
+
+### When to Use This Widget
+
+Choose the Connected Matrix Widget when:
+- You need to visualize relationships between **two categorical dimensions** (not continuous data)
+- Distribution patterns or concentrations matter more than individual details
+- Users need to quickly identify gaps, conflicts, or categorization at a glance
+- The data naturally maps to a grid structure (like assignments, allocations, or assessments)
+- Both dimensions have a manageable number of distinct values (typically 3-20 per axis)
+
+### When to Consider Alternatives
+
+**Use a Table Widget instead** when:
+- You need detailed data with multiple columns
+- Sorting and filtering by many attributes is important
+- Users need to see all attribute values, not just two dimensions
+- The focus is on individual records rather than distribution patterns
+
+**Use a Chart Widget (Bar/Pie) instead** when:
+- You only have one dimension to visualize
+- You need to show proportional distribution rather than absolute positioning
+- Aggregate counts or percentages are more important than individual items
+
+**Use a Timeline/Gantt Widget instead** when:
+- Time is a continuous axis (not discrete periods)
+- Duration and scheduling are the primary concerns
+- Dependencies between tasks need to be visualized
+
+**Use a Tree Table Widget instead** when:
+- Hierarchical relationships are more important than dimensional categorization
+- Parent-child structures define the organization
+- Drill-down through levels is the primary navigation pattern
+
+### Attribute Selection Guidelines
+
+**Good candidates for axes**:
+- Enumeration attributes with 3-20 values (ideal range)
+- Reference attributes to organizational entities (people, teams, departments)
+- Date attributes that naturally group (quarters, months)
+- Categorical attributes that represent discrete states or categories
+
+**Poor candidates for axes**:
+- Free-text strings with many unique values
+- Continuous numeric ranges (use charts instead)
+- Attributes with too many values (matrix becomes unwieldy)
+- Optional attributes where most pages lack values
+
+### Visual Styles
+
+The widget supports different visual styles for axis headers:
+- **Plain**: Simple text labels (default, works for all attribute types)
+- **Label**: Styled label boxes (good for enumeration values)
+- **Arrow**: Labels with arrow indicators (useful for directional progression)
+- **Profile-line/Profile-column**: User profile images (for Person references)
+
+Choose the style that best matches your data type and visual design needs.
+
+### Performance Considerations
+
+- **Default limit**: 500 pages (configurable via `MAX_RESULTS`)
+- Matrices work best with **focused searches** that return relevant subsets
+- Very large matrices (many values on both axes) can impact browser performance
+- Consider using connected table filters to let users narrow down results dynamically
+
+### Cell Population Patterns
+
+**Enumeration attributes**:
+- All enumeration values appear as lanes (rows/columns)
+- Empty cells are visible but contain no links
+- Helps identify gaps (e.g., "no one is responsible for this task")
+
+**Other attribute types**:
+- Only values present in search results create lanes
+- Empty lanes are omitted entirely
+- Matrix size adapts to actual data
+
+## Connection Patterns
+
+### Required Connected Widget
+The matrix widget **requires** a table widget connection:
+- Shares the table's search query and filters
+- Inherits permission settings from the table
+- Updates when table filters change
+
+**Setup**: Configure `TABLE_WIDGET_ID` to point to the source table widget
+
+### Optional Connected Widgets
+Works well with:
+- **Connected Table Filter** widgets: Provide interactive filtering controls
+- **Connected Bar/Pie Chart** widgets: Offer alternative visualizations of the same data
+- **Connected Single Attribute** widgets: Show aggregate metrics alongside the matrix
+
+All connected widgets sharing the same table stay synchronized.
+
+## Common Pitfalls
+
+### Matrix Size Management
+**Problem**: Too many unique values create an unwieldy matrix
+**Solution**:
+- Refine the search query to focus on relevant subsets
+- Use enumeration attributes with controlled value sets
+- Add connected filter widgets to let users narrow results
+- Consider grouping continuous attributes (e.g., date ranges instead of individual dates)
+
+### Attribute Coverage
+**Problem**: Pages without X or Y attribute values are excluded from display
+**Solution**:
+- Ensure the search query targets types with both attributes defined
+- Make attributes required if all pages should appear
+- Use validation rules to ensure data quality
+
+### Multiple Pages Per Cell
+**Problem**: Cells with many pages become crowded and hard to read
+**Solution**:
+- Use icon attributes to provide visual differentiation
+- Refine search to reduce result count
+- Consider whether the axes are granular enough
+- Accept that this is a high-level overview (users click through for details)
+
+### Profile Image Display
+**Problem**: Profile images don't appear even with profile-line/profile-column style
+**Solution**:
+- Ensure the axis uses a Person reference attribute
+- Verify that Person pages have profile images uploaded
+- Check that thumbnail generation is configured correctly in cplace
+
+## Related Patterns
+
+### Connected Widget Family
+All widgets sharing the `cf.platform.connected*` naming pattern integrate with table widgets:
+- `cf.platform.connectedBarChart` - Bar chart visualization
+- `cf.platform.connectedPieChart` - Proportional distribution
+- `cf.platform.connectedTableFilter` - Interactive filtering controls
+- `cf.platform.connectedSingleAttribute` - Single value display
+- `cf.platform.connectedAttributesGroup` - Multi-attribute grouping
+
+### Alternative Visualizations
+Depending on your data and goals, consider:
+- `cf.cplace.platform.tableWidget` - Detailed tabular view
+- `cf.cplace.extendedTreeTableWidget` - Hierarchical data
+- Timeline widgets - Time-phased planning
+- Chart widgets - Aggregated metrics

package/dist/widget-specifications/cf.platform.connectedMatrix/_summary.md

@@ -0,0 +1 @@
+Visualizes the content of a table broken down according to two search criteria. Positions pages based on two configurable attributes (X and Y axes) to show distribution patterns and relationships. Ideal for RACI matrices, risk assessments, resource allocations, and other scenarios requiring categorical two-dimensional analysis.

package/dist/widget-specifications/cf.platform.connectedPieChart/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.platform.connectedPieChart",
+  "Description": "{\"en\":\"Visualizes an attribute of a table or a search configurable in the widget as a pie chart.\",\"de\":\"Visualisiert ein Attribut einer Tabelle oder einer im Widget konfigurierbaren Suche als Kuchendiagramm.\"}",
+  "Localized Name": "{\"en\":\"Pie Chart\",\"de\":\"Kuchendiagramm\"}",
+  "Icon": "fa-chart-pie",
+  "Plugin": "cf.cplace.platform",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace",
+  "* Details DE": null,
+  "* Details EN": "<p><strong>More Details</strong></p>\n\n<p>The 'Pie Chart' widget can be used to visualize an attribute of a table (i.e. a table column) or the result of a configurable search as a pie chart.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Table:</p>\n\n<p>// * Search: If no connected table is specified, the search specified here will be used to generate the pie chart.</p>\n\n<p>// * Title: Bilingual text.</p>\n\n<p>// * Height in pixels:</p>\n\n<p>&nbsp;</p>\n\n<p>&nbsp;</p>"
+}

package/dist/widget-specifications/cf.platform.connectedPieChart/_implementation.md

@@ -0,0 +1,10 @@
+**Data Source Modes**:
+- `tableWidgetId`: Links to an existing table widget on the same page (shares its search/filters)
+- `search`: Standalone search definition for data
+
+**Important**: At least one data source must be specified. If both are set, `tableWidgetId` takes priority.
+
+**Typical Configuration Workflow**:
+1. Choose data source: connect to table widget OR define standalone search
+2. Set `attributeName` to choose which attribute to aggregate (options depend on data source)
+3. Optionally set title and height

package/dist/widget-specifications/cf.platform.connectedPieChart/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "chart",
+    "attributes",
+    "searchable",
+    "connected",
+    "dashboard",
+    "read-only"
+  ],
+  "requiredApp": null
+}

package/dist/widget-specifications/cf.platform.connectedPieChart/_overview.md

@@ -0,0 +1,70 @@
+## Overview
+
+Visualizes an attribute of a table or a search configurable in the widget as a pie chart.
+
+The Connected Pie Chart widget visualizes the distribution of values in a selected attribute as an interactive pie chart. It aggregates data by counting the frequency of each distinct value and displays the results as proportional slices with percentages and a legend.
+
+The widget can operate in two modes: connected to a table widget for dynamic updates based on table filters, or with a direct search query for independent data visualization.
+
+## Use Cases
+
+### Status Distribution Analysis
+Display the distribution of items across different status values to get a quick overview of work progress. For example, a project manager can see how many tasks are in each status category (Open, In Progress, Completed) to understand project health at a glance.
+
+### Category Breakdown
+Visualize how items are distributed across categorical attributes like priority, type, or department. This helps identify where resources should be focused, such as showing the distribution of support tickets by priority level.
+
+### Demographic Analysis
+Display demographic breakdowns such as team distribution, location distribution, or role distribution within an organization.
+
+### Connected Filtering Scenario
+When connected to a table widget, the pie chart updates dynamically based on table filters, providing real-time distribution visualization of filtered data. As users filter the table, the chart automatically reflects the filtered subset.
+
+## Design Considerations
+
+### Data Source Selection
+
+The widget requires exactly one data source:
+
+**Connected Table Mode**
+- Links to an existing table widget on the same page
+- Automatically responds to table filters and updates dynamically
+- Ideal when users need to explore data interactively
+
+**Direct Search Mode**
+- Defines a search query directly in the widget
+- Operates independently without dependency on other widgets
+- Ideal for static dashboards or standalone visualizations
+
+### Attribute Requirements
+
+The selected attribute must be an enumeration or reference attribute that can be aggregated. The widget counts occurrences of each distinct value and displays them as proportional slices.
+
+### Visualization Behavior
+
+- Displays percentages in tooltips
+- Shows a legend with value names on the right side
+- Slices can be selected/highlighted interactively
+- Values are sorted alphabetically by display name
+
+## Alternatives
+
+### Connected Bar Chart
+The `cf.platform.connectedBarChart` widget provides nearly identical functionality but displays data as vertical bars instead of pie slices.
+
+**When to use Pie Chart:**
+- You want to emphasize the proportion of parts to a whole (e.g., "50% of tasks are complete")
+- You have a small number of categories (ideally 5-7 or fewer)
+
+**When to use Bar Chart:**
+- You have many categories
+- You want to compare absolute values more precisely
+- Categories have similar proportions that would be hard to distinguish as slices
+
+## Related Patterns
+
+- **cf.platform.connectedBarChart** - Same data visualization concept with bar chart display
+- **cf.platform.connectedMatrix** - Two-dimensional visualization of relationships
+- **cf.platform.connectedTableFilter** - Provides filtering controls that can drive connected charts
+- **cf.platform.connectedSingleAttribute** - Displays a single attribute value from a selected table row
+- **cf.platform.connectedAttributesGroup** - Displays multiple attributes from a selected table row

package/dist/widget-specifications/cf.platform.connectedPieChart/_summary.md

@@ -0,0 +1 @@
+Visualizes an attribute of a table or a search configurable in the widget as a pie chart. Shows proportions of each distinct value with support for data from a connected table widget or a direct search query.

package/dist/widget-specifications/cf.platform.connectedPieChart/search.md

@@ -0,0 +1,10 @@
+**Warning**: Do not manually construct search JSON!
+
+**Correct Usage**: Use the `cplaceJson` field from `cplace_search_pages` response.
+
+**Workflow**:
+1. Call `cplace_search_pages` with your desired filter criteria
+2. Take the `cplaceJson` field from the response
+3. Use that value for the `search` attribute
+
+**Note**: Only used when `tableWidgetId` is not specified. The search must target a single type for the widget to be valid.

package/dist/widget-specifications/cf.platform.connectedSingleAttribute/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.platform.connectedSingleAttribute",
+  "Description": "{\"en\":\"Displays a single attribute of a selected table entry dynamically. Prerequisite: There must be a table widget on the page.\",\"de\":\"Zeigt dynamisch ein einzelnes Attribut eines selektierten Tabelleneintrags an. Voraussetzung: Auf der Seite muss ein Tabellen-Widget existieren.\"}",
+  "Localized Name": "{\"en\":\"Single Attribute of a Table\",\"de\":\"Einzelnes Attribut aus Tabelle\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.platform",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace",
+  "* Details DE": null,
+  "* Details EN": "<p><strong>More Details</strong></p>\n\n<p>The 'Single Attribute of a Table' widget dynamically displays a single attribute of a selected table entry.</p>\n\n<p>// This widget is a nested widget.</p>\n\n<p><strong>Prerequisite</strong><br>\nThere must be a table widget on the same page.</p>\n\n<p>&nbsp;</p>"
+}

package/dist/widget-specifications/cf.platform.connectedSingleAttribute/_implementation.md

@@ -0,0 +1,15 @@
+**Configuration Modes**:
+- **Value only** (`withValue=true`, `withLabel=false`): Shows attribute value inline
+- **Label only** (`withValue=false`, `withLabel=true`): Shows only the attribute name
+- **Value + Label** (`withValue=true`, `withLabel=true`): Shows both label and value (supports two layouts via `singleColumn`)
+
+**Typical Configuration Workflow**:
+1. Set `singleSelectionWidgetId` to the table/selection widget that provides entity selection
+   - Use `"<empty>"` when embedded inside a `cf.platform.connectedAttributesGroup` widget
+2. Set `attributeName`
+3. Configure display options:
+   - `withValue` and `withLabel` (at least one must be true)
+   - `singleColumn` for layout (only relevant when both value and label are shown)
+   - `inPlaceEditing` to allow inline editing
+4. Optional: Set `showAttributeScript` for conditional visibility
+5. Optional: Set `reloadAfterChange` to refresh connected widgets after edits

package/dist/widget-specifications/cf.platform.connectedSingleAttribute/_meta.json

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "attributes",
+    "form",
+    "detail-view",
+    "connected",
+    "inline-edit"
+  ],
+  "requiredApp": null
+}

package/dist/widget-specifications/cf.platform.connectedSingleAttribute/_overview.md

@@ -0,0 +1,69 @@
+## Overview
+
+Displays a single attribute of a selected table entry dynamically. Prerequisite: There must be a table widget on the page.
+
+The Connected Single Attribute Widget displays a single attribute value from an entity that is dynamically selected in a connected table or selection widget. Unlike the standard Single Attribute Widget which displays attributes from a fixed entity, this widget updates automatically when users select different rows in a connected table.
+
+This widget implements the master-detail pattern by showing specific attribute values from entities selected in related table widgets, making it ideal for building interactive detail panels, quick edit interfaces, and responsive data exploration experiences.
+
+## Use Cases
+
+### Master-Detail View
+Display detailed information about a selected table row. A table lists projects, and connected single attribute widgets show the selected project's status, owner, budget, and description in a detail panel. When users click different rows, all connected widgets update simultaneously.
+
+### Quick Edit Interface
+Allow inline editing of specific attributes from a selection. A table of tasks where selecting a task allows quick status updates via connected single attribute widgets with in-place editing enabled. Changes can trigger automatic reload of dependent widgets.
+
+### Conditional Attribute Display
+Show different attributes based on the selected entity's state. Display "Approval Date" only for approved items, or "Rejection Reason" only for rejected items using cplaceJS scripts for conditional visibility.
+
+### Grouped Attributes Display
+Multiple related attributes displayed together with a shared table selection. Embed multiple connected single attribute widgets within a Connected Attributes Group Widget to create a form-like interface showing multiple attributes from the selected entity.
+
+### Inline Display in Rich Text
+Embed dynamic attribute values within narrative content. A report page with text like "The selected project's current status is [status widget] and is owned by [owner widget]."
+
+## Design Considerations
+
+### Connected Widget Requirement
+This widget requires a connection to a widget that produces single entity selections (implements `ISingleEntitySelectionProducer`). The most common source is the Embedded Search as Table widget. The widget starts with no target entity and updates based on user selections.
+
+### Display Modes
+The widget supports flexible display configurations:
+- **Value only**: Displays just the attribute value, useful for inline embedding in sentences
+- **Label only**: Shows only the attribute label, useful for headers or dynamic labels
+- **Label and value**: Standard form field appearance with both elements
+- **Stacked layout**: Label displayed above value, better for narrow layouts
+
+### Embedding Contexts
+The widget can be embedded in two contexts:
+1. **Rich text content**: Directly in page content for inline displays
+2. **Connected Attributes Group Widget**: For structured form-like interfaces where the parent widget manages the table connection
+
+When embedded in a Connected Attributes Group, the parent widget controls the table selection for all embedded widgets, and its layout settings can override individual widget settings.
+
+### In-Place Editing
+When editing is enabled, users can modify attribute values directly without leaving the page. Consider enabling the reload-after-change option to refresh dependent widgets when values change.
+
+### Conditional Visibility
+The widget supports cplaceJS scripts that evaluate the current selection to determine whether the attribute should be displayed. This enables dynamic interfaces that adapt to the selected entity's state.
+
+## Common Pitfalls
+
+- Forgetting to specify the connected selection widget ID
+- Not enabling at least one display option (value or label)
+- Using this widget when a static Single Attribute Widget would suffice (no dynamic selection needed)
+- Not considering the reload behavior after edits when other widgets depend on the edited values
+
+## Alternatives to Consider
+
+| Widget | When to Use Instead |
+|--------|---------------------|
+| **Single Attribute Widget** (`cf.platform.singleAttribute`) | When the entity is fixed and known at design time, not based on user selection |
+| **Connected Attributes Group Widget** (`cf.cplace.platform.connectedAttributesGroup`) | When displaying multiple attributes together with shared table selection - use this as a container with embedded connected single attribute widgets |
+
+## Related Patterns
+
+- **Master-Detail Pattern**: Use with a table widget as the master and multiple connected single attribute widgets as the detail display
+- **Quick Edit Interface**: Combine with in-place editing for efficient data updates from table selections
+- **Dashboard Panels**: Create KPI displays based on filtered table selections using connected single attributes

package/dist/widget-specifications/cf.platform.connectedSingleAttribute/_summary.md

@@ -0,0 +1 @@
+Displays a single attribute of a selected table entry dynamically. Prerequisite: There must be a table widget on the page. Use for master-detail views, quick edit interfaces, and detail panels that respond to table row selections.

package/dist/widget-specifications/cf.platform.connectedSingleAttribute/attributeName.md

@@ -0,0 +1,10 @@
+**Warning**: Use the full internal attribute name, not the simple/short name!
+
+**Important**:
+- **Custom attributes** require single quotes around the attribute name: `'cf.cplace.myApp.myAttribute'`
+- **Builtin attributes** (e.g., `name`, `createdAt`, `creator`, `modifiedAt`, `modifier`, `owner`) are specified without quotes: `name`
+
+**Workflow**:
+1. Call `cplace_get_type_datamodel` for the type displayed in the connected table
+2. Find the custom attribute you want to display
+3. Use the custom attribute's `name` field (the full internal name), wrapped in single quotes

package/dist/widget-specifications/cf.platform.connectedSingleAttribute/singleColumn.md

@@ -0,0 +1,9 @@
+**Note**: This attribute is only relevant when both `withValue=true` AND `withLabel=true`.
+
+**Layout Modes**:
+- `false` (default): Two-column layout with label and value side by side
+- `true`: Single-column layout with label above value
+
+**Parent Widget Override**: When this widget is embedded inside a `cf.platform.connectedAttributesGroup` widget, the parent widget's `singleColumn` setting takes precedence over this widget's setting. The parent's layout configuration will override the individual widget's setting.
+
+**Example**: If the parent ConnectedAttributesGroup has `singleColumn=true`, all embedded ConnectedSingleAttribute widgets will use single-column layout regardless of their individual `singleColumn` settings.

package/dist/widget-specifications/cf.platform.connectedSingleAttribute/singleSelectionWidgetId.md

@@ -0,0 +1,3 @@
+**Valid Values**:
+- When embedded inside a `cf.cplace.platform.connectedAttributesGroup` widget, use `"<empty>"` as the value - the parent widget provides the actual table connection
+- When the connection goes against a `cf.platform.treeTable` widget - insert the widget ID

package/dist/widget-specifications/cf.platform.connectedSingleAttribute/withLabel.md

@@ -0,0 +1,11 @@
+**Warning**: At least one of `withValue` or `withLabel` must be `true` for the widget configuration to be complete!
+
+**Valid Values**:
+- `false` (default): Hide the attribute's label/name
+- `true`: Show the attribute's localized label/name
+
+**Configuration Completeness Check**: The widget validates that at least one display option is enabled. If both `withValue=false` and `withLabel=false`, the configuration is considered incomplete and the widget will not render properly.
+
+**Note**: The `singleColumn` attribute is only relevant when `withLabel=true` and `withValue=true` - it controls whether the label and value are displayed side by side or stacked vertically.
+
+**Frontend Behavior**: When `withLabel=false` and `inPlaceEditing=false`, the widget renders in inline mode using a span element. Otherwise, it uses a block-level div element.

package/dist/widget-specifications/cf.platform.connectedSingleAttribute/withValue.md

@@ -0,0 +1,12 @@
+**Warning**: At least one of `withValue` or `withLabel` must be `true` for the widget configuration to be complete!
+
+**Valid Values**:
+- `true` (default): Show the attribute's value
+- `false`: Hide the attribute's value (only valid if `withLabel=true`)
+
+**Configuration Completeness Check**: The widget validates that at least one display option is enabled. If both `withValue=false` and `withLabel=false`, the configuration is considered incomplete and the widget will not render properly.
+
+**Common Patterns**:
+- `withValue=true, withLabel=false`: Display value only (inline mode)
+- `withValue=true, withLabel=true`: Display both label and value
+- `withValue=false, withLabel=true`: Display label only (useful for showing which attribute is selected without showing its value)

package/dist/widget-specifications/cf.platform.connectedTableFilter/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.platform.connectedTableFilter",
+  "Description": "{\"en\":\"Displays the column filters of a table and enables you to adjust the filter criteria.\",\"de\":\"Zeigt die Spaltenfilter einer Tabelle an und ermöglicht die Anpassung der Filterkriterien.\"}",
+  "Localized Name": "{\"en\":\"Filter Configuration of a Table\",\"de\":\"Filterkonfiguration einer Tabelle\"}",
+  "Icon": "fa-filter",
+  "Plugin": "cf.cplace.platform",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace",
+  "* Details DE": null,
+  "* Details EN": "<p><strong>More Details</strong></p>\n\n<p>The 'Filter Criteria of a Table' widget shows the current column filters of a table and allows you to modify the filter criteria.</p>\n\n<p><strong>Prerequisites</strong></p>\n\n<p>A table must be embedded in the page.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Table*:</p>"
+}

package/dist/widget-specifications/cf.platform.connectedTableFilter/_meta.json

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "filterable",
+    "connected",
+    "table",
+    "dashboard",
+    "navigation"
+  ],
+  "requiredApp": null
+}

package/dist/widget-specifications/cf.platform.connectedTableFilter/_overview.md

@@ -0,0 +1,89 @@
+## Overview
+
+Displays the column filters of a table and enables you to adjust the filter criteria.
+
+The Filter Configuration widget provides users with an interactive interface to view and modify the active column filters of a connected table widget. Instead of filtering directly within a table header, this widget exposes filter controls as a separate, dedicated component that can be positioned anywhere on the layout. This separation enables cleaner table interfaces while providing prominent, easy-to-access filter controls.
+
+The widget displays all filterable columns from the connected table and shows their current filter states. Users can modify filter criteria through the widget, and changes are immediately reflected in the connected table's displayed data.
+
+## Use Cases
+
+### Dashboard Layouts with Prominent Filter Controls
+- Displaying filter controls above or beside table widgets on dashboards
+- Creating filter panels that remain visible while scrolling through large tables
+- Providing dedicated space for complex filtering interfaces without cluttering table headers
+- Building analytical dashboards where filter configuration is a primary user task
+
+### Master-Detail Patterns with Shared Filtering
+- Allowing users to adjust filters while viewing detail views
+- Creating side-by-side layouts with filter controls and filtered results
+- Enabling filter manipulation without returning to the table view
+- Supporting workflows where filter criteria need frequent adjustment
+
+### Guided Filtering Workflows
+- Presenting filter options in a specific order or grouping
+- Creating step-by-step data exploration interfaces
+- Building filtering experiences that guide users through available filter dimensions
+- Implementing progressive disclosure of filtering capabilities
+
+## Operating Mode
+
+### Connected Table Mode
+The widget requires a connection to a table widget via the `tableWidgetId` attribute. Once connected, the filter widget:
+- Automatically discovers all filterable columns from the connected table
+- Displays the current filter state for each column
+- Synchronizes filter changes bidirectionally with the table
+- Updates when the table's filter configuration changes
+
+The connected table must be one of these compatible widget types:
+- `cf.platform.embeddedSearchAsTable`
+- `cf.cplace.platform.tableWidget`
+- Other table widgets that support column filtering
+
+## Design Considerations
+
+### When to Use This Widget
+Choose this widget when:
+- You want to separate filter controls from the table header for cleaner table interfaces
+- Filter controls need prominent positioning (e.g., dashboard headers, side panels)
+- You're building workflows where filtering is a primary user interaction
+- You need filter controls to remain visible while scrolling through table data
+- You want to provide a dedicated space for filter guidance or instructions
+
+### When NOT to Use This Widget
+Avoid this widget when:
+- Simple in-table filtering is sufficient for your use case
+- You don't need filter controls to be separate from the table
+- The table has few or no filterable columns
+- Screen space is limited and you can't afford separate filter UI
+
+### Connection Requirements
+The widget requires:
+- A table widget on the same layout/page
+- The table widget must support column filtering
+- The table widget's ID must be known for configuration
+- Both widgets must be visible to the user for proper interaction
+
+### User Experience Considerations
+- The filter widget provides no visual indication of the connected table - consider adding explanatory text or positioning the widgets adjacently
+- Filter changes take effect immediately, which is intuitive but requires the table to be visible for users to see the impact
+- Users need appropriate permissions to both view and modify filters on the underlying data
+
+## Common Pitfalls
+
+- **Missing table connection**: The widget is non-functional without a valid `tableWidgetId` reference. Always verify the table widget ID during configuration.
+- **Non-filterable columns**: If the connected table has no filterable columns configured, the filter widget will appear empty. Ensure the table has filterable columns enabled.
+- **Hidden table widget**: If the connected table is not visible on the same layout (e.g., on a different tab), filter changes may confuse users who cannot see the results update.
+- **Permission mismatches**: Users need permissions to filter the data in the connected table. If permissions are insufficient, the filter widget may appear but not function correctly.
+
+## Alternative Widgets
+
+- **Native table filtering**: Use the table widget's built-in column filters when a separate filter UI is not needed
+- **cf.cplace.platform.tableWidget**: Consider this table widget which includes comprehensive built-in filtering capabilities in the table header
+- **cf.platform.embeddedSearchAsTable**: This table widget also provides native column filtering that may be sufficient without a separate filter widget
+
+## Related Patterns
+
+- **Master-Detail Pattern**: Combine with table widgets and detail view widgets to create comprehensive data exploration interfaces
+- **Dashboard Layouts**: Position filter widgets prominently in dashboard headers or side panels for analytical workflows
+- **Progressive Disclosure**: Use filter widgets to guide users through multi-step filtering processes with clear, dedicated UI space

package/dist/widget-specifications/cf.platform.connectedTableFilter/_summary.md

@@ -0,0 +1 @@
+Displays the column filters of a table and enables you to adjust the filter criteria. Use in dashboard layouts and master-detail patterns to provide prominent, dedicated filter controls alongside table displays.

package/dist/widget-specifications/cf.platform.customRichStringAttribute/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.platform.customRichStringAttribute",
+  "Description": "{\"de\":\"Zeigt den Inhalt eines Rich-String-Attributs und erlaubt es, diesen über einen WYSIWYG-Editor zu bearbeiten.\",\"en\":\"Shows the content of a Rich String attribute and enables you to edit this content using a WYSIWYG editor.\"}",
+  "Localized Name": "{\"en\":\"Richstring Attribute\",\"de\":\"Attribut mit formatiertem Text\"}",
+  "Icon": "fa-pen-square",
+  "Plugin": "cf.cplace.platform",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace",
+  "* Details DE": null,
+  "* Details EN": "<p><strong>More Details</strong></p>\n\n<p>The 'Richstring Attribute' widget displays the value of an attribute of type 'Richtstring'. You can specify whether the widget should be surrounded by a frame or not.</p>\n\n<p>&nbsp;</p>\n\n<p>&nbsp;</p>"
+}

package/dist/widget-specifications/cf.platform.customRichStringAttribute/_meta.json

@@ -0,0 +1,9 @@
+{
+  "tags": [
+    "rich-text",
+    "attributes",
+    "detail-view",
+    "read-only"
+  ],
+  "requiredApp": null
+}