Fluent Commerce Logo
Docs

Activity Component

UI Component

Changed on:

19 Sept 2025

Overview

  • The Activity component displays events and related entities for a lifecycle of the entity that the page represents.
  • This document describes what is an activity component, its properties, and sample usage.
No alt text provided
Plugin NameOMS
Admin components for managing a Fluent Commerce account.

Alias

fc.activity.entity

Detailed technical description

  • The Activity component can be included in any mystique page to display relevant activities associated with the entity the page represents.
  • The "showChildEntities" parameter specifies whether or not the page should display activities related to child entities.
  • Fulfillment and Article are sub-entities of the Order entity. It is possible to display activities associated with these sub-entities in the Activity component added to the Order entity using this parameter.
  • The Activity component renders activity logs using a set of built-in templates to deliver a clear and structured representation of the data captured in orchestration event logs.
  • Administrators can use settings to replace the default templates with custom ones (see the Settings for custom template configuration).

Settings for custom template configuration

The Activity component custom templates are to be configured within the settings (see the Custom template configuration).The list of available settings:
  • ACCOUNT level setting: `fc.mystique.events.templates`:
    • Custom templates configured within the setting will be applied to all of the following entities: `ORDER, BILLING_ACCOUNT, INVENTORY_CATALOGUE, VIRTUAL_CATALOGUE, PRODUCT_CATALOGUE, FULFILMENT_OPTIONS, RETURN_ORDER, CREDIT_MEMO, INVENTORY_POSITION`.
  • Entity-specific settings:
    • fc.mystique.events.templates.order
    • fc.mystique.events.templates.billing_account
    • fc.mystique.events.templates.inventory_catalogue
    • fc.mystique.events.templates.virtual_catalogue
    • fc.mystique.events.templates.product_catalogue
    • fc.mystique.events.templates.fulfilment_options
    • fc.mystique.events.templates.return_order
    • fc.mystique.events.templates.credit_memo
    • fc.mystique.events.templates.inventory_position

Activity component templates application logic

  • Entity-specific custom templates are applied to the Activity component when:
    • At least one of the entity-specific settings exists and is turned on.
  • General (not entity-specific) custom templates are applied to the Activity component when:
    • `fc.mystique.events.templates` setting exists and is turned on
    • All the entity-specific settings don’t exist or are turned off.
  • Default templates (see the Activity Component Default Content) are applied to the Activity component when:
    • All the entity-specific settings don’t exist or are turned off.
    • `fc.mystique.events.templates` don't exist or are turned off

Custom template configuration

The list of event types available to be configured:
  • ORCHESTRATION
  • ORCHESTRATION_AUDIT
  • GENERAL
  • API
  • INTEGRATION
  • SECURITY
Priority determines the rendering order for the templates processed from higher to lower. Only the first match will be rendered.Value configuration example:No alt providedNo alt provided

Q&A

What can I do if Activity Tab doesn’t display the entity status when changed?
  • Step 1: Check if the setting is named `fc.mystique.events.templates` exist. Go to Admin → Settings and filter by fc.mystique.events.templates
No alt provided
  • Step 2: Turn this setting off if you want to apply default Activity Tab templates. To do this - rename the setting.
No alt provided
  • Step 3: If you want your Activity Tab templates to be applied - check your settings and update them like in the example below:
No alt provided

Properties

NameTypeRequiredDefaultDescription
width`quarter` / `third` / `half` / `two-thirds` / full / `number (1-12`No`full`Define the width of this component on a 12-column grid. Can use the named widths for readability or numbers directly.On mobile devices, all widths will automatically change to 12 for the best responsive experience.The default is `full` and will take up the entire component width.
showChildEntities`Boolean`NotrueThe parameter specifies whether or not the page should display activities related to child entities.

Configuration example

1{
2    "component": "fc.activity.entity",
3    "dataSource": "orderById",
4    "props": {
5        "width": "12",
6        "showChildEntities": true
7    }
8}

Version History

Recommended Placement

None