Widget History

OverviewDirect link to Overview

The Widget History component displays a chronological record of activities and changes for instances and tasks. This component automatically loads and presents historical data in a structured table format, providing users with a comprehensive view of all actions, validations, and modifications that have occurred.

Key FeaturesDirect link to Key Features

Automatic History Loading: Automatically fetches history data when an instance ID or task ID is present
Hierarchical History: Option to include parent and child instance histories
Responsive Design: Optimized for both desktop and mobile viewing
Customizable Measures: Add custom columns to display additional data fields
Interactive Comments: Integrated comment area for adding new entries
Mobile-Friendly: Collapsible rows on mobile devices for better user experience

Configuration OptionsDirect link to Configuration Options

Basic ConfigurationDirect link to Basic Configuration

Include Father HistoryDirect link to Include Father History

Description: When enabled, includes the history of the parent instance in addition to the current instance history
Use Case: Useful for tracking the complete lineage of related processes

Include Children HistoryDirect link to Include Children History

Description: When enabled, includes the history of all child instances related to the current instance
Use Case: Provides a comprehensive view of all sub-processes and their activities

Measures ConfigurationDirect link to Measures Configuration

Measures allow you to add custom columns to display additional data from the history records.

Adding a New MeasureDirect link to Adding a New Measure

Click "Add Measure" button
Configure the following properties:

Field: The field name from the history data object

Example: status, priority, assignedUser

Label: The display label for the column header

Example: "Status", "Priority Level", "Assigned To"

Width: Column width (optional)

Format: CSS width values
Examples: 120px, 15%, auto

Visibility Rule: JavaScript condition to show/hide the column

Context: Access to models object
Example: models.userRole === 'admin'

HTML Template: Custom HTML template for rendering cell content

Context: Access to scope.row for current row data
Example:

<span class="status-badge" :class="scope.row.status">
  {{ scope.row.measures.status || 'N/A' }}
</span>

Widget History [Measures](/docs/en/ressources/project/process/measures) Configuration

Default ColumnsDirect link to Default Columns

ValidatorDirect link to Validator

Content: User avatar and email
Mobile: Shows email with expand/collapse functionality
Special: Displays "pour [representative]" if user is acting on behalf of someone else