@cplace/mcp-server 1.3.14

package/dist/widget-specifications/cf.cplace.pageViewHeadline.widget/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.pageViewHeadline.widget",
+  "Description": "{\"en\":\"Allows you to insert simple headlines\",\"de\":\"Ermöglicht das Einfügen einfacher Überschriften\"}",
+  "Localized Name": "{\"en\":\"Simple Headline\",\"de\":\"Einfache Überschrift\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.pageViewHeadline",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace-paw",
+  "* Details DE": null,
+  "* Details EN": "<p><strong>More Details</strong></p>\n\n<p>The 'Simple Headline' widget allows you to add a header and a subheader to a cplace page.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Title*: Bilingual text.</p>\n\n<p>// * Subtitle: Bilingual text.</p>\n\n<p>// * Background color:</p>\n\n<p>// * Font color:</p>\n\n<p>&nbsp;</p>\n\n<p>&nbsp;</p>"
+}

package/dist/widget-specifications/cf.cplace.pageViewHeadline.widget/_meta.json

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

package/dist/widget-specifications/cf.cplace.pageViewHeadline.widget/_overview.md

@@ -0,0 +1,62 @@
+## Overview
+
+The Simple Headline widget allows you to insert simple headlines. It creates visually styled page headers with a large decorative icon, custom colors, and optional subtitle. The widget displays the page's icon as a large semi-transparent watermark in the background, combined with customizable title and subtitle text.
+
+## Use Cases
+
+### Page Header Enhancement
+Add visually appealing headers to important pages, creating a professional and branded look. The widget allows consistent headline styling across different page types, helping differentiate content through visual design.
+
+### Visual Page Hierarchy
+Make landing pages or section entry points stand out with prominent headers. The combination of custom colors, large text, and decorative icons provides clear visual distinction between different page types and guides users through content organization.
+
+### Branded Content Sections
+Apply corporate colors to page headers and create consistent visual themes across page collections. The widget supports multi-language content through localized titles and subtitles, enabling branded experiences for international users.
+
+### Dashboard and Overview Pages
+Create attention-grabbing headers for dashboard pages and overview sections. The two-level text hierarchy (title and subtitle) allows you to provide both main headings and explanatory context.
+
+## Design Considerations
+
+### When to Use This Widget
+
+Choose the Simple Headline widget when:
+- Standard page titles lack sufficient visual prominence
+- You need to apply custom branding or colors to specific pages
+- You want both a main title and explanatory subtitle
+- You need to incorporate the page icon in a decorative way
+- You're creating landing pages, dashboards, or important section headers
+
+### When NOT to Use This Widget
+
+Avoid this widget when:
+- Simple page titles are sufficient for your needs
+- You need complex header functionality (interactive elements, buttons, etc.)
+- The page layout requires a standard widget frame or padding
+- You're working with non-page entities (widget only works on Page types)
+
+### Visual Design Features
+
+The widget provides responsive design across three breakpoints:
+- **Desktop (>767px)**: Full-size display with maximum visual impact
+- **Tablet (<=767px)**: Medium-size display with balanced layout
+- **Mobile (<=579px)**: Compact display optimized for small screens
+
+Typography scales automatically:
+- Desktop: Title 40px, Subtitle 24px, Icon 100px
+- Tablet: Title 30px, Subtitle 20px, Icon 70px
+- Mobile: Title 20px, Subtitle 14px, Icon 50px
+
+The widget renders without frame or padding, creating seamless integration with the page layout. Text shadows are applied for readability over the decorative icon background.
+
+## Common Pitfalls
+
+- **Entity Type Limitation**: Widget only works on Page entities. Cannot be embedded in other entity types.
+- **Static Display Only**: Widget provides no interactive features. If you need buttons, links, or other interactions in your header, use a different approach.
+- **Fixed Visual Style**: While colors are customizable, the overall layout and design pattern is fixed. Limited flexibility for radically different header designs.
+
+## Related Patterns
+
+- **Standard Page Titles**: For pages where simple text titles are sufficient
+- **Custom Header Widgets**: For pages requiring interactive header elements or complex layouts
+- **Image Widgets**: For pages where photographic headers are more appropriate than icon-based headers

package/dist/widget-specifications/cf.cplace.pageViewHeadline.widget/_summary.md

@@ -0,0 +1 @@
+Allows you to insert simple headlines with optional subtitle, customizable colors, and a decorative page icon background. Use for creating branded page headers and making important sections stand out.

package/dist/widget-specifications/cf.cplace.pdfPreview.widget/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.pdfPreview.widget",
+  "Description": "{\"en\":\"Enables you to embed a PDF and shows the first page of the document.\",\"de\":\"Erlaubt die Einbettung eines PDFs und zeigt die erste Seite des Dokuments.\"}",
+  "Localized Name": "{\"en\":\"PDF Preview\",\"de\":\"PDF-Vorschau\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.pdfPreview",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace-paw",
+  "* Details DE": null,
+  "* Details EN": "<p><strong>More Details</strong></p>\n\n<p>The 'PDF Preview' widget shows the first page of a PDF document. A 'Download' button at the bottom of the display allows you to download the entire document.</p>\n\n<p><strong>Prerequisite</strong></p>\n\n<p>The type of the page to which the 'PDF Preview' widget should be added must have a relational attribute of type 'File'. The value of this attribute must be a PDF document.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * PDF reference attribute*:</p>\n\n<p>// * Show download button*:</p>\n\n<p>// * Show widget frame*:</p>\n\n<p>// * Height:</p>\n\n<p>&nbsp;</p>"
+}

package/dist/widget-specifications/cf.cplace.pdfPreview.widget/_meta.json

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

package/dist/widget-specifications/cf.cplace.pdfPreview.widget/_overview.md

@@ -0,0 +1,79 @@
+## Overview
+
+The PDF Preview widget enables you to embed a PDF and shows the first page of the document directly within a cplace page. It provides an inline preview of PDF files that are referenced via Document reference attributes, allowing users to view PDF content without opening or downloading the file. The widget uses PDF.js library to render PDFs in an HTML5 canvas with automatic scaling and optional download functionality.
+
+## Use Cases
+
+### When to Use This Widget
+
+- **Document Preview on Pages**: Display PDF attachments or referenced documents directly on entity pages without requiring users to download or open them separately
+- **Quick Visual Reference**: Provide a quick visual preview of PDF documents (e.g., contracts, reports, diagrams) on dashboards or detail pages
+- **Document Galleries**: Show preview thumbnails of multiple PDF documents in a collection
+- **Form Attachments**: Display PDF forms or documentation alongside data entry forms
+- **Report Previews**: Show generated PDF reports inline on summary pages
+
+Use this widget when:
+- You want to provide immediate visual context of a PDF document
+- The first page of a PDF contains the most relevant information (e.g., cover pages, summary sheets)
+- You want to reduce friction by avoiding the need to download files just to see their content
+- You're building document management interfaces where quick previews enhance usability
+
+### When NOT to Use This Widget
+
+- **Multi-page PDFs**: When users need to view or interact with multiple pages of a PDF (only the first page is displayed)
+- **Non-PDF Documents**: When the referenced attribute points to non-PDF documents (the widget only works with PDF files)
+- **Non-Document References**: When the referenced document is not a Document entity type
+- **Interactive PDFs**: When users need to interact with PDF form fields or annotations
+
+## Design Considerations
+
+### Key Features
+
+- **Inline PDF Rendering**: Displays the first page of a PDF file directly in the widget using HTML5 canvas
+- **Dynamic Scaling**: Automatically scales the PDF to fit the widget width or height (depending on configuration)
+- **Access Control**: Respects cplace's permission system and displays appropriate messages for insufficient rights
+- **Optional Download Button**: Configurable download button for accessing the full PDF
+- **Widget Reload**: Supports dynamic reload to refresh the PDF preview
+- **Error Handling**: Provides user-friendly error messages for various failure scenarios
+
+### Rendering Behavior
+
+The widget offers two scaling modes:
+- **Width-based scaling** (default): When no fixed height is set, the PDF scales to fit the widget width and the widget height adjusts based on the PDF's aspect ratio
+- **Height-based scaling**: When a fixed height is configured, the PDF scales to fit the specified height
+
+### Prerequisites and Dependencies
+
+**System Requirements**:
+- PDF.js library must be available in the frontend
+- Document entity type must be available (platform feature)
+- Modern browser with HTML5 canvas support
+
+**Configuration Prerequisites**:
+- Entity type must have at least one reference attribute pointing to Document entities
+- The attribute must have multiplicity of 1..1 or 0..1
+- Users must have read access to referenced documents
+
+### Limitations
+
+1. **Single Page Only**: Only displays the first page of the PDF
+2. **PDF Files Only**: Does not work with other document types (Word, Excel, images, etc.)
+3. **No Interactivity**: Cannot interact with PDF form fields or annotations
+4. **No Navigation**: Cannot scroll or navigate to other pages
+5. **Canvas Rendering**: Some PDF features may not render perfectly (complex fonts, advanced graphics)
+
+## Related Widgets
+
+### Alternative Widgets
+
+- **Files Widget** (`cf.platform.files`): Shows all attached files, but doesn't provide inline preview
+- **Dynamic Iframe Widget** (`cf.cplace.platform.dynamicIframe`): Can embed external content, but doesn't handle PDF rendering directly
+- **Image Gallery Widget** (`msg.scripts.imagegallery.basic`): Shows image previews but focused on images rather than PDFs
+
+### Integration Context
+
+- Works with any custom entity type that has Document reference attributes
+- Integrates with cplace's permission system for access control
+- Compatible with cplace's widget framework (reload actions, fixed heights, frames)
+- Can be used on any page layout that supports widgets
+- Complements document management capabilities in cplace

package/dist/widget-specifications/cf.cplace.pdfPreview.widget/_summary.md

@@ -0,0 +1 @@
+Enables you to embed a PDF and shows the first page of the document directly within a cplace page as an inline preview. Use when you want to provide immediate visual context of PDF documents without requiring users to download or open them separately.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.platform.attributesGroup",
+  "Description": "{\"en\":\"Allows the flexible arrangement of attributes on a page.\",\"de\":\"Erlaubt die flexible Anordnung von Attributen einer Seite.\"}",
+  "Localized Name": "{\"en\":\"Grouped Attributes of a Page\",\"de\":\"Gruppierte Attribute einer Seite\"}",
+  "Icon": "cf-pencil-group",
+  "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 'Grouped Attributes of a Page' widget is a configurable display component for attributes. It allows a flexible placement of attributes on the page.</p>\n\n<p>The attributes to be displayed are specified in the 'Edit Layout' view by inserting a 'Single Attribute for a Page' widget (ToDo: add link) for each attribute.</p>\n\n<p>The source of the attributes can either be the embedding page itself, a different page that can be explicitly selected, or a relative page that can be specified via the relations attribute of the embedding page.</p>\n\n<p>The attributes can either be displayed for reading or for editing.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Title: Bilingual text.</p>\n\n<p>// * Show widget frame*: True/False. Specifies if the widget should be displayed within a visible frame or not.</p>\n\n<p>// * Show attribute in single column*: True/False. Determines if an attribute and its value(s) should be displayed as individual lines within the same column (true) or next to each other in a single line with different columns (false).</p>\n\n<p>// * Data source (Embedding page, Explicit selection, From attribute):</p>\n\n<p>// * Enable multi-edit*: True/False.</p>\n\n<p>// * Layout*: Opens the 'Edit Layout' page on which you can add a 'Heading' widget or a 'Single Attribute on a Page' widget.</p>\n\n<p>// * Height: Value in pixels. Heigth of the widget in pixels. If the specified height is not sufficient for all data to be shown, a scrollbar will be displayed.</p>\n\n<p><strong>Key Benefits</strong></p>\n\n<p><strong>Examples</strong></p>"
+}

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/_implementation.md

@@ -0,0 +1,13 @@
+**Configuration Modes** (via `pageSelection`):
+- `embedding`: Display attributes of the current page (the page containing this widget) - most common
+- `absolute`: Display attributes of a specific, statically-configured page (requires `absoluteSelection`)
+- `relative`: Display attributes of a dynamically-referenced page via an attribute (requires `relativeSelection`)
+
+**Typical Configuration Workflow**:
+1. Choose data source mode via `pageSelection` (usually `"embedding"` for current page)
+2. Configure the corresponding selection attribute:
+   - For `absolute`: Set `absoluteSelection` to the target page UID
+   - For `relative`: Set `relativeSelection` to a reference attribute name
+   - For `embedding`: No additional configuration needed
+3. Configure the `layout` using dedicated MCP Tools for Managing Embedded Layouts
+4. Optionally customize appearance (`showFrame`, `singleColumn`) and behavior (`enableMultiEdit`)

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/_meta.json

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

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/_overview.md

@@ -0,0 +1,108 @@
+## Overview
+
+The Grouped Attributes widget allows the flexible arrangement of attributes on a page. Unlike a standard attribute list that shows all attributes in a fixed format, this widget gives full control over which attributes appear and how they're arranged in a custom grid layout.
+
+## When to Use
+
+**Choose this widget when:**
+- You need to highlight specific attributes rather than showing everything
+- Attributes should be grouped logically (e.g., dates together, people together)
+- The layout requires multiple columns with varying widths
+- Individual attributes need different display settings (labels, editing behavior)
+
+**Choose alternatives when:**
+- You want a quick view of all attributes without customization - use standard Attributes widget
+- Attributes should come from a connected/selected page rather than the current page - use **Connected Attributes**
+
+## Conceptual Architecture
+
+The widget acts as a container holding an embedded layout grid. Each cell in the grid contains a single attribute display:
+
+```
++- Grouped Attributes Container --------------------------+
+|                                                         |
+|  +----------+----------+----------+----------+          |
+|  | Start    | End      | Duration | Owner    |  Row 1   |
+|  +----------+----------+----------+----------+          |
+|  | Parent Project      | Schedule            |  Row 2   |
+|  +---------------------+---------------------+          |
+|  | Status              | Rating              |  Row 3   |
+|  +---------------------+---------------------+          |
+|                                                         |
++---------------------------------------------------------+
+```
+
+This nested structure means:
+- The outer widget defines the container (title, frame, height)
+- The inner grid defines rows and column proportions
+- Each cell contains an individual attribute with its own display settings
+
+## Layout Patterns
+
+### Logical Row Grouping
+
+Arrange related attributes in the same row for visual coherence:
+
+| Row Theme | Typical Attributes |
+|-----------|-------------------|
+| Temporal | Start date, end date, duration |
+| People | Owner, responsible, assignee |
+| Status | State, rating, escalation level |
+| Hierarchy | Parent, schedule, project |
+
+### Column Proportions
+
+The grid uses a 12-unit system. Common arrangements:
+
+| Layout | Suited For |
+|--------|-----------|
+| Four equal columns | Short values like dates |
+| Three equal columns | Medium-length values |
+| Two equal columns | References, longer text |
+| Full width | Descriptions, rich text |
+
+### Progressive Disclosure
+
+Place the Grouped Attributes widget at the top of a page with key summary information. Use Layout Tabs below for secondary details, keeping the primary view focused.
+
+## Design Considerations
+
+### Custom Labels
+
+Individual attributes can have alternative labels. This is useful for:
+- Adding units (e.g., "Duration (days)" instead of "Duration")
+- Shortening labels in tight layouts
+- Providing domain-specific terminology
+
+### Inline Editing
+
+Each attribute can be configured for inline editing, allowing users to modify values directly without opening a dialog. Consider enabling this for frequently-updated fields while keeping computed or sensitive fields read-only.
+
+### Frame and Title
+
+The container can display with or without a visual frame. Use a frame when:
+- The widget sits alongside other widgets and needs visual separation
+- A title helps users understand the grouped content
+- The panel represents a distinct logical section
+
+Skip the frame for seamless integration into the page flow.
+
+## Comparison with Related Widgets
+
+| Aspect | Grouped Attributes | Standard Attributes | Connected Attributes |
+|--------|-------------------|--------------------|-----------------------|
+| Attribute source | Current page | Current page | Selected page from table |
+| Attribute selection | Explicit choice | All or filtered | Explicit choice |
+| Layout control | Full grid customization | Fixed format | Full grid customization |
+| Complexity | Higher | Lower | Higher |
+| Primary use | Custom detail panels | Quick overview | Master-detail patterns |
+
+## Common Use Cases
+
+1. **Detail Page Header**: Show the most important attributes prominently at the top of a page, with logical grouping and custom layout
+
+2. **Settings Panel**: Collect configuration attributes in a dedicated section with appropriate frame and title
+
+3. **Status Overview**: Group status-related attributes (state, rating, escalation) for quick assessment
+
+4. **Scheduling Summary**: Combine temporal attributes (dates, duration, milestones) in a focused view

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/_summary.md

@@ -0,0 +1 @@
+Allows the flexible arrangement of attributes on a page in a custom grid layout. Use when you need to highlight specific attributes with logical grouping and controlled column arrangements rather than showing all attributes.

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/absoluteSelection.md

@@ -0,0 +1,9 @@
+**Note**: Conditionally required based on `pageSelection` mode.
+
+**When Required**:
+- Only when `pageSelection` is set to `"absolute"` (Explicit Selection mode)
+- Inactive/ignored for other pageSelection modes
+
+**Purpose**: Specifies the exact page whose attributes should be displayed in the widget.
+
+**Usage**: Set to the UID of the target page you want to display attributes from.

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/layout.md

@@ -0,0 +1,3 @@
+**Purpose**: Defines the grid layout structure and embedded widget configurations. This is the core of the attributesGroup widget, containing the actual attribute widgets arranged in rows and columns.
+
+**Managing Embedded Layouts**: Use `cplace_define_layout` with `layout.define()` and the `embeddedLayouts` parameter to define nested layouts within container widgets like AttributesGroup. This handles embedded layout creation atomically as part of the overall layout definition.

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/pageSelection.md

@@ -0,0 +1,12 @@
+**Warning**: This is a mode selector, not a data reference!
+
+**Valid Values**:
+- `embedding`: Display attributes of the current page (the page containing this widget)
+- `absolute`: Display attributes of a specific page selected explicitly (requires `absoluteSelection`)
+- `relative`: Display attributes of a page referenced via an attribute on the current page (requires `relativeSelection`)
+
+**Note**:
+- Choosing `absolute` activates the `absoluteSelection` attribute
+- Choosing `relative` activates the `relativeSelection` attribute
+- Choosing `embedding` requires no additional configuration
+- This controls which selection attribute becomes active/required

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/relativeSelection.md

@@ -0,0 +1,14 @@
+**Note**: Conditionally required based on `pageSelection` mode.
+
+**When Required**:
+- Only when `pageSelection` is set to `"relative"` (From Attribute mode)
+- Inactive/ignored for other pageSelection modes
+
+**Purpose**: Specifies a reference attribute on the embedding page that points to the target page.
+
+**Valid Values**:
+- Attribute name of any single-page reference attribute on the embedding page's type
+- The dynamic enumeration provider lists available reference attributes at runtime
+- Common examples: parent references, related entity references, owner references
+
+**Usage**: Enter the attribute name (e.g., `"cf.cplace.myPlugin.relatedPage"`) of the reference attribute to follow.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.platform.batchJobQuickGlance",
+  "Description": "{\"en\":\"Provides a brief overview of a selected job. The job can be started or configured.\",\"de\":\"Gibt einen kurzen Überblick über einen ausgewählten Job. Der Job kann gestartet oder konfiguriert werden.\"}",
+  "Localized Name": "{\"en\":\"Batch Job Quick Access\",\"de\":\"Batch-Job Schnellzugriff\"}",
+  "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 'Batch-Job Quick Access' widget provides you with a quick overview of the properties of a selected batch job. The batch job can also be started and configured from within this widget.</p>\n\n<p><strong>Settings</strong></p>"
+}

package/dist/widget-specifications/cf.cplace.platform.batchJobQuickGlance/_meta.json

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

package/dist/widget-specifications/cf.cplace.platform.batchJobQuickGlance/_overview.md

@@ -0,0 +1,52 @@
+## Overview
+
+The Batch Job Quick Access widget provides a brief overview of a selected job. The job can be started or configured directly from within the widget. It displays the status of the most recent execution of a selected batch job and offers action buttons to start, configure, suspend, or resume the job.
+
+This widget serves as a quick-access interface for jobs that run asynchronously in the background, without requiring users to navigate to dedicated job management pages.
+
+## Use Cases
+
+### Administrative Dashboards
+Display status of critical system jobs (data synchronization, cleanup tasks, exports) on admin overview pages. Multiple widget instances can be placed on a single page to monitor several jobs at once.
+
+### Department/Team Pages
+Allow department managers to monitor and trigger department-specific jobs (e.g., employee data exports) directly from their department page.
+
+### Configuration Pages
+Embed on pages related to job configuration to provide immediate execution capability and status feedback after making configuration changes.
+
+### Operational Monitoring
+Create dedicated monitoring pages that aggregate multiple batch jobs using multiple widget instances, providing a single view of all background processing activities.
+
+## Design Considerations
+
+### Extension-Based Architecture
+The widget requires a corresponding `BatchJobQuickGlanceExtension` implementation in a plugin. This means:
+- Widget can only be embedded where at least one extension is selectable
+- Extensions control where they can be used via `isSelectableIn()` method
+- Extensions define which buttons are shown (configuration, download, suspend/resume)
+
+### Real-Time Updates
+The widget automatically polls for updates every 5 seconds when a job is running:
+- Stops polling when job completes
+- Restarts on new job creation
+- Provides loading indicators during operations
+
+### Single Job Focus
+Each widget instance monitors only one batch job and shows only the most recent execution. For job history, users need to navigate to the detailed job view.
+
+### Security Model
+Access control is delegated to extension implementations. Default behavior allows anyone who can view the page to start the job, but extensions can implement custom permission checks.
+
+## When NOT to Use
+
+- For real-time operations that don't use the batch job infrastructure
+- When jobs don't create persistent job records in the system
+- For simple actions that complete immediately (use regular action handlers instead)
+- When you need to show job execution history (use Embedded Search widgets configured to show PersistentJob entities)
+
+## Related Widgets
+
+- **Attributes Widget**: Often used alongside to show job configuration settings on the same page
+- **Comments Widget**: Useful for team communication about job issues or results
+- **Embedded Search Widgets**: Can display a list of all historical job executions if configured to search PersistentJob entities

package/dist/widget-specifications/cf.cplace.platform.batchJobQuickGlance/_summary.md

@@ -0,0 +1 @@
+Provides a brief overview of a selected job. The job can be started or configured directly from the widget. Use for monitoring job execution and enabling users to start, configure, or suspend/resume jobs.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.platform.connectedAttributesGroup",
+  "Description": "{\"en\":\"Allows you to position the attributes from a table flexibly.\",\"de\":\"Erlaubt die flexible Anordnung von Attributen aus einer Tabelle.\"}",
+  "Localized Name": "{\"en\":\"Grouped Attributes of a Table\",\"de\":\"Gruppierte Attribute einer Tabelle\"}",
+  "Icon": "cf-pencil-group",
+  "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 'Grouped Attributes of a Table' widget allows the flexible arrangement of attributes from a table. This coupled widget displays the attributes of the currently selected entry from a linked table.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Title: Bilingual Text.</p>\n\n<p>// * Show Widget Frame*: True/false.<br>\n// * Show attribute in single column*: True/false.<br>\n// * Data source*:</p>\n\n<p>// * Enable multi-edit: True/false.</p>\n\n<p>// * Layout*: Opens 'Edit Layout' dialog in which headings and attributes can be combined to form a layout.<br>\n// * Height: Value in pixels. Heigth of the widget in pixels. If the specified height is not sufficient for all data to be shown, a scrollbar will be displayed.</p>\n\n<p>&nbsp;</p>\n\n<p><strong>Key Benefits</strong></p>\n\n<p>&nbsp;</p>\n\n<p><strong>Examples</strong></p>"
+}

package/dist/widget-specifications/cf.cplace.platform.connectedAttributesGroup/_implementation.md

@@ -0,0 +1,17 @@
+**Purpose**: Displays attributes of the entity selected in a connected table widget, with flexible grid-based layout.
+
+This is a **container widget** that holds an embedded layout grid. It contains nested `cf.platform.connectedSingleAttribute` widgets arranged in customizable rows and columns.
+
+**Typical Workflow**:
+1. First, configure `singleSelectionWidgetId` to connect to a table widget on the same page
+2. Configure the `layout` using dedicated MCP Tools for Managing Embedded Layouts
+3. Optionally set title, height, and frame visibility
+
+**Key Attributes**:
+- `singleSelectionWidgetId`: **Required first step** - ID of the table widget that provides entity selection events
+- `cf.cplace.platform.attributesGroup.layout`: Grid-based layout defining how embedded attribute widgets are arranged
+
+**Widget Behavior**:
+- Widget subscribes to selection events from the connected table widget
+- When user selects a row in the table, this widget refreshes to show attributes of that entity
+- Currently only table widgets (`cf.cplace.platform.table`) can be used as selection sources

package/dist/widget-specifications/cf.cplace.platform.connectedAttributesGroup/_meta.json

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

package/dist/widget-specifications/cf.cplace.platform.connectedAttributesGroup/_overview.md

@@ -0,0 +1,103 @@
+## Overview
+
+The Grouped Attributes of a Table widget allows you to position the attributes from a table flexibly. It displays and edits attributes from a page selected in a connected table widget, implementing the master-detail pattern where selecting a row in a table automatically displays that row's attributes in a detail panel.
+
+## Core Concept: Master-Detail Pattern
+
+```
++-------------------------------------------------------------------------------+
+|                              Master-Detail Pattern                             |
++---------------------------------+---------------------------------------------+
+|   Master Table                  |   Connected Attributes Group                |
+|                                 |                                             |
+|   [Row 1: Item A]               |                                             |
+|   [Row 2: Item B] <-- selected  |   +-------------------------------------+   |
+|   [Row 3: Item C]               |   | Displays attributes of Item B      |   |
+|                                 |   | (the selected row)                  |   |
+|                                 |   +-------------------------------------+   |
++---------------------------------+---------------------------------------------+
+```
+
+### How It Works
+
+1. User selects a row in the master table
+2. The connected attributes group receives the selection event
+3. Widget displays attributes from the selected page
+4. When selection changes, the widget automatically updates
+
+### Embedded Layout Structure
+
+This widget contains an **embedded layout** - a nested grid of attribute widgets. Each attribute is displayed using a `cf.platform.connectedSingleAttribute` widget, which can be arranged in rows and columns within the panel.
+
+## Display Modes
+
+### Single Attribute Detail
+
+Display one attribute (like a description or notes field) from the selected row. Best for rich content that benefits from more space.
+
+### Multi-Attribute Grid
+
+Display several attributes in a grid layout for a compact overview of the selected item.
+
+### Vertical Stack
+
+All attributes in a single column for a detailed, form-like view.
+
+## Layout Patterns
+
+### Side-by-Side (Most Common)
+
+Table on the left, detail panel on the right. Users can browse the list while seeing details of their selection.
+
+### Stacked
+
+Table spans full width with the detail panel below. Good when both table columns and detail content need horizontal space.
+
+### Dashboard with Multiple Connected Widgets
+
+A single master table can drive multiple detail widgets - attribute panels, charts, and secondary tables all update based on the selection.
+
+## Design Considerations
+
+### Visual Alignment
+
+Match the height of the detail panel to the master table for visual balance. When they're side-by-side, equal heights create a cohesive layout.
+
+### Label Strategy
+
+- **Single attribute with a titled frame**: Hide individual attribute labels to avoid redundancy
+- **Multiple attributes in one panel**: Show labels to distinguish each field
+
+### In-Place Editing
+
+Individual attributes can enable in-place editing, allowing users to modify values directly in the detail panel without opening a dialog.
+
+### Empty State
+
+The widget shows nothing until the user selects a row. Consider this in your layout - the panel will appear empty on initial page load.
+
+## When to Use This vs. Alternatives
+
+| Scenario | Recommended Widget |
+|----------|-------------------|
+| Custom detail layout with specific attributes | **Connected Attributes** |
+| Quick detail panel showing all attributes | **Table Detail View** |
+| Attributes of the page being viewed | **Grouped Attributes** |
+| Need inline editing of selected item | **Connected Attributes** |
+| Simple preview without customization | **Table Detail View** |
+
+## Comparison: Connected Attributes vs Grouped Attributes
+
+| Aspect | Connected Attributes | Grouped Attributes |
+|--------|----------------------|--------------------|
+| Data source | Selected row in a table | The current page |
+| Requires table connection | Yes | No |
+| Updates dynamically | Yes, on selection change | No |
+| Use case | Master-detail patterns | Page detail layouts |
+
+## Related Widgets
+
+- **Embedded Search Table**: The typical master widget that drives selection
+- **Grouped Attributes**: Same concept but for the current page's own attributes
+- **Table Detail View**: Simpler alternative that shows all attributes automatically
+- **Connected charts**: Charts can also connect to tables using the same master-detail pattern

package/dist/widget-specifications/cf.cplace.platform.connectedAttributesGroup/_summary.md

@@ -0,0 +1 @@
+Allows you to position the attributes from a table flexibly. Use for master-detail patterns where selecting a table row should show that item's details in a separate panel.

package/dist/widget-specifications/cf.cplace.platform.connectedAttributesGroup/cf.cplace.platform.attributesGroup.layout.md

@@ -0,0 +1,3 @@
+**Purpose**: Defines the grid layout structure and embedded widget configurations. This is the core of the attributesGroup widget, containing the actual attribute widgets arranged in rows and columns.
+
+**Managing Embedded Layouts**: Use `cplace_define_layout` with `layout.define()` and the `embeddedLayouts` parameter to define nested layouts within container widgets like AttributesGroup. This handles embedded layout creation atomically as part of the overall layout definition.