Free cookie consent management tool by TermsFeed Event Data Component (a!eventData)
Event Data Component
SAIL Design System guidance available for Event History List

The event history list component should allow users to see all relevant event data at a glance. Check out the design guidance page to learn how to display your data in a structured, easy-to-scan layout to help your users find what they need.

Function

a!eventData( recordType, filters, timestamp, user, eventTypeName, details, recordTypeForTag, recordIdentifier )

This function determines the event data to display for a single record type in the Event History List component.

See also: Configure Record Events

Parameters

Name Keyword Types Description

Record Type

recordType

Record Type

A reference to a record type, configured using the recordType! domain. For example, recordType!Order. If you configured record events, use the Event History record type.

Filters

filters

Any Type

A single logical expression or a list of query filters, which are applied together with an AND operation, can be provided to apply additional filters to the record set. Queries also inherit the record-level security or default filters defined on the referenced record type. When filtering, use only record fields or related record fields from the referenced record type. Record types sourced from a web service or other expression only support this parameter if data sync is enabled.

Timestamp

timestamp

Record Field

A record field of type Date and Time, Date, or Time that displays the timestamp when an event occurred. The list of event data will be sorted in descending order by this field. If you generated an Event History record type, use the timestamp field from that record type. For example, recordType!Order Event History.fields.timestamp.

User

user

Any Type

A record field of type User that displays who completed the event. If you generated an Event History record type, use the user field from that record type. For example, recordType!Order Event History.fields.user.

Event Type Name

eventTypeName

Any Type

A record field of type Text that displays the type of event that occurred. If you generated an Event Type Lookup record type, use the eventType relationship on the Event History record type to select the name field. You must use the fv!data prefix to access the data in this field. For example, fv!data[recordType!Order Event History.relationships.eventType.fields.name].

Additional Details

details

Text

Any additional information about the event. If you generated an Event History record type, this field is not automatically included, but can be manually added by a developer. You must use the fv!data prefix to access the data in this field. For example, fv!data[recordType!Order Event History.fields.details].

Record Type for Tag

recordTypeForTag

Record Type

The record type linked in the tag for an event.

Record Identifier for Tag

recordIdentifier

Record Field

The record identifier that links your Event History record type to your base record type.

Usage considerations

Where to use this function

This function can only be used to configure the Event History List component. For the fastest configuration, we recommend using design mode to configure this component.

You can select any record type in the recordType parameter, but this function works best when you select an Event History record type that's used in your record events configuration.

If you generated an Event History record type, you can easily map those generated fields to the parameters in this function.

For example, let's say you configured record events on an Order record type by generating an Event History record type and an Event Type Lookup record type. To configure this function to display the order event history, you'd select the following fields:

Parameter Example Event History Record Field
timestamp recordType!Order Event History.fields.timestamp
user recordType!Order Event History.fields.user
eventTypeLookup recordType!Order Event History.relationships.eventType.fields.name

Then, if you are logging the specific automation type that completed an event, you could use the following expression in the details parameter to show which type of automation completed the order:

1
2
3
4
5
if(
  isNullOrEmpty(recordType!Order Event History.fields.user),
  a!automationType(recordType!Order Event History.fields.automationId) & " completed this order.",
  {}
)

Examples

See the Event History List component for examples using this function.

Feature compatibility

The table below lists this SAIL component's compatibility with various features in Appian.
Feature Compatibility Note
Portals Incompatible
Offline Mobile Incompatible
Sync-Time Custom Record Fields Incompatible
Real-Time Custom Record Fields Incompatible

Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.

Process Reports Incompatible

Cannot be used to configure a process report.

Process Events Incompatible

Cannot be used to configure a process event node, such as a start event or timer event.

Open in Github Built: Fri, May 24, 2024 (06:19:22 PM)

Event Data Component

FEEDBACK