Actions
Learn about Actions in Layer Automations, including creating or updating elements, sending notifications, and syncing Revit parameters. Customize tasks for streamlined workflows.
Zach Soflin
Sep 24, 2024
What are Actions in Automations?
Automation Actions define the task that is performed when an automation is run. An automation must include at least one action, but may also include any number of actions that all run in parallel when the automation is run.
Create an Element
This action creates an element in the specified category.
Element Name
The element name can either be the auto-generated element name or a custom element name.
Set Field Values
Manually set a Field Value
This option allows you to manually define a field and a value for the field that will be used when the element is created.
Insert a Field Value from Trigger Element
This option allows you to pull a field value from the element that triggered the automation and insert it into the newly created element. This option is available when the trigger is Element is Created, Element is Updated, Element in Category is Updated, or Element Matches a Filter.
A value may be inserted into the created element if:
The field type from the triggering element matches to field type in the new element
If the value from the triggering element can be converted to a string, and the field type of new element is text. Learn more about which fields can be converted to a string here.
Update an Element
This action updates an element in the project. The element can either be a single specific element or the element that triggered the automation.
Element to Update
Use Trigger Element
This option allows you to use the element that triggered the automation as the element that will be updated. This option is available when the trigger is Element is Created, Element is Updated, Element in Category is Updated, or Element Matches a Filter.
♾️ Note that we take measures to prevent an infinite automation loop in which an element is updated via an automation action, which in turn triggers the same automation based on an element update, and so on. An element that is updated as part of an automation action cannot in turn trigger an automation.
Manually Select an Element
This option allows you to manually select a single element in the project to update.
Set Field Values
Manually set a Field Value
This option allows you to manually define a field and a value for the field that will be used when the element is updated.
Insert a Field Value from Trigger Element
This option allows you to pull a field value from the element that triggered the automation and insert it into the element being updated. This option is available when the trigger is Element is Created, Element is Updated, Element in Category is Updated, or Element Matches a Filter.
A value may be inserted into the element being updated if:
The field type from the triggering element matches to field type in the new element
If the value from the triggering element can be converted to a string, and the field type of new element is text. Learn more about which fields can be converted to a string here.
Send a notification
This action sends a push notification to one or users. The user can either be manually selected from a list of users in the project or dynamically pulled from a field in the triggering element. Notifications will be sent to users’ mobile devices and desktop devices so long as they have enabled notification from Layer on that device.
Send Notification To
Field from the Trigger Element
Select one or more fields from the triggering element that define a user in the project to send the notification to. Supported fields are Person Field, Last Updated By, Created By.
Users in Project
Select one or more users from the list of project users to send the notification to.
Notification Message
Define the message body of the notification. The body can include field values from the triggering element. To insert a value into the notification message, you can click on the + button to the tight of the text field or type # to bring up a list of fields. Supported fields TODO
are any fields that can be converted to a string.
Send an Email
Send To
Define the email addresses and users to send the email to. The input can include any number of comma-separated email addresses, even for users who are outside the project. Clicking the + button allows you to insert fields from the triggering element or users from the set of project users. Supported fields to use in Send To are Person Field, Last Updated By, Created By.
Subject
The Subject input defines the subject of the email, and can include generic text and field values from the triggering element. Supported field to insert are any field that can converted to a string.
Message
The body of the email, which can be any combination of generic text and field values from the triggering element. Supported field to insert are any field that can converted to a string.
When the email is delivered to the user’s inbox, it will be formatted with all of the field values inserted, as seen in this screenshot:
Update a Revit Parameter
This action queues up values to be written to Revit Parameters within a Revit model. This action is only present when the project is linked to a Revit Model.
<aside> ⚠️ The Update a Revit Parameter action is only compatible with triggers that point to a Revit model category.
</aside>
To set up this action, you will be prompted to select a Revit Parameter, which is a parameter that is present on the Revit object that the triggering element represents. You will then select the Value to Set from the Trigger Element. Note that only fields that can be represented as strings are able to be written to Revit Parameters.
After selecting the Value to Set from the Trigger Element, you will be shown an option indicating how many elements currently in your project will be effected by this automation. Leaving the checkbox selected will run the automation on all existing elements that match the criteria, thus effectively “back-filling” values to the Revit Parameters. All future changes will be handled by the automation.
To read more about the entire process of writing Layer data to a Revit Model, see Param Sync.
References
Field types that be be converted to a string
The following fields can be converted into strings to be used when inserting a field value from a trigger element into an automation action.
Area
Barcode
Created By
Date
Element Number
Email
Number
Person
Phone
Range
Related
Select
Text
Toggle
Updated At
Updated By
Revit Parameter
Element Name