Skip to main content

Details Widget

The Details Widget in 1Relation displays custom fields from any module in the system, providing detailed information about specific items.

Alt text

Configuring the Details Widget through UI

To set up your Details Widget in the UI, follow these steps:

  • Name: Specify the name of the widget.
  • Sort: Determine the order of this widget on the dashboard.
  • Size: Set the size of the widget (between 1 and 12).
  • Tabs: Select in which tab(s) this widget should be shown.
  • Columns: Specify which columns should be shown in the table and their order.

Alt text

JSON Configuration

##2 Widget Customization

Customize the appearance of your widget with these main properties:

PropertyTypeRequiredOptionsDescription
iconstringNoN/AIcon for the widget. Visit Google Fonts Icons for options.
iconColorstringNoHex color codeColor of the icon. Use a hex color code.
iconBackgroundColorstringNoHex color codeBackground color of the icon. Use a hex color code.

Example 1: Widget Customization

{
"icon": "info",
"iconColor": "#FFFFFF",
"iconBackgroundColor": "#007BFF"
}

Relations

Define the relationships between different modules within your widget:

PropertyTypeRequiredOptionsDescription
parentintegerYesN/AThe ID of the parent module in the relation.
childintegerYesN/AThe ID of the child module in the relation.
relationidintegerNoN/AThe ID of the specific relation, if multiple relations exist between the two modules.

Example 2: Widget with Relations

{
"relations": {
"module43": {
"parent": 43,
"child": 41,
"relationid": 22
}
}
}

In this relation configuration, the parent module is identified as module 43, and the child module as module 41. The relationid is set to 22, indicating the specific relation used if multiple relations exist between these two modules.

Widget Functionalities

Configure additional functionalities for the widget:

PropertyTypeRequiredOptionsDescription
allowInlineEditbooleanNotrue, falseToggle field editing through an added edit icon.
disableInlineEditLogicarrayNoN/ALogic to deactivate field editing when certain custom field values are set. Uses our JSON query functionality
clickablestringNoN/AThe ID of the custom field that should be clickable.

Example 3: Widget Functionalities

{
"allowInlineEdit": true,
"disableInlineEditLogic": [
{
"field": "[cf94]",
"value": "Closed"
},
{
"field": "[cf94]",
"value": "Done"
}
],
"clickable": "cf100"
}